Bun v1.0.3

Bun v1.0.3 fixes numerous bugs, adds support for metadata reflection via TypeScript's emitDecoratorMetadata, improves fetch compatibility, unblocks private registries like Azure Artifacts and Artifactory, bunx bugfix, console.log() depth 8 -> 2, Node.js compatibility improvements, and more.

Thank you for reporting issues. We are working hard to fix them as quickly as possible.

Bun is an incredibly fast JavaScript runtime, bundler, transpiler, and package manager — all in one. We've been releasing a lot of changes to Bun recently. Here's a recap of the last few releases. In case you missed it:

• v1.0.0 - Bun's first stable release!
• v1.0.1 - Named imports for .json & .toml files, bugfixes to bun install, node:path, Buffer
• v1.0.2 - Make --watch faster, plus bug fixes

To install Bun:

curl -fsSL https://bun.sh/install | bash

npm install -g bun

brew tap oven-sh/bun

brew install bun

docker pull oven/bun

docker run --rm --init --ulimit memlock=-1:-1 oven/bun

To upgrade Bun:

bun upgrade

emitDecoratorMetadata (used by Nest.js, TypeORM, and more)

Bun now supports metadata reflection via TypeScript's emitDecoratorMetadata. This means that you can use Nest.js with Bun, and it will work out of the box.

{
  "compilerOptions": {
    "emitDecoratorMetadata": true,
    "experimentalDecorators": true
  }
}

The emitDecoratorMetadata is a TypeScript compiler option that enables the generation of metadata for decorators via reflect-metadata.

Improved Nest.js support

The addition of emitDecoratorMetadata dramatically improves Nest.js support, as it relies on custom "Reflectors" to attach metadata and middleware to route handlers.

@Post()
@Roles(['admin']) // custom authentication decorator
async create(@Body() createCatDto: CreateCatDto) {
  this.catsService.create(createCatDto);
}

module.parent support

In Node, the CommonJS module.parent getter is a reference to the parent module that required the current module. This is useful for determining whether a module was run directly or required by another module.

if (module.parent) {
  // this module was required by another module
} else {
  // this module was run directly
}

Bun now supports module.parent in the same way that Node does.

For ES modules, you can use import.meta.main to find out if the current module started the Bun process.

Bugfixes for private npm registries

Improvements to fetch unblock the usage of bun install with popular private package registries like Azure Artifacts and JFrog Artifactory.

You can configure a private registry using bunfig.toml instead of .npmrc. Provide values for url, username, and password under the [install.registry] section of your bunfig.toml file.

[install.registry]
url = "https://pkgs.dev.azure.com/my-azure-artifacts-user/_packaging/my-azure-artifacts-user/npm/registry"
username = "my-azure-artifacts-user"
# Bun v1.0.3+ supports using an environment variable here
password = "$NPM_PASSWORD"

Alternatively, specify a token instead of a username and password. This is useful for Artifactory.

[install.registry]
url = "https://my-artifactory-server.com/artifactory/api/npm/npm-virtual"
token = "$NPM_TOKEN"

For more complete information, refer to our new guides:

• Using bun install with Artifactory
• Using bun install with Azure Artifacts

[0.5ms] env message is now silent by default

Many people asked for this, so @colinhacks made it happen. The [0.5ms] env loaded message is now silent by default. You can still see it by setting logLevel to "debug" in bunfig.toml

Node.js compatiblity improvements

The work on Node.js compatibility continues. Here are some of the improvements in this release:

Implement console.Console constructor

The Node.js console.Console constructor has been implemented.

import { Console } from "console";
import { createWriteStream } from "fs";

const writer = new Console({ stdout: createWriteStream("log.txt") });

writer.log("hello");
writer.log("world", { x: 2 });

This fixes vitest and webpack's ts-loader when executed with the Bun runtime—though consider using bun test and bun build instead! Of course, there are a lot of tools and codebases that rely on these technologies which will now work with Bun.

Empty environment variables now appear as an empty string ("")

