bun-types 1.2.3-canary.20250212T140603 → 1.2.3-canary.20250214T140552

package/bun.d.ts

@@ -1415,6 +1415,18 @@ declare module "bun" {
 		 */
 		endpoint?: string;
 
+		/**
+		 * Use virtual hosted style endpoint. default to false, when true if `endpoint` is informed it will ignore the `bucket`
+		 *
+		 * @example
+		 *     // Using virtual hosted style
+		 *     const file = s3("my-file.txt", {
+		 *       virtualHostedStyle: true,
+		 *       endpoint: "https://my-bucket.s3.us-east-1.amazonaws.com"
+		 *     });
+		 */
+		virtualHostedStyle?: boolean;
+
 		/**
 		 * The size of each part in multipart uploads (in bytes).
 		 * - Minimum: 5 MiB
@@ -2096,6 +2108,8 @@ declare module "bun" {
 		max?: number;
 		/** By default values outside i32 range are returned as strings. If this is true, values outside i32 range are returned as BigInts. */
 		bigint?: boolean;
+		/** Automatic creation of prepared statements, defaults to true */
+		prepare?: boolean;
 	};
 
 	/**
@@ -2109,6 +2123,8 @@ declare module "bun" {
 		cancelled: boolean;
 		/** Cancels the executing query */
 		cancel(): SQLQuery;
+		/** Execute as a simple query, no parameters are allowed but can execute multiple commands separated by semicolons */
+		simple(): SQLQuery;
 		/** Executes the query */
 		execute(): SQLQuery;
 		/** Returns the raw query result */

package/docs/api/fetch.md

@@ -337,7 +337,7 @@ This will print the request and response headers to your terminal:
 ```sh
 [fetch] > HTTP/1.1 GET http://example.com/
 [fetch] > Connection: keep-alive
-[fetch] > User-Agent: Bun/1.2.3-canary.20250212T140603
+[fetch] > User-Agent: Bun/1.2.3-canary.20250214T140552
 [fetch] > Accept: */*
 [fetch] > Host: example.com
 [fetch] > Accept-Encoding: gzip, deflate, br

package/docs/api/s3.md

@@ -181,8 +181,8 @@ const download = s3.presign("my-file.txt"); // GET, text/plain, expires in 24 ho
 
 const upload = s3.presign("my-file", {
   expiresIn: 3600, // 1 hour
-  method: 'PUT',
-  type: 'application/json', // No extension for inferring, so we can specify the content type to be JSON
+  method: "PUT",
+  type: "application/json", // No extension for inferring, so we can specify the content type to be JSON
 });
 
 // You can call .presign() if on a file reference, but avoid doing so
@@ -361,6 +361,56 @@ const minio = new S3Client({
 });
 ```
 
+### Using Bun's S3Client with supabase
+
+To use Bun's S3 client with [supabase](https://supabase.com/), set `endpoint` to the supabase endpoint in the `S3Client` constructor. The supabase endpoint includes your account ID and /storage/v1/s3 path. Make sure to set Enable connection via S3 protocol on in the supabase dashboard in https://supabase.com/dashboard/project/<account-id>/settings/storage and to set the region informed in the same section.
+
+```ts
+import { S3Client } from "bun";
+
+const supabase = new S3Client({
+  accessKeyId: "access-key",
+  secretAccessKey: "secret-key",
+  bucket: "my-bucket",
+  region: "us-west-1",
+  endpoint: "https://<account-id>.supabase.co/storage/v1/s3/storage",
+});
+```
+
+### Using Bun's S3Client with S3 Virtual Hosted-Style endpoints
+
+When using a S3 Virtual Hosted-Style endpoint, you need to set the `virtualHostedStyle` option to `true` and if no endpoint is provided, Bun will use region and bucket to infer the endpoint to AWS S3, if no region is provided it will use `us-east-1`. If you provide a the endpoint, there are no need to provide the bucket name.
+
+```ts
+import { S3Client } from "bun";
+
+// AWS S3 endpoint inferred from region and bucket
+const s3 = new S3Client({
+  accessKeyId: "access-key",
+  secretAccessKey: "secret-key",
+  bucket: "my-bucket",
+  virtualHostedStyle: true,
+  // endpoint: "https://my-bucket.s3.us-east-1.amazonaws.com",
+  // region: "us-east-1",
+});
+
+// AWS S3
+const s3WithEndpoint = new S3Client({
+  accessKeyId: "access-key",
+  secretAccessKey: "secret-key",
+  endpoint: "https://<bucket-name>.s3.<region>.amazonaws.com",
+  virtualHostedStyle: true,
+});
+
+// Cloudflare R2
+const r2WithEndpoint = new S3Client({
+  accessKeyId: "access-key",
+  secretAccessKey: "secret-key",
+  endpoint: "https://<bucket-name>.<account-id>.r2.cloudflarestorage.com",
+  virtualHostedStyle: true,
+});
+```
+
 ## Credentials
 
 Credentials are one of the hardest parts of using S3, and we've tried to make it as easy as possible. By default, Bun reads the following environment variables for credentials.

