bun-types 1.2.8-canary.20250327T140605 → 1.2.8-canary.20250329T140548

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.8-canary.20250327T140605
+[fetch] > User-Agent: Bun/1.2.8-canary.20250329T140548
 [fetch] > Accept: */*
 [fetch] > Host: example.com
 [fetch] > Accept-Encoding: gzip, deflate, br

package/docs/api/spawn.md

@@ -120,7 +120,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.8-canary.20250327T140605"
+console.log(text); // => "1.2.8-canary.20250329T140548"
 ```
 
 Configure the output stream by passing one of the following values to `stdout/stderr`:

package/docs/api/sql.md

@@ -240,7 +240,7 @@ const result = await sql.unsafe(
 
 ### Execute and Cancelling Queries
 
-Bun's SQL is lazy that means its will only start executing when awaited or executed with `.execute()`.
+Bun's SQL is lazy, which means it will only start executing when awaited or executed with `.execute()`.
 You can cancel a query that is currently executing by calling the `cancel()` method on the query object.
 
 ```ts

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.8-canary.20250327T140605 (ca7428e9)
+bun publish v1.2.8-canary.20250329T140548 (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.8-canary.20250327T140605 (16b4bf34)
+bun install v1.2.8-canary.20250329T140548 (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.8-canary.20250327T140605"
++   "@types/bun": "^1.2.8-canary.20250329T140548"
   }
 }
 ```
@@ -28,7 +28,7 @@ Running `bun install` will install peer dependencies by default, unless marked o
 ```json-diff
 {
   "peerDependencies": {
-    "@types/bun": "^1.2.8-canary.20250327T140605"
+    "@types/bun": "^1.2.8-canary.20250329T140548"
   },
   "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.8-canary.20250327T140605
+$ bun update @types/bun@1.2.8-canary.20250329T140548
 
 # Update all dependencies to the latest versions
 $ bun update --latest

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.8-canary.20250327T140605 (9c68abdb)
+bun test v1.2.8-canary.20250329T140548 (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.8-canary.20250327T140605 (9c68abdb)
+bun test v1.2.8-canary.20250329T140548 (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.8-canary.20250327T140605 (9c68abdb)
+bun test v1.2.8-canary.20250329T140548 (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.8-canary.20250327T140605 (9c68abdb)
+bun test v1.2.8-canary.20250329T140548 (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.8-canary.20250327T140605 (9c68abdb)
+bun test v1.2.8-canary.20250329T140548 (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.8-canary.20250327T140605 (9c68abdb)
+bun test v1.2.8-canary.20250329T140548 (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.8-canary.20250327T140605 (9c68abdb)
+bun test v1.2.8-canary.20250329T140548 (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.8-canary.20250327T140605"
+Bun.version; // => "1.2.8-canary.20250329T140548"
 ```
 
 ---

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.8-canary.20250327T140605"
+$ curl -fsSL https://bun.sh/install | bash -s "bun-v1.2.8-canary.20250329T140548"
 ```
 
 ```bash#npm
@@ -189,10 +189,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.8-canary.20250327T140605`.
+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.8-canary.20250329T140548`.
 
 ```sh
-$ curl -fsSL https://bun.sh/install | bash -s "bun-v1.2.8-canary.20250327T140605"
+$ curl -fsSL https://bun.sh/install | bash -s "bun-v1.2.8-canary.20250329T140548"
 ```
 
 ### Installing a specific version of Bun on Windows
@@ -201,7 +201,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.8-canary.20250327T140605"
+$ iex "& {$(irm https://bun.sh/install.ps1)} -Version 1.2.8-canary.20250329T140548"
 ```
 
 ## Downloading Bun binaries directly

package/docs/project/contributing.md

@@ -134,6 +134,16 @@ We recommend adding `./build/debug` to your `$PATH` so that you can run `bun-deb
 $ bun-debug
 ```
 
+## Running debug builds
+
+The `bd` package.json script compiles and runs a debug build of Bun, only printing the output of the build process if it fails.
+
+```sh
+$ bun bd <args>
+$ bun bd test foo.test.ts
+$ bun bd ./foo.ts
+```
+
 ## Code generation scripts
 
 Several code generation scripts are used during Bun's build process. These are run automatically when changes are made to certain files.

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.8-canary.20250327T140605" -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.8-canary.20250329T140548" -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.8-canary.20250327T140605
+[fetch] > User-Agent: Bun/1.2.8-canary.20250329T140548
 [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.8-canary.20250327T140605
+[fetch] > User-Agent: Bun/1.2.8-canary.20250329T140548
 [fetch] > Accept: */*
 [fetch] > Host: example.com
 [fetch] > Accept-Encoding: gzip, deflate, br

