bun-types 1.2.19-canary.20250710T140803 → 1.2.19-canary.20250712T140547

package/bun.d.ts

@@ -3510,7 +3510,13 @@ declare module "bun" {
       [K in HTTPMethod]?: RouteHandlerWithWebSocketUpgrade<T>;
     };
 
-    type RouteValue<T extends string> = Response | false | RouteHandler<T> | RouteHandlerObject<T> | HTMLBundle;
+    type RouteValue<T extends string> =
+      | Response
+      | false
+      | RouteHandler<T>
+      | RouteHandlerObject<T>
+      | HTMLBundle
+      | BunFile;
     type RouteValueWithWebSocketUpgrade<T extends string> =
       | RouteValue<T>
       | RouteHandlerWithWebSocketUpgrade<T>

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.19-canary.20250710T140803
+[fetch] > User-Agent: Bun/1.2.19-canary.20250712T140547
 [fetch] > Accept: */*
 [fetch] > Host: example.com
 [fetch] > Accept-Encoding: gzip, deflate, br

package/docs/api/spawn.md

@@ -140,7 +140,7 @@ You can read results from the subprocess via the `stdout` and `stderr` propertie
 ```ts
 const proc = Bun.spawn(["bun", "--version"]);
 const text = await proc.stdout.text();
-console.log(text); // => "1.2.19-canary.20250710T140803\n"
+console.log(text); // => "1.2.19-canary.20250712T140547\n"
 ```
 
 Configure the output stream by passing one of the following values to `stdout/stderr`:

package/docs/bundler/executables.md

@@ -126,6 +126,42 @@ The `--sourcemap` argument embeds a sourcemap compressed with zstd, so that erro
 
 The `--bytecode` argument enables bytecode compilation. Every time you run JavaScript code in Bun, JavaScriptCore (the engine) will compile your source code into bytecode. We can move this parsing work from runtime to bundle time, saving you startup time.
 
+## Act as the Bun CLI
+
+{% note %}
+
+New in Bun v1.2.16
+
+{% /note %}
+
+You can run a standalone executable as if it were the `bun` CLI itself by setting the `BUN_BE_BUN=1` environment variable. When this variable is set, the executable will ignore its bundled entrypoint and instead expose all the features of Bun's CLI.
+
+For example, consider an executable compiled from a simple script:
+
+```sh
+$ cat such-bun.js
+console.log("you shouldn't see this");
+
+$ bun build --compile ./such-bun.js
+ [3ms] bundle 1 modules
+[89ms] compile such-bun
+```
+
+Normally, running `./such-bun` with arguments would execute the script. However, with the `BUN_BE_BUN=1` environment variable, it acts just like the `bun` binary:
+
+```sh
+# Executable runs its own entrypoint by default
+$ ./such-bun install
+you shouldn't see this
+
+# With the env var, the executable acts like the `bun` CLI
+$ BUN_BE_BUN=1 ./such-bun install
+bun install v1.2.16-canary.1 (1d1db811)
+Checked 63 installs across 64 packages (no changes) [5.00ms]
+```
+
+This is useful for building CLI tools on top of Bun that may need to install packages, bundle dependencies, run different or local files and more without needing to download a separate binary or install bun.
+
 ## Full-stack executables
 
 {% note %}

package/docs/cli/pm.md

@@ -158,7 +158,7 @@ To display current package version and help:
 
 ```bash
 $ bun pm version
-bun pm version v1.2.19-canary.20250710T140803 (ca7428e9)
+bun pm version v1.2.19-canary.20250712T140547 (ca7428e9)
 Current package version: v1.0.0
 
 Increment:

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.19-canary.20250710T140803 (ca7428e9)
+bun publish v1.2.19-canary.20250712T140547 (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.19-canary.20250710T140803 (16b4bf34)
+bun install v1.2.19-canary.20250712T140547 (16b4bf34)
  + @nuxt/devtools@0.8.2
  + nuxt@3.7.0
  785 packages installed [2.67s]

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

@@ -15,7 +15,7 @@ This will add the package to `peerDependencies` in `package.json`.
 ```json-diff
 {
   "peerDependencies": {
-+   "@types/bun": "^1.2.19-canary.20250710T140803"
++   "@types/bun": "^1.2.19-canary.20250712T140547"
   }
 }
 ```
@@ -27,7 +27,7 @@ Running `bun install` will install peer dependencies by default, unless marked o
 ```json-diff
 {
   "peerDependencies": {
-    "@types/bun": "^1.2.19-canary.20250710T140803"
+    "@types/bun": "^1.2.19-canary.20250712T140547"
   },
   "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.19-canary.20250710T140803
+$ bun update @types/bun@1.2.19-canary.20250712T140547
 
 # Update all dependencies to the latest versions
 $ bun update --latest

package/docs/guides/test/migrate-from-jest.md

@@ -26,6 +26,40 @@ But if you'd rather switch to the `bun:test` imports, you can do that too.
 
 ---
 
+Since Bun v1.2.19, you can enable **TypeScript support** for global test functions with a single triple-slash directive. This makes migrating from Jest even easier since you only need to add the directive once in your entire project:
+
+Add this directive to _just one file_ in your project, such as:
+
+- A `global.d.ts` file in your project root
+- Your test `preload.ts` setup file (if using `preload` in bunfig.toml)
+- Any single `.ts` file that TypeScript includes in your compilation
+
+```ts
+/// <reference types="bun/test-globals" />
+```
+
+---
+
+Once added, all test files in your project automatically get TypeScript support for Jest globals:
+
+```ts#math.test.ts
+describe("my test suite", () => {
+  test("should work", () => {
+    expect(1 + 1).toBe(2);
+  });
+
+  beforeAll(() => {
+    // setup code
+  });
+
+  afterEach(() => {
+    // cleanup code
+  });
+});
+```
+
+---
+
 Bun implements the vast majority of Jest's matchers, but compatibility isn't 100% yet. Refer to the full compatibility table at [Docs > Test runner > Writing tests](https://bun.sh/docs/test/writing#matchers).
 
 Some notable missing features:

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.19-canary.20250710T140803 (9c68abdb)
+bun test v1.2.19-canary.20250712T140547 (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.19-canary.20250710T140803 (9c68abdb)
+bun test v1.2.19-canary.20250712T140547 (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.19-canary.20250710T140803 (9c68abdb)
+bun test v1.2.19-canary.20250712T140547 (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.19-canary.20250710T140803 (9c68abdb)
+bun test v1.2.19-canary.20250712T140547 (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.19-canary.20250710T140803 (9c68abdb)
+bun test v1.2.19-canary.20250712T140547 (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.19-canary.20250710T140803 (9c68abdb)
+bun test v1.2.19-canary.20250712T140547 (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.19-canary.20250710T140803 (9c68abdb)
+bun test v1.2.19-canary.20250712T140547 (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.19-canary.20250710T140803"
+Bun.version; // => "1.2.19-canary.20250712T140547"
 ```
 
 ---

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.com/install | bash # for macOS, Linux, and WSL
 # to install a specific version
-$ curl -fsSL https://bun.com/install | bash -s "bun-v1.2.19-canary.20250710T140803"
+$ curl -fsSL https://bun.com/install | bash -s "bun-v1.2.19-canary.20250712T140547"
 ```
 
 ```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.19-canary.20250710T140803`.
+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.19-canary.20250712T140547`.
 
 ```sh
-$ curl -fsSL https://bun.com/install | bash -s "bun-v1.2.19-canary.20250710T140803"
+$ curl -fsSL https://bun.com/install | bash -s "bun-v1.2.19-canary.20250712T140547"
 ```
 
 ### 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.com/install.ps1)} -Version 1.2.19-canary.20250710T140803"
+$ iex "& {$(irm https://bun.com/install.ps1)} -Version 1.2.19-canary.20250712T140547"
 ```
 
 ## 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.19-canary.20250710T140803" -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.19-canary.20250712T140547" -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.19-canary.20250710T140803
+[fetch] > User-Agent: Bun/1.2.19-canary.20250712T140547
 [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.19-canary.20250710T140803
+[fetch] > User-Agent: Bun/1.2.19-canary.20250712T140547
 [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.19-canary.20250710T140803
+bun test v1.2.19-canary.20250712T140547
 
 dom.test.ts:
 ✓ dom test [0.82ms]

package/globals.d.ts

@@ -1,22 +1,35 @@
 declare module "bun" {
   namespace __internal {
-    type NodeWorkerThreadsWorker = import("node:worker_threads").Worker;
-    type LibWorkerOrBunWorker = Bun.__internal.UseLibDomIfAvailable<"Worker", Bun.Worker>;
-
-    type LibPerformanceOrNodePerfHooksPerformance = Bun.__internal.UseLibDomIfAvailable<
-      "Performance",
-      import("perf_hooks").Performance
-    >;
-
     type NodeCryptoWebcryptoSubtleCrypto = import("crypto").webcrypto.SubtleCrypto;
     type NodeCryptoWebcryptoCryptoKey = import("crypto").webcrypto.CryptoKey;
     type NodeCryptoWebcryptoCryptoKeyPair = import("crypto").webcrypto.CryptoKeyPair;
 
+    type LibWorkerOrBunWorker = LibDomIsLoaded extends true ? {} : Bun.Worker;
     type LibEmptyOrBunWebSocket = LibDomIsLoaded extends true ? {} : Bun.WebSocket;
 
+    type LibPerformanceOrNodePerfHooksPerformance = LibDomIsLoaded extends true ? {} : import("perf_hooks").Performance;
+    type LibEmptyOrPerformanceEntry = LibDomIsLoaded extends true ? {} : import("node:perf_hooks").PerformanceEntry;
+    type LibEmptyOrPerformanceMark = LibDomIsLoaded extends true ? {} : import("node:perf_hooks").PerformanceMark;
+    type LibEmptyOrPerformanceMeasure = LibDomIsLoaded extends true ? {} : import("node:perf_hooks").PerformanceMeasure;
+    type LibEmptyOrPerformanceObserver = LibDomIsLoaded extends true
+      ? {}
+      : import("node:perf_hooks").PerformanceObserver;
+    type LibEmptyOrPerformanceObserverEntryList = LibDomIsLoaded extends true
+      ? {}
+      : import("node:perf_hooks").PerformanceObserverEntryList;
+    type LibEmptyOrPerformanceResourceTiming = LibDomIsLoaded extends true
+      ? {}
+      : import("node:perf_hooks").PerformanceResourceTiming;
+
     type LibEmptyOrNodeUtilTextEncoder = LibDomIsLoaded extends true ? {} : import("node:util").TextEncoder;
+    type LibEmptyOrNodeStreamWebTextEncoderStream = LibDomIsLoaded extends true
+      ? {}
+      : import("node:stream/web").TextEncoderStream;
 
     type LibEmptyOrNodeUtilTextDecoder = LibDomIsLoaded extends true ? {} : import("node:util").TextDecoder;
+    type LibEmptyOrNodeStreamWebTextDecoderStream = LibDomIsLoaded extends true
+      ? {}
+      : import("node:stream/web").TextDecoderStream;
 
     type LibEmptyOrNodeReadableStream<T> = LibDomIsLoaded extends true
       ? {}
@@ -27,6 +40,20 @@ declare module "bun" {
       : import("node:stream/web").WritableStream<T>;
 
     type LibEmptyOrNodeMessagePort = LibDomIsLoaded extends true ? {} : import("node:worker_threads").MessagePort;
+    type LibEmptyOrBroadcastChannel = LibDomIsLoaded extends true ? {} : import("node:worker_threads").BroadcastChannel;
+    type LibEmptyOrEventSource = LibDomIsLoaded extends true ? {} : import("undici-types").EventSource;
+
+    type LibEmptyOrReadableByteStreamController = LibDomIsLoaded extends true
+      ? {}
+      : import("node:stream/web").ReadableByteStreamController;
+
+    type LibEmptyOrReadableStreamBYOBReader = LibDomIsLoaded extends true
+      ? {}
+      : import("node:stream/web").ReadableStreamBYOBReader;
+
+    type LibEmptyOrReadableStreamBYOBRequest = LibDomIsLoaded extends true
+      ? {}
+      : import("node:stream/web").ReadableStreamBYOBRequest;
   }
 }
 
@@ -1489,7 +1516,7 @@ interface Uint8ArrayConstructor {
   fromHex(hex: string): Uint8Array;
 }
 
-interface BroadcastChannel {}
+interface BroadcastChannel extends Bun.__internal.LibEmptyOrBroadcastChannel {}
 declare var BroadcastChannel: Bun.__internal.UseLibDomIfAvailable<
   "BroadcastChannel",
   typeof import("node:worker_threads").BroadcastChannel
@@ -1593,7 +1620,7 @@ interface FormData {
 }
 declare var FormData: Bun.__internal.UseLibDomIfAvailable<"FormData", { prototype: FormData; new (): FormData }>;
 
-interface EventSource {}
+interface EventSource extends Bun.__internal.LibEmptyOrEventSource {}
 declare var EventSource: Bun.__internal.UseLibDomIfAvailable<
   "EventSource",
   { prototype: EventSource; new (): EventSource }
@@ -1602,67 +1629,67 @@ declare var EventSource: Bun.__internal.UseLibDomIfAvailable<
 interface Performance extends Bun.__internal.LibPerformanceOrNodePerfHooksPerformance {}
 declare var performance: Bun.__internal.UseLibDomIfAvailable<"performance", Performance>;
 
-interface PerformanceEntry {}
+interface PerformanceEntry extends Bun.__internal.LibEmptyOrPerformanceEntry {}
 declare var PerformanceEntry: Bun.__internal.UseLibDomIfAvailable<
   "PerformanceEntry",
   { prototype: PerformanceEntry; new (): PerformanceEntry }
 >;
 
-interface PerformanceMark {}
+interface PerformanceMark extends Bun.__internal.LibEmptyOrPerformanceMark {}
 declare var PerformanceMark: Bun.__internal.UseLibDomIfAvailable<
   "PerformanceMark",
   { prototype: PerformanceMark; new (): PerformanceMark }
 >;
 
-interface PerformanceMeasure {}
+interface PerformanceMeasure extends Bun.__internal.LibEmptyOrPerformanceMeasure {}
 declare var PerformanceMeasure: Bun.__internal.UseLibDomIfAvailable<
   "PerformanceMeasure",
   { prototype: PerformanceMeasure; new (): PerformanceMeasure }
 >;
 
-interface PerformanceObserver {}
+interface PerformanceObserver extends Bun.__internal.LibEmptyOrPerformanceObserver {}
 declare var PerformanceObserver: Bun.__internal.UseLibDomIfAvailable<
   "PerformanceObserver",
   { prototype: PerformanceObserver; new (): PerformanceObserver }
 >;
 
-interface PerformanceObserverEntryList {}
+interface PerformanceObserverEntryList extends Bun.__internal.LibEmptyOrPerformanceObserverEntryList {}
 declare var PerformanceObserverEntryList: Bun.__internal.UseLibDomIfAvailable<
   "PerformanceObserverEntryList",
   { prototype: PerformanceObserverEntryList; new (): PerformanceObserverEntryList }
 >;
 
-interface PerformanceResourceTiming {}
+interface PerformanceResourceTiming extends Bun.__internal.LibEmptyOrPerformanceResourceTiming {}
 declare var PerformanceResourceTiming: Bun.__internal.UseLibDomIfAvailable<
   "PerformanceResourceTiming",
   { prototype: PerformanceResourceTiming; new (): PerformanceResourceTiming }
 >;
 
-interface ReadableByteStreamController {}
+interface ReadableByteStreamController extends Bun.__internal.LibEmptyOrReadableByteStreamController {}
 declare var ReadableByteStreamController: Bun.__internal.UseLibDomIfAvailable<
   "ReadableByteStreamController",
   { prototype: ReadableByteStreamController; new (): ReadableByteStreamController }
 >;
 
-interface ReadableStreamBYOBReader {}
+interface ReadableStreamBYOBReader extends Bun.__internal.LibEmptyOrReadableStreamBYOBReader {}
 declare var ReadableStreamBYOBReader: Bun.__internal.UseLibDomIfAvailable<
   "ReadableStreamBYOBReader",
   { prototype: ReadableStreamBYOBReader; new (): ReadableStreamBYOBReader }
 >;
 
-interface ReadableStreamBYOBRequest {}
+interface ReadableStreamBYOBRequest extends Bun.__internal.LibEmptyOrReadableStreamBYOBRequest {}
 declare var ReadableStreamBYOBRequest: Bun.__internal.UseLibDomIfAvailable<
   "ReadableStreamBYOBRequest",
   { prototype: ReadableStreamBYOBRequest; new (): ReadableStreamBYOBRequest }
 >;
 
-interface TextDecoderStream {}
+interface TextDecoderStream extends Bun.__internal.LibEmptyOrNodeStreamWebTextDecoderStream {}
 declare var TextDecoderStream: Bun.__internal.UseLibDomIfAvailable<
   "TextDecoderStream",
   { prototype: TextDecoderStream; new (): TextDecoderStream }
 >;
 
-interface TextEncoderStream {}
+interface TextEncoderStream extends Bun.__internal.LibEmptyOrNodeStreamWebTextEncoderStream {}
 declare var TextEncoderStream: Bun.__internal.UseLibDomIfAvailable<
   "TextEncoderStream",
   { prototype: TextEncoderStream; new (): TextEncoderStream }

package/overrides.d.ts

@@ -23,7 +23,7 @@ declare module "stream/web" {
 
 declare global {
   namespace NodeJS {
-    interface ProcessEnv extends Bun.Env, ImportMetaEnv {}
+    interface ProcessEnv extends Bun.Env {}
 
     interface Process {
       readonly version: string;

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.2.19-canary.20250710T140803",
+  "version": "1.2.19-canary.20250712T140547",
   "name": "bun-types",
   "license": "MIT",
   "types": "./index.d.ts",

package/test-globals.d.ts

@@ -0,0 +1,20 @@
+// Do not include this file in ./index.d.ts
+//
+// This file gets loaded by developers including the following triple slash directive:
+//
+// ```ts
+// /// <reference types="bun/test-globals" />
+// ```
+
+declare var test: typeof import("bun:test").test;
+declare var it: typeof import("bun:test").it;
+declare var describe: typeof import("bun:test").describe;
+declare var expect: typeof import("bun:test").expect;
+declare var beforeAll: typeof import("bun:test").beforeAll;
+declare var beforeEach: typeof import("bun:test").beforeEach;
+declare var afterEach: typeof import("bun:test").afterEach;
+declare var afterAll: typeof import("bun:test").afterAll;
+declare var setDefaultTimeout: typeof import("bun:test").setDefaultTimeout;
+declare var mock: typeof import("bun:test").mock;
+declare var spyOn: typeof import("bun:test").spyOn;
+declare var jest: typeof import("bun:test").jest;