package/docs/api/spawn.md

@@ -110,7 +110,7 @@ You can read results from the subprocess via the `stdout` and `stderr` propertie
 ```ts
 const proc = Bun.spawn(["bun", "--version"]);
 const text = await new Response(proc.stdout).text();
-console.log(text); // => "1.2.3-canary.20250212T140603"
+console.log(text); // => "1.2.3-canary.20250214T140552"
 ```
 
 Configure the output stream by passing one of the following values to `stdout/stderr`:

package/docs/cli/publish.md

@@ -7,7 +7,7 @@ Use `bun publish` to publish a package to the npm registry.
 $ bun publish
 
 ## Output
-bun publish v1.2.3-canary.20250212T140603 (ca7428e9)
+bun publish v1.2.3-canary.20250214T140552 (ca7428e9)
 
 packed 203B package.json
 packed 224B README.md

package/docs/guides/ecosystem/nuxt.md

@@ -9,7 +9,7 @@ $ bunx nuxi init my-nuxt-app
 ✔ Which package manager would you like to use?
 bun
 ◐ Installing dependencies...
-bun install v1.2.3-canary.20250212T140603 (16b4bf34)
+bun install v1.2.3-canary.20250214T140552 (16b4bf34)
  + @nuxt/devtools@0.8.2
  + nuxt@3.7.0
  785 packages installed [2.67s]

package/docs/guides/install/add-peer.md

@@ -16,7 +16,7 @@ This will add the package to `peerDependencies` in `package.json`.
 ```json-diff
 {
   "peerDependencies": {
-+   "@types/bun": "^1.2.3-canary.20250212T140603"
++   "@types/bun": "^1.2.3-canary.20250214T140552"
   }
 }
 ```
@@ -28,7 +28,7 @@ Running `bun install` will install peer dependencies by default, unless marked o
 ```json-diff
 {
   "peerDependencies": {
-    "@types/bun": "^1.2.3-canary.20250212T140603"
+    "@types/bun": "^1.2.3-canary.20250214T140552"
   },
   "peerDependenciesMeta": {
 +   "@types/bun": {

package/docs/guides/install/from-npm-install-to-bun-install.md

@@ -97,7 +97,7 @@ $ bun update
 $ bun update @types/bun --latest
 
 # Update a dependency to a specific version
-$ bun update @types/bun@1.2.3-canary.20250212T140603
+$ bun update @types/bun@1.2.3-canary.20250214T140552
 
 # Update all dependencies to the latest versions
 $ bun update --latest

package/docs/guides/runtime/delete-directory.md

@@ -0,0 +1,37 @@
+---
+name: Delete directories
+---
+
+To recursively delete a directory and all its contents, use `rm` from `node:fs/promises`. This is like running `rm -rf` in JavaScript.
+
+```ts
+import { rm } from "node:fs/promises";
+
+// Delete a directory and all its contents
+await rm("path/to/directory", { recursive: true, force: true });
+```
+
+---
+
+These options configure the deletion behavior:
+
+- `recursive: true` - Delete subdirectories and their contents
+- `force: true` - Don't throw errors if the directory doesn't exist
+
+You can also use it without `force` to ensure the directory exists:
+
+```ts
+try {
+  await rm("path/to/directory", { recursive: true });
+} catch (error) {
+  if (error.code === "ENOENT") {
+    console.log("Directory doesn't exist");
+  } else {
+    throw error;
+  }
+}
+```
+
+---
+
+See [Docs > API > FileSystem](https://bun.sh/docs/api/file-io) for more filesystem operations.

package/docs/guides/runtime/delete-file.md

@@ -0,0 +1,19 @@
+---
+name: Delete files
+---
+
+To delete a file, use `Bun.file(path).delete()`.
+
+```ts
+// Delete a file
+const file = Bun.file("path/to/file.txt");
+await file.delete();
+
+// Now the file doesn't exist
+const exists = await file.exists();
+// => false
+```
+
+---
+
+See [Docs > API > FileSystem](https://bun.sh/docs/api/file-io) for more filesystem operations.

package/docs/guides/runtime/heap-snapshot.md

@@ -0,0 +1,26 @@
+---
+name: Inspect memory usage using V8 heap snapshots
+---
+
+Bun implements V8's heap snapshot API, which allows you to create snapshots of the heap at runtime. This helps debug memory leaks in your JavaScript/TypeScript application.
+
+```ts#snapshot.ts
+import v8 from "node:v8";
+
+// Creates a heap snapshot file with an auto-generated name
+const snapshotPath = v8.writeHeapSnapshot();
+console.log(`Heap snapshot written to: ${snapshotPath}`);
+```
+
+---
+
+## Inspect memory in Chrome DevTools
+
+To view V8 heap snapshots in Chrome DevTools:
+
+1. Open Chrome DevTools (F12 or right-click and select "Inspect")
+2. Go to the "Memory" tab
+3. Click the "Load" button (folder icon)
+4. Select your `.heapsnapshot` file
+
+{% image src="/images/chrome-devtools-memory.png" alt="Chrome DevTools Memory Tab" width="100%" /%}

package/docs/guides/test/run-tests.md

@@ -21,7 +21,7 @@ Here's what the output of a typical test run looks like. In this case, there are
 
 ```sh
 $ bun test