package/docs/runtime/nodejs-apis.md

@@ -378,8 +378,7 @@ The table below lists all globals implemented by Node.js and Bun's current compa
 
 ### [`require()`](https://nodejs.org/api/globals.html#require)
 
-🟢 Fully implemented, including [`require.main`](https://nodejs.org/api/modules.html#requiremain), [`require.cache`](https://nodejs.org/api/modules.html#requirecache), [`require.resolve`](https://nodejs.org/api/modules.html#requireresolverequest-options). `require.extensions` is a stub.
-
+🟢 Fully implemented, including [`require.main`](https://nodejs.org/api/modules.html#requiremain), [`require.cache`](https://nodejs.org/api/modules.html#requirecache), [`require.resolve`](https://nodejs.org/api/modules.html#requireresolverequest-options).
 ### [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response)
 
 🟢 Fully implemented.

package/docs/test/dom.md

@@ -55,7 +55,7 @@ Let's run this test with `bun test`:
 
 ```bash
 $ bun test
-bun test v1.2.8-canary.20250327T140605
+bun test v1.2.8-canary.20250329T140548
 
 dom.test.ts:
 ✓ dom test [0.82ms]

package/ffi.d.ts

@@ -13,6 +13,8 @@
  * that convert JavaScript types to C types and back. Internally,
  * bun uses [tinycc](https://github.com/TinyCC/tinycc), so a big thanks
  * goes to Fabrice Bellard and TinyCC maintainers for making this possible.
+ *
+ * @category FFI
  */
 declare module "bun:ffi" {
   enum FFIType {
@@ -600,6 +602,8 @@ declare module "bun:ffi" {
    * that convert JavaScript types to C types and back. Internally,
    * bun uses [tinycc](https://github.com/TinyCC/tinycc), so a big thanks
    * goes to Fabrice Bellard and TinyCC maintainers for making this possible.
+   *
+   * @category FFI
    */
   function dlopen<Fns extends Record<string, FFIFunction>>(
     name: string | import("bun").BunFile | URL,
@@ -1018,6 +1022,8 @@ declare module "bun:ffi" {
    *  // Do something with rawPtr
    * }
    * ```
+   *
+   * @category FFI
    */
   function ptr(view: NodeJS.TypedArray | ArrayBufferLike | DataView, byteOffset?: number): Pointer;
 
@@ -1042,8 +1048,9 @@ declare module "bun:ffi" {
    * thing to do safely. Passing an invalid pointer can crash the program and
    * reading beyond the bounds of the pointer will crash the program or cause
    * undefined behavior. Use with care!
+   *
+   * @category FFI
    */
-
   class CString extends String {
     /**
      * Get a string from a UTF-8 encoded C string

package/globals.d.ts

@@ -1,7 +1,7 @@
 declare module "bun" {
   namespace __internal {
     type NodeWorkerThreadsWorker = import("worker_threads").Worker;
-    type LibWorkerOrNodeWorkerThreadsWorker = Bun.__internal.UseLibDomIfAvailable<"Worker", NodeWorkerThreadsWorker>;
+    type LibWorkerOrBunWorker = Bun.__internal.UseLibDomIfAvailable<"Worker", Bun.Worker>;
 
     type NodePerfHooksPerformance = import("perf_hooks").Performance;
     type LibPerformanceOrNodePerfHooksPerformance = Bun.__internal.UseLibDomIfAvailable<
@@ -11,8 +11,10 @@ declare module "bun" {
 
     type NodeCryptoWebcryptoSubtleCrypto = import("crypto").webcrypto.SubtleCrypto;
     type NodeCryptoWebcryptoCryptoKey = import("crypto").webcrypto.CryptoKey;
-    type NodeUtilTextEncoder = import("util").TextEncoder;
-    type NodeUtilTextDecoder = import("util").TextDecoder;
+
+    type LibEmptyOrNodeUtilTextEncoder = LibDomIsLoaded extends true ? {} : import("util").TextEncoder;
+
+    type LibEmptyOrNodeUtilTextDecoder = LibDomIsLoaded extends true ? {} : import("util").TextDecoder;
 
     type LibEmptyOrNodeReadableStream<T = any> = LibDomIsLoaded extends true
       ? {}
@@ -25,6 +27,8 @@ declare module "bun" {
     type LibEmptyOrNodeTransformStream<I = any, O = any> = LibDomIsLoaded extends true
       ? {}
       : import("stream/web").TransformStream<I, O>;
+
+    type LibEmptyOrNodeMessagePort = LibDomIsLoaded extends true ? {} : import("worker_threads").MessagePort;
   }
 }
 
@@ -47,7 +51,7 @@ declare var WritableStream: Bun.__internal.UseLibDomIfAvailable<
   }
 >;
 
-interface Worker extends Bun.__internal.LibWorkerOrNodeWorkerThreadsWorker {}
+interface Worker extends Bun.__internal.LibWorkerOrBunWorker {}
 declare var Worker: Bun.__internal.UseLibDomIfAvailable<
   "Worker",
   {
@@ -62,6 +66,13 @@ declare var Worker: Bun.__internal.UseLibDomIfAvailable<
   }
 >;
 
+/**
+ * A WebSocket client implementation
+ *
+ * If `DOM` is included in tsconfig `lib`, this falls back to the default DOM global `WebSocket`.
+ * Otherwise (when outside of a browser environment), this will be the `WebSocket`
+ * implementation from the `ws` package, which Bun implements.
+ */
 declare var WebSocket: Bun.__internal.UseLibDomIfAvailable<"WebSocket", typeof import("ws").WebSocket>;
 
 interface Crypto {}
@@ -81,7 +92,7 @@ declare var crypto: Crypto;
  * const uint8array = encoder.encode('this is some data');
  * ```
  */
-interface TextEncoder extends Bun.__internal.NodeUtilTextEncoder {
+interface TextEncoder extends Bun.__internal.LibEmptyOrNodeUtilTextEncoder {
   /**
    * UTF-8 encodes the `src` string to the `dest` Uint8Array and returns an object
    * containing the read Unicode code units and written UTF-8 bytes.
@@ -113,53 +124,51 @@ declare var TextEncoder: Bun.__internal.UseLibDomIfAvailable<
  * const decoder = new TextDecoder();
  * const uint8array = decoder.decode('this is some data');
  */
+interface TextDecoder extends Bun.__internal.LibEmptyOrNodeUtilTextDecoder {}
 declare var TextDecoder: Bun.__internal.UseLibDomIfAvailable<
   "TextDecoder",
   {
-    prototype: Bun.__internal.NodeUtilTextDecoder;
-    new (
-      encoding?: Bun.Encoding,
-      options?: { fatal?: boolean; ignoreBOM?: boolean },
-    ): Bun.__internal.NodeUtilTextDecoder;
+    prototype: TextDecoder;
+    new (encoding?: Bun.Encoding, options?: { fatal?: boolean; ignoreBOM?: boolean }): TextDecoder;
   }
 >;
 
-// interface Event {
-//   /** This is not used in Node.js and is provided purely for completeness. */
-//   readonly bubbles: boolean;
-//   /** Alias for event.stopPropagation(). This is not used in Node.js and is provided purely for completeness. */
-//   cancelBubble: () => void;
-//   /** True if the event was created with the cancelable option */
-//   readonly cancelable: boolean;
-//   /** This is not used in Node.js and is provided purely for completeness. */
-//   readonly composed: boolean;
-//   /** Returns an array containing the current EventTarget as the only entry or empty if the event is not being dispatched. This is not used in Node.js and is provided purely for completeness. */
-//   composedPath(): [EventTarget?];
-//   /** Alias for event.target. */
-//   readonly currentTarget: EventTarget | null;
-//   /** Is true if cancelable is true and event.preventDefault() has been called. */
-//   readonly defaultPrevented: boolean;
-//   /** This is not used in Node.js and is provided purely for completeness. */
-//   readonly eventPhase: typeof globalThis extends { Event: infer T extends {eventPhase: number} } ? T['eventPhase'] : 0 | 2;
-//   /** The `AbortSignal` "abort" event is emitted with `isTrusted` set to `true`. The value is `false` in all other cases. */
-//   readonly isTrusted: boolean;
-//   /** Sets the `defaultPrevented` property to `true` if `cancelable` is `true`. */
-//   preventDefault(): void;
-//   /** This is not used in Node.js and is provided purely for completeness. */
-//   returnValue: boolean;
-//   /** Alias for event.target. */
-//   readonly srcElement: EventTarget | null;
-//   /** Stops the invocation of event listeners after the current one completes. */
-//   stopImmediatePropagation(): void;
-//   /** This is not used in Node.js and is provided purely for completeness. */
-//   stopPropagation(): void;
-//   /** The `EventTarget` dispatching the event */
-//   readonly target: EventTarget | null;
-//   /** The millisecond timestamp when the Event object was created. */
-//   readonly timeStamp: number;
-//   /** Returns the type of event, e.g. "click", "hashchange", or "submit". */
-//   readonly type: string;
-// }
+interface Event {
+  /** This is not used in Node.js and is provided purely for completeness. */
+  readonly bubbles: boolean;
+  /** Alias for event.stopPropagation(). This is not used in Node.js and is provided purely for completeness. */
+  cancelBubble: boolean;
+  /** True if the event was created with the cancelable option */
+  readonly cancelable: boolean;
+  /** This is not used in Node.js and is provided purely for completeness. */
+  readonly composed: boolean;
+  /** Returns an array containing the current EventTarget as the only entry or empty if the event is not being dispatched. This is not used in Node.js and is provided purely for completeness. */
+  composedPath(): [EventTarget?];
+  /** Alias for event.target. */
+  readonly currentTarget: EventTarget | null;
+  /** Is true if cancelable is true and event.preventDefault() has been called. */
+  readonly defaultPrevented: boolean;
+  /** This is not used in Node.js and is provided purely for completeness. */
+  readonly eventPhase: number;
+  /** The `AbortSignal` "abort" event is emitted with `isTrusted` set to `true`. The value is `false` in all other cases. */
+  readonly isTrusted: boolean;
+  /** Sets the `defaultPrevented` property to `true` if `cancelable` is `true`. */
+  preventDefault(): void;
+  /** This is not used in Node.js and is provided purely for completeness. */
+  returnValue: boolean;
+  /** Alias for event.target. */
+  readonly srcElement: EventTarget | null;
+  /** Stops the invocation of event listeners after the current one completes. */
+  stopImmediatePropagation(): void;
+  /** This is not used in Node.js and is provided purely for completeness. */
+  stopPropagation(): void;
+  /** The `EventTarget` dispatching the event */
+  readonly target: EventTarget | null;
+  /** The millisecond timestamp when the Event object was created. */
+  readonly timeStamp: number;
+  /** Returns the type of event, e.g. "click", "hashchange", or "submit". */
+  readonly type: string;
+}
 declare var Event: {
   prototype: Event;
   readonly NONE: 0;
@@ -411,7 +420,13 @@ declare var CloseEvent: {
 };
 
 interface MessageEvent<T = any> extends Bun.MessageEvent<T> {}
-declare var MessageEvent: Bun.__internal.UseLibDomIfAvailable<"MessageEvent", MessageEvent>;
+declare var MessageEvent: Bun.__internal.UseLibDomIfAvailable<
+  "MessageEvent",
+  {
+    prototype: MessageEvent;
+    new <T>(type: string, eventInitDict?: Bun.MessageEventInit<T>): MessageEvent<any>;
+  }
+>;
 
 interface CustomEvent<T = any> extends Event {
   /** Returns any custom data event was created with. Typically used for synthetic events. */
@@ -1119,7 +1134,7 @@ interface ImportMeta {
    * import.meta.env === process.env
    * ```
    */
-  readonly env: NodeJS.ProcessEnv;
+  readonly env: Bun.Env;
 
   /**
    * @deprecated Use `require.resolve` or `Bun.resolveSync(moduleId, path.dirname(parent))` instead
@@ -1256,6 +1271,16 @@ interface BlobPropertyBag {
 interface WorkerOptions extends Bun.WorkerOptions {}
 
 interface Blob {
+  /**
+   * The size of this Blob in bytes
+   */
+  readonly size: number;
+
+  /**
+   * The MIME type of this Blob
+   */
+  readonly type: string;
+
   /**
    * Read the data from the blob as a JSON object.
    *
@@ -1384,7 +1409,7 @@ interface Uint8ArrayConstructor {
 interface BroadcastChannel {}
 declare var BroadcastChannel: Bun.__internal.UseLibDomIfAvailable<
   "BroadcastChannel",
-  import("node:worker_threads").BroadcastChannel
+  typeof import("node:worker_threads").BroadcastChannel
 >;
 
 declare var URL: Bun.__internal.UseLibDomIfAvailable<
@@ -1434,6 +1459,24 @@ declare var AbortSignal: Bun.__internal.UseLibDomIfAvailable<
   {
     prototype: AbortSignal;
     new (): AbortSignal;
+    /**
+     * Create an AbortSignal that will be aborted after a timeout
+     * @param ms The timeout in milliseconds
+     * @returns An AbortSignal that will be aborted after the timeout
+     */
+    timeout(ms: number): AbortSignal;
+    /**
+     * Create an immediately-aborted AbortSignal
+     * @param reason The reason for the abort
+     * @returns An AbortSignal that is already aborted
+     */
+    abort(reason?: any): AbortSignal;
+    /**
+     * Create an AbortSignal that will be aborted if any of the signals are aborted
+     * @param signals The signals to combine
+     * @returns An AbortSignal that will be aborted if any of the signals are aborted
+     */
+    any(signals: AbortSignal[]): AbortSignal;
   }
 >;
 
@@ -1443,7 +1486,28 @@ declare var DOMException: Bun.__internal.UseLibDomIfAvailable<
   { prototype: DOMException; new (): DOMException }
 >;
 
-interface FormData {}
+interface FormData {
+  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/append) */
+  append(name: string, value: string | Blob): void;
+  append(name: string, value: string): void;
+  append(name: string, blobValue: Blob, filename?: string): void;
+  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/delete) */
+  delete(name: string): void;
+  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/get) */
+  get(name: string): Bun.FormDataEntryValue | null;
+  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/getAll) */
+  getAll(name: string): Bun.FormDataEntryValue[];
+  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/has) */
+  has(name: string): boolean;
+  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/set) */
+  set(name: string, value: string | Blob): void;
+  set(name: string, value: string): void;
+  set(name: string, blobValue: Blob, filename?: string): void;
+  forEach(callbackfn: (value: Bun.FormDataEntryValue, key: string, parent: FormData) => void, thisArg?: any): void;
+  keys(): IterableIterator<string>;
+  values(): IterableIterator<string>;
+  entries(): IterableIterator<[string, string]>;
+}
 declare var FormData: Bun.__internal.UseLibDomIfAvailable<"FormData", { prototype: FormData; new (): FormData }>;
 
 interface EventSource {}