In process.env and Bun.env, empty environment variables appeared as undefined instead of an empty string. This is fixed, thanks to @liz3.

dns.lookupService is now implemented

The node:dns function dns.lookupService is now implemented. Thanks to @Hanaasagi.

console.log() depth is now 2 instead of 8

8 was nice, but caused issues with large objects filling up your terminal screen. Thanks to @JibranKalia. This aligns the behavior with Node.js.

node_api_create_external_string_latin1 and node_api_create_external_string_utf16

The node_api functions node_api_create_external_string_latin1 and node_api_create_external_string_utf16 are now implemented

listen() in node:http callback bugfix

The error event was not emitting to the event listener correctly. Thanks to @SuperAuguste for fixing this.

Bugfixes

Crash in request.json() fixed

A crash that could occur when calling request.json() was fixed. It was caused by incorrect exception handling in native code.

bun pm rm cache now works

The bun pm rm cache command now deletes the cache directory. Thanks to @WingLim.

Max redirect URL length is now 8192 instead of 4096

This fixes an issue with certain private npm registries.

bunx choosing version from $PATH instead of @version tag bugfix

A bug causing bunx to choose the version of the executable from $PATH instead of the @version tag was fixed

Full changelog

New contributors

Thanks to Bun's newest contributors!

• @52 made their first contribution in https://github.com/oven-sh/bun/pull/5579
• @a4addel made their first contribution in https://github.com/oven-sh/bun/pull/5447
• @AaronDewes made their first contribution in https://github.com/oven-sh/bun/pull/4779
• @bdenham made their first contribution in https://github.com/oven-sh/bun/pull/5555
• @brookslybrand made their first contribution in https://github.com/oven-sh/bun/pull/5702
• @Brooooooklyn made their first contribution in https://github.com/oven-sh/bun/pull/5788
• @Cilooth made their first contribution in https://github.com/oven-sh/bun/pull/5628
• @coratgerl made their first contribution in https://github.com/oven-sh/bun/pull/4693
• @ggobbe made their first contribution in https://github.com/oven-sh/bun/pull/5786
• @h2210316651 made their first contribution in https://github.com/oven-sh/bun/pull/5456
• @Hamcker made their first contribution in https://github.com/oven-sh/bun/pull/5594
• @igorshapiro made their first contribution in https://github.com/oven-sh/bun/pull/5873
• @ImBIOS made their first contribution in https://github.com/oven-sh/bun/pull/5885
• @JeremyFunk made their first contribution in https://github.com/oven-sh/bun/pull/4652
• @JibranKalia made their first contribution in https://github.com/oven-sh/bun/pull/5595
• @jonahsnider made their first contribution in https://github.com/oven-sh/bun/pull/5104
• @jt3k made their first contribution in https://github.com/oven-sh/bun/pull/5620
• @jumoog made their first contribution in https://github.com/oven-sh/bun/pull/5638
• @liz3 made their first contribution in https://github.com/oven-sh/bun/pull/5684
• @nithinkjoy-tech made their first contribution in https://github.com/oven-sh/bun/pull/5696
• @pan93412 made their first contribution in https://github.com/oven-sh/bun/pull/5610
• @rauny-brandao made their first contribution in https://github.com/oven-sh/bun/pull/5685
• @ruihe774 made their first contribution in https://github.com/oven-sh/bun/pull/5444
• @sanyamkamat made their first contribution in https://github.com/oven-sh/bun/pull/4810
• @shinichy made their first contribution in https://github.com/oven-sh/bun/pull/5510
• @sum117 made their first contribution in https://github.com/oven-sh/bun/pull/5513
• @Vilsol made their first contribution in https://github.com/oven-sh/bun/pull/5576
• @weyert made their first contribution in https://github.com/oven-sh/bun/pull/5562
• @xbjfk made their first contribution in https://github.com/oven-sh/bun/pull/5660
• @yadav-saurabh made their first contribution in https://github.com/oven-sh/bun/pull/5270