-bun test v1.2.3-canary.20250212T140603 (9c68abdb)
+bun test v1.2.3-canary.20250214T140552 (9c68abdb)
 
 test.test.js:
 ✓ add [0.87ms]
@@ -47,7 +47,7 @@ To only run certain test files, pass a positional argument to `bun test`. The ru
 
 ```sh
 $ bun test test3
-bun test v1.2.3-canary.20250212T140603 (9c68abdb)
+bun test v1.2.3-canary.20250214T140552 (9c68abdb)
 
 test3.test.js:
 ✓ add [1.40ms]
@@ -85,7 +85,7 @@ Adding `-t add` will only run tests with "add" in the name. This works with test
 
 ```sh
 $ bun test -t add
-bun test v1.2.3-canary.20250212T140603 (9c68abdb)
+bun test v1.2.3-canary.20250214T140552 (9c68abdb)
 
 test.test.js:
 ✓ add [1.79ms]

package/docs/guides/test/snapshot.md

@@ -18,7 +18,7 @@ The first time this test is executed, Bun will evaluate the value passed into `e
 
 ```sh
 $ bun test test/snap
-bun test v1.2.3-canary.20250212T140603 (9c68abdb)
+bun test v1.2.3-canary.20250214T140552 (9c68abdb)
 
 test/snap.test.ts:
 ✓ snapshot [1.48ms]
@@ -61,7 +61,7 @@ Later, when this test file is executed again, Bun will read the snapshot file an
 
 ```sh
 $ bun test
-bun test v1.2.3-canary.20250212T140603 (9c68abdb)
+bun test v1.2.3-canary.20250214T140552 (9c68abdb)
 
 test/snap.test.ts:
 ✓ snapshot [1.05ms]
@@ -78,7 +78,7 @@ To update snapshots, use the `--update-snapshots` flag.
 
 ```sh
 $ bun test --update-snapshots
-bun test v1.2.3-canary.20250212T140603 (9c68abdb)
+bun test v1.2.3-canary.20250214T140552 (9c68abdb)
 
 test/snap.test.ts:
 ✓ snapshot [0.86ms]

package/docs/guides/test/update-snapshots.md

@@ -29,7 +29,7 @@ To regenerate snapshots, use the `--update-snapshots` flag.
 
 ```sh
 $ bun test --update-snapshots
-bun test v1.2.3-canary.20250212T140603 (9c68abdb)
+bun test v1.2.3-canary.20250214T140552 (9c68abdb)
 
 test/snap.test.ts:
 ✓ snapshot [0.86ms]

package/docs/guides/util/version.md

@@ -5,7 +5,7 @@ name: Get the current Bun version
 Get the current version of Bun in a semver format.
 
 ```ts#index.ts