@@ -1524,16 +1588,39 @@ declare var TextEncoderStream: Bun.__internal.UseLibDomIfAvailable<
 interface URLSearchParams {}
 declare var URLSearchParams: Bun.__internal.UseLibDomIfAvailable<
   "URLSearchParams",
-  { prototype: URLSearchParams; new (): URLSearchParams }
+  {
+    prototype: URLSearchParams;
+    new (
+      init?:
+        | URLSearchParams
+        | string
+        | Record<string, string | readonly string[]>
+        | Iterable<[string, string]>
+        | ReadonlyArray<[string, string]>,
+    ): URLSearchParams;
+  }
 >;
 
-interface MessageChannel {}
+interface MessageChannel {
+  /**
+   * Returns the first MessagePort object.
+   *
+   * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageChannel/port1)
+   */
+  readonly port1: MessagePort;
+  /**
+   * Returns the second MessagePort object.
+   *
+   * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageChannel/port2)
+   */
+  readonly port2: MessagePort;
+}
 declare var MessageChannel: Bun.__internal.UseLibDomIfAvailable<
   "MessageChannel",
   { prototype: MessageChannel; new (): MessageChannel }
 >;
 
-interface MessagePort {}
+interface MessagePort extends Bun.__internal.LibEmptyOrNodeMessagePort {}
 declare var MessagePort: Bun.__internal.UseLibDomIfAvailable<
   "MessagePort",
   {
@@ -1665,26 +1752,6 @@ interface BunFetchRequestInit extends RequestInit {
   s3?: Bun.S3Options;
 }
 
-/**
- * Send a HTTP(s) request
- *
- * @param request Request object
- * @param init A structured value that contains settings for the fetch() request.
- *
- * @returns A promise that resolves to {@link Response} object.
- */
-declare function fetch(request: Request, init?: BunFetchRequestInit): Promise<Response>;
-
-/**
- * Send a HTTP(s) request
- *
- * @param url URL string
- * @param init A structured value that contains settings for the fetch() request.
- *
- * @returns A promise that resolves to {@link Response} object.
- */
-declare function fetch(url: string | URL | Request, init?: BunFetchRequestInit): Promise<Response>;
-
 /**
  * Send a HTTP(s) request
  *

package/html-rewriter.d.ts

@@ -147,6 +147,8 @@ declare namespace HTMLRewriterTypes {
  * });
  * rewriter.transform(await fetch("https://remix.run"));
  * ```
+ *
+ * @category HTML Manipulation
  */
 declare class HTMLRewriter {
   constructor();

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.2.8-canary.20250327T140605",
+  "version": "1.2.8-canary.20250329T140548",
   "name": "bun-types",
   "license": "MIT",
   "types": "./index.d.ts",

package/s3.d.ts

@@ -340,6 +340,8 @@ declare module "bun" {
   /**
    * Represents a file in an S3-compatible storage service.
    * Extends the Blob interface for compatibility with web APIs.
+   *
+   * @category Cloud Storage
    */
   interface S3File extends Blob {
     /**
@@ -635,6 +637,8 @@ declare module "bun" {
    *     await bucket.write("data.json", JSON.stringify({hello: "world"}));
    *     const url = bucket.presign("file.pdf");
    *     await bucket.unlink("old.txt");
+   *
+   * @category Cloud Storage
    */
   class S3Client {
     prototype: S3Client;
@@ -820,6 +824,8 @@ declare module "bun" {
    * A default instance of S3Client
    *
    * Pulls credentials from environment variables. Use `new Bun.S3Client()` if you need to explicitly set credentials.
+   *
+   * @category Cloud Storage
    */
   var s3: S3Client;
 }