bun-types 1.2.6-canary.20250319T140718 → 1.2.6-canary.20250321T140602

package/bun.d.ts

@@ -3901,6 +3901,7 @@ declare module "bun" {
 
 	interface BunRequest<T extends string = string> extends Request {
 		params: RouterTypes.ExtractRouteParams<T>;
+		readonly cookies: CookieMap;
 	}
 
 	interface GenericServeOptions {
@@ -7854,4 +7855,89 @@ declare module "bun" {
 		| [pkg: string, info: BunLockFilePackageInfo, bunTag: string]
 		/** root */
 		| [pkg: string, info: Pick<BunLockFileBasePackageInfo, "bin" | "binDir">];
+
+	interface CookieInit {
+		name?: string;
+		value?: string;
+		domain?: string;
+		path?: string;
+		expires?: number | Date;
+		secure?: boolean;
+		sameSite?: CookieSameSite;
+		httpOnly?: boolean;
+		partitioned?: boolean;
+		maxAge?: number;
+	}
+
+	interface CookieStoreDeleteOptions {
+		name: string;
+		domain?: string | null;
+		path?: string;
+	}
+
+	interface CookieStoreGetOptions {
+		name?: string;
+		url?: string;
+	}
+
+	type CookieSameSite = "strict" | "lax" | "none";
+
+	class Cookie {
+		constructor(name: string, value: string, options?: CookieInit);
+		constructor(cookieString: string);
+		constructor(cookieObject?: CookieInit);
+
+		name: string;
+		value: string;
+		domain?: string;
+		path: string;
+		expires?: number;
+		secure: boolean;
+		sameSite: CookieSameSite;
+		partitioned: boolean;
+		maxAge?: number;
+		httpOnly: boolean;
+
+		isExpired(): boolean;
+
+		toString(): string;
+		toJSON(): CookieInit;
+
+		static parse(cookieString: string): Cookie;
+		static from(name: string, value: string, options?: CookieInit): Cookie;
+		static serialize(...cookies: Cookie[]): string;
+	}
+
+	class CookieMap implements Iterable<[string, Cookie]> {
+		constructor(init?: string[][] | Record<string, string> | string);
+
+		get(name: string): Cookie | null;
+		get(options?: CookieStoreGetOptions): Cookie | null;
+
+		getAll(name: string): Cookie[];
+		getAll(options?: CookieStoreGetOptions): Cookie[];
+
+		has(name: string, value?: string): boolean;
+
+		set(name: string, value: string): void;
+		set(options: CookieInit): void;
+
+		delete(name: string): void;
+		delete(options: CookieStoreDeleteOptions): void;
+
+		toString(): string;
+
+		toJSON(): Record<string, ReturnType<Cookie["toJSON"]>>;
+		readonly size: number;
+
+		entries(): IterableIterator<[string, Cookie]>;
+		keys(): IterableIterator<string>;
+		values(): IterableIterator<Cookie>;
+		forEach(
+			callback: (value: Cookie, key: string, map: CookieMap) => void,
+			thisArg?: any,
+		): void;
+
+		[Symbol.iterator](): IterableIterator<[string, Cookie]>;
+	}
 }

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.6-canary.20250319T140718
+[fetch] > User-Agent: Bun/1.2.6-canary.20250321T140602
 [fetch] > Accept: */*
 [fetch] > Host: example.com
 [fetch] > Accept-Encoding: gzip, deflate, br

package/docs/api/s3.md

@@ -715,7 +715,7 @@ await S3Client.delete("my-file.txt", credentials);
 await S3Client.unlink("my-file.txt", credentials);
 ```
 
-## s3:// protocol
+## `s3://` protocol
 
 To make it easier to use the same code for local files and S3 files, the `s3://` protocol is supported in `fetch` and `Bun.file()`.
 

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.6-canary.20250319T140718"
+console.log(text); // => "1.2.6-canary.20250321T140602"
 ```
 
 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.6-canary.20250319T140718 (ca7428e9)
+bun publish v1.2.6-canary.20250321T140602 (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.6-canary.20250319T140718 (16b4bf34)
+bun install v1.2.6-canary.20250321T140602 (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.6-canary.20250319T140718"
++   "@types/bun": "^1.2.6-canary.20250321T140602"
   }
 }
 ```
@@ -28,7 +28,7 @@ Running `bun install` will install peer dependencies by default, unless marked o
 ```json-diff
 {
   "peerDependencies": {
-    "@types/bun": "^1.2.6-canary.20250319T140718"
+    "@types/bun": "^1.2.6-canary.20250321T140602"
   },
   "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.6-canary.20250319T140718
+$ bun update @types/bun@1.2.6-canary.20250321T140602
 
 # 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.6-canary.20250319T140718 (9c68abdb)
+bun test v1.2.6-canary.20250321T140602 (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.6-canary.20250319T140718 (9c68abdb)
+bun test v1.2.6-canary.20250321T140602 (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.6-canary.20250319T140718 (9c68abdb)
+bun test v1.2.6-canary.20250321T140602 (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.6-canary.20250319T140718 (9c68abdb)
+bun test v1.2.6-canary.20250321T140602 (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.6-canary.20250319T140718 (9c68abdb)
+bun test v1.2.6-canary.20250321T140602 (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.6-canary.20250319T140718 (9c68abdb)
+bun test v1.2.6-canary.20250321T140602 (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.6-canary.20250319T140718 (9c68abdb)
+bun test v1.2.6-canary.20250321T140602 (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.6-canary.20250319T140718"
+Bun.version; // => "1.2.6-canary.20250321T140602"
 ```
 
 ---

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.6-canary.20250319T140718"
+$ curl -fsSL https://bun.sh/install | bash -s "bun-v1.2.6-canary.20250321T140602"
 ```
 
 ```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.6-canary.20250319T140718`.
+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.6-canary.20250321T140602`.
 
 ```sh
-$ curl -fsSL https://bun.sh/install | bash -s "bun-v1.2.6-canary.20250319T140718"
+$ curl -fsSL https://bun.sh/install | bash -s "bun-v1.2.6-canary.20250321T140602"
 ```
 
 ### 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.6-canary.20250319T140718"
+$ iex "& {$(irm https://bun.sh/install.ps1)} -Version 1.2.6-canary.20250321T140602"
 ```
 
 ## Downloading Bun binaries directly

package/docs/project/building-windows.md

@@ -60,7 +60,7 @@ Visual Studio can be installed graphically using the wizard or through WinGet:
 
 After Visual Studio, you need the following:
 
-- LLVM 18.1.8
+- LLVM 19.1.7
 - Go
 - Rust
 - NASM
@@ -81,7 +81,7 @@ After Visual Studio, you need the following:
 > irm https://get.scoop.sh | iex
 > scoop install nodejs-lts go rust nasm ruby perl ccache
 # scoop seems to be buggy if you install llvm and the rest at the same time
-> scoop install llvm@18.1.8
+> scoop install llvm@19.1.7
 ```
 
 {% /codetabs %}

package/docs/project/contributing.md

@@ -80,7 +80,7 @@ $ sudo zypper install clang18 lld18 llvm18
 
 {% /codetabs %}
 
-If none of the above solutions apply, you will have to install it [manually](https://github.com/llvm/llvm-project/releases/tag/llvmorg-18.1.8).
+If none of the above solutions apply, you will have to install it [manually](https://github.com/llvm/llvm-project/releases/tag/llvmorg-19.1.7).
 
 Make sure Clang/LLVM 18 is in your path:
 

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.6-canary.20250319T140718" -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.6-canary.20250321T140602" -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.6-canary.20250319T140718
+[fetch] > User-Agent: Bun/1.2.6-canary.20250321T140602
 [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.6-canary.20250319T140718
+[fetch] > User-Agent: Bun/1.2.6-canary.20250321T140602
 [fetch] > Accept: */*
 [fetch] > Host: example.com
 [fetch] > Accept-Encoding: gzip, deflate, br

package/docs/runtime/nodejs-apis.md

@@ -174,7 +174,7 @@ Some methods are not optimized yet.
 
 ### [`node:test`](https://nodejs.org/api/test.html)
 
-🔴 Not implemented. Use [`bun:test`](https://bun.sh/docs/cli/test) instead.
+🟡 Partly implemented. Missing mocks, snapshots, timers. Use [`bun:test`](https://bun.sh/docs/cli/test) instead.
 
 ### [`node:trace_events`](https://nodejs.org/api/tracing.html)
 

package/docs/test/dom.md

@@ -55,7 +55,7 @@ Let's run this test with `bun test`:
 
 ```bash
 $ bun test
-bun test v1.2.6-canary.20250319T140718
+bun test v1.2.6-canary.20250321T140602
 
 dom.test.ts:
 ✓ dom test [0.82ms]

package/globals.d.ts

@@ -76,6 +76,17 @@ declare global {
 			revision: string;
 			reallyExit(code?: number): never;
 			dlopen(module: { exports: any }, filename: string, flags?: number): void;
+			_exiting: boolean;
+			noDeprecation: boolean;
+
+			binding(m: string): object;
+			binding(m: "constants"): {
+				os: typeof import("node:os").constants;
+				fs: typeof import("node:fs").constants;
+				crypto: typeof import("node:crypto").constants;
+				zlib: typeof import("node:zlib").constants;
+				trace: typeof import("node:trace").constants;
+			};
 		}
 	}
 
@@ -1887,7 +1898,43 @@ declare global {
 		 * @param base64 The base64 encoded string to decode into the array
 		 * @param offset Optional starting index to begin setting the decoded bytes (default: 0)
 		 */
-		setFromBase64(base64: string, offset?: number): void;
+		setFromBase64(
+			base64: string,
+			offset?: number,
+		): {
+			/**
+			 * The number of bytes read from the base64 string
+			 */
+			read: number;
+			/**
+			 * The number of bytes written to the Uint8Array
+			 * Will never be greater than the `.byteLength` of this Uint8Array
+			 */
+			written: number;
+		};
+
+		/**
+		 * Convert the Uint8Array to a hex encoded string
+		 * @returns The hex encoded string representation of the Uint8Array
+		 */
+		toHex(): string;
+
+		/**
+		 * Set the contents of the Uint8Array from a hex encoded string
+		 * @param hex The hex encoded string to decode into the array. The string must have
+		 * an even number of characters, be valid hexadecimal characters and contain no whitespace.
+		 */
+		setFromHex(hex: string): {
+			/**
+			 * The number of bytes read from the hex string
+			 */
+			read: number;
+			/**
+			 * The number of bytes written to the Uint8Array
+			 * Will never be greater than the `.byteLength` of this Uint8Array
+			 */
+			written: number;
+		};
 	}
 
 	interface Uint8ArrayConstructor {

package/package.json

@@ -1,5 +1,5 @@
 {
-	"version": "1.2.6-canary.20250319T140718",
+	"version": "1.2.6-canary.20250321T140602",
 	"name": "bun-types",
 	"license": "MIT",
 	"types": "./index.d.ts",