-Bun.version; // => "1.2.3-canary.20250212T140603"
+Bun.version; // => "1.2.3-canary.20250214T140552"
 ```
 
 ---

package/docs/installation.md

@@ -14,7 +14,7 @@ Kernel version 5.6 or higher is strongly recommended, but the minimum is 5.1. Us
 ```bash#macOS/Linux_(curl)
 $ curl -fsSL https://bun.sh/install | bash # for macOS, Linux, and WSL
 # to install a specific version
-$ curl -fsSL https://bun.sh/install | bash -s "bun-v1.2.3-canary.20250212T140603"
+$ curl -fsSL https://bun.sh/install | bash -s "bun-v1.2.3-canary.20250214T140552"
 ```
 
 ```bash#npm
@@ -188,10 +188,10 @@ Since Bun is a single binary, you can install older versions of Bun by re-runnin
 
 ### Installing a specific version of Bun on Linux/Mac
 
-To install a specific version of Bun, you can pass the git tag of the version you want to install to the install script, such as `bun-v1.2.0` or `bun-v1.2.3-canary.20250212T140603`.
+To install a specific version of Bun, you can pass the git tag of the version you want to install to the install script, such as `bun-v1.2.0` or `bun-v1.2.3-canary.20250214T140552`.
 
 ```sh
-$ curl -fsSL https://bun.sh/install | bash -s "bun-v1.2.3-canary.20250212T140603"
+$ curl -fsSL https://bun.sh/install | bash -s "bun-v1.2.3-canary.20250214T140552"
 ```
 
 ### Installing a specific version of Bun on Windows
@@ -200,7 +200,7 @@ On Windows, you can install a specific version of Bun by passing the version num
 
 ```sh
 # PowerShell:
-$ iex "& {$(irm https://bun.sh/install.ps1)} -Version 1.2.3-canary.20250212T140603"
+$ iex "& {$(irm https://bun.sh/install.ps1)} -Version 1.2.3-canary.20250214T140552"
 ```
 
 ## Downloading Bun binaries directly

package/docs/runtime/debugger.md

@@ -124,11 +124,11 @@ await fetch("https://example.com", {
 This prints the `fetch` request as a single-line `curl` command to let you copy-paste into your terminal to replicate the request.
 
 ```sh
-[fetch] $ curl --http1.1 "https://example.com/" -X POST -H "content-type: application/json" -H "Connection: keep-alive" -H "User-Agent: Bun/1.2.3-canary.20250212T140603" -H "Accept: */*" -H "Host: example.com" -H "Accept-Encoding: gzip, deflate, br" --compressed -H "Content-Length: 13" --data-raw "{\"foo\":\"bar\"}"
+[fetch] $ curl --http1.1 "https://example.com/" -X POST -H "content-type: application/json" -H "Connection: keep-alive" -H "User-Agent: Bun/1.2.3-canary.20250214T140552" -H "Accept: */*" -H "Host: example.com" -H "Accept-Encoding: gzip, deflate, br" --compressed -H "Content-Length: 13" --data-raw "{\"foo\":\"bar\"}"
 [fetch] > HTTP/1.1 POST https://example.com/
 [fetch] > content-type: application/json
 [fetch] > Connection: keep-alive
-[fetch] > User-Agent: Bun/1.2.3-canary.20250212T140603
+[fetch] > User-Agent: Bun/1.2.3-canary.20250214T140552
 [fetch] > Accept: */*
 [fetch] > Host: example.com
 [fetch] > Accept-Encoding: gzip, deflate, br
@@ -170,7 +170,7 @@ This prints the following to the console:
 [fetch] > HTTP/1.1 POST https://example.com/
 [fetch] > content-type: application/json
 [fetch] > Connection: keep-alive
-[fetch] > User-Agent: Bun/1.2.3-canary.20250212T140603
+[fetch] > User-Agent: Bun/1.2.3-canary.20250214T140552
 [fetch] > Accept: */*
 [fetch] > Host: example.com
 [fetch] > Accept-Encoding: gzip, deflate, br

package/docs/test/dom.md

@@ -55,7 +55,7 @@ Let's run this test with `bun test`:
 
 ```bash
 $ bun test
-bun test v1.2.3-canary.20250212T140603
+bun test v1.2.3-canary.20250214T140552
 
 dom.test.ts:
 ✓ dom test [0.82ms]

package/package.json

@@ -1,5 +1,5 @@
 {
-	"version": "1.2.3-canary.20250212T140603",
+	"version": "1.2.3-canary.20250214T140552",
 	"name": "bun-types",
 	"license": "MIT",
 	"main": "",