Merge branch 'main' into jarred/serve-https-test

* fix intcast on ptr value of zero-length strings

* Make this better

---------

Co-authored-by: Jarred Sumner <709451+Jarred-Sumner@users.noreply.github.com>
Co-authored-by: Jarred Sumner <jarred@jarredsumner.com>

.github/actions/setup-bun/action.yml

@@ -0,0 +1,50 @@
+name: Setup Bun
+description: An internal version of the 'oven-sh/setup-bun' action.
+
+inputs:
+  bun-version:
+    type: string
+    description: "The version of bun to install: 'latest', 'canary', 'bun-v1.0.0', etc."
+    default: latest
+    required: false
+  baseline:
+    type: boolean
+    description: "Whether to use the baseline version of bun."
+    default: false
+    required: false
+  download-url:
+    type: string
+    description: "The base URL to download bun from."
+    default: "https://pub-5e11e972747a44bf9aaf9394f185a982.r2.dev/releases"
+    required: false
+
+runs:
+  using: composite
+  steps:
+    - name: Setup Bun
+      shell: bash
+      run: |
+        case "$(uname -s)" in
+          Linux*)  os=linux;;
+          Darwin*) os=darwin;;
+          *)       os=windows;;
+        esac
+        case "$(uname -m)" in
+          arm64 | aarch64)  arch=arm64;;
+          *)                arch=x64;;
+        esac
+        case "${{ inputs.baseline }}" in
+          true | 1) target="bun-${os}-${arch}-baseline";;
+          *)        target="bun-${os}-${arch}";;
+        esac
+        case "${{ inputs.bun-version }}" in
+          latest) release="latest";;
+          canary) release="canary";;
+          *)      release="bun-v${{ inputs.bun-version }}";;
+        esac
+        curl -LO "${{ inputs.download-url }}/${release}/${target}.zip"
+        unzip ${target}.zip
+        mkdir -p ${{ runner.temp }}/.bun/bin
+        mv ${target}/bun* ${{ runner.temp }}/.bun/bin/
+        chmod +x ${{ runner.temp }}/.bun/bin/*
+        echo "${{ runner.temp }}/.bun/bin" >> ${GITHUB_PATH}

.github/workflows/bun-linux-aarch64.yml

@@ -9,6 +9,7 @@ on:
     branches:
       - main
     paths:
+      - ".github/workflows/bun-linux-aarch64.yml"
       - "src/**/*"
       - "test/**/*"
       - "packages/bun-usockets/src/**/*"
@@ -17,11 +18,11 @@ on:
       - "build.zig"
       - "Makefile"
       - "Dockerfile"
-      - ".github/workflows/bun-linux-aarch64.yml"
   pull_request:
     branches:
       - main
     paths:
+      - ".github/workflows/bun-linux-aarch64.yml"
       - "src/**/*"
       - "test/**/*"
       - "packages/bun-usockets/src/**/*"
@@ -30,7 +31,6 @@ on:
       - "build.zig"
       - "Makefile"
       - "Dockerfile"
-      - ".github/workflows/bun-linux-aarch64.yml"
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
@@ -51,14 +51,14 @@ jobs:
             runner: linux-arm64
             build_machine_arch: aarch64
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           submodules: false
           ref: ${{github.sha}}
           clean: true
       - run: |
           bash ./scripts/update-submodules.sh
-      - uses: docker/setup-buildx-action@v2
+      - uses: docker/setup-buildx-action@v3
         id: buildx
         with:
           install: true
@@ -66,7 +66,7 @@ jobs:
         run: |
           rm -rf ${{runner.temp}}/release
       - name: Login to GitHub Container Registry
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           registry: ghcr.io
           username: ${{ github.actor }}
@@ -74,7 +74,7 @@ jobs:
       - run: |
           mkdir -p /tmp/.buildx-cache-${{matrix.tag}}
       - name: Build and push
-        uses: docker/build-push-action@v3
+        uses: docker/build-push-action@v5
         with:
           context: .
           push: false
@@ -113,14 +113,16 @@ jobs:
 
           zip -r bun-${{matrix.tag}}-profile.zip bun-${{matrix.tag}}-profile
           zip -r bun-${{matrix.tag}}.zip bun-${{matrix.tag}}
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: bun-${{matrix.tag}}-profile
           path: ${{runner.temp}}/release/bun-${{matrix.tag}}-profile.zip
-      - uses: actions/upload-artifact@v3
+          if-no-files-found: "error"
+      - uses: actions/upload-artifact@v4
         with:
           name: bun-${{matrix.tag}}
           path: ${{runner.temp}}/release/bun-${{matrix.tag}}.zip
+          if-no-files-found: "error"
       - name: Release
         id: release
         uses: ncipollo/release-action@v1

.github/workflows/bun-linux-build.yml

@@ -9,6 +9,7 @@ on:
     branches:
       - main
     paths:
+      - ".github/workflows/bun-linux-build.yml"
       - "src/**/*"
       - "test/**/*"
       - "packages/bun-usockets/src/**/*"
@@ -21,6 +22,7 @@ on:
     branches:
       - main
     paths:
+      - ".github/workflows/bun-linux-build.yml"
       - "src/**/*"
       - "test/**/*"
       - "packages/bun-usockets/src/**/*"
@@ -47,7 +49,7 @@ jobs:
             tag: linux-x64
             arch: x86_64
             build_arch: amd64
-            runner: big-ubuntu
+            runner: namespace-profile-bun-linux-x64
             build_machine_arch: x86_64
             assertions: "OFF"
             zig_optimize: "ReleaseFast"
@@ -56,7 +58,7 @@ jobs:
             tag: linux-x64-baseline
             arch: x86_64
             build_arch: amd64
-            runner: big-ubuntu
+            runner: namespace-profile-bun-linux-x64
             build_machine_arch: x86_64
             assertions: "OFF"
             zig_optimize: "ReleaseFast"
@@ -86,28 +88,20 @@ jobs:
           submodules: recursive
           ref: ${{github.sha}}
           clean: true
-      - uses: docker/setup-buildx-action@v2
-        id: buildx
-        with:
-          install: true
       - name: Run
         run: |
           rm -rf ${{runner.temp}}/release
       - name: Login to GitHub Container Registry
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           registry: ghcr.io
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
-      - run: |
-          mkdir -p /tmp/.buildx-cache-${{matrix.tag}}
       - name: Build and push
-        uses: docker/build-push-action@v3
+        uses: docker/build-push-action@v5
         with:
           context: .
           push: false
-          cache-from: type=local,src=/tmp/.buildx-cache-${{matrix.tag}}
-          cache-to: type=local,dest=/tmp/.buildx-cache-${{matrix.tag}}
           build-args: |
             ARCH=${{matrix.arch}}
             BUILDARCH=${{matrix.build_arch}}
@@ -116,12 +110,6 @@ jobs:
             GIT_SHA=${{github.sha}}
             ASSERTIONS=${{matrix.assertions}}
             ZIG_OPTIMIZE=${{matrix.zig_optimize}}
-            SCCACHE_BUCKET=bun
-            SCCACHE_REGION=auto
-            SCCACHE_S3_USE_SSL=true
-            SCCACHE_ENDPOINT=${{ secrets.CACHE_S3_ENDPOINT }}
-            AWS_ACCESS_KEY_ID=${{ secrets.CACHE_S3_ACCESS_KEY_ID }}
-            AWS_SECRET_ACCESS_KEY=${{ secrets.CACHE_S3_SECRET_ACCESS_KEY }}
           platforms: linux/${{matrix.build_arch}}
           target: ${{matrix.target}}
           outputs: type=local,dest=${{runner.temp}}/release
@@ -154,22 +142,16 @@ jobs:
 
           zip -r bun-${{matrix.tag}}-profile.zip bun-${{matrix.tag}}-profile
           zip -r bun-${{matrix.tag}}.zip bun-${{matrix.tag}}
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: bun-${{matrix.tag}}-profile
           path: ${{runner.temp}}/release/bun-${{matrix.tag}}-profile.zip
-      - uses: actions/upload-artifact@v3
+          if-no-files-found: "error"
+      - uses: actions/upload-artifact@v4
         with:
           name: bun-${{matrix.tag}}
           path: ${{runner.temp}}/release/bun-${{matrix.tag}}.zip
-      - uses: actions/upload-artifact@v3
-        with:
-          name: bun-obj-${{matrix.tag}}
-          path: ${{runner.temp}}/release/bun-obj
-      - uses: actions/upload-artifact@v3
-        with:
-          name: ${{matrix.tag}}-dependencies
-          path: ${{runner.temp}}/release/bun-dependencies
+          if-no-files-found: "error"
       - name: Release
         id: release
         uses: ncipollo/release-action@v1
@@ -208,7 +190,7 @@ jobs:
             [Commit ${{github.sha}}](https://github.com/oven-sh/bun/commits/${{github.sha}})
   linux-test:
     name: Tests ${{matrix.tag}}
-    runs-on: ubuntu-latest
+    runs-on: namespace-profile-bun-linux-x64
     needs: [linux]
     if: github.event_name == 'pull_request'
     timeout-minutes: 20
@@ -234,7 +216,7 @@ jobs:
           clean: true
       - id: download
         name: Download
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: bun-${{matrix.tag}}
           path: ${{runner.temp}}/release
@@ -275,19 +257,18 @@ jobs:
         name: Test (node runner)
         env:
           SMTP_SENDGRID_SENDER: ${{ secrets.SMTP_SENDGRID_SENDER }}
+          TMPDIR: ${{runner.temp}}
           TLS_MONGODB_DATABASE_URL: ${{ secrets.TLS_MONGODB_DATABASE_URL }}
           TLS_POSTGRES_DATABASE_URL: ${{ secrets.TLS_POSTGRES_DATABASE_URL }}
         # if: ${{github.event.inputs.use_bun == 'false'}}
         run: |
-          ulimit -c unlimited
-          ulimit -c
-
           node packages/bun-internal-test/src/runner.node.mjs || true
-      - uses: actions/upload-artifact@v3
-        if: steps.test.outputs.failing_tests != ''
-        with:
-          name: cores
-          path: /cores
+      # - uses: actions/upload-artifact@v4
+      #   if: steps.test.outputs.failing_tests != ''
+      #   with:
+      #     name: cores
+      #     path: /cores
+      #     if-no-files-found: "error"
       - uses: sarisia/actions-status-discord@v1
         if: always() && steps.test.outputs.failing_tests != '' && github.event_name == 'pull_request'
         with:

.github/workflows/bun-mac-aarch64.yml

@@ -37,7 +37,7 @@ on:
 jobs:
   macOS-zig:
     name: macOS Zig Object
-    runs-on: med-ubuntu
+    runs-on: namespace-profile-zig-build
     if: github.repository_owner == 'oven-sh'
     strategy:
       matrix:
@@ -50,22 +50,15 @@ jobs:
       # - name: Checkout submodules
       #   run: git submodule update --init --recursive --depth=1 --progress --force
 
-      - name: Setup Docker Buildx
-        uses: docker/setup-buildx-action@v2
-        id: buildx
-        with:
-          install: true
-
       - name: Login to GitHub Container Registry
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           registry: ghcr.io
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Compile Zig Object
-        uses: docker/build-push-action@v3
-        if: runner.arch == 'X64'
+        uses: docker/build-push-action@v5
         with:
           context: .
           push: false
@@ -84,10 +77,11 @@ jobs:
           outputs: type=local,dest=${{runner.temp}}/release
 
       - name: Upload Zig Object
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.tag }}
           path: ${{runner.temp}}/release/bun-zig.o
+          if-no-files-found: "error"
 
   macOS-dependencies:
     name: macOS Dependencies
@@ -141,7 +135,7 @@ jobs:
 
       - name: Cache submodule dependencies
         id: cache-deps-restore
-        uses: actions/cache/restore@v3
+        uses: actions/cache/restore@v4
         with:
           path: ${{runner.temp}}/bun-deps
           key: bun-deps-${{ matrix.tag }}-${{ steps.submodule-versions.outputs.sha }}
@@ -159,16 +153,17 @@ jobs:
       - name: Cache submodule dependencies
         if: ${{ !steps.cache-deps-restore.outputs.cache-hit }}
         id: cache-deps-save
-        uses: actions/cache/save@v3
+        uses: actions/cache/save@v4
         with:
           path: ${{runner.temp}}/bun-deps
           key: ${{ steps.cache-deps-restore.outputs.cache-primary-key }}
 
       - name: Upload submodule dependencies
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.tag }}-deps
           path: ${{runner.temp}}/bun-deps
+          if-no-files-found: "error"
 
   macOS-cpp:
     name: macOS C++
@@ -228,6 +223,7 @@ jobs:
 
           cmake -S $SOURCE_DIR -B $OBJ_DIR \
             -G Ninja \
+            -DUSE_LTO=ON \
             -DCMAKE_BUILD_TYPE=Release \
             -DBUN_CPP_ONLY=1 \
             -DNO_CONFIGURE_DEPENDS=1
@@ -235,10 +231,11 @@ jobs:
           bash compile-cpp-only.sh -v
 
       - name: Upload C++
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.tag }}-cpp
           path: ${{ runner.temp }}/bun-cpp-obj/bun-cpp-objects.a
+          if-no-files-found: "error"
   macOS-link:
     name: macOS Link
     runs-on: ${{ matrix.runner }}
@@ -285,19 +282,19 @@ jobs:
           echo "${{ runner.temp }}/.bun/bin" >> $GITHUB_PATH
 
       - name: Download C++
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ matrix.tag }}-cpp
           path: ${{ runner.temp }}/bun-cpp-obj
 
       - name: Download Zig Object
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ matrix.obj }}
           path: ${{ runner.temp }}/release
 
       - name: Downloaded submodule dependencies
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ matrix.tag }}-deps
           path: ${{runner.temp}}/bun-deps
@@ -312,6 +309,7 @@ jobs:
           cmake $SRC_DIR \
             -G Ninja \
             -DCMAKE_BUILD_TYPE=Release \
+            -DUSE_LTO=ON \
             -DBUN_LINK_ONLY=1 \
             -DBUN_ZIG_OBJ="${{ runner.temp }}/release/bun-zig.o" \
             -DBUN_CPP_ARCHIVE="${{ runner.temp }}/bun-cpp-obj/bun-cpp-objects.a" \
@@ -330,14 +328,16 @@ jobs:
 
           zip -r ${{matrix.tag}}-profile.zip ${{matrix.tag}}-profile
           zip -r ${{matrix.tag}}.zip ${{matrix.tag}}
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: ${{matrix.tag}}-profile
           path: ${{runner.temp}}/link-build/${{matrix.tag}}-profile.zip
-      - uses: actions/upload-artifact@v3
+          if-no-files-found: "error"
+      - uses: actions/upload-artifact@v4
         with:
           name: ${{matrix.tag}}
           path: ${{runner.temp}}/link-build/${{matrix.tag}}.zip
+          if-no-files-found: "error"
       - name: Release
         id: release
         uses: ncipollo/release-action@v1
@@ -394,12 +394,12 @@ jobs:
     steps:
       - id: checkout
         name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           submodules: false
       - id: download
         name: Download
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{matrix.tag}}
           path: ${{runner.temp}}/release
@@ -426,6 +426,7 @@ jobs:
         name: Test (node runner)
         env:
           SMTP_SENDGRID_SENDER: ${{ secrets.SMTP_SENDGRID_SENDER }}
+          TMPDIR: ${{runner.temp}}
           TLS_MONGODB_DATABASE_URL: ${{ secrets.TLS_MONGODB_DATABASE_URL }}
           TLS_POSTGRES_DATABASE_URL: ${{ secrets.TLS_POSTGRES_DATABASE_URL }}
         # if: ${{github.event.inputs.use_bun == 'false'}}

.github/workflows/bun-mac-x64-baseline.yml

@@ -37,7 +37,7 @@ on:
 jobs:
   macos-object-files:
     name: macOS Object
-    runs-on: med-ubuntu
+    runs-on: namespace-profile-zig-build
     if: github.repository_owner == 'oven-sh'
     strategy:
       matrix:
@@ -53,31 +53,17 @@ jobs:
           #   tag: bun-obj-darwin-aarch64
     steps:
       - uses: actions/checkout@v4
-
-      - name: Setup Docker Buildx
-        uses: docker/setup-buildx-action@v2
-        id: buildx
-        with:
-          install: true
-
       - name: Login to GitHub Container Registry
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           registry: ghcr.io
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
-
       - name: Compile Zig Object
-        uses: docker/build-push-action@v3
+        uses: docker/build-push-action@v5
         with:
           context: .
           push: false
-          # This doesnt seem to work
-          # cache-from: type=s3,endpoint_url=${{ secrets.CACHE_S3_ENDPOINT }},blobs_prefix=docker_blobs/,manifests_prefix=docker_manifests/,access_key_id=${{ secrets.CACHE_S3_ACCESS_KEY_ID }},secret_access_key=${{ secrets.CACHE_S3_SECRET_ACCESS_KEY }},bucket=bun,region=auto
-          # cache-to: type=s3,endpoint_url=${{ secrets.CACHE_S3_ENDPOINT }},blobs_prefix=docker_blobs/,manifests_prefix=docker_manifests/,access_key_id=${{ secrets.CACHE_S3_ACCESS_KEY_ID }},secret_access_key=${{ secrets.CACHE_S3_SECRET_ACCESS_KEY }},bucket=bun,region=auto
-          # This was used before, but also does not really work
-          cache-from: type=local,src=/tmp/.buildx-cache-${{matrix.tag}}
-          cache-to: type=local,dest=/tmp/.buildx-cache-${{matrix.tag}}
           build-args: |
             BUILDARCH=${{ runner.arch == 'X64' && 'amd64' || 'arm64' }}
             BUILD_MACHINE_ARCH=${{ runner.arch == 'X64' && 'x86_64' || 'aarch64' }}
@@ -85,22 +71,15 @@ jobs:
             CPU_TARGET=${{ matrix.cpu }}
             TRIPLET=${{ matrix.arch }}-macos-none
             GIT_SHA=${{ github.sha }}
-
-            SCCACHE_BUCKET=bun
-            SCCACHE_REGION=auto
-            SCCACHE_S3_USE_SSL=true
-            SCCACHE_ENDPOINT=${{ secrets.CACHE_S3_ENDPOINT }}
-            AWS_ACCESS_KEY_ID=${{ secrets.CACHE_S3_ACCESS_KEY_ID }}
-            AWS_SECRET_ACCESS_KEY=${{ secrets.CACHE_S3_SECRET_ACCESS_KEY }}
           platforms: linux/${{ runner.arch == 'X64' && 'amd64' || 'arm64' }}
           target: build_release_obj
           outputs: type=local,dest=${{runner.temp}}/release
-
       - name: Upload Zig Object
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.tag }}
           path: ${{runner.temp}}/release/bun-zig.o
+          if-no-files-found: "error"
   macOS-dependencies:
     name: macOS Dependencies
     runs-on: ${{ matrix.runner }}
@@ -146,7 +125,7 @@ jobs:
 
       - name: Cache submodule dependencies
         id: cache-deps-restore
-        uses: actions/cache/restore@v3
+        uses: actions/cache/restore@v4
         with:
           path: ${{runner.temp}}/bun-deps
           key: bun-deps-${{ matrix.tag }}-${{ steps.submodule-versions.outputs.sha }}
@@ -164,16 +143,17 @@ jobs:
       - name: Cache submodule dependencies
         if: ${{ !steps.cache-deps-restore.outputs.cache-hit }}
         id: cache-deps-save
-        uses: actions/cache/save@v3
+        uses: actions/cache/save@v4
         with:
           path: ${{runner.temp}}/bun-deps
           key: ${{ steps.cache-deps-restore.outputs.cache-primary-key }}
 
       - name: Upload submodule dependencies
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.tag }}-deps
           path: ${{runner.temp}}/bun-deps
+          if-no-files-found: "error"
 
   macOS-cpp:
     name: macOS C++
@@ -233,6 +213,7 @@ jobs:
 
           cmake -S $SOURCE_DIR -B $OBJ_DIR \
             -G Ninja \
+            -DUSE_LTO=ON \
             -DCMAKE_BUILD_TYPE=Release \
             -DBUN_CPP_ONLY=1 \
             -DNO_CONFIGURE_DEPENDS=1
@@ -240,10 +221,11 @@ jobs:
           bash compile-cpp-only.sh -v
 
       - name: Upload C++
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.tag }}-cpp
           path: ${{ runner.temp }}/bun-cpp-obj/bun-cpp-objects.a
+          if-no-files-found: "error"
   macOS:
     name: macOS Link
     runs-on: ${{ matrix.runner }}
@@ -262,7 +244,7 @@ jobs:
             runner: macos-12-large
             artifact: bun-obj-darwin-x64-baseline
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Checkout submodules
         run: git submodule update --init --recursive --depth=1 --progress --force
 
@@ -286,19 +268,19 @@ jobs:
           echo "${{ runner.temp }}/.bun/bin" >> $GITHUB_PATH
 
       - name: Download C++
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ matrix.tag }}-cpp
           path: ${{ runner.temp }}/bun-cpp-obj
 
       - name: Download Zig Object
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ matrix.obj }}
           path: ${{ runner.temp }}/release
 
       - name: Downloaded submodule dependencies
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ matrix.tag }}-deps
           path: ${{runner.temp}}/bun-deps
@@ -312,6 +294,7 @@ jobs:
           cd ${{runner.temp}}/link-build
           cmake $SRC_DIR \
             -G Ninja \
+            -DUSE_LTO=ON \
             -DCMAKE_BUILD_TYPE=Release \
             -DBUN_LINK_ONLY=1 \
             -DBUN_ZIG_OBJ="${{ runner.temp }}/release/bun-zig.o" \
@@ -331,14 +314,16 @@ jobs:
 
           zip -r ${{matrix.tag}}-profile.zip ${{matrix.tag}}-profile
           zip -r ${{matrix.tag}}.zip ${{matrix.tag}}
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: ${{matrix.tag}}-profile
           path: ${{runner.temp}}/link-build/${{matrix.tag}}-profile.zip
-      - uses: actions/upload-artifact@v3
+          if-no-files-found: "error"
+      - uses: actions/upload-artifact@v4
         with:
           name: ${{matrix.tag}}
           path: ${{runner.temp}}/link-build/${{matrix.tag}}.zip
+          if-no-files-found: "error"
       - name: Release
         id: release
         uses: ncipollo/release-action@v1
@@ -396,12 +381,12 @@ jobs:
     steps:
       - id: checkout
         name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           submodules: false
       - id: download
         name: Download
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{matrix.tag}}
           path: ${{runner.temp}}/release
@@ -428,6 +413,7 @@ jobs:
         name: Test (node runner)
         env:
           SMTP_SENDGRID_SENDER: ${{ secrets.SMTP_SENDGRID_SENDER }}
+          TMPDIR: ${{runner.temp}}
           TLS_MONGODB_DATABASE_URL: ${{ secrets.TLS_MONGODB_DATABASE_URL }}
           TLS_POSTGRES_DATABASE_URL: ${{ secrets.TLS_POSTGRES_DATABASE_URL }}
         # if: ${{github.event.inputs.use_bun == 'false'}}

.github/workflows/bun-mac-x64.yml

@@ -37,7 +37,7 @@ on:
 jobs:
   macOS-zig:
     name: macOS Zig Object
-    runs-on: med-ubuntu
+    runs-on: namespace-profile-zig-build
     if: github.repository_owner == 'oven-sh'
     strategy:
       matrix:
@@ -50,31 +50,17 @@ jobs:
             tag: bun-obj-darwin-x64
     steps:
       - uses: actions/checkout@v4
-
-      - name: Setup Docker Buildx
-        uses: docker/setup-buildx-action@v2
-        id: buildx
-        with:
-          install: true
-
       - name: Login to GitHub Container Registry
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           registry: ghcr.io
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
-
       - name: Compile Zig Object
-        uses: docker/build-push-action@v3
+        uses: docker/build-push-action@v5
         with:
           context: .
           push: false
-          # This doesnt seem to work
-          # cache-from: type=s3,endpoint_url=${{ secrets.CACHE_S3_ENDPOINT }},blobs_prefix=docker_blobs/,manifests_prefix=docker_manifests/,access_key_id=${{ secrets.CACHE_S3_ACCESS_KEY_ID }},secret_access_key=${{ secrets.CACHE_S3_SECRET_ACCESS_KEY }},bucket=bun,region=auto
-          # cache-to: type=s3,endpoint_url=${{ secrets.CACHE_S3_ENDPOINT }},blobs_prefix=docker_blobs/,manifests_prefix=docker_manifests/,access_key_id=${{ secrets.CACHE_S3_ACCESS_KEY_ID }},secret_access_key=${{ secrets.CACHE_S3_SECRET_ACCESS_KEY }},bucket=bun,region=auto
-          # This was used before, but also does not really work
-          cache-from: type=local,src=/tmp/.buildx-cache-${{matrix.tag}}
-          cache-to: type=local,dest=/tmp/.buildx-cache-${{matrix.tag}}
           build-args: |
             BUILDARCH=${{ runner.arch == 'X64' && 'amd64' || 'arm64' }}
             BUILD_MACHINE_ARCH=${{ runner.arch == 'X64' && 'x86_64' || 'aarch64' }}
@@ -82,22 +68,15 @@ jobs:
             CPU_TARGET=${{ matrix.cpu }}
             TRIPLET=${{ matrix.arch }}-macos-none
             GIT_SHA=${{ github.sha }}
-
-            SCCACHE_BUCKET=bun
-            SCCACHE_REGION=auto
-            SCCACHE_S3_USE_SSL=true
-            SCCACHE_ENDPOINT=${{ secrets.CACHE_S3_ENDPOINT }}
-            AWS_ACCESS_KEY_ID=${{ secrets.CACHE_S3_ACCESS_KEY_ID }}
-            AWS_SECRET_ACCESS_KEY=${{ secrets.CACHE_S3_SECRET_ACCESS_KEY }}
           platforms: linux/${{ runner.arch == 'X64' && 'amd64' || 'arm64' }}
           target: build_release_obj
           outputs: type=local,dest=${{runner.temp}}/release
-
       - name: Upload Zig Object
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.tag }}
           path: ${{runner.temp}}/release/bun-zig.o
+          if-no-files-found: "error"
 
   macOS-dependencies:
     name: macOS Dependencies
@@ -144,7 +123,7 @@ jobs:
 
       - name: Cache submodule dependencies
         id: cache-deps-restore
-        uses: actions/cache/restore@v3
+        uses: actions/cache/restore@v4
         with:
           path: ${{runner.temp}}/bun-deps
           key: bun-deps-${{ matrix.tag }}-${{ steps.submodule-versions.outputs.sha }}
@@ -162,16 +141,17 @@ jobs:
       - name: Cache submodule dependencies
         if: ${{ !steps.cache-deps-restore.outputs.cache-hit }}
         id: cache-deps-save
-        uses: actions/cache/save@v3
+        uses: actions/cache/save@v4
         with:
           path: ${{runner.temp}}/bun-deps
           key: ${{ steps.cache-deps-restore.outputs.cache-primary-key }}
 
       - name: Upload submodule dependencies
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.tag }}-deps
           path: ${{runner.temp}}/bun-deps
+          if-no-files-found: "error"
 
   macOS-cpp:
     name: macOS C++
@@ -232,16 +212,18 @@ jobs:
           cmake -S $SOURCE_DIR -B $OBJ_DIR \
             -G Ninja \
             -DCMAKE_BUILD_TYPE=Release \
+            -DUSE_LTO=ON \
             -DBUN_CPP_ONLY=1 \
             -DNO_CONFIGURE_DEPENDS=1
 
           bash compile-cpp-only.sh -v
 
       - name: Upload C++
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.tag }}-cpp
           path: ${{ runner.temp }}/bun-cpp-obj/bun-cpp-objects.a
+          if-no-files-found: "error"
   macOS:
     name: macOS Link
     runs-on: ${{ matrix.runner }}
@@ -260,7 +242,7 @@ jobs:
             runner: macos-12-large
             artifact: bun-obj-darwin-x64
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Checkout submodules
         run: git submodule update --init --recursive --depth=1 --progress --force
 
@@ -284,19 +266,19 @@ jobs:
           echo "${{ runner.temp }}/.bun/bin" >> $GITHUB_PATH
 
       - name: Download C++
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ matrix.tag }}-cpp
           path: ${{ runner.temp }}/bun-cpp-obj
 
       - name: Download Zig Object
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ matrix.obj }}
           path: ${{ runner.temp }}/release
 
       - name: Downloaded submodule dependencies
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ matrix.tag }}-deps
           path: ${{runner.temp}}/bun-deps
@@ -311,6 +293,7 @@ jobs:
           cmake $SRC_DIR \
             -G Ninja \
             -DCMAKE_BUILD_TYPE=Release \
+            -DUSE_LTO=ON \
             -DBUN_LINK_ONLY=1 \
             -DBUN_ZIG_OBJ="${{ runner.temp }}/release/bun-zig.o" \
             -DBUN_CPP_ARCHIVE="${{ runner.temp }}/bun-cpp-obj/bun-cpp-objects.a" \
@@ -329,14 +312,16 @@ jobs:
 
           zip -r ${{matrix.tag}}-profile.zip ${{matrix.tag}}-profile
           zip -r ${{matrix.tag}}.zip ${{matrix.tag}}
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: ${{matrix.tag}}-profile
           path: ${{runner.temp}}/link-build/${{matrix.tag}}-profile.zip
-      - uses: actions/upload-artifact@v3
+          if-no-files-found: "error"
+      - uses: actions/upload-artifact@v4
         with:
           name: ${{matrix.tag}}
           path: ${{runner.temp}}/link-build/${{matrix.tag}}.zip
+          if-no-files-found: "error"
       - name: Release
         id: release
         uses: ncipollo/release-action@v1
@@ -393,12 +378,12 @@ jobs:
     steps:
       - id: checkout
         name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           submodules: false
       - id: download
         name: Download
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{matrix.tag}}
           path: ${{runner.temp}}/release
@@ -426,6 +411,7 @@ jobs:
         env:
           SMTP_SENDGRID_SENDER: ${{ secrets.SMTP_SENDGRID_SENDER }}
           TLS_MONGODB_DATABASE_URL: ${{ secrets.TLS_MONGODB_DATABASE_URL }}
+          TMPDIR: ${{runner.temp}}
           TLS_POSTGRES_DATABASE_URL: ${{ secrets.TLS_POSTGRES_DATABASE_URL }}
         # if: ${{github.event.inputs.use_bun == 'false'}}
         run: |

.github/workflows/bun-release.yml

@@ -51,7 +51,7 @@ jobs:
         working-directory: packages/bun-release
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Setup GPG
         uses: crazy-max/ghaction-import-gpg@v5
         with:
@@ -81,7 +81,7 @@ jobs:
         working-directory: packages/bun-release
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Setup Bun
         uses: oven-sh/setup-bun@v1
         with:
@@ -105,7 +105,7 @@ jobs:
         working-directory: packages/bun-types
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Setup Node.js
         uses: actions/setup-node@v3
         with:
@@ -170,12 +170,12 @@ jobs:
             suffix: -distroless
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Setup Docker emulator
         uses: docker/setup-qemu-action@v2
       - id: buildx
         name: Setup Docker buildx
-        uses: docker/setup-buildx-action@v2
+        uses: docker/setup-buildx-action@v3
         with:
           platforms: linux/amd64,linux/arm64
       - id: metadata
@@ -192,12 +192,12 @@ jobs:
             type=match,pattern=(bun-v)?(canary|\d+.\d+),group=2,value=${{ env.BUN_VERSION }},suffix=${{ matrix.suffix }}
             type=match,pattern=(bun-v)?(canary|\d+),group=2,value=${{ env.BUN_VERSION }},suffix=${{ matrix.suffix }}
       - name: Login to Docker
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           username: ${{ secrets.DOCKER_USERNAME }}
           password: ${{ secrets.DOCKER_PASSWORD }}
       - name: Push to Docker
-        uses: docker/build-push-action@v3
+        uses: docker/build-push-action@v5
         with:
           context: ./dockerhub/${{ matrix.dir || matrix.variant }}
           platforms: linux/amd64,linux/arm64
@@ -216,7 +216,7 @@ jobs:
     if: ${{ github.event_name == 'release' || github.event.inputs.use-homebrew == 'true' }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           repository: oven-sh/homebrew-bun
           token: ${{ secrets.ROBOBUN_TOKEN }}
@@ -252,7 +252,7 @@ jobs:
         working-directory: packages/bun-release
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Setup Bun
         uses: oven-sh/setup-bun@v1
         with:

.github/workflows/bun-types-tests.yml

@@ -18,7 +18,7 @@ jobs:
 
     steps:
       - name: Checkout repo
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Install bun
         uses: oven-sh/setup-bun@v1

.github/workflows/bun-windows.yml

@@ -53,20 +53,15 @@ jobs:
         cpu: [haswell, nehalem]
         arch: [x86_64]
     name: Zig Build
-    runs-on: med-ubuntu
+    runs-on: namespace-profile-zig-build
     timeout-minutes: 60
     if: github.repository_owner == 'oven-sh'
     steps:
       - run: git config --global core.autocrlf false && git config --global core.eol lf
       - uses: actions/checkout@v4
-      - name: Setup Docker Buildx
-        uses: docker/setup-buildx-action@v2
-        id: buildx
-        with:
-          install: true
 
       - name: Login to GitHub Container Registry
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           registry: ghcr.io
           username: ${{ github.actor }}
@@ -79,8 +74,7 @@ jobs:
           echo "canary_revision=$(GITHUB_TOKEN="${{ secrets.GITHUB_TOKEN }}" bash ./scripts/calculate-canary-revision.sh --raw)" >> $GITHUB_OUTPUT
 
       - name: Compile Zig Object
-        uses: docker/build-push-action@v3
-        if: runner.arch == 'X64'
+        uses: docker/build-push-action@v5
         with:
           context: .
           push: false
@@ -102,10 +96,11 @@ jobs:
           outputs: type=local,dest=${{runner.temp}}/release
 
       - name: Upload Zig Object
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-zig${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
           path: ${{runner.temp}}/release/bun-zig.o
+          if-no-files-found: "error"
 
   windows-dependencies:
     name: Dependencies
@@ -138,7 +133,7 @@ jobs:
 
       - name: Try fetch dependencies
         id: cache-deps-restore
-        uses: actions/cache/restore@v3
+        uses: actions/cache/restore@v4
         with:
           path: bun-deps
           key: bun-deps-${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-${{ steps.submodule-versions.outputs.sha }}
@@ -165,19 +160,25 @@ jobs:
           .\scripts\all-dependencies.ps1
 
       - name: Upload Dependencies
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-deps${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
           path: bun-deps/
+          if-no-files-found: "error"
 
       - name: Cache Dependencies
         if: ${{ !steps.cache-deps-restore.outputs.cache-hit }}
         id: cache-deps-save
-        uses: actions/cache/save@v3
+        uses: actions/cache/save@v4
         with:
           path: bun-deps
           key: ${{ steps.cache-deps-restore.outputs.cache-primary-key }}
 
+  # TODO(@paperdave): stop relying on this and use bun.exe to build itself.
+  # we cant do that now because there isn't a tagged release to use.
+  #
+  # and at the time of writing, the minimum canary required to work is not
+  # yet released as it is the one *this* commit.
   windows-codegen:
     name: Codegen
     runs-on: ubuntu-latest
@@ -199,10 +200,11 @@ jobs:
         if: ${{ env.canary == 'true' }}
         run: |
           echo "canary_revision=$(GITHUB_TOKEN="${{ secrets.GITHUB_TOKEN }}" bash ./scripts/calculate-canary-revision.sh --raw)" > build-codegen-win32-x64/.canary_revision
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-codegen
           path: build-codegen-win32-x64/
+          if-no-files-found: "error"
 
   windows-cpp:
     name: C++ Build
@@ -223,7 +225,7 @@ jobs:
           version: ${{ env.LLVM_VERSION }}
       - run: choco install -y ninja
       - name: Download Codegen
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-codegen
           path: build
@@ -258,10 +260,11 @@ jobs:
           if ($LASTEXITCODE -ne 0) { throw "CMake configuration failed" }
           .\compile-cpp-only.ps1 -v
           if ($LASTEXITCODE -ne 0) { throw "C++ compilation failed" }
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-cpp${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
           path: build/bun-cpp-objects.a
+          if-no-files-found: "error"
 
   windows-link:
     strategy:
@@ -271,7 +274,7 @@ jobs:
         arch: [x86_64]
     name: Link
     needs: [windows-dependencies, windows-codegen, windows-cpp, windows-zig]
-    runs-on: windows-latest
+    runs-on: windows-small
     if: github.repository_owner == 'oven-sh'
     timeout-minutes: 30
     permissions: write-all
@@ -283,22 +286,22 @@ jobs:
           version: ${{ env.LLVM_VERSION }}
       - run: choco install -y ninja
       - name: Download Codegen
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-codegen
           path: build
       - name: Download Dependencies
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-deps${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
           path: bun-deps
       - name: Download Zig Object
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-zig${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
           path: bun-zig
       - name: Download C++ Objects
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-cpp${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
           path: bun-cpp
@@ -331,14 +334,16 @@ jobs:
           cp -r build\bun.pdb "$Dist\bun.pdb"
           Compress-Archive "$Dist" "$Dist.zip"
 
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
           path: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}.zip
-      - uses: actions/upload-artifact@v3
+          if-no-files-found: "error"
+      - uses: actions/upload-artifact@v4
         with:
           name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-profile
           path: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-profile.zip
+          if-no-files-found: "error"
       - name: Release
         id: release
         uses: ncipollo/release-action@v1
@@ -374,7 +379,7 @@ jobs:
             **[Build Output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})** | [Commit](https://github.com/oven-sh/bun/commits/${{github.sha}})
   windows-test:
     name: Test
-    runs-on: windows-latest
+    runs-on: windows-small
     needs: [windows-link]
     if: github.event_name == 'pull_request' && github.repository_owner == 'oven-sh'
     permissions:
@@ -393,12 +398,12 @@ jobs:
       - run: git config --global core.autocrlf false && git config --global core.eol lf
       - id: checkout
         name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           submodules: false
       - id: download
         name: Download Release
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-profile
           path: ${{runner.temp}}/release
@@ -412,6 +417,9 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: 20
+      - uses: secondlife/setup-cygwin@v1
+        with:
+          packages: bash
       - name: Install dependencies
         run: |
           # bun install --verbose
@@ -426,14 +434,15 @@ jobs:
         name: Run tests
         env:
           SMTP_SENDGRID_SENDER: ${{ secrets.SMTP_SENDGRID_SENDER }}
+          TMPDIR: ${{runner.temp}}
           TLS_MONGODB_DATABASE_URL: ${{ secrets.TLS_MONGODB_DATABASE_URL }}
           TLS_POSTGRES_DATABASE_URL: ${{ secrets.TLS_POSTGRES_DATABASE_URL }}
+          SHELLOPTS: igncr
+          BUN_PATH_BASE: ${{runner.temp}}
+          BUN_PATH: release/${{env.tag}}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-profile/bun.exe
         run: |
-          try {
-            $ErrorActionPreference = "SilentlyContinue"
-            $null = node packages/bun-internal-test/src/runner.node.mjs ${{runner.temp}}/release/${{env.tag}}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-profile/bun.exe || $true
-          } catch {}
-          $ErrorActionPreference = "Stop"
+          node packages/bun-internal-test/src/runner.node.mjs  || true
+        shell: bash
       - uses: sarisia/actions-status-discord@v1
         if: always() && steps.test.outputs.failing_tests != '' && github.event_name == 'pull_request'
         with:

.github/workflows/format.yml

@@ -1,5 +1,8 @@
 name: autofix.ci # Must be named this for autofix.ci to work
 
+permissions:
+  contents: read
+
 on:
   workflow_dispatch:
   pull_request:
@@ -10,24 +13,22 @@ on:
 env:
   ZIG_VERSION: 0.12.0-dev.1828+225fe6ddb
 
-permissions:
-  contents: read
-
 jobs:
   format:
     name: format
-    runs-on: ubuntu-latest
+    runs-on: ${{ vars.RUNNER_LINUX_X64 || 'ubuntu-latest' }}
     steps:
       - name: Checkout
         uses: actions/checkout@v4
         with:
           sparse-checkout: |
+            .github
             src
             packages
             test
             bench
       - name: Setup Bun
-        uses: oven-sh/setup-bun@v1
+        uses: ./.github/actions/setup-bun
         with:
           bun-version: "1.0.21"
       - name: Setup Zig

.gitignore

@@ -1,166 +1,169 @@
-.DS_Store
-zig-cache
-packages/*/*.wasm
-*.o
-*.a
-profile.json
-
-node_modules
-.envrc
-.swcrc
-yarn.lock
-dist
-*.tmp
-*.log
-*.out.js
-*.out.refresh.js
-**/package-lock.json
-build
-*.wat
-zig-out
-pnpm-lock.yaml
-README.md.template
-src/deps/zig-clap/example
-src/deps/zig-clap/README.md
-src/deps/zig-clap/.github
-src/deps/zig-clap/.gitattributes
-out
-outdir
-
-.trace
-cover
-coverage
-coverv
-*.trace
-github
-out.*
-out
-.parcel-cache
-esbuilddir
-*.bun
-parceldist
-esbuilddir
-outdir/
-outcss
-.next
-txt.js
-.idea
-.vscode/cpp*
-.vscode/clang*
-
-node_modules_*
-*.jsb
-*.zip
-bun-zigld
-bun-singlehtreaded
-bun-nomimalloc
-bun-mimalloc
-examples/lotta-modules/bun-yday
-examples/lotta-modules/bun-old
-examples/lotta-modules/bun-nofscache
-
-src/node-fallbacks/out/*
-src/node-fallbacks/node_modules
-sign.json
-release/
-*.dmg
-sign.*.json
-packages/debug-*
-packages/bun-cli/postinstall.js
-packages/bun-*/bun
-packages/bun-*/bun-profile
-packages/bun-*/debug-bun
-packages/bun-*/*.o
-packages/bun-cli/postinstall.js
-
-packages/bun-cli/bin/*
-bun-test-scratch
-misctools/fetch
-
-src/deps/libiconv
-src/deps/openssl
-src/tests.zig
-*.blob
-src/deps/s2n-tls
-.npm
-.npm.gz
-
-bun-binary
-
-src/deps/PLCrashReporter/
-
-*.dSYM
-*.crash
-misctools/sha
-packages/bun-wasm/*.mjs
-packages/bun-wasm/*.cjs
-packages/bun-wasm/*.map
-packages/bun-wasm/*.js
-packages/bun-wasm/*.d.ts
-packages/bun-wasm/*.d.cts
-packages/bun-wasm/*.d.mts
-*.bc
-
-src/fallback.version
-src/runtime.version
-*.sqlite
-*.database
-*.db
-misctools/machbench
-*.big
-.eslintcache
-
-/bun-webkit
-
-src/deps/c-ares/build
-src/bun.js/bindings-obj
-src/bun.js/debug-bindings-obj
-
-failing-tests.txt
-test.txt
-myscript.sh
-
-cold-jsc-start
-cold-jsc-start.d
-
-/test.ts
-/test.js
-
-src/js/out/modules*
-src/js/out/functions*
-src/js/out/tmp
-src/js/out/DebugPath.h
-
-make-dev-stats.csv
-
-.uuid
-tsconfig.tsbuildinfo
-
-test/js/bun/glob/fixtures
-*.lib
-*.pdb
-CMakeFiles
-build.ninja
-.ninja_deps
-.ninja_log
-CMakeCache.txt
-cmake_install.cmake
-compile_commands.json
-
-*.lib
-x64
-**/*.vcxproj*
-**/*.sln*
-**/*.dir
-**/*.pdb
-
-/.webkit-cache
-/.cache
-/src/deps/libuv
-/build-*/
-
-.vs
-
-**/.verdaccio-db.json
-/test-report.md
-/test-report.json
+.DS_Store
+zig-cache
+packages/*/*.wasm
+*.o
+*.a
+profile.json
+
+.env
+node_modules
+.envrc
+.swcrc
+yarn.lock
+dist
+*.tmp
+*.log
+*.out.js
+*.out.refresh.js
+**/package-lock.json
+build
+*.wat
+zig-out
+pnpm-lock.yaml
+README.md.template
+src/deps/zig-clap/example
+src/deps/zig-clap/README.md
+src/deps/zig-clap/.github
+src/deps/zig-clap/.gitattributes
+out
+outdir
+
+.trace
+cover
+coverage
+coverv
+*.trace
+github
+out.*
+out
+.parcel-cache
+esbuilddir
+*.bun
+parceldist
+esbuilddir
+outdir/
+outcss
+.next
+txt.js
+.idea
+.vscode/cpp*
+.vscode/clang*
+
+node_modules_*
+*.jsb
+*.zip
+bun-zigld
+bun-singlehtreaded
+bun-nomimalloc
+bun-mimalloc
+examples/lotta-modules/bun-yday
+examples/lotta-modules/bun-old
+examples/lotta-modules/bun-nofscache
+
+src/node-fallbacks/out/*
+src/node-fallbacks/node_modules
+sign.json
+release/
+*.dmg
+sign.*.json
+packages/debug-*
+packages/bun-cli/postinstall.js
+packages/bun-*/bun
+packages/bun-*/bun-profile
+packages/bun-*/debug-bun
+packages/bun-*/*.o
+packages/bun-cli/postinstall.js
+
+packages/bun-cli/bin/*
+bun-test-scratch
+misctools/fetch
+
+src/deps/libiconv
+src/deps/openssl
+src/tests.zig
+*.blob
+src/deps/s2n-tls
+.npm
+.npm.gz
+
+bun-binary
+
+src/deps/PLCrashReporter/
+
+*.dSYM
+*.crash
+misctools/sha
+packages/bun-wasm/*.mjs
+packages/bun-wasm/*.cjs
+packages/bun-wasm/*.map
+packages/bun-wasm/*.js
+packages/bun-wasm/*.d.ts
+packages/bun-wasm/*.d.cts
+packages/bun-wasm/*.d.mts
+*.bc
+
+src/fallback.version
+src/runtime.version
+*.sqlite
+*.database
+*.db
+misctools/machbench
+*.big
+.eslintcache
+
+/bun-webkit
+
+src/deps/c-ares/build
+src/bun.js/bindings-obj
+src/bun.js/debug-bindings-obj
+
+failing-tests.txt
+test.txt
+myscript.sh
+
+cold-jsc-start
+cold-jsc-start.d
+
+/testdir
+/test.ts
+/test.js
+
+src/js/out/modules*
+src/js/out/functions*
+src/js/out/tmp
+src/js/out/DebugPath.h
+
+make-dev-stats.csv
+
+.uuid
+tsconfig.tsbuildinfo
+
+test/js/bun/glob/fixtures
+*.lib
+*.pdb
+CMakeFiles
+build.ninja
+.ninja_deps
+.ninja_log
+CMakeCache.txt
+cmake_install.cmake
+compile_commands.json
+
+*.lib
+x64
+**/*.vcxproj*
+**/*.sln*
+**/*.dir
+**/*.pdb
+
+/.webkit-cache
+/.cache
+/src/deps/libuv
+/build-*/
+/kcov-out
+
+.vs
+
+**/.verdaccio-db.json
+/test-report.md
+/test-report.json

.gitmodules

@@ -82,4 +82,4 @@ url = https://github.com/litespeedtech/ls-hpack.git
 ignore = dirty
 depth = 1
 shallow = true
-fetchRecurseSubmodules = false
+fetchRecurseSubmodules = false

.prettierignore

@@ -1,14 +1,5 @@
-src/fallback.html
 src/bun.js/WebKit
-src/js/out
-src/*.out.js
-src/*out.*.js
 src/deps
-src/test/fixtures
-src/react-refresh.js
 test/snapshots
-test/snapshots-no-hmr
-test/js/deno/*.test.ts
-test/js/deno/**/*.test.ts
-bench/react-hello-world/react-hello-world.node.js
-test/cli/run/encoding-utf16-le-bom.ts
+test/js/deno
+src/react-refresh.js

.prettierrc

@@ -0,0 +1,15 @@
+{
+  "arrowParens": "avoid",
+  "printWidth": 120,
+  "trailingComma": "all",
+  "useTabs": false,
+  "quoteProps": "preserve",
+  "overrides": [
+    {
+      "files": ["*.md"],
+      "options": {
+        "printWidth": 80
+      }
+    }
+  ]
+}

.prettierrc.cjs

@@ -1,15 +0,0 @@
-module.exports = {
-  arrowParens: "avoid",
-  printWidth: 120,
-  trailingComma: "all",
-  useTabs: false,
-  quoteProps: "preserve",
-  overrides: [
-    {
-      files: ["*.md"],
-      options: {
-        printWidth: 80,
-      },
-    },
-  ],
-};

.vscode/c_cpp_properties.json

@@ -3,6 +3,7 @@
     {
       "name": "Debug",
       "forcedInclude": ["${workspaceFolder}/src/bun.js/bindings/root.h"],
+      "compileCommands": "${workspaceFolder}/build/compile_commands.json",
       "includePath": [
         "${workspaceFolder}/build/bun-webkit/include",
         "${workspaceFolder}/build/codegen",

.vscode/extensions.json

@@ -1,10 +1,33 @@
 {
   "recommendations": [
+    // Zig
     "ziglang.vscode-zig",
-    "biomejs.biome",
+
+    // C/C++
+    "clang.clangd",
+    "ms-vscode.cmake-tools",
     "xaver.clang-format",
     "vadimcn.vscode-lldb",
-    "bierner.comment-tagged-templates",
-    "clangd.clangd"
+
+    // JavaScript
+    "oven.bun-vscode",
+    "esbenp.prettier-vscode",
+
+    // TypeScript
+    "better-ts-errors.better-ts-errors",
+    "MylesMurphy.prettify-ts",
+
+    // Markdown
+    "bierner.markdown-preview-github-styles",
+    "bierner.markdown-emoji",
+    "bierner.emojisense",
+    "bierner.markdown-checkbox",
+    "bierner.jsdoc-markdown-highlighting",
+
+    // TOML
+    "tamasfe.even-better-toml",
+
+    // Other
+    "bierner.comment-tagged-templates"
   ]
 }

.vscode/settings.json

@@ -1,58 +1,89 @@
 {
-  "git.autoRepositoryDetection": "openEditors",
+  // Editor
+  "editor.tabSize": 2,
+  "editor.insertSpaces": true,
+  "editor.formatOnSave": true,
+  "editor.formatOnSaveMode": "file",
+
+  // Search
   "search.quickOpen.includeSymbols": false,
   "search.seedWithNearestWord": true,
   "search.smartCase": true,
   "search.exclude": {
     "node_modules": true,
-    "src/bun.js/WebKit": true,
     ".git": true,
+    "src/bun.js/WebKit": true,
     "src/deps/*/**": true
   },
   "search.followSymlinks": false,
   "search.useIgnoreFiles": true,
+
+  // Git
+  "git.autoRepositoryDetection": "openEditors",
+  "git.ignoreSubmodules": true,
+  "git.ignoreLimitWarning": true,
+
+  // Zig
+  "zig.initialSetupDone": true,
   "zig.buildOnSave": false,
-  "zig.formattingProvider": "zls",
   "zig.buildOption": "build",
   "zig.buildFilePath": "${workspaceFolder}/build.zig",
-  "zig.initialSetupDone": true,
-  "editor.formatOnSave": true,
-
-  // We are using biome instead of prettier.
-  "prettier.enable": false,
-
-  "[json]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[jsonc]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
+  "zig.path": "${workspaceFolder}/.cache/zig/zig.exe",
+  "zig.formattingProvider": "zls",
+  "zig.zls.enableInlayHints": false,
   "[zig]": {
     "editor.tabSize": 4,
     "editor.useTabStops": false,
     "editor.defaultFormatter": "ziglang.vscode-zig"
   },
-  "[ts]": {
-    "editor.defaultFormatter": "biomejs.biome"
+
+  // C++
+  "lldb.verboseLogging": false,
+  "cmake.configureOnOpen": false,
+  "C_Cpp.errorSquiggles": "enabled",  
+  "[cpp]": {
+    "editor.defaultFormatter": "xaver.clang-format"
   },
-  "[js]": {
-    "editor.defaultFormatter": "biomejs.biome"
+  "[c]": {
+    "editor.defaultFormatter": "xaver.clang-format"
   },
-  "zig.zls.enableInlayHints": false,
-  "zig.path": "${workspaceFolder}/.cache/zig/zig.exe",
-  "git.ignoreSubmodules": true,
-  "[jsx]": {
-    "editor.defaultFormatter": "biomejs.biome"
+  "[h]": {
+    "editor.defaultFormatter": "xaver.clang-format"
   },
-  "[tsx]": {
-    "editor.defaultFormatter": "biomejs.biome"
+
+  // JavaScript
+  "prettier.enable": true,
+  "eslint.workingDirectories": ["${workspaceFolder}/packages/bun-types"],
+  "[javascript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
   },
-  "[yaml]": {},
+  "[javascriptreact]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+
+  // TypeScript
+  "typescript.tsdk": "${workspaceFolder}/node_modules/typescript/lib",
+  "[typescript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+
+  // JSON
+  "[json]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+  },
+  
+  // Markdown
   "[markdown]": {
-    "editor.unicodeHighlight.ambiguousCharacters": false,
-    "editor.unicodeHighlight.invisibleCharacters": false,
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.unicodeHighlight.ambiguousCharacters": true,
+    "editor.unicodeHighlight.invisibleCharacters": true,
     "diffEditor.ignoreTrimWhitespace": false,
-    "editor.defaultFormatter": "biomejs.biome",
     "editor.wordWrap": "on",
     "editor.quickSuggestions": {
       "comments": "off",
@@ -60,7 +91,18 @@
       "other": "off"
     }
   },
-  "lldb.verboseLogging": false,
+
+  // TOML
+  "[toml]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+  },
+
+  // YAML
+  "[yaml]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+  },
+
+  // Files
   "files.exclude": {
     "**/.git": true,
     "**/.svn": true,
@@ -70,7 +112,6 @@
     "**/Thumbs.db": true,
     "**/*.xcworkspacedata": true,
     "**/*.xcscheme": true,
-    "**/*.pem": true,
     "**/*.xcodeproj": true,
     "src/bun.js/WebKit": true,
     "src/deps/libarchive": true,
@@ -85,7 +126,10 @@
     "src/deps/tinycc": true,
     "src/deps/zstd": true,
     "**/*.i": true,
-    "packages/bun-uws/fuzzing/seed-corpus/**/*": true
+    "packages/bun-uws/fuzzing/seed-corpus": true
+  },
+  "files.associations": {
+    "*.idl": "cpp"
   },
   "C_Cpp.files.exclude": {
     "**/.vscode": true,
@@ -105,137 +149,4 @@
     "WebKit/WebKitBuild": true,
     "WebKit/WebInspectorUI": true
   },
-  "[cpp]": {
-    "editor.defaultFormatter": "xaver.clang-format"
-  },
-  "[h]": {
-    "editor.defaultFormatter": "xaver.clang-format"
-  },
-  "[c]": {
-    "editor.defaultFormatter": "xaver.clang-format"
-  },
-  "files.associations": {
-    "*.lock": "yarnlock",
-    "*.idl": "cpp",
-    "memory": "cpp",
-    "iostream": "cpp",
-    "algorithm": "cpp",
-    "random": "cpp",
-    "ios": "cpp",
-    "filesystem": "cpp",
-    "__locale": "cpp",
-    "type_traits": "cpp",
-    "__mutex_base": "cpp",
-    "__string": "cpp",
-    "string": "cpp",
-    "string_view": "cpp",
-    "typeinfo": "cpp",
-    "__config": "cpp",
-    "__nullptr": "cpp",
-    "exception": "cpp",
-    "__bit_reference": "cpp",
-    "atomic": "cpp",
-    "utility": "cpp",
-    "sstream": "cpp",
-    "__functional_base": "cpp",
-    "new": "cpp",
-    "__debug": "cpp",
-    "__errc": "cpp",
-    "__hash_table": "cpp",
-    "__node_handle": "cpp",
-    "__split_buffer": "cpp",
-    "__threading_support": "cpp",
-    "__tuple": "cpp",
-    "array": "cpp",
-    "bit": "cpp",
-    "bitset": "cpp",
-    "cctype": "cpp",
-    "chrono": "cpp",
-    "clocale": "cpp",
-    "cmath": "cpp",
-    "complex": "cpp",
-    "condition_variable": "cpp",
-    "cstdarg": "cpp",
-    "cstddef": "cpp",
-    "cstdint": "cpp",
-    "cstdio": "cpp",
-    "cstdlib": "cpp",
-    "cstring": "cpp",
-    "ctime": "cpp",
-    "cwchar": "cpp",
-    "cwctype": "cpp",
-    "deque": "cpp",
-    "fstream": "cpp",
-    "functional": "cpp",
-    "initializer_list": "cpp",
-    "iomanip": "cpp",
-    "iosfwd": "cpp",
-    "istream": "cpp",
-    "iterator": "cpp",
-    "limits": "cpp",
-    "locale": "cpp",
-    "mutex": "cpp",
-    "optional": "cpp",
-    "ostream": "cpp",
-    "ratio": "cpp",
-    "stack": "cpp",
-    "stdexcept": "cpp",
-    "streambuf": "cpp",
-    "system_error": "cpp",
-    "thread": "cpp",
-    "tuple": "cpp",
-    "unordered_map": "cpp",
-    "unordered_set": "cpp",
-    "vector": "cpp",
-    "__bits": "cpp",
-    "__tree": "cpp",
-    "map": "cpp",
-    "numeric": "cpp",
-    "set": "cpp",
-    "__memory": "cpp",
-    "memory_resource": "cpp",
-    "*.tcc": "cpp",
-    "list": "cpp",
-    "shared_mutex": "cpp",
-    "cinttypes": "cpp",
-    "variant": "cpp",
-    "sysctl.h": "c",
-    "queue": "cpp",
-    "compare": "cpp",
-    "concepts": "cpp",
-    "typeindex": "cpp",
-    "__verbose_abort": "cpp",
-    "__std_stream": "cpp",
-    "any": "cpp",
-    "charconv": "cpp",
-    "csignal": "cpp",
-    "format": "cpp",
-    "forward_list": "cpp",
-    "future": "cpp",
-    "regex": "cpp",
-    "span": "cpp",
-    "valarray": "cpp",
-    "codecvt": "cpp",
-    "xtr1common": "cpp",
-    "stop_token": "cpp",
-    "xfacet": "cpp",
-    "xhash": "cpp",
-    "xiosbase": "cpp",
-    "xlocale": "cpp",
-    "xlocbuf": "cpp",
-    "xlocinfo": "cpp",
-    "xlocmes": "cpp",
-    "xlocmon": "cpp",
-    "xlocnum": "cpp",
-    "xloctime": "cpp",
-    "xmemory": "cpp",
-    "xstring": "cpp",
-    "xtree": "cpp",
-    "xutility": "cpp"
-  },
-  "C_Cpp.errorSquiggles": "enabled",
-  "eslint.workingDirectories": ["packages/bun-types"],
-  "typescript.tsdk": "node_modules/typescript/lib",
-  "cmake.configureOnOpen": false,
-  "git.ignoreLimitWarning": true
 }

.vscode/tasks.json

@@ -2,10 +2,51 @@
   "version": "2.0.0",
   "tasks": [
     {
-      "label": "Rebuild Debug",
-      "command": "ninja",
-      "args": ["-Cbuild"],
       "type": "process",
-    }
+      "label": "Install Dependencies",
+      "command": "scripts/all-dependencies.sh",
+      "windows": {
+        "command": "scripts/all-dependencies.ps1"
+      },
+      "icon": {
+        "id": "arrow-down"
+      },
+      "options": {
+        "cwd": "${workspaceFolder}"
+      },
+    },
+    {
+      "type": "process",
+      "label": "Setup Environment",
+      "dependsOn": ["Install Dependencies"],
+      "command": "scripts/setup.sh",
+      "windows": {
+        "command": "scripts/setup.ps1"
+      },
+      "icon": {
+        "id": "check"
+      },
+      "options": {
+        "cwd": "${workspaceFolder}"
+      },
+    },
+    {
+      "type": "process",
+      "label": "Build Bun",
+      "dependsOn": ["Setup Environment"],
+      "command": "bun",
+      "args": ["run", "build"],
+      "icon": {
+        "id": "gear"
+      },
+      "options": {
+        "cwd": "${workspaceFolder}"
+      },
+      "isBuildCommand": true,
+      "runOptions": {
+        "instanceLimit": 1,
+        "reevaluateOnRerun": true,
+      },
+    },
   ]
 }

Dockerfile

@@ -16,7 +16,7 @@ ARG BUILD_MACHINE_ARCH=x86_64
 ARG BUILDARCH=amd64
 ARG TRIPLET=${ARCH}-linux-gnu
 ARG GIT_SHA=""
-ARG BUN_VERSION="bun-v1.0.7"
+ARG BUN_VERSION="bun-v1.0.30"
 ARG BUN_DOWNLOAD_URL_BASE="https://pub-5e11e972747a44bf9aaf9394f185a982.r2.dev/releases/${BUN_VERSION}"
 ARG CANARY=0
 ARG ASSERTIONS=OFF
@@ -290,7 +290,6 @@ ENV CCACHE_DIR=/ccache
 
 COPY Makefile ${BUN_DIR}/Makefile
 COPY src/deps/zstd ${BUN_DIR}/src/deps/zstd
-COPY .prettierrc.cjs ${BUN_DIR}/.prettierrc.cjs
 
 WORKDIR $BUN_DIR
 
@@ -373,12 +372,12 @@ ENV CCACHE_DIR=/ccache
 RUN --mount=type=cache,target=/ccache  mkdir ${BUN_DIR}/build \
   && cd ${BUN_DIR}/build \
   && mkdir -p tmp_modules tmp_functions js codegen \
-  && cmake .. -GNinja -DCMAKE_BUILD_TYPE=Release -DUSE_DEBUG_JSC=${ASSERTIONS} -DBUN_CPP_ONLY=1 -DWEBKIT_DIR=/build/bun/bun-webkit -DCANARY=${CANARY} -DZIG_COMPILER=system \
+  && cmake .. -GNinja -DCMAKE_BUILD_TYPE=Release -DUSE_LTO=ON -DUSE_DEBUG_JSC=${ASSERTIONS} -DBUN_CPP_ONLY=1 -DWEBKIT_DIR=/build/bun/bun-webkit -DCANARY=${CANARY} -DZIG_COMPILER=system \
   && bash compile-cpp-only.sh -v
 
 FROM bun-base-with-zig as bun-codegen-for-zig
 
-COPY package.json bun.lockb Makefile .gitmodules .prettierrc.cjs ${BUN_DIR}/
+COPY package.json bun.lockb Makefile .gitmodules ${BUN_DIR}/
 COPY src/runtime ${BUN_DIR}/src/runtime
 COPY src/runtime.js src/runtime.bun.js ${BUN_DIR}/src/
 COPY packages/bun-error ${BUN_DIR}/packages/bun-error
@@ -420,6 +419,7 @@ RUN mkdir -p build \
   && cmake .. \
   -G Ninja \
   -DCMAKE_BUILD_TYPE=Release \
+  -DUSE_LTO=ON \
   -DZIG_OPTIMIZE="${ZIG_OPTIMIZE}" \
   -DCPU_TARGET="${CPU_TARGET}" \
   -DZIG_TARGET="${TRIPLET}" \
@@ -477,6 +477,7 @@ RUN cmake .. \
   -DCMAKE_BUILD_TYPE=Release \
   -DBUN_LINK_ONLY=1 \
   -DBUN_ZIG_OBJ="${BUN_DIR}/build/bun-zig.o" \
+  -DUSE_LTO=ON \
   -DUSE_DEBUG_JSC=${ASSERTIONS} \
   -DBUN_CPP_ARCHIVE="${BUN_DIR}/build/bun-cpp-objects.a" \
   -DWEBKIT_DIR="${BUN_DIR}/bun-webkit" \
@@ -541,6 +542,7 @@ RUN cmake .. \
   -DNO_CONFIGURE_DEPENDS=1 \
   -DCANARY="${CANARY}" \
   -DZIG_COMPILER=system \
+  -DUSE_LTO=ON \
   && ninja -v \
   && ./bun --revision \
   && mkdir -p /build/out \

Makefile

@@ -823,7 +823,6 @@ fmt: fmt-cpp fmt-zig
 api:
 	./node_modules/.bin/peechy --schema src/api/schema.peechy --esm src/api/schema.js --ts src/api/schema.d.ts --zig src/api/schema.zig
 	$(ZIG) fmt src/api/schema.zig
-	$(PRETTIER) --config=.prettierrc.cjs --write src/api/schema.js src/api/schema.d.ts
 
 .PHONY: node-fallbacks
 node-fallbacks:
@@ -1723,7 +1722,7 @@ sizegen:
 # Linux uses bundled SQLite3
 ifeq ($(OS_NAME),linux)
 sqlite:
-	$(CC) $(EMIT_LLVM_FOR_RELEASE) $(CFLAGS) $(INCLUDE_DIRS) -DSQLITE_ENABLE_COLUMN_METADATA= -DSQLITE_MAX_VARIABLE_NUMBER=250000 -DSQLITE_ENABLE_RTREE=1 -DSQLITE_ENABLE_FTS3=1 -DSQLITE_ENABLE_FTS3_PARENTHESIS=1 -DSQLITE_ENABLE_FTS5=1 -DSQLITE_ENABLE_JSON1=1 $(SRC_DIR)/sqlite/sqlite3.c -c -o $(SQLITE_OBJECT)
+	$(CC) $(EMIT_LLVM_FOR_RELEASE) $(CFLAGS) $(INCLUDE_DIRS) -DSQLITE_ENABLE_COLUMN_METADATA= -DSQLITE_MAX_VARIABLE_NUMBER=250000 -DSQLITE_ENABLE_RTREE=1 -DSQLITE_ENABLE_FTS3=1 -DSQLITE_ENABLE_FTS3_PARENTHESIS=1 -DSQLITE_ENABLE_FTS5=1 -DSQLITE_ENABLE_JSON1=1 -DSQLITE_ENABLE_MATH_FUNCTIONS=1 $(SRC_DIR)/sqlite/sqlite3.c -c -o $(SQLITE_OBJECT)
 endif
 
 picohttp:

README.md

@@ -24,9 +24,9 @@
 
 ## What is Bun?
 
-> **​​Bun is under active development.** Use it to speed up your development workflows or run simpler production code in resource-constrained environments like serverless functions. We're working on more complete Node.js compatibility and integration with existing frameworks. Join the [Discord](https://bun.sh/discord) and watch the [GitHub repository](https://github.com/oven-sh/bun) to keep tabs on future releases.
+> **Bun is under active development.** Use it to speed up your development workflows or run simpler production code in resource-constrained environments like serverless functions. We're working on more complete Node.js compatibility and integration with existing frameworks. Join the [Discord](https://bun.sh/discord) and watch the [GitHub repository](https://github.com/oven-sh/bun) to keep tabs on future releases.
 
-Bun is an all-in-one toolkit for JavaScript and TypeScript apps. It ships as a single executable called `bun​`.
+Bun is an all-in-one toolkit for JavaScript and TypeScript apps. It ships as a single executable called `bun`.
 
 At its core is the _Bun runtime_, a fast JavaScript runtime designed as a drop-in replacement for Node.js. It's written in Zig and powered by JavaScriptCore under the hood, dramatically reducing startup times and memory usage.
 
@@ -34,12 +34,12 @@ At its core is the _Bun runtime_, a fast JavaScript runtime designed as a drop-i
 bun run index.tsx             # TS and JSX supported out-of-the-box
 ```
 
-​​The `bun​` command-line tool also implements a test runner, script runner, and Node.js-compatible package manager. Instead of 1,000 node_modules for development, you only need `bun`. Bun's built-in tools are significantly faster than existing options and usable in existing Node.js projects with little to no changes.
+The `bun` command-line tool also implements a test runner, script runner, and Node.js-compatible package manager. Instead of 1,000 node_modules for development, you only need `bun`. Bun's built-in tools are significantly faster than existing options and usable in existing Node.js projects with little to no changes.
 
 ```bash
 bun test                      # run tests
 bun run start                 # run the `start` script in `package.json`
-bun install <pkg>​             # install a package
+bun install <pkg>             # install a package
 bunx cowsay 'Hello, world!'   # execute a package
 ```
 

bench/package.json

@@ -12,7 +12,7 @@
     "fast-glob": "3.3.1",
     "fdir": "^6.1.0",
     "mitata": "^0.1.6",
-    "string-width": "^7.0.0",
+    "string-width": "7.1.0",
     "zx": "^7.2.3"
   },
   "scripts": {
@@ -25,6 +25,5 @@
   },
   "devDependencies": {
     "fast-deep-equal": "^3.1.3"
-  },
-  "prettier": "../.prettierrc.cjs"
+  }
 }

bench/snippets/cp.mjs

@@ -1,9 +1,10 @@
-import { mkdirSync, writeFileSync } from "fs";
-import { bench, run } from "./runner.mjs";
+import { mkdirSync, rmSync, writeFileSync } from "fs";
 import { cp } from "fs/promises";
-import { join } from "path";
 import { tmpdir } from "os";
+import { join, resolve } from "path";
+import { bench, run } from "./runner.mjs";
 
+import { fileURLToPath } from "url";
 const hugeDirectory = (() => {
   const root = join(tmpdir(), "huge");
   const base = join(root, "directory", "for", "benchmarks", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10");
@@ -18,14 +19,21 @@ const hugeDirectory = (() => {
 const hugeFilePath = join(tmpdir(), "huge-file-0.txt");
 const hugeText = "Hello, world!".repeat(1000000);
 writeFileSync(hugeFilePath, hugeText);
+let base = process.argv.at(-1);
+if (resolve(base) === fileURLToPath(import.meta.url)) {
+  base = tmpdir();
+} else {
+  rmSync(base, { recursive: true, force: true });
+  mkdirSync(base, { recursive: true });
+}
 
 var hugeCopyI = 0;
 bench("cp -r (1000 files)", async b => {
-  await cp(hugeDirectory, join(tmpdir(), "huge-copy" + hugeCopyI++), { recursive: true });
+  await cp(hugeDirectory, join(base, "huge-copy" + hugeCopyI++), { recursive: true });
 });
 
 bench("cp 1 " + ((hugeText.length / 1024) | 0) + " KB file", async b => {
-  await cp(hugeFilePath, join(tmpdir(), "huge-file" + hugeCopyI++));
+  await cp(hugeFilePath, join(base, "huge-file" + hugeCopyI++));
 });
 
 await run();

bench/snippets/native-overhead.mjs

@@ -5,6 +5,11 @@ const lazy = globalThis[Symbol.for("Bun.lazy")];
 const noop = lazy("noop");
 const fn = noop.function;
 const regular = noop.functionRegular;
+const callback = noop.callback;
+
+bench("C++ callback into JS", () => {
+  callback(() => {});
+});
 
 bench("C++ fn regular", () => {
   regular();

bench/snippets/read-file-chunk.mjs

@@ -0,0 +1,73 @@
+import { tmpdir } from "node:os";
+import { bench, group, run } from "./runner.mjs";
+import { createReadStream, writeFileSync } from "node:fs";
+import { sep } from "node:path";
+
+if (!Promise.withResolvers) {
+  Promise.withResolvers = function () {
+    let resolve, reject;
+    const promise = new Promise((res, rej) => {
+      resolve = res;
+      reject = rej;
+    });
+    return { promise, resolve, reject };
+  };
+}
+
+const ALLOW_BUN = typeof Bun !== "undefined";
+const ALLOW_NODE = true;
+
+const dir = tmpdir() + sep;
+
+var short = (function () {
+  const text = "Hello World!";
+  const path = dir + "bun-bench-short.text";
+  writeFileSync(path, text, "utf8");
+  return { path, length: text.length };
+})();
+var shortUTF16 = (function () {
+  const text = "Hello World 💕💕💕";
+  const path = dir + "bun-bench-shortUTF16.text";
+  writeFileSync(path, text, "utf8");
+  return { path, length: text.length };
+})();
+var long = (function () {
+  const text = "Hello World!".repeat(1024);
+  const path = dir + "bun-bench-long.text";
+  writeFileSync(path, text, "utf8");
+  return { path, length: text.length };
+})();
+var longUTF16 = (function () {
+  const text = "Hello World 💕💕💕".repeat(15 * 70192);
+  const path = dir + "bun-bench-longUTF16.text";
+  writeFileSync(path, text, "utf8");
+  return { path, length: text.length };
+})();
+
+async function bun(path) {
+  for await (const chunk of Bun.file(path).stream()) {
+    chunk;
+  }
+}
+
+async function node(path) {
+  const { promise, resolve } = Promise.withResolvers();
+  const stream = createReadStream(path);
+  stream.on("data", chunk => {});
+  stream.on("end", () => resolve());
+  await promise;
+}
+
+ALLOW_BUN && bench("short - bun", () => bun(short.path));
+ALLOW_NODE && bench("short - node", () => node(short.path));
+
+ALLOW_BUN && bench("shortUTF16 - bun", () => bun(shortUTF16.path));
+ALLOW_NODE && bench("shortUTF16 - node", () => node(shortUTF16.path));
+
+ALLOW_BUN && bench("long - bun", () => bun(long.path));
+ALLOW_NODE && bench("long - node", () => node(long.path));
+
+ALLOW_BUN && bench("longUTF16 - bun", () => bun(longUTF16.path));
+ALLOW_NODE && bench("longUTF16 - node", () => node(longUTF16.path));
+
+await run();

bench/snippets/string-width.mjs

@@ -3,41 +3,38 @@ import npmStringWidth from "string-width";
 
 const bunStringWidth = globalThis?.Bun?.stringWidth;
 
-bench("npm/string-width (ansi + emoji + ascii)", () => {
-  npmStringWidth("hello there! 😀\u001b[31m😀😀");
-});
+const stringWidth = bunStringWidth || npmStringWidth;
+const formatter = new Intl.NumberFormat();
+const format = n => {
+  return formatter.format(n);
+};
 
-bench("npm/string-width (ansi + emoji)", () => {
-  npmStringWidth("😀\u001b[31m😀😀");
-});
+const inputs = [
+  ["hello", "ascii"],
+  ["[31mhello", "ascii+ansi"],
+  ["hello😀", "ascii+emoji"],
+  ["[31m😀😀", "ansi+emoji"],
+  ["😀hello😀[31m😀😀😀", "ansi+emoji+ascii"],
+];
 
-bench("npm/string-width (ansi + ascii)", () => {
-  npmStringWidth("\u001b[31mhello there!");
-});
+const repeatCounts = [1, 10, 100, 1000, 5000];
 
-if (bunStringWidth) {
-  bench("Bun.stringWidth (ansi + emoji + ascii)", () => {
-    bunStringWidth("hello there! 😀\u001b[31m😀😀");
-  });
+const maxInputLength = Math.max(...inputs.map(([input]) => input.repeat(Math.max(...repeatCounts)).length));
 
-  bench("Bun.stringWidth (ansi + emoji)", () => {
-    bunStringWidth("😀\u001b[31m😀😀");
-  });
+for (const [input, textLabel] of inputs) {
+  for (let repeatCount of repeatCounts) {
+    const label = bunStringWidth ? "Bun.stringWidth" : "npm/string-width";
 
-  bench("Bun.stringWidth (ansi + ascii)", () => {
-    bunStringWidth("\u001b[31mhello there!");
-  });
+    const str = input.repeat(repeatCount);
+    const name = `${label} ${format(str.length).padStart(format(maxInputLength).length, " ")} chars ${textLabel}`;
 
-  if (npmStringWidth("😀\u001b[31m😀😀") !== bunStringWidth("😀\u001b[31m😀😀")) {
-    console.error("string-width mismatch");
-  }
+    bench(name, () => {
+      stringWidth(str);
+    });
 
-  if (npmStringWidth("hello there! 😀\u001b[31m😀😀") !== bunStringWidth("hello there! 😀\u001b[31m😀😀")) {
-    console.error("string-width mismatch");
-  }
-
-  if (npmStringWidth("\u001b[31mhello there!") !== bunStringWidth("\u001b[31mhello there!")) {
-    console.error("string-width mismatch");
+    if (bunStringWidth && bunStringWidth(str) !== npmStringWidth(str)) {
+      throw new Error("string-width mismatch");
+    }
   }
 }
 

bench/sqlite/package.json

@@ -7,8 +7,8 @@
     "build": "exit 0",
     "bench:bun": "$BUN bun.js",
     "bench:node": "$NODE node.mjs",
-    "deps": "npm install && sh src/download.sh",
-    "bench:deno": "$DENO run -A --unstable deno.js",
+    "deps": "npm install && bash src/download.sh",
+    "bench:deno": "$DENO run -A --unstable-ffi deno.js",
     "bench": "bun run bench:bun && bun run bench:node && bun run bench:deno"
   }
 }

biome.json

@@ -1,70 +0,0 @@
-{
-  "$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
-  "organizeImports": {
-    "enabled": true
-  },
-  "linter": {
-    "enabled": false
-  },
-  "javascript": {
-    "parser": {
-      "unsafeParameterDecoratorsEnabled": true
-    },
-    "formatter": {
-      "arrowParentheses": "asNeeded",
-      "quoteProperties": "preserve",
-      "semicolons": "always",
-      "trailingComma": "all",
-      "indentStyle": "space",
-      "quoteStyle": "double"
-    }
-  },
-  "json": {
-    "formatter": {
-      "indentStyle": "space"
-    },
-    "parser": {
-      "allowComments": true,
-      "allowTrailingCommas": true
-    }
-  },
-  "vcs": {
-    "clientKind": "git",
-    "enabled": false,
-    "root": "./"
-  },
-  "files": {
-    "maxSize": 9128312873
-  },
-  "formatter": {
-    "enabled": true,
-    "indentWidth": 2,
-    "lineEnding": "lf",
-    "formatWithErrors": true,
-    "lineWidth": 120,
-    "indentStyle": "space",
-    "ignore": [
-      "node_modules/**",
-      "test/snapshots",
-      "test/fixtures",
-      ".next",
-      "test/js/deno",
-      "./src/deps",
-      "./src/bun.js/WebKit/**",
-      "packages/bun-polyfills",
-      "./build-*",
-      "./build",
-      ".cache",
-      "out/",
-      "test/transpiler/property-non-ascii-fixture.js",
-      "test/transpiler/macro-test.test.ts",
-      "test/transpiler/decorator-metadata.test.ts",
-      "src/react-refresh.js",
-      "bindings-obj/*",
-      "src/deps/**",
-      "./bench/react-hello-world/react-hello-world.node.js",
-      "./test/cli/run/require-cache-bug-leak-fixture-large-ast.js",
-      "./test/cli/run/esm-leak-fixture-large-ast.mjs"
-    ]
-  }
-}

build.zig

@@ -1,7 +1,7 @@
 const std = @import("std");
 const pathRel = std.fs.path.relative;
 const builtin = @import("builtin");
-const Wyhash = @import("./src/wyhash.zig").Wyhash;
+const Wyhash11 = @import("./src/wyhash.zig").Wyhash11;
 
 const zig_version = builtin.zig_version;
 
@@ -84,7 +84,7 @@ const BunBuildOptions = struct {
     pub fn updateRuntime(this: *BunBuildOptions) anyerror!void {
         if (std.fs.cwd().openFile("src/runtime.out.js", .{ .mode = .read_only })) |file| {
             defer file.close();
-            const runtime_hash = Wyhash.hash(
+            const runtime_hash = Wyhash11.hash(
                 0,
                 try file.readToEndAlloc(std.heap.page_allocator, try file.getEndPos()),
             );
@@ -97,7 +97,7 @@ const BunBuildOptions = struct {
 
         if (std.fs.cwd().openFile("src/fallback.out.js", .{ .mode = .read_only })) |file| {
             defer file.close();
-            const fallback_hash = Wyhash.hash(
+            const fallback_hash = Wyhash11.hash(
                 0,
                 try file.readToEndAlloc(std.heap.page_allocator, try file.getEndPos()),
             );

bunfig.toml

@@ -6,3 +6,4 @@
 #
 # Instead, we can only scan the test directory for Bun's runtime tests
 root = "test"
+preload = "./test/preload.ts"

completions/spec.yaml

@@ -2,7 +2,7 @@
 name: bun
 appspec: { version: "0.001" }
 plugins: [-Meta]
-title: A tool for installing and managing Python packages
+title: A tool for installing and managing JavaScript packages
 
 options:
   - version|V                  --Show version and exit

dockerhub/alpine/Dockerfile

@@ -96,18 +96,16 @@ FROM alpine:3.18
 ARG BUN_RUNTIME_TRANSPILER_CACHE_PATH=0
 ENV BUN_RUNTIME_TRANSPILER_CACHE_PATH=${BUN_RUNTIME_TRANSPILER_CACHE_PATH}
 
-COPY --from=build /tmp/glibc.apk /tmp/
-COPY --from=build /tmp/glibc-bin.apk /tmp/
 COPY --from=build /usr/local/bin/bun /usr/local/bin/
 COPY docker-entrypoint.sh /usr/local/bin/
 
-RUN addgroup -g 1000 bun \
+# Temporarily use the `build`-stage /tmp folder to access the glibc APKs:
+RUN --mount=type=bind,from=build,source=/tmp,target=/tmp \
+    addgroup -g 1000 bun \
     && adduser -u 1000 -G bun -s /bin/sh -D bun \
     && apk --no-cache --force-overwrite --allow-untrusted add \
       /tmp/glibc.apk \
       /tmp/glibc-bin.apk \
-    && rm /tmp/glibc.apk \
-    && rm /tmp/glibc-bin.apk \
     && ln -s /usr/local/bin/bun /usr/local/bin/bunx \
     && which bun \
     && which bunx \

docs/api/binary-data.md

@@ -65,19 +65,19 @@ Below we create a new `DataView` and set the first byte to 5.
 
 ```ts
 const buf = new ArrayBuffer(4);
-// [0x0, 0x0, 0x0, 0x0]
+// [0b00000000, 0b00000000, 0b00000000, 0b00000000]
 
 const dv = new DataView(buf);
 dv.setUint8(0, 3); // write value 3 at byte offset 0
 dv.getUint8(0); // => 3
-// [0x11, 0x0, 0x0, 0x0]
+// [0b00000011, 0b00000000, 0b00000000, 0b00000000]
 ```
 
 Now let's write a `Uint16` at byte offset `1`. This requires two bytes. We're using the value `513`, which is `2 * 256 + 1`; in bytes, that's `00000010 00000001`.
 
 ```ts
 dv.setUint16(1, 513);
-// [0x11, 0x10, 0x1, 0x0]
+// [0b00000011, 0b00000010, 0b00000001, 0b00000000]
 
 console.log(dv.getUint16(1)); // => 513
 ```

docs/api/ffi.md

@@ -58,17 +58,18 @@ Pass a path to the shared library and a map of symbols to import into `dlopen`:
 
 ```ts
 import { dlopen, FFIType, suffix } from "bun:ffi";
+const { i32 } = FFIType;
 
 const path = `libadd.${suffix}`;
 
 const lib = dlopen(path, {
   add: {
-    args: [FFIType.i32, FFIType.i32],
-    returns: FFIType.i32,
+    args: [i32, i32],
+    returns: i32,
   },
 });
 
-lib.symbols.add(1, 2);
+console.log(lib.symbols.add(1, 2));
 ```
 
 ### Rust
@@ -76,7 +77,7 @@ lib.symbols.add(1, 2);
 ```rust
 // add.rs
 #[no_mangle]
-pub extern "C" fn add(a: isize, b: isize) -> isize {
+pub extern "C" fn add(a: i32, b: i32) -> i32 {
     a + b
 }
 ```
@@ -87,6 +88,22 @@ To compile:
 $ rustc --crate-type cdylib add.rs
 ```
 
+### C++
+
+```c
+#include <cstdint>
+
+extern "C" int32_t add(int32_t a, int32_t b) {
+    return a + b;
+}
+```
+
+To compile:
+
+```bash
+$ zig build-lib add.cpp -dynamic -lc -lc++
+```
+
 ## FFI types
 
 The following `FFIType` values are supported.

docs/api/glob.md

@@ -7,7 +7,7 @@ Bun includes a fast native implementation of file globbing.
 ```ts
 import { Glob } from "bun";
 
-const glob = new Glob("*.ts");
+const glob = new Glob("**/*.ts");
 
 // Scans the current working directory and each of its sub-directories recursively
 for await (const file of glob.scan(".")) {

docs/api/streams.md

@@ -56,6 +56,45 @@ const stream = new ReadableStream({
 
 When using a direct `ReadableStream`, all chunk queueing is handled by the destination. The consumer of the stream receives exactly what is passed to `controller.write()`, without any encoding or modification.
 
+## Async generator streams
+
+Bun also supports async generator functions as a source for `Response` and `Request`. This is an easy way to create a `ReadableStream` that fetches data from an asynchronous source.
+
+```ts
+const response = new Response(async function* () {
+  yield "hello";
+  yield "world";
+}());
+
+await response.text(); // "helloworld"
+```
+
+You can also use `[Symbol.asyncIterator]` directly.
+
+```ts
+const response = new Response({
+  [Symbol.asyncIterator]: async function* () {
+    yield "hello";
+    yield "world";
+  },
+});
+
+await response.text(); // "helloworld"
+```
+
+If you need more granular control over the stream, `yield` will return the direct ReadableStream controller.
+
+```ts
+const response = new Response({
+  [Symbol.asyncIterator]: async function* () {
+    const controller = yield "hello";
+    await controller.end();
+  },
+});
+
+await response.text(); // "hello"
+```
+
 ## `Bun.ArrayBufferSink`
 
 The `Bun.ArrayBufferSink` class is a fast incremental writer for constructing an `ArrayBuffer` of unknown size.

docs/api/tcp.md

@@ -115,7 +115,7 @@ Use `Bun.connect` to connect to a TCP server. Specify the server to connect to w
 
 ```ts
 // The client
-const socket = Bun.connect({
+const socket = await Bun.connect({
   hostname: "localhost",
   port: 8080,
 
@@ -138,7 +138,7 @@ To require TLS, specify `tls: true`.
 
 ```ts
 // The client
-const socket = Bun.connect({
+const socket = await Bun.connect({
   // ... config
   tls: true,
 });
@@ -164,7 +164,7 @@ server.reload({
 ```
 
 ```ts#Client
-const socket = Bun.connect({ /* config */ })
+const socket = await Bun.connect({ /* config */ })
 socket.reload({
   data(){
     // new 'data' handler

docs/api/transpiler.md

@@ -50,7 +50,7 @@ export default jsx(
 To override the default loader specified in the `new Bun.Transpiler()` constructor, pass a second argument to `.transformSync()`.
 
 ```ts
-await transpiler.transform("<div>hi!</div>", "tsx");
+transpiler.transformSync("<div>hi!</div>", "tsx");
 ```
 
 {% details summary="Nitty gritty" %}

docs/api/utils.md

@@ -261,13 +261,12 @@ This function is optimized for large input. On an M1X, it processes 480 MB/s -
 20 GB/s, depending on how much data is being escaped and whether there is non-ascii
 text. Non-string types will be converted to a string before escaping.
 
-## `Bun.stringWidth()`
+## `Bun.stringWidth()` ~6,756x faster `string-width` alternative
 
-```ts
-Bun.stringWidth(input: string, options?: { countAnsiEscapeCodes?: boolean = false }): number
-```
+Get the column count of a string as it would be displayed in a terminal.
+Supports ANSI escape codes, emoji, and wide characters.
 
-Returns the number of columns required to display a string. This is useful for aligning text in a terminal. By default, ANSI escape codes are removed before measuring the string. To include them, pass `{ countAnsiEscapeCodes: true }` as the second argument.
+Example usage:
 
 ```ts
 Bun.stringWidth("hello"); // => 5
@@ -275,8 +274,131 @@ Bun.stringWidth("\u001b[31mhello\u001b[0m"); // => 5
 Bun.stringWidth("\u001b[31mhello\u001b[0m", { countAnsiEscapeCodes: true }); // => 12
 ```
 
-Compared with the popular `string-width` npm package, `bun`'s implementation is > [100x faster](https://github.com/oven-sh/bun/blob/8abd1fb088bcf2e78bd5d0d65ba4526872d2ab61/bench/snippets/string-width.mjs#L22)
+This is useful for:
+- Aligning text in a terminal
+- Quickly checking if a string contains ANSI escape codes
+- Measuring the width of a string in a terminal
 
+This API is designed to match the popular "string-width" package, so that
+existing code can be easily ported to Bun and vice versa.
+
+[In this benchmark](https://github.com/oven-sh/bun/blob/5147c0ba7379d85d4d1ed0714b84d6544af917eb/bench/snippets/string-width.mjs#L13), `Bun.stringWidth` is a ~6,756x faster than the `string-width` npm package for input larger than about 500 characters. Big thanks to [sindresorhus](https://github.com/sindresorhus) for their work on `string-width`!
+
+```ts
+❯ bun string-width.mjs
+cpu: 13th Gen Intel(R) Core(TM) i9-13900
+runtime: bun 1.0.29 (x64-linux)
+
+benchmark                                          time (avg)             (min … max)       p75       p99      p995
+------------------------------------------------------------------------------------- -----------------------------
+Bun.stringWidth     500 chars ascii              37.09 ns/iter   (36.77 ns … 41.11 ns)  37.07 ns  38.84 ns  38.99 ns
+
+❯ node string-width.mjs
+
+benchmark                                          time (avg)             (min … max)       p75       p99      p995
+------------------------------------------------------------------------------------- -----------------------------
+npm/string-width    500 chars ascii             249,710 ns/iter (239,970 ns … 293,180 ns) 250,930 ns  276,700 ns 281,450 ns
+```
+
+To make `Bun.stringWidth` fast, we've implemented it in Zig using optimized SIMD instructions, accounting for Latin1, UTF-16, and UTF-8 encodings. It passes `string-width`'s tests.
+
+{% details summary="View full benchmark" %}
+
+As a reminder, 1 nanosecond (ns) is 1 billionth of a second. Here's a quick reference for converting between units:
+
+| Unit | 1 Millisecond |
+| ---- | ------------- |
+| ns   | 1,000,000     |
+| µs   | 1,000         |
+| ms   | 1             |
+
+```js
+❯ bun string-width.mjs
+cpu: 13th Gen Intel(R) Core(TM) i9-13900
+runtime: bun 1.0.29 (x64-linux)
+
+benchmark                                          time (avg)             (min … max)       p75       p99      p995
+------------------------------------------------------------------------------------- -----------------------------
+Bun.stringWidth      5 chars ascii              16.45 ns/iter   (16.27 ns … 19.71 ns)  16.48 ns  16.93 ns  17.21 ns
+Bun.stringWidth     50 chars ascii              19.42 ns/iter   (18.61 ns … 27.85 ns)  19.35 ns   21.7 ns  22.31 ns
+Bun.stringWidth    500 chars ascii              37.09 ns/iter   (36.77 ns … 41.11 ns)  37.07 ns  38.84 ns  38.99 ns
+Bun.stringWidth  5,000 chars ascii              216.9 ns/iter  (215.8 ns … 228.54 ns) 216.23 ns 228.52 ns 228.53 ns
+Bun.stringWidth 25,000 chars ascii               1.01 µs/iter     (1.01 µs … 1.01 µs)   1.01 µs   1.01 µs   1.01 µs
+Bun.stringWidth      7 chars ascii+emoji         54.2 ns/iter   (53.36 ns … 58.19 ns)  54.23 ns  57.55 ns  57.94 ns
+Bun.stringWidth     70 chars ascii+emoji       354.26 ns/iter (350.51 ns … 363.96 ns) 355.93 ns 363.11 ns 363.96 ns
+Bun.stringWidth    700 chars ascii+emoji          3.3 µs/iter      (3.27 µs … 3.4 µs)    3.3 µs    3.4 µs    3.4 µs
+Bun.stringWidth  7,000 chars ascii+emoji        32.69 µs/iter   (32.22 µs … 45.27 µs)   32.7 µs  34.57 µs  34.68 µs
+Bun.stringWidth 35,000 chars ascii+emoji       163.35 µs/iter (161.17 µs … 170.79 µs) 163.82 µs 169.66 µs 169.93 µs
+Bun.stringWidth      8 chars ansi+emoji         66.15 ns/iter   (65.17 ns … 69.97 ns)  66.12 ns   69.8 ns  69.87 ns
+Bun.stringWidth     80 chars ansi+emoji        492.95 ns/iter  (488.05 ns … 499.5 ns)  494.8 ns 498.58 ns  499.5 ns
+Bun.stringWidth    800 chars ansi+emoji          4.73 µs/iter     (4.71 µs … 4.88 µs)   4.72 µs   4.88 µs   4.88 µs
+Bun.stringWidth  8,000 chars ansi+emoji         47.02 µs/iter   (46.37 µs … 67.44 µs)  46.96 µs  49.57 µs  49.63 µs
+Bun.stringWidth 40,000 chars ansi+emoji        234.45 µs/iter (231.78 µs … 240.98 µs) 234.92 µs 236.34 µs 236.62 µs
+Bun.stringWidth     19 chars ansi+emoji+ascii  135.46 ns/iter (133.67 ns … 143.26 ns) 135.32 ns 142.55 ns 142.77 ns
+Bun.stringWidth    190 chars ansi+emoji+ascii    1.17 µs/iter     (1.16 µs … 1.17 µs)   1.17 µs   1.17 µs   1.17 µs
+Bun.stringWidth  1,900 chars ansi+emoji+ascii   11.45 µs/iter   (11.26 µs … 20.41 µs)  11.45 µs  12.08 µs  12.11 µs
+Bun.stringWidth 19,000 chars ansi+emoji+ascii  114.06 µs/iter (112.86 µs … 120.06 µs) 114.25 µs 115.86 µs 116.15 µs
+Bun.stringWidth 95,000 chars ansi+emoji+ascii  572.69 µs/iter (565.52 µs … 607.22 µs) 572.45 µs 604.86 µs 605.21 µs
+```
+
+```ts
+❯ node string-width.mjs
+cpu: 13th Gen Intel(R) Core(TM) i9-13900
+runtime: node v21.4.0 (x64-linux)
+
+benchmark                                           time (avg)             (min … max)       p75       p99      p995
+-------------------------------------------------------------------------------------- -----------------------------
+npm/string-width      5 chars ascii               3.19 µs/iter     (3.13 µs … 3.48 µs)   3.25 µs   3.48 µs   3.48 µs
+npm/string-width     50 chars ascii              20.09 µs/iter  (18.93 µs … 435.06 µs)  19.49 µs  21.89 µs  22.59 µs
+npm/string-width    500 chars ascii             249.71 µs/iter (239.97 µs … 293.18 µs) 250.93 µs  276.7 µs 281.45 µs
+npm/string-width  5,000 chars ascii               6.69 ms/iter     (6.58 ms … 6.76 ms)   6.72 ms   6.76 ms   6.76 ms
+npm/string-width 25,000 chars ascii             139.57 ms/iter (137.17 ms … 143.28 ms) 140.49 ms 143.28 ms 143.28 ms
+npm/string-width      7 chars ascii+emoji          3.7 µs/iter     (3.62 µs … 3.94 µs)   3.73 µs   3.94 µs   3.94 µs
+npm/string-width     70 chars ascii+emoji        23.93 µs/iter   (22.44 µs … 331.2 µs)  23.15 µs  25.98 µs   30.2 µs
+npm/string-width    700 chars ascii+emoji       251.65 µs/iter (237.78 µs … 444.69 µs) 252.92 µs 325.89 µs 354.08 µs
+npm/string-width  7,000 chars ascii+emoji         4.95 ms/iter     (4.82 ms … 5.19 ms)      5 ms   5.04 ms   5.19 ms
+npm/string-width 35,000 chars ascii+emoji        96.93 ms/iter  (94.39 ms … 102.58 ms)  97.68 ms 102.58 ms 102.58 ms
+npm/string-width      8 chars ansi+emoji          3.92 µs/iter     (3.45 µs … 4.57 µs)   4.09 µs   4.57 µs   4.57 µs
+npm/string-width     80 chars ansi+emoji         24.46 µs/iter     (22.87 µs … 4.2 ms)  23.54 µs  25.89 µs  27.41 µs
+npm/string-width    800 chars ansi+emoji        259.62 µs/iter (246.76 µs … 480.12 µs) 258.65 µs 349.84 µs 372.55 µs
+npm/string-width  8,000 chars ansi+emoji          5.46 ms/iter     (5.41 ms … 5.57 ms)   5.48 ms   5.55 ms   5.57 ms
+npm/string-width 40,000 chars ansi+emoji        108.91 ms/iter  (107.55 ms … 109.5 ms) 109.25 ms  109.5 ms  109.5 ms
+npm/string-width     19 chars ansi+emoji+ascii    6.53 µs/iter     (6.35 µs … 6.75 µs)   6.54 µs   6.75 µs   6.75 µs
+npm/string-width    190 chars ansi+emoji+ascii   55.52 µs/iter  (52.59 µs … 352.73 µs)  54.19 µs  80.77 µs 167.21 µs
+npm/string-width  1,900 chars ansi+emoji+ascii  701.71 µs/iter (653.94 µs … 893.78 µs)  715.3 µs 855.37 µs  872.9 µs
+npm/string-width 19,000 chars ansi+emoji+ascii   27.19 ms/iter   (26.89 ms … 27.41 ms)  27.28 ms  27.41 ms  27.41 ms
+npm/string-width 95,000 chars ansi+emoji+ascii     3.68 s/iter        (3.66 s … 3.7 s)    3.69 s     3.7 s     3.7 s
+```
+
+{% /details %}
+
+
+TypeScript definition:
+
+```ts
+namespace Bun {
+  export function stringWidth(
+    /**
+     * The string to measure
+     */
+    input: string,
+    options?: {
+      /**
+       * If `true`, count ANSI escape codes as part of the string width. If `false`, ANSI escape codes are ignored when calculating the string width.
+       *
+       * @default false
+       */
+      countAnsiEscapeCodes?: boolean;
+      /**
+       * When it's ambiugous and `true`, count emoji as 1 characters wide. If `false`, emoji are counted as 2 character wide.
+       *
+       * @default true
+       */
+      ambiguousIsNarrow?: boolean;
+    },
+  ): number;
+}
+```
 
 
 <!-- ## `Bun.enableANSIColors()` -->

docs/api/websockets.md

@@ -182,12 +182,12 @@ const server = Bun.serve<{ username: string }>({
     open(ws) {
       const msg = `${ws.data.username} has entered the chat`;
       ws.subscribe("the-group-chat");
-      ws.publish("the-group-chat", msg);
+      server.publish("the-group-chat", msg);
     },
     message(ws, message) {
       // this is a group chat
       // so the server re-broadcasts incoming message to everyone
-      ws.publish("the-group-chat", `${ws.data.username}: ${message}`);
+      server.publish("the-group-chat", `${ws.data.username}: ${message}`);
     },
     close(ws) {
       const msg = `${ws.data.username} has left the chat`;

docs/bundler/executables.md

@@ -26,12 +26,31 @@ All imported files and packages are bundled into the executable, along with a co
 **Note** — Currently, the `--compile` flag can only accept a single entrypoint at a time and does not support the following flags:
 
 - `--outdir` — use `outfile` instead.
-- `--external`
 - `--splitting`
 - `--public-path`
 
 {% /callout %}
 
+## Deploying to production
+
+Compiled executables reduce memory usage and improve Bun's start time.
+
+Normally, Bun reads and transpiles JavaScript and TypeScript files on `import` and `require`. This is part of what makes so much of Bun "just work", but it's not free. It costs time and memory to read files from disk, resolve file paths, parse, transpile, and print source code. 
+
+With compiled executables, you can move that cost from runtime to build-time.
+
+When deploying to production, we recommend the following:
+
+```sh
+bun build --compile --minify --sourcemap ./path/to/my/app.ts --outfile myapp
+```
+
+**What do these flags do?**
+
+The `--minify` argument optimizes the size of the transpiled output code. If you have a large application, this can save megabytes of space. For smaller applications, it might still improve start time a little.
+
+The `--sourcemap` argument embeds a sourcemap compressed with zstd, so that errors & stacktraces point to their original locations instead of the transpiled location. Bun will automatically decompress & resolve the sourcemap when an error occurs.
+
 ## SQLite
 
 You can use `bun:sqlite` imports with `bun build --compile`.

docs/bundler/index.md

@@ -43,7 +43,7 @@ Let's build our first bundle. You have the following two files, which implement
 import * as ReactDOM from 'react-dom/client';
 import {Component} from "./Component"
 
-const root = ReactDOM.createRoot(document.getElementById('root'));
+const root = ReactDOM.createRoot(document.getElementById('root')!);
 root.render(<Component message="Sup!" />)
 ```
 

docs/bundler/vs-esbuild.md

@@ -7,7 +7,7 @@ There are a few behavioral differences to note.
 
 ## Performance
 
-With an performance-minded API coupled with the extensively optimized Zig-based JS/TS parser, Bun's bundler is 1.75x faster than esbuild on esbuild's [three.js benchmark](https://github.com/oven-sh/bun/tree/main/bench/bundle).
+With a performance-minded API coupled with the extensively optimized Zig-based JS/TS parser, Bun's bundler is 1.75x faster than esbuild on esbuild's [three.js benchmark](https://github.com/oven-sh/bun/tree/main/bench/bundle).
 
 {% image src="/images/bundler-speed.png" caption="Bundling 10 copies of three.js from scratch, with sourcemaps and minification" /%}
 

docs/cli/install.md

@@ -195,7 +195,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repo
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Install bun
         uses: oven-sh/setup-bun@v1
       - name: Install dependencies

docs/cli/run.md

@@ -75,14 +75,6 @@ $ bun run dev --watch # ❌ don't do this
 Flags that occur at the end of the command will be ignored and passed through to the `"dev"` script itself.
 {% /callout %}
 
-### `--smol`
-
-In memory-constrained environments, use the `--smol` flag to reduce memory usage at a cost to performance.
-
-```bash
-$ bun --smol run index.tsx
-```
-
 ## Run a `package.json` script
 
 {% note %}
@@ -95,7 +87,7 @@ $ bun [bun flags] run <script> [script flags]
 
 Your `package.json` can define a number of named `"scripts"` that correspond to shell commands.
 
-```jsonc
+```json
 {
   // ... other fields
   "scripts": {
@@ -158,3 +150,32 @@ By default, Bun respects this shebang and executes the script with `node`. Howev
 ```bash
 $ bun run --bun vite
 ```
+
+## `bun run -` to pipe code from stdin
+
+`bun run -` lets you read JavaScript, TypeScript, TSX, or JSX from stdin and execute it without writing to a temporary file first.
+
+```bash
+$ echo "console.log('Hello')" | bun run -
+Hello
+```
+
+You can also use `bun run -` to redirect files into Bun. For example, to run a `.js` file as if it were a `.ts` file:
+
+```bash
+$ echo "console.log!('This is TypeScript!' as any)" > secretly-typescript.js
+$ bun run - < secretly-typescript.js
+This is TypeScript!
+```
+
+For convenience, all code is treated as TypeScript with JSX support when using `bun run -`.
+
+## `bun run --smol`
+
+In memory-constrained environments, use the `--smol` flag to reduce memory usage at a cost to performance.
+
+```bash
+$ bun --smol run index.tsx
+```
+
+This causes the garbage collector to run more frequently, which can slow down execution. However, it can be useful in environments with limited memory. Bun automatically adjusts the garbage collector's heap size based on the available memory (accounting for cgroups and other memory limits) with and without the `--smol` flag, so this is mostly useful for cases where you want to make the heap size grow more slowly.

docs/cli/test.md

@@ -113,10 +113,6 @@ See [Test > Lifecycle](/docs/test/lifecycle) for complete documentation.
 
 ## Mocks
 
-{% callout %}
-Module mocking (`jest.mock()`) is not yet supported. Track support for it [here](https://github.com/oven-sh/bun/issues/5394).
-{% /callout %}
-
 Create mock functions with the `mock` function. Mocks are automatically reset between tests.
 
 ```ts

docs/guides/http/fetch-unix.md

@@ -0,0 +1,33 @@
+---
+name: fetch with unix domain sockets in Bun
+---
+
+In Bun, the `unix` option in `fetch()` lets you send HTTP requests over a [unix domain socket](https://en.wikipedia.org/wiki/Unix_domain_socket).
+
+```ts
+const unix = "/var/run/docker.sock";
+
+const response = await fetch("http://localhost/info", { unix });
+
+const body = await response.json();
+console.log(body); // { ... }
+```
+
+---
+
+The `unix` option is a string that specifies the local file path to a unix domain socket. The `fetch()` function will use the socket to send the request to the server instead of using a TCP network connection. `https` is also supported by using the `https://` protocol in the URL instead of `http://`.
+
+To send a `POST` request to an API endpoint over a unix domain socket:
+
+```ts
+const response = await fetch("https://hostname/a/path", {
+  unix: "/var/run/path/to/unix.sock",
+  method: "POST",
+  body: JSON.stringify({ message: "Hello from Bun!" }),
+  headers: {
+    "Content-Type": "application/json",
+  },
+});
+
+const body = await response.json();
+```

docs/guides/http/server.md

@@ -0,0 +1,46 @@
+---
+name: Common HTTP server usage
+---
+
+This starts an HTTP server listening on port `3000`. It demonstrates basic routing with a number of common responses and also handles POST data from standard forms or as JSON.
+
+See [`Bun.serve`](/docs/api/http) for details.
+
+```ts
+const server = Bun.serve({
+  async fetch (req) {
+    const path = new URL(req.url).pathname;
+
+    // respond with text/html
+    if (path === "/") return new Response("Welcome to Bun!");
+
+    // redirect
+    if (path === "/abc") return Response.redirect("/source", 301);
+
+    // send back a file (in this case, *this* file)
+    if (path === "/source") return new Response(Bun.file(import.meta.file));
+
+    // respond with JSON
+    if (path === "/api") return Response.json({ some: "buns", for: "you" });
+
+    // receive JSON data to a POST request
+    if (req.method === "POST" && path === "/api/post") {
+      const data = await req.json();
+      console.log("Received JSON:", data);
+      return Response.json({ success: true, data });
+    }
+
+    // receive POST data from a form
+    if (req.method === "POST" && path === "/form") {
+      const data = await req.formData();
+      console.log(data.get("someField"));
+      return new Response("Success");
+    }
+
+    // 404s
+    return new Response("Page not found", { status: 404 });
+  }
+})
+
+console.log(`Listening on ${server.url}`);
+```

docs/guides/runtime/cicd.md

@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       # ...
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 +     - uses: oven-sh/setup-bun@v1
 
       # run any `bun` or `bunx` command

docs/guides/runtime/shell.md

@@ -0,0 +1,40 @@
+---
+name: Run a Shell Command
+---
+
+Bun Shell is a cross-platform bash-like shell built in to Bun.
+
+It provides a simple way to run shell commands in JavaScript and TypeScript. To get started, import the `$` function from the `bun` package and use it to run shell commands.
+
+```ts#foo.ts
+import { $ } from "bun";
+
+await $`echo Hello, world!`; // => "Hello, world!"
+```
+
+---
+
+The `$` function is a tagged template literal that runs the command and returns a promise that resolves with the command's output.
+
+```ts#foo.ts
+import { $ } from "bun";
+
+const output = await $`ls -l`.text();
+console.log(output);
+```
+
+---
+
+To get each line of the output as an array, use the `lines` method.
+
+```ts#foo.ts
+import { $ } from "bun";
+
+for await (const line of $`ls -l`.lines()) {
+  console.log(line);
+}
+```
+
+---
+
+See [Docs > API > Shell](/docs/runtime/shell) for complete documentation.

docs/guides/runtime/typescript.md

@@ -15,13 +15,13 @@ Below is the full set of recommended `compilerOptions` for a Bun project. With t
 ```jsonc
 {
   "compilerOptions": {
-    // enable latest features
-    "lib": ["ESNext"],
+    // Enable latest features
+    "lib": ["ESNext","DOM"],
     "target": "ESNext",
     "module": "ESNext",
     "moduleDetection": "force",
-    "jsx": "react-jsx", // support JSX
-    "allowJs": true, // allow importing `.js` from `.ts`
+    "jsx": "react-jsx",
+    "allowJs": true,
 
     // Bundler mode
     "moduleResolution": "bundler",
@@ -32,12 +32,11 @@ Below is the full set of recommended `compilerOptions` for a Bun project. With t
     // Best practices
     "strict": true,
     "skipLibCheck": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
     "noFallthroughCasesInSwitch": true,
 
     // Some stricter flags
-    "useUnknownInCatchVariables": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
     "noPropertyAccessFromIndexSignature": true
   }
 }

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

@@ -93,7 +93,7 @@ $ bun test --timeout 10000
 
 Many other flags become irrelevant or obsolete when using `bun test`.
 
-- `transform` — Buns supports TypeScript & JSX. Other file types can be configured with [Plugins](/docs/runtime/plugins).
+- `transform` — Bun supports TypeScript & JSX. Other file types can be configured with [Plugins](/docs/runtime/plugins).
 - `extensionsToTreatAsEsm`
 - `haste` — Bun uses it's own internal source maps
 - `watchman`, `watchPlugins`, `watchPathIgnorePatterns` — use `--watch` to run tests in watch mode

docs/guides/util/which-path-to-executable-bin.md

@@ -0,0 +1,15 @@
+---
+name: Get the path to an executable bin file
+---
+
+`Bun.which` is a utility function to find the absolute path of an executable file. It is similar to the `which` command in Unix-like systems.
+
+```ts#foo.ts
+Bun.which("sh"); // => "/bin/sh"
+Bun.which("notfound"); // => null
+Bun.which("bun"); // => "/home/user/.bun/bin/bun"
+```
+
+---
+
+See [Docs > API > Utils](/docs/api/utils#bun-which) for complete documentation.

docs/guides/websocket/pubsub.md

@@ -20,11 +20,11 @@ const server = Bun.serve<{ username: string }>({
     open(ws) {
       const msg = `${ws.data.username} has entered the chat`;
       ws.subscribe("the-group-chat");
-      ws.publish("the-group-chat", msg);
+      server.publish("the-group-chat", msg);
     },
     message(ws, message) {
       // the server re-broadcasts incoming messages to everyone
-      ws.publish("the-group-chat", `${ws.data.username}: ${message}`);
+      server.publish("the-group-chat", `${ws.data.username}: ${message}`);
     },
     close(ws) {
       const msg = `${ws.data.username} has left the chat`;

docs/guides/websocket/upgrade.md

@@ -1,28 +0,0 @@
----
-name: Upgrade an HTTP request to a WebSocket connection
----
-
-Inside `fetch`, use the `server.upgrade()` function to upgrade an incoming `Request` to a WebSocket connection. Bun automatically returns a 101 Switching Protocols response if the upgrade succeeds.
-
-Refer to the [WebSocket docs](/docs/api/websockets) for more information on building WebSocket servers.
-
-```ts
-const server = Bun.serve<{ authToken: string }>({
-  fetch(req, server) {
-    const success = server.upgrade(req);
-    if (success) {
-      // Bun automatically returns a 101 Switching Protocols
-      // if the upgrade succeeds
-      return undefined;
-    }
-
-    // handle HTTP request normally
-    return new Response("Hello world!");
-  },
-  websocket: {
-    // define websocket handlers
-  },
-});
-
-console.log(`Listening on localhost:\${server.port}`);
-```

docs/index.md

@@ -1,4 +1,4 @@
-Bun is an all-in-one toolkit for JavaScript and TypeScript apps. It ships as a single executable called `bun​`.
+Bun is an all-in-one toolkit for JavaScript and TypeScript apps. It ships as a single executable called `bun`.
 
 At its core is the _Bun runtime_, a fast JavaScript runtime designed as a drop-in replacement for Node.js. It's written in Zig and powered by JavaScriptCore under the hood, dramatically reducing startup times and memory usage.
 
@@ -6,18 +6,18 @@ At its core is the _Bun runtime_, a fast JavaScript runtime designed as a drop-i
 $ bun run index.tsx  # TS and JSX supported out of the box
 ```
 
-​​The `bun​` command-line tool also implements a test runner, script runner, and Node.js-compatible package manager, all significantly faster than existing tools and usable in existing Node.js projects with little to no changes necessary.
+The `bun` command-line tool also implements a test runner, script runner, and Node.js-compatible package manager, all significantly faster than existing tools and usable in existing Node.js projects with little to no changes necessary.
 
 ```bash
 $ bun run start                 # run the `start` script
-$ bun install <pkg>​             # install a package
+$ bun install <pkg>             # install a package
 $ bun build ./index.tsx         # bundle a project for browsers
 $ bun test                      # run tests
 $ bunx cowsay 'Hello, world!'   # execute a package
 ```
 
 {% callout type="note" %}
-**​​Bun is still under development.** Use it to speed up your development workflows or run simpler production code in resource-constrained environments like serverless functions. We're working on more complete Node.js compatibility and integration with existing frameworks. Join the [Discord](https://bun.sh/discord) and watch the [GitHub repository](https://github.com/oven-sh/bun) to keep tabs on future releases.
+**Bun is still under development.** Use it to speed up your development workflows or run simpler production code in resource-constrained environments like serverless functions. We're working on more complete Node.js compatibility and integration with existing frameworks. Join the [Discord](https://bun.sh/discord) and watch the [GitHub repository](https://github.com/oven-sh/bun) to keep tabs on future releases.
 {% /callout %}
 
 Get started with one of the quick links below, or read on to learn more about Bun.

docs/install/cache.md

@@ -1,6 +1,6 @@
 All packages downloaded from the registry are stored in a global cache at `~/.bun/install/cache`. They are stored in subdirectories named like `${name}@${version}`, so multiple versions of a package can be cached.
 
-{% details summary="Configuring cache behavior" %}
+{% details summary="Configuring cache behavior" (bunfig.toml) %}
 
 ```toml
 [install.cache]

docs/installation.md

@@ -22,8 +22,7 @@ $ npm install -g bun # the last `npm` command you'll ever need
 ```
 
 ```bash#Homebrew
-$ brew tap oven-sh/bun # for macOS and Linux
-$ brew install bun
+$ brew install oven-sh/bun/bun # for macOS and Linux
 ```
 
 ```bash#Docker
@@ -233,6 +232,10 @@ If you need to remove Bun from your system, use the following commands.
 $ rm -rf ~/.bun # for macOS, Linux, and WSL
 ```
 
+```powershell#Windows
+powershell -c ~\.bun\uninstall.ps1
+```
+
 ```bash#NPM
 $ npm uninstall -g bun
 ```

docs/project/building-windows.md

@@ -1,6 +1,6 @@
 This document describes the build process for Windows. If you run into problems, please join the [#windows channel on our Discord](http://bun.sh/discord) for help.
 
-It is strongly recommended to use [PowerShell 7 (pwsh.exe)](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.4) instead of the default `powershell.exe`.
+It is strongly recommended to use [PowerShell 7 (`pwsh.exe`)](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.4) instead of the default `powershell.exe`.
 
 ## Prerequisites
 
@@ -44,6 +44,12 @@ Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted
 
 ### System Dependencies
 
+- Bun 1.1 or later. We use Bun to run it's own code generators.
+
+```ps1
+irm bun.sh/install.ps1 | iex
+```
+
 - [Visual Studio](https://visualstudio.microsoft.com) with the "Desktop Development with C++" workload.
   - Install Git and CMake from this installer, if not already installed.
 
@@ -57,16 +63,20 @@ After Visual Studio, you need the following:
 - Ruby
 - Node.js
 
-[Scoop](https://scoop.sh) can be used to install these easily:
+{% callout %}
+The Zig compiler is automatically downloaded, installed, and updated by the building process.
+{% /callout %}
+
+[Scoop](https://scoop.sh) can be used to install these remaining tools easily:
 
 ```ps1
-Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
+irm https://get.scoop.sh | iex
 
 scoop install nodejs-lts go rust nasm ruby perl
 scoop llvm@16.0.4 # scoop bug if you install llvm and the rest at the same time
 ```
 
-If you intend on building WebKit locally (optional), you should install some more packages:
+If you intend on building WebKit locally (optional), you should install these packages:
 
 ```ps1
 scoop install make cygwin python
@@ -88,65 +98,51 @@ Get-Command mt
 It is not recommended to install `ninja` / `cmake` into your global path, because you may run into a situation where you try to build bun without .\scripts\env.ps1 sourced.
 {% /callout %}
 
-### Codegen
-
-On Unix platforms, we depend on an existing build of Bun to generate code for itself. Since the Windows build is not stable enough for this to run the code generators, you currently need to use another computer or WSL to generate this:
-
-```bash
-$ wsl --install # run twice if it doesnt install
-# in the linux environment
-$ sudo apt install unzip
-$ curl -fsSL https://bun.sh/install | bash
-```
-
-Whenever codegen-related things are updated, please re-run
-
-```ps1
-$ .\scripts\codegen.ps1
-```
-
-(TODO: it probably is stable enough to use `bun.exe` for codegen, but the CMake configuration still has these disabled by default)
-
 ## Building
 
 ```ps1
-bun install # or npm install
+bun install
 
 .\scripts\env.ps1
 .\scripts\update-submodules.ps1 # this syncs git submodule state
-.\scripts\make-old-js.ps1 # runs some old code generators
 .\scripts\all-dependencies.ps1 # this builds all dependencies
+.\scripts\make-old-js.ps1 # runs some old code generators
 
-cd build # this was created by the codegen.ps1 script earlier
+# Configure build environment
+cmake -Bbuild -GNinja -DCMAKE_BUILD_TYPE=Debug
 
-cmake .. -G Ninja -DCMAKE_BUILD_TYPE=Debug
-ninja
+# Build bun
+ninja -Cbuild
 ```
 
 If this was successful, you should have a `bun-debug.exe` in the `build` folder.
 
 ```ps1
-.\build\bun-debug.exe --version
+.\build\bun-debug.exe --revision
 ```
 
-You should add this to `$Env:PATH`. The simplest way to do so is to open the start menu, type "Path", and then navigate the environment variables menu to add `C:\.....\bun\build` to your path.
+You should add this to `$Env:PATH`. The simplest way to do so is to open the start menu, type "Path", and then navigate the environment variables menu to add `C:\.....\bun\build` to the user environment variable `PATH`. You should then restart your editor (if it does not update still, log out and log back in).
+
+## Extra paths
+
+- WebKit is extracted to `build/bun-webkit`
+- Zig is extracted to `.cache/zig/zig.exe`
 
 ## Tests
 
-You can run the test suite by using `packages\bun-internal-test`
+You can run the test suite either using `bun test`, or by using the wrapper script `packages\bun-internal-test`. The internal test package is a wrapper cli to run every test file in a separate instance of bun.exe, to prevent a crash in the test runner from stopping the entire suite.
 
 ```ps1
 # Setup
-cd packages\bun-internal-test
-bun i
-cd ..\..
+bun i --cwd packages\bun-internal-test
 
 # Run the entire test suite with reporter
+# the package.json script "test" uses "build/bun-debug.exe" by default
 bun run test
 
 # Run an individual test file:
-bun test node\fs
-bun test "C:\bun\test\js\bun\resolve\import-meta.test.js"
+bun-debug test node\fs
+bun-debug test "C:\bun\test\js\bun\resolve\import-meta.test.js"
 ```
 
 ## Troubleshooting

docs/project/contributing.md

@@ -13,7 +13,7 @@ $ brew install automake ccache cmake coreutils gnu-sed go icu4c libiconv libtool
 ```
 
 ```bash#Ubuntu/Debian
-$ sudo apt install cargo ccache cmake git golang libtool ninja-build pkg-config rustc ruby-full xz-utils
+$ sudo apt install curl wget lsb-release software-properties-common cargo ccache cmake git golang libtool ninja-build pkg-config rustc ruby-full xz-utils
 ```
 
 ```bash#Arch
@@ -24,34 +24,31 @@ $ sudo pacman -S base-devel ccache cmake git go libiconv libtool make ninja pkg-
 $ sudo dnf install cargo ccache cmake git golang libtool ninja-build pkg-config rustc ruby libatomic-static libstdc++-static sed unzip which libicu-devel 'perl(Math::BigInt)'
 ```
 
+```bash#openSUSE Tumbleweed
+$ sudo zypper install go cmake ninja automake git rustup && rustup toolchain install stable
+```
+
 {% /codetabs %}
 
+> **Note**: The Zig compiler is automatically installed and updated by the build scripts. Manual installation is not required.
+
 Before starting, you will need to already have a release build of Bun installed, as we use our bundler to transpile and minify our code, as well as for code generation scripts.
 
 {% codetabs %}
 
 ```bash#Native
-$ curl -fsSL https://bun.sh/install | bash # for macOS, Linux, and WSL
+$ curl -fsSL https://bun.sh/install | bash
 ```
 
 ```bash#npm
-$ npm install -g bun # the last `npm` command you'll ever need
+$ npm install -g bun
 ```
 
 ```bash#Homebrew
-$ brew tap oven-sh/bun # for macOS and Linux
+$ brew tap oven-sh/bun
 $ brew install bun
 ```
 
-```bash#Docker
-$ docker pull oven/bun
-$ docker run --rm --init --ulimit memlock=-1:-1 oven/bun
-```
-
-```bash#proto
-$ proto install bun
-```
-
 {% /codetabs %}
 
 ## Install LLVM
@@ -79,6 +76,10 @@ $ sudo dnf copr enable -y @fedora-llvm-team/llvm-snapshots
 $ sudo dnf install llvm clang lld
 ```
 
+```bash#openSUSE Tumbleweed
+$ sudo zypper install clang16 lld16 llvm16
+```
+
 {% /codetabs %}
 
 If none of the above solutions apply, you will have to install it [manually](https://github.com/llvm/llvm-project/releases/tag/llvmorg-16.0.6).
@@ -105,6 +106,8 @@ $ export PATH="$PATH:/usr/lib/llvm16/bin"
 
 {% /codetabs %}
 
+> ⚠️ Ubuntu distributions may require installation of the C++ standard library independently. See the [troubleshooting section](#span-file-not-found-on-ubuntu) for more information.
+
 ## Building Bun
 
 After cloning the repository, run the following command to run the first build. This may take a while as it will clone submodules and build dependencies.
@@ -134,12 +137,14 @@ $ cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Debug
 $ ninja -C build # 'bun run build' runs just this
 ```
 
-Advanced uses can pass CMake flags to customize the build.
+Advanced users can pass CMake flags to customize the build.
 
 ## VSCode
 
 VSCode is the recommended IDE for working on Bun, as it has been configured. Once opening, you can run `Extensions: Show Recommended Extensions` to install the recommended extensions for Zig and C++. ZLS is automatically configured.
 
+If you use a different editor, make sure that you tell ZLS to use the automatically installed Zig compiler, which is located at `./.cache/zig/zig` (`zig.exe` on Windows).
+
 ## Code generation scripts
 
 {% callout %}
@@ -252,6 +257,16 @@ fatal error: 'span' file not found
          ^~~~~~
 ```
 
+The issue may manifest when initially running `bun setup` as Clang being unable to compile a simple program:
+
+```
+The C++ compiler
+
+  "/usr/bin/clang++-16"
+
+is not able to compile a simple test program.
+```
+
 To fix the error, we need to update the GCC version to 11. To do this, we'll need to check if the latest version is available in the distribution's official repositories or use a third-party repository that provides GCC 11 packages. Here are general steps:
 
 ```bash
@@ -292,8 +307,7 @@ $ xcode-select --install
 Bun defaults to linking `libatomic` statically, as not all systems have it. If you are building on a distro that does not have a static libatomic available, you can run the following command to enable dynamic linking:
 
 ```bash
-$ cmake -Bbuild -GNinja -DUSE_STATIC_LIBATOMIC=ON
-$ ninja -Cbuild
+$ bun setup -DUSE_STATIC_LIBATOMIC=OFF
 ```
 
 The built version of Bun may not work on other systems if compiled this way.

docs/quickstart.md

@@ -124,12 +124,12 @@ Update `index.ts` to use `figlet` in the `fetch` handler.
 + import figlet from "figlet";
 
   const server = Bun.serve({
-    fetch() {
+    port: 3000,
+    fetch(req) {
 +     const body = figlet.textSync("Bun!");
 +     return new Response(body);
 -     return new Response("Bun!");
     },
-    port: 3000,
   });
 ```
 

docs/runtime/bun-apis.md

@@ -30,17 +30,20 @@ Click the link in the right column to jump to the associated documentation.
 ---
 
 - File I/O
-- [`Bun.file`](/docs/api/file-io#reading-files-bun-file) [`Bun.write`](/docs/api/file-io#writing-files-bun-write)
+- [`Bun.file`](/docs/api/file-io#reading-files-bun-file)
+  [`Bun.write`](/docs/api/file-io#writing-files-bun-write)
 
 ---
 
 - Child processes
-- [`Bun.spawn`](/docs/api/spawn#spawn-a-process-bun-spawn) [`Bun.spawnSync`](/docs/api/spawn#blocking-api-bun-spawnsync)
+- [`Bun.spawn`](/docs/api/spawn#spawn-a-process-bun-spawn)
+  [`Bun.spawnSync`](/docs/api/spawn#blocking-api-bun-spawnsync)
 
 ---
 
 - TCP
-- [`Bun.listen`](/docs/api/tcp#start-a-server-bun-listen) [`Bun.connect`](/docs/api/tcp#start-a-server-bun-listen)
+- [`Bun.listen`](/docs/api/tcp#start-a-server-bun-listen)
+  [`Bun.connect`](/docs/api/tcp#start-a-server-bun-listen)
 
 ---
 
@@ -60,7 +63,8 @@ Click the link in the right column to jump to the associated documentation.
 ---
 
 - Hashing
-- [`Bun.hash`](/docs/api/hashing#bun-hash) [`Bun.CryptoHasher`](/docs/api/hashing#bun-cryptohasher)
+- [`Bun.hash`](/docs/api/hashing#bun-hash)
+  [`Bun.CryptoHasher`](/docs/api/hashing#bun-cryptohasher)
 
 ---
 
@@ -100,6 +104,26 @@ Click the link in the right column to jump to the associated documentation.
 ---
 
 - Utilities
-- [`Bun.version`](/docs/api/utils#bun-version) [`Bun.revision`](/docs/api/utils#bun-revision) [`Bun.env`](/docs/api/utils#bun-env) [`Bun.main`](/docs/api/utils#bun-main) [`Bun.sleep()`](/docs/api/utils#bun-sleep) [`Bun.sleepSync()`](/docs/api/utils#bun-sleepsync) [`Bun.which()`](/docs/api/utils#bun-which) [`Bun.peek()`](/docs/api/utils#bun-peek) [`Bun.openInEditor()`](/docs/api/utils#bun-openineditor) [`Bun.deepEquals()`](/docs/api/utils#bun-deepequals) [`Bun.escapeHTML()`](/docs/api/utils#bun-escapehtml) [`Bun.fileURLToPath()`](/docs/api/utils#bun-fileurltopath) [`Bun.pathToFileURL()`](/docs/api/utils#bun-pathtofileurl) [`Bun.gzipSync()`](/docs/api/utils#bun-gzipsync) [`Bun.gunzipSync()`](/docs/api/utils#bun-gunzipsync) [`Bun.deflateSync()`](/docs/api/utils#bun-deflatesync) [`Bun.inflateSync()`](/docs/api/utils#bun-inflatesync) [`Bun.inspect()`](/docs/api/utils#bun-inspect) [`Bun.nanoseconds()`](/docs/api/utils#bun-nanoseconds) [`Bun.readableStreamTo*()`](/docs/api/utils#bun-readablestreamto) [`Bun.resolveSync()`](/docs/api/utils#bun-resolvesync)
+- [`Bun.version`](/docs/api/utils#bun-version)
+  [`Bun.revision`](/docs/api/utils#bun-revision)
+  [`Bun.env`](/docs/api/utils#bun-env)
+  [`Bun.main`](/docs/api/utils#bun-main)
+  [`Bun.sleep()`](/docs/api/utils#bun-sleep)
+  [`Bun.sleepSync()`](/docs/api/utils#bun-sleepsync)
+  [`Bun.which()`](/docs/api/utils#bun-which)
+  [`Bun.peek()`](/docs/api/utils#bun-peek)
+  [`Bun.openInEditor()`](/docs/api/utils#bun-openineditor)
+  [`Bun.deepEquals()`](/docs/api/utils#bun-deepequals)
+  [`Bun.escapeHTML()`](/docs/api/utils#bun-escapehtml)
+  [`Bun.fileURLToPath()`](/docs/api/utils#bun-fileurltopath)
+  [`Bun.pathToFileURL()`](/docs/api/utils#bun-pathtofileurl)
+  [`Bun.gzipSync()`](/docs/api/utils#bun-gzipsync)
+  [`Bun.gunzipSync()`](/docs/api/utils#bun-gunzipsync)
+  [`Bun.deflateSync()`](/docs/api/utils#bun-deflatesync)
+  [`Bun.inflateSync()`](/docs/api/utils#bun-inflatesync)
+  [`Bun.inspect()`](/docs/api/utils#bun-inspect)
+  [`Bun.nanoseconds()`](/docs/api/utils#bun-nanoseconds)
+  [`Bun.readableStreamTo*()`](/docs/api/utils#bun-readablestreamto)
+  [`Bun.resolveSync()`](/docs/api/utils#bun-resolvesync)
 
 {% /table %}

docs/runtime/bunfig.md

@@ -298,7 +298,7 @@ Valid values are:
 ---
 
 - `"fallback"`
-- Check local `node_modules` first, the auto-install any packages that aren't found. You can enable this from the CLI with `bun -i`.
+- Check local `node_modules` first, then auto-install any packages that aren't found. You can enable this from the CLI with `bun -i`.
 
 {% /table %}
 
@@ -426,4 +426,94 @@ editor = "code"
 # - "nvim", "neovim"
 # - "vim","vi"
 # - "emacs"
-``` -->
+```
+-->
+
+## `bun run`
+
+The `bun run` command can be configured under the `[run]` section. These apply to the `bun run` command and the `bun` command when running a file or executable or script.
+
+Currently, `bunfig.toml` isn't always automatically loaded for `bun run` in a local project (it does check for a global `bunfig.toml`), so you might still need to pass `-c` or `-c=bunfig.toml` to use these settings.
+
+### `run.shell` - use the system shell or Bun's shell
+
+The shell to use when running package.json scripts via `bun run` or `bun`. On Windows, this defaults to `"bun"` and on other platforms it defaults to `"system"`.
+
+To always use the system shell instead of Bun's shell (default behavior unless Windows):
+
+```toml
+[run]
+# default outside of Windows
+shell = "system"
+```
+
+To always use Bun's shell instead of the system shell:
+
+```toml
+[run]
+# default on Windows
+shell = "bun"
+```
+
+### `run.bun` - auto alias `node` to `bun`
+
+When `true`, this prepends `$PATH` with a `node` symlink that points to the `bun` binary for all scripts or executables invoked by `bun run` or `bun`.
+
+This means that if you have a script that runs `node`, it will actually run `bun` instead, without needing to change your script. This works recursively, so if your script runs another script that runs `node`, it will also run `bun` instead. This applies to shebangs as well, so if you have a script with a shebang that points to `node`, it will actually run `bun` instead.
+
+By default, this is enabled if `node` is not already in your `$PATH`.
+
+```toml
+[run]
+# equivalent to `bun --bun` for all `bun run` commands
+bun = true
+```
+
+You can test this by running:
+
+```sh
+$ bun --bun which node # /path/to/bun
+$ bun which node # /path/to/node
+```
+
+This option is equivalent to prefixing all `bun run` commands with `--bun`:
+
+```sh
+bun --bun run dev
+bun --bun dev
+bun run --bun dev
+```
+
+If set to `false`, this will disable the `node` symlink.
+
+### `run.silent` - suppress reporting the command being run
+
+When `true`, suppresses the output of the command being run by `bun run` or `bun`.
+
+```toml
+[run]
+silent = true
+```
+
+Without this option, the command being run will be printed to the console:
+
+```sh
+$ bun run dev
+> $ echo "Running \"dev\"..."
+Running "dev"...
+```
+
+With this option, the command being run will not be printed to the console:
+
+```sh
+$ bun run dev
+Running "dev"...
+```
+
+This is equivalent to passing `--silent` to all `bun run` commands:
+
+```sh
+bun --silent run dev
+bun --silent dev
+bun run --silent dev
+```

docs/runtime/env.md

@@ -163,6 +163,16 @@ These environment variables are read by Bun and configure aspects of its behavio
 
 ---
 
+- `BUN_CONFIG_MAX_HTTP_REQUESTS`
+- Control the maximum number of concurrent HTTP requests sent by fetch and `bun install`. Defaults to `256`. If you are running into rate limits or connection issues, you can reduce this number.
+
+---
+
+- `BUN_CONFIG_NO_CLEAR_TERMINAL_ON_RELOAD`
+- If `BUN_CONFIG_NO_CLEAR_TERMINAL_ON_RELOAD=1`, then `bun --watch` will not clear the console on reload
+
+---
+
 - `DO_NOT_TRACK`
 - Telemetry is not sent yet as of November 28th, 2023, but we are planning to add telemetry in the coming months. If `DO_NOT_TRACK=1`, then analytics are [disabled](https://do-not-track.dev/). Bun records bundle timings (so we can answer with data, "is Bun getting faster?") and feature usage (e.g., "are people actually using macros?"). The request body size is about 60 bytes, so it's not a lot of data. Equivalent of `telemetry=false` in bunfig.
 

docs/runtime/nodejs-apis.md

@@ -56,7 +56,7 @@ Some methods are not optimized yet.
 
 ### [`node:fs`](https://nodejs.org/api/fs.html)
 
-🟡 Missing `Dir` `openAsBlob` `opendir` `opendirSync` `statfs` `statfsSync`
+🟡 Missing `statfs` `statfsSync`, `opendirSync`. `Dir` is partially implemented.
 
 ### [`node:http`](https://nodejs.org/api/http.html)
 
@@ -116,7 +116,7 @@ Some methods are not optimized yet.
 
 ### [`node:stream`](https://nodejs.org/api/stream.html)
 
-🟡 Missing `getDefaultHighWaterMark` `setDefaultHighWaterMark`
+🟡 Missing `getDefaultHighWaterMark` `setDefaultHighWaterMark` `toWeb`
 
 ### [`node:string_decoder`](https://nodejs.org/api/string_decoder.html)
 
@@ -148,7 +148,7 @@ Some methods are not optimized yet.
 
 ### [`node:url`](https://nodejs.org/api/url.html)
 
-🟡 Missing `domainToASCII` `domainToUnicode`. It's recommended to use `URL` and `URLSearchParams` globals instead.
+🟢 Fully implemented.
 
 ### [`node:util`](https://nodejs.org/api/util.html)
 
@@ -432,7 +432,7 @@ The table below lists all globals implemented by Node.js and Bun's current compa
 
 ### [`URL`](https://developer.mozilla.org/en-US/docs/Web/API/URL)
 
-🟢 Fully implemented.
+🟡 `URL.createObjectURL` is missing. See [Issue #3925](https://github.com/oven-sh/bun/issues/3925)
 
 ### [`URLSearchParams`](https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams)
 

docs/runtime/plugins.md

@@ -63,7 +63,7 @@ Plugins are primarily used to extend Bun with loaders for additional file types.
 ```ts#yamlPlugin.ts
 import { plugin } from "bun";
 
-plugin({
+await plugin({
   name: "YAML",
   async setup(build) {
     const { load } = await import("js-yaml");
@@ -179,7 +179,7 @@ Loading a YAML file is useful, but plugins support more than just data loading.
 ```ts#sveltePlugin.ts
 import { plugin } from "bun";
 
-plugin({
+await plugin({
   name: "svelte loader",
   async setup(build) {
     const { compile } = await import("svelte/compiler");
@@ -214,7 +214,7 @@ With this plugin, Svelte components can now be directly imported and consumed.
 import "./sveltePlugin.ts";
 import MySvelteComponent from "./component.svelte";
 
-console.log(mySvelteComponent.render());
+console.log(MySvelteComponent.render());
 ```
 
 ## Virtual Modules

docs/runtime/shell.md

@@ -12,7 +12,7 @@ import { $ } from "bun";
 const response = await fetch("https://example.com");
 
 // Use Response as stdin.
-await $`echo < ${response} > wc -c`; // 120
+await $`cat < ${response} | wc -c`; // 1256
 ```
 
 ## Features:
@@ -67,9 +67,21 @@ console.log(exitCode); // 0
 
 ## Redirection
 
-Bun Shell supports redirection with `<`, `>`, and `|` operators.
+A command's _input_ or _output_ may be _redirected_ using the typical Bash operators:
 
-### To JavaScript objects (`>`)
+- `<` redirect stdin
+- `>` or `1>` redirect stdout
+- `2>` redirect stderr
+- `&>` redirect both stdout and stderr
+- `>>` or `1>>` redirect stdout, _appending_ to the destination, instead of overwriting
+- `2>>` redirect stderr, _appending_ to the destination, instead of overwriting
+- `&>>` redirect both stdout and stderr, _appending_ to the destination, instead of overwriting
+- `1>&2` redirect stdout to stderr (all writes to stdout will instead be in stderr)
+- `2>&1` redirect stderr to stdout (all writes to stderr will instead be in stdout)
+
+Bun Shell also supports redirecting from and to JavaScript objects.
+
+### Example: Redirect output to JavaScript objects (`>`)
 
 To redirect stdout to a JavaScript object, use the `>` operator:
 
@@ -88,7 +100,7 @@ The following JavaScript objects are supported for redirection to:
 - `Buffer`, `Uint8Array`, `Uint16Array`, `Uint32Array`, `Int8Array`, `Int16Array`, `Int32Array`, `Float32Array`, `Float64Array`, `ArrayBuffer`, `SharedArrayBuffer` (writes to the underlying buffer)
 - `Bun.file(path)`, `Bun.file(fd)` (writes to the file)
 
-### From JavaScript objects (`<`)
+### Example: Redirect input from JavaScript objects (`<`)
 
 To redirect the output from JavaScript objects to stdin, use the `<` operator:
 
@@ -108,7 +120,51 @@ The following JavaScript objects are supported for redirection from:
 - `Bun.file(path)`, `Bun.file(fd)` (reads from the file)
 - `Response` (reads from the body)
 
-### Piping (`|`)
+### Example: Redirect stdin -> file
+
+```js
+import { $ } from "bun";
+
+await $`cat < myfile.txt`;
+```
+
+### Example: Redirect stdout -> file
+
+```js
+import { $ } from "bun";
+
+await $`echo bun! > greeting.txt`;
+```
+
+### Example: Redirect stderr -> file
+
+```js
+import { $ } from "bun";
+
+await $`bun run index.ts 2> errors.txt`;
+```
+
+### Example: Redirect stdout -> stderr
+
+```js
+import { $ } from "bun";
+
+// redirects stderr to stdout, so all output
+// will be available on stdout
+await $`bun run ./index.ts 2>&1`;
+```
+
+### Example: Redirect stderr -> stdout
+
+```js
+import { $ } from "bun";
+
+// redirects stdout to stderr, so all output
+// will be available on stderr
+await $`bun run ./index.ts 1>&2`;
+```
+
+## Piping (`|`)
 
 Like in bash, you can pipe the output of one command to another:
 
@@ -322,36 +378,48 @@ await $.braces(`echo {1,2,3}`);
 // => ["echo 1", "echo 2", "echo 3"]
 ```
 
-### `$.escape` (unescaped strings)
+### `$.escape` (escape strings)
 
-For security purposes, Bun Shell escapes input by default. If you need to disable that, this function returns a string that is not escaped by Bun Shell:
+Exposes Bun Shell's escaping logic as a function:
 
 ```js
 import { $ } from "bun";
 
-await $`echo ${$.escape("Hello World!")}`;
-// => Hello World!
+console.log($.escape('$(foo) `bar` "baz"'));
+// => \$(foo) \`bar\` \"baz\"
 ```
 
-## .bun.sh file loader
+If you do not want your string to be escaped, wrap it in a `{ raw: 'str' }` object:
 
-For simple shell scripts, instead of `sh`, you can use Bun Shell to run shell scripts.
+```js
+import { $ } from "bun";
 
-To do that, run any file with bun that ends with `.bun.sh`:
+await $`echo ${{ raw: '$(foo) `bar` "baz"' }}`;
+// => bun: command not found: foo
+// => bun: command not found: bar
+// => baz
+```
+
+## .sh file loader
+
+For simple shell scripts, instead of `/bin/sh`, you can use Bun Shell to run shell scripts.
+
+To do so, just run the script with `bun` on a file with the `.bun.sh` extension.
+
+```sh#script.bun.sh
+echo "Hello World! pwd=$(pwd)"
+```
 
 ```sh
-$ echo "echo Hello World!" > script.bun.sh
 $ bun ./script.bun.sh
-> Hello World!
+Hello World! pwd=/home/demo
 ```
 
-On Windows, Bun Shell is used automatically to run `.sh` files when using Bun:
+Scripts with Bun Shell are cross platform, which means they work on Windows:
 
-```sh
-$ echo "echo Hello World!" > script.sh
-# On windows, .bun.sh is not needed, just .sh
-$ bun ./script.sh
-> Hello World!
+```
+PS C:\Users\Demo> bun .\script.bun.sh
+Hello World! pwd=C:\Users\Demo
 ```
 
 ## Credits

docs/test/coverage.md

@@ -52,7 +52,7 @@ It is possible to specify a coverage threshold in `bunfig.toml`. If your test su
 coverageThreshold = 0.9
 
 # to set different thresholds for lines and functions
-coverageThreshold = { line = 0.9, function = 0.9 }
+coverageThreshold = { lines = 0.9, functions = 0.9 }
 ```
 
 ### Sourcemaps

docs/test/writing.md

@@ -109,7 +109,7 @@ $ bun test --todo
 
 ## `test.only`
 
-To run a particular test or suite of tests use `test.only()` or `describe.only()`. Once declared, running `bun test --only` will only execute tests/suites that have been marked with `.only()`.
+To run a particular test or suite of tests use `test.only()` or `describe.only()`. Once declared, running `bun test --only` will only execute tests/suites that have been marked with `.only()`. Running `bun test` without the `--only` option with `test.only()` declared will result in all tests in the given suite being executed _up to_ the test with `.only()`. `describe.only()` functions the same in both execution scenarios.
 
 ```ts
 import { test, describe } from "bun:test";
@@ -135,6 +135,12 @@ The following command will only execute tests #2 and #3.
 $ bun test --only
 ```
 
+The following command will only execute tests #1, #2 and #3.
+
+```sh
+$ bun test
+```
+
 ## `test.if`
 
 To run a test conditionally, use `test.if()`. The test will run if the condition is truthy. This is particularly useful for tests that should only run on specific architectures or operating systems.
@@ -321,7 +327,7 @@ Bun implements the following matchers. Full Jest compatibility is on the roadmap
 
 ---
 
-- ❌
+- ✅
 - [`.assertions()`](https://jestjs.io/docs/expect#expectassertionsnumber)
 
 ---
@@ -331,7 +337,7 @@ Bun implements the following matchers. Full Jest compatibility is on the roadmap
 
 ---
 
-- ❌
+- ✅
 - [`.hasAssertions()`](https://jestjs.io/docs/expect#expecthasassertions)
 
 ---

docs/typescript.md

@@ -17,13 +17,13 @@ Bun supports things like top-level await, JSX, and extensioned `.ts` imports, wh
 ```jsonc
 {
   "compilerOptions": {
-    // enable latest features
+    // Enable latest features
     "lib": ["ESNext"],
     "target": "ESNext",
     "module": "ESNext",
     "moduleDetection": "force",
-    "jsx": "react-jsx", // support JSX
-    "allowJs": true, // allow importing `.js` from `.ts`
+    "jsx": "react-jsx",
+    "allowJs": true,
 
     // Bundler mode
     "moduleResolution": "bundler",
@@ -34,18 +34,17 @@ Bun supports things like top-level await, JSX, and extensioned `.ts` imports, wh
     // Best practices
     "strict": true,
     "skipLibCheck": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
     "noFallthroughCasesInSwitch": true,
 
     // Some stricter flags
-    "useUnknownInCatchVariables": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
     "noPropertyAccessFromIndexSignature": true
   }
 }
 ```
 
-If you run `bun init` in a new directory, this `tsconfig.json` will be generated for you.
+If you run `bun init` in a new directory, this `tsconfig.json` will be generated for you. (The stricter flags are disabled by default.)
 
 ```sh
 $ bun init

misctools/mime.js

@@ -21,7 +21,7 @@ const withExtensions = [
         return !!json[key]?.extensions?.length;
       })
       .flatMap(mime => {
-        return [...new Set([...json[mime].extensions])].map(ext => {
+        return [...new Set(json[mime].extensions)].map(ext => {
           return [`.{.@"${ext}", all.@"${mime}"}`];
         });
       })

package.json

@@ -1,40 +1,38 @@
 {
+  "private": true,
   "name": "bun",
   "dependencies": {
-    "@biomejs/biome": "^1.5.3",
     "@vscode/debugadapter": "^1.61.0",
     "esbuild": "^0.17.15",
     "eslint": "^8.20.0",
     "eslint-config-prettier": "^8.5.0",
     "mitata": "^0.1.3",
     "peechy": "0.4.34",
-    "prettier": "3.2.2",
+    "prettier": "^3.2.5",
     "react": "next",
     "react-dom": "next",
     "source-map-js": "^1.0.2",
     "typescript": "^5.0.2"
   },
-  "private": true,
-  "scripts": {
-    "setup": "./scripts/setup.sh",
-    "build": "if [ ! -e build ]; then bun setup; fi && ninja -C build",
-    "build:valgrind": "cmake . -DZIG_OPTIMIZE=Debug -DUSE_DEBUG_JSC=ON -DCMAKE_BUILD_TYPE=Debug -GNinja -Bbuild-valgrind && ninja -Cbuild-valgrind",
-    "build:release": "cmake . -DCMAKE_BUILD_TYPE=Release -GNinja -Bbuild-release && ninja -Cbuild-release",
-    "build:safe": "cmake . -DZIG_OPTIMIZE=ReleaseSafe -DUSE_DEBUG_JSC=ON -DCMAKE_BUILD_TYPE=Release -GNinja -Bbuild-safe && ninja -Cbuild-safe",
-    "typecheck": "tsc --noEmit && cd test && bun run typecheck",
-    "fmt": "biome format --write {src,test,bench,packages/{bun-types,bun-inspector-*,bun-vscode,bun-debug-adapter-protocol}}",
-    "fmt:zig": "zig fmt src/*.zig src/**/*.zig",
-    "lint": "eslint './**/*.d.ts' --cache",
-    "lint:fix": "eslint './**/*.d.ts' --cache --fix",
-    "test": "node packages/bun-internal-test/src/runner.node.mjs ./build/bun-debug",
-    "test:release": "node packages/bun-internal-test/src/runner.node.mjs ./build-release/bun",
-    "update-known-failures": "node packages/bun-internal-test/src/update-known-windows-failures.mjs"
-  },
   "devDependencies": {
     "@types/react": "^18.0.25",
     "@typescript-eslint/eslint-plugin": "^5.31.0",
     "@typescript-eslint/parser": "^5.31.0"
   },
-  "version": "0.0.0",
-  "prettier": "./.prettierrc.cjs"
+  "scripts": {
+    "setup": "./scripts/setup.sh",
+    "build": "if [ ! -e build ]; then bun setup; fi && ninja -C build",
+    "build:valgrind": "cmake . -DZIG_OPTIMIZE=Debug -DUSE_DEBUG_JSC=ON -DCMAKE_BUILD_TYPE=Debug -GNinja -Bbuild-valgrind && ninja -Cbuild-valgrind",
+    "build:release": "cmake . -DCMAKE_BUILD_TYPE=Release -GNinja -Bbuild-release && ninja -Cbuild-release",
+    "build:debug-zig-release": "cmake . -DCMAKE_BUILD_TYPE=Release -DZIG_OPTIMIZE=Debug -GNinja -Bbuild-debug-zig-release && ninja -Cbuild-debug-zig-release",
+    "build:safe": "cmake . -DZIG_OPTIMIZE=ReleaseSafe -DUSE_DEBUG_JSC=ON -DCMAKE_BUILD_TYPE=Release -GNinja -Bbuild-safe && ninja -Cbuild-safe",
+    "typecheck": "tsc --noEmit && cd test && bun run typecheck",
+    "fmt": "prettier --write --cache './{.vscode,src,test,bench,packages/{bun-types,bun-inspector-*,bun-vscode,bun-debug-adapter-protocol}}/**/*.{mjs,ts,tsx,js,jsx}'",
+    "fmt:zig": "zig fmt src/*.zig src/*/*.zig src/*/*/*.zig src/*/*/*/*.zig",
+    "lint": "eslint './**/*.d.ts' --cache",
+    "lint:fix": "eslint './**/*.d.ts' --cache --fix",
+    "test": "node packages/bun-internal-test/src/runner.node.mjs ./build/bun-debug",
+    "test:release": "node packages/bun-internal-test/src/runner.node.mjs ./build-release/bun",
+    "update-known-failures": "node packages/bun-internal-test/src/update-known-windows-failures.mjs"
+  }
 }

packages/bun-internal-test/package.json

@@ -7,9 +7,11 @@
     "runners/qunit"
   ],
   "dependencies": {
-    "@actions/core": "latest"
+    "@actions/core": "latest",
+    "p-queue": "^8.0.1"
   },
   "devDependencies": {
+    "@types/p-queue": "^3.2.1",
     "bun-types": "canary",
     "prettier": "^2.8.2"
   },

packages/bun-internal-test/src/runner.node.mjs

@@ -1,49 +1,91 @@
 import * as action from "@actions/core";
 import { spawn, spawnSync } from "child_process";
-import { rmSync, writeFileSync, readFileSync } from "fs";
-import { readFile } from "fs/promises";
+import { rmSync, writeFileSync, readFileSync, mkdirSync, openSync, close, closeSync } from "fs";
+import { readFile, rm } from "fs/promises";
 import { readdirSync } from "node:fs";
 import { resolve, basename } from "node:path";
-import { cpus, hostname, totalmem, userInfo } from "os";
+import { constants, cpus, hostname, tmpdir, totalmem, userInfo } from "os";
+import { join, normalize } from "path";
 import { fileURLToPath } from "url";
+import PQueue from "p-queue";
 
 const run_start = new Date();
+const TIMEOUT_DURATION = 1000 * 60 * 5;
+const SHORT_TIMEOUT_DURATION = Math.ceil(TIMEOUT_DURATION / 5);
+
+function defaultConcurrency() {
+  // This causes instability due to the number of open file descriptors / sockets in some tests
+  // Windows has higher limits
+  if (process.platform !== "win32") {
+    return 1;
+  }
+
+  return Math.min(Math.floor((cpus().length - 2) / 2), 2);
+}
 
 const windows = process.platform === "win32";
-
+const KEEP_TMPDIR = process.env["BUN_KEEP_TMPDIR"] === "1";
 const nativeMemory = totalmem();
 const force_ram_size_input = parseInt(process.env["BUN_JSC_forceRAMSize"] || "0", 10);
 let force_ram_size = Number(BigInt(nativeMemory) >> BigInt(2)) + "";
 if (!(Number.isSafeInteger(force_ram_size_input) && force_ram_size_input > 0)) {
   force_ram_size = force_ram_size_input + "";
 }
+function uncygwinTempDir() {
+  if (process.platform === "win32") {
+    for (let key of ["TMPDIR", "TEMP", "TEMPDIR", "TMP"]) {
+      let TMPDIR = process.env[key] || "";
+      if (!/^\/[a-zA-Z]\//.test(TMPDIR)) {
+        continue;
+      }
+
+      const driveLetter = TMPDIR[1];
+      TMPDIR = path.win32.normalize(`${driveLetter.toUpperCase()}:` + TMPDIR.substring(2));
+      process.env[key] = TMPDIR;
+    }
+  }
+}
+
+uncygwinTempDir();
 
 const cwd = resolve(fileURLToPath(import.meta.url), "../../../../");
 process.chdir(cwd);
 
 const ci = !!process.env["GITHUB_ACTIONS"];
-const enableProgressBar = !ci;
+const enableProgressBar = false;
 
-function defaultConcurrency() {
-  // Concurrency causes more flaky tests, only enable it by default on windows
-  // See https://github.com/oven-sh/bun/issues/8071
-  if (windows) {
-    return Math.floor((cpus().length - 2) / 2);
-  }
-  return 1;
+const dirPrefix = "bun-test-tmp-" + ((Math.random() * 100_000_0) | 0).toString(36) + "_";
+const run_concurrency = Math.max(Number(process.env["BUN_TEST_CONCURRENCY"] || defaultConcurrency(), 10), 1);
+const queue = new PQueue({ concurrency: run_concurrency });
+
+var prevTmpdir = "";
+function maketemp() {
+  prevTmpdir = join(
+    tmpdir(),
+    dirPrefix + (Date.now() | 0).toString() + "_" + ((Math.random() * 100_000_0) | 0).toString(36),
+  );
+  mkdirSync(prevTmpdir, { recursive: true });
+  return prevTmpdir;
 }
 
-const run_concurrency = Math.max(Number(process.env["BUN_TEST_CONCURRENCY"] || defaultConcurrency(), 10), 1);
-
-const extensions = [".js", ".ts", ".jsx", ".tsx"];
+const extensions = [".js", ".ts", ".jsx", ".tsx", ".mjs", ".cjs", ".mts", ".cts", ".mjsx", ".cjsx", ".mtsx", ".ctsx"];
 
 const git_sha =
   process.env["GITHUB_SHA"] ?? spawnSync("git", ["rev-parse", "HEAD"], { encoding: "utf-8" }).stdout.trim();
 
+const TEST_FILTER = process.env.BUN_TEST_FILTER;
+
 function isTest(path) {
   if (!basename(path).includes(".test.") || !extensions.some(ext => path.endsWith(ext))) {
     return false;
   }
+
+  if (TEST_FILTER) {
+    if (!path.includes(TEST_FILTER)) {
+      return false;
+    }
+  }
+
   return true;
 }
 
@@ -58,8 +100,15 @@ function* findTests(dir, query) {
   }
 }
 
-// pick the last one, kind of a hack to allow 'bun run test bun-release' to test the release build
-let bunExe = (process.argv.length > 2 ? process.argv[process.argv.length - 1] : null) ?? "bun";
+let bunExe = "bun";
+
+if (process.argv.length > 2) {
+  bunExe = resolve(process.argv.at(-1));
+} else if (process.env.BUN_PATH) {
+  const { BUN_PATH_BASE, BUN_PATH } = process.env;
+  bunExe = resolve(normalize(BUN_PATH_BASE), normalize(BUN_PATH));
+}
+
 const { error, stdout: revision_stdout } = spawnSync(bunExe, ["--revision"], {
   env: { ...process.env, BUN_DEBUG_QUIET_LOGS: 1 },
 });
@@ -100,57 +149,182 @@ const failing_tests = [];
 const passing_tests = [];
 const fixes = [];
 const regressions = [];
+let maxFd = -1;
+function getMaxFileDescriptor(path) {
+  if (process.platform === "win32") {
+    return -1;
+  }
 
+  hasInitialMaxFD = true;
+
+  if (process.platform === "linux") {
+    try {
+      readdirSync("/proc/self/fd").forEach(name => {
+        const fd = parseInt(name.trim(), 10);
+        if (Number.isSafeInteger(fd) && fd >= 0) {
+          maxFd = Math.max(maxFd, fd);
+        }
+      });
+
+      return maxFd;
+    } catch {}
+  }
+
+  const devnullfd = openSync("/dev/null", "r");
+  closeSync(devnullfd);
+  maxFd = devnullfd + 1;
+  return maxFd;
+}
+let hasInitialMaxFD = false;
+
+const activeTests = new Map();
+
+let slowTestCount = 0;
+function checkSlowTests() {
+  const now = Date.now();
+  const prevSlowTestCount = slowTestCount;
+  slowTestCount = 0;
+  for (const [path, { start, proc }] of activeTests) {
+    if (proc && now - start >= TIMEOUT_DURATION) {
+      console.error(
+        `\x1b[31merror\x1b[0;2m:\x1b[0m Killing test ${JSON.stringify(path)} after ${Math.ceil((now - start) / 1000)}s`,
+      );
+      proc?.stdout?.destroy?.();
+      proc?.stderr?.destroy?.();
+      proc?.kill?.();
+    } else if (now - start > SHORT_TIMEOUT_DURATION) {
+      console.error(
+        `\x1b[33mwarning\x1b[0;2m:\x1b[0m Test ${JSON.stringify(path)} has been running for ${Math.ceil(
+          (now - start) / 1000,
+        )}s`,
+      );
+      slowTestCount++;
+    }
+  }
+
+  if (slowTestCount > prevSlowTestCount && queue.concurrency > 1) {
+    queue.concurrency += 1;
+  }
+}
+
+setInterval(checkSlowTests, SHORT_TIMEOUT_DURATION).unref();
+var currentTestNumber = 0;
 async function runTest(path) {
+  const thisTestNumber = currentTestNumber++;
   const name = path.replace(cwd, "").slice(1);
   let exitCode, signal, err, output;
 
   const expected_crash_reason = windows
     ? await readFile(resolve(path), "utf-8").then(data => {
-      const match = data.match(/@known-failing-on-windows:(.*)\n/);
-      return match ? match[1].trim() : null;
-    })
+        const match = data.match(/@known-failing-on-windows:(.*)\n/);
+        return match ? match[1].trim() : null;
+      })
     : null;
 
   const start = Date.now();
 
-  await new Promise((done, reject) => {
-    const proc = spawn(bunExe, ["test", resolve(path)], {
-      stdio: ["ignore", "pipe", "pipe"],
-      timeout: 1000 * 60 * 3,
-      env: {
-        ...process.env,
-        FORCE_COLOR: "1",
-        BUN_GARBAGE_COLLECTOR_LEVEL: "1",
-        BUN_JSC_forceRAMSize: force_ram_size,
-        BUN_RUNTIME_TRANSPILER_CACHE_PATH: "0",
-        // reproduce CI results locally
-        GITHUB_ACTIONS: process.env.GITHUB_ACTIONS ?? "true",
-        BUN_DEBUG_QUIET_LOGS: "1",
-      },
-    });
+  const activeTestObject = { start, proc: undefined };
+  activeTests.set(path, activeTestObject);
 
-    const chunks = [];
-    proc.stdout.on("data", chunk => {
-      chunks.push(chunk);
-      if (run_concurrency === 1) process.stdout.write(chunk);
-    });
-    proc.stderr.on("data", chunk => {
-      chunks.push(chunk);
-      if (run_concurrency === 1) process.stderr.write(chunk);
-    });
+  try {
+    await new Promise((finish, reject) => {
+      const chunks = [];
+      process.stderr.write(
+        `
+at ${((start - run_start.getTime()) / 1000).toFixed(2)}s, file ${thisTestNumber
+          .toString()
+          .padStart(total.toString().length, "0")}/${total}, ${failing_tests.length} failing files
+Starting "${name}"
 
-    proc.on("exit", (code_, signal_) => {
-      exitCode = code_;
-      signal = signal_;
-      output = Buffer.concat(chunks).toString();
-      done();
+`,
+      );
+      const TMPDIR = maketemp();
+      const proc = spawn(bunExe, ["test", resolve(path)], {
+        stdio: ["ignore", "pipe", "pipe"],
+        env: {
+          ...process.env,
+          FORCE_COLOR: "1",
+          BUN_GARBAGE_COLLECTOR_LEVEL: "1",
+          BUN_JSC_forceRAMSize: force_ram_size,
+          BUN_RUNTIME_TRANSPILER_CACHE_PATH: "0",
+          GITHUB_ACTIONS: process.env.GITHUB_ACTIONS ?? "true",
+          BUN_DEBUG_QUIET_LOGS: "1",
+          [windows ? "TEMP" : "TMPDIR"]: TMPDIR,
+        },
+      });
+      activeTestObject.proc = proc;
+      proc.stdout.once("end", () => {
+        done();
+      });
+
+      let doneCalls = 0;
+      var done = () => {
+        // TODO: wait for stderr as well
+        // spawn.test currently causes it to hang
+        if (doneCalls++ === 1) {
+          actuallyDone();
+        }
+      };
+      var actuallyDone = function () {
+        actuallyDone = done = () => {};
+        proc?.stderr?.unref?.();
+        proc?.stdout?.unref?.();
+        proc?.unref?.();
+        output = Buffer.concat(chunks).toString();
+        finish();
+      };
+
+      // if (!KEEP_TMPDIR)
+      //   proc.once("close", () => {
+      //     rm(TMPDIR, { recursive: true, force: true }).catch(() => {});
+      //   });
+
+      proc.stdout.on("data", chunk => {
+        chunks.push(chunk);
+        if (run_concurrency === 1) process.stdout.write(chunk);
+      });
+      proc.stderr.on("data", chunk => {
+        chunks.push(chunk);
+        if (run_concurrency === 1) process.stderr.write(chunk);
+      });
+
+      proc.once("close", () => {
+        activeTestObject.proc = undefined;
+      });
+
+      proc.once("exit", (code_, signal_) => {
+        activeTestObject.proc = undefined;
+        exitCode = code_;
+        signal = signal_;
+        if (signal || exitCode !== 0) {
+          actuallyDone();
+        } else {
+          done();
+        }
+      });
+      proc.once("error", err_ => {
+        activeTestObject.proc = undefined;
+        err = err_;
+        actuallyDone();
+      });
     });
-    proc.on("error", err_ => {
-      err = err_;
-      done();
-    });
-  });
+  } finally {
+    activeTests.delete(path);
+  }
+
+  if (!hasInitialMaxFD) {
+    getMaxFileDescriptor();
+  } else if (maxFd > 0) {
+    const prevMaxFd = maxFd;
+    maxFd = getMaxFileDescriptor();
+    if (maxFd > prevMaxFd + queue.concurrency * 2) {
+      process.stderr.write(
+        `\n\x1b[31mewarn\x1b[0;2m:\x1b[0m file descriptor leak in ${name}, delta: ${
+          maxFd - prevMaxFd
+        }, current: ${maxFd}, previous: ${prevMaxFd}\n`,
+      );
+    }
+  }
 
   const passed = exitCode === 0 && !err && !signal;
 
@@ -195,7 +369,8 @@ async function runTest(path) {
   }
 
   console.log(
-    `\x1b[2m${formatTime(duration).padStart(6, " ")}\x1b[0m ${passed ? "\x1b[32m✔" : expected_crash_reason ? "\x1b[33m⚠" : "\x1b[31m✖"
+    `\x1b[2m${formatTime(duration).padStart(6, " ")}\x1b[0m ${
+      passed ? "\x1b[32m✔" : expected_crash_reason ? "\x1b[33m⚠" : "\x1b[31m✖"
     } ${name}\x1b[0m${reason ? ` (${reason})` : ""}`,
   );
 
@@ -217,6 +392,7 @@ async function runTest(path) {
     }
 
     failing_tests.push({ path: name, reason, output, expected_crash_reason });
+    process.exitCode = 1;
     if (err) console.error(err);
   } else {
     if (windows && expected_crash_reason !== null) {
@@ -225,13 +401,11 @@ async function runTest(path) {
 
     passing_tests.push(name);
   }
+
+  return passed;
 }
 
-const queue = [...findTests(resolve(cwd, "test"))];
-let running = 0;
-let total = queue.length;
-let finished = 0;
-let on_entry_finish = null;
+var finished = 0;
 
 function writeProgressBar() {
   const barWidth = Math.min(process.stdout.columns || 40, 80) - 2;
@@ -241,34 +415,23 @@ function writeProgressBar() {
   process.stdout.write(`\r${str1}${" ".repeat(barWidth - str1.length)}]`);
 }
 
-while (queue.length > 0) {
-  if (running >= run_concurrency) {
-    await new Promise(resolve => (on_entry_finish = resolve));
-    continue;
-  }
-
-  const path = queue.shift();
-  running++;
-  runTest(path)
-    .catch(e => {
-      console.error("Bug in bun-internal-test");
-      console.error(e);
-      process.exit(1);
-    })
-    .finally(() => {
-      running--;
-      if (on_entry_finish) {
-        on_entry_finish();
-        on_entry_finish = null;
-      }
-    });
-}
-while (running > 0) {
-  await Promise.race([
-    new Promise(resolve => (on_entry_finish = resolve)),
-    new Promise(resolve => setTimeout(resolve, 1000)),
-  ]);
+const allTests = [...findTests(resolve(cwd, "test"))];
+console.log(`Starting ${allTests.length} tests with ${run_concurrency} concurrency...`);
+let total = allTests.length;
+for (const path of allTests) {
+  queue.add(
+    async () =>
+      await runTest(path).catch(e => {
+        console.error("Bug in bun-internal-test");
+        console.error(e);
+        process.exit(1);
+      }),
+  );
 }
+await queue.onIdle();
+console.log(`
+Completed ${total} tests with ${failing_tests.length} failing tests
+`);
 console.log("\n");
 
 function linkToGH(linkTo) {
@@ -279,10 +442,13 @@ function sectionLink(linkTo) {
   return "#" + linkTo.replace(/[^a-zA-Z0-9_-]/g, "").toLowerCase();
 }
 
+failing_tests.sort((a, b) => a.path.localeCompare(b.path));
+passing_tests.sort((a, b) => a.localeCompare(b));
+
 const failingTestDisplay = failing_tests
-  .filter(({ reason }) => !regressions.some(({ path }) => path === path))
   .map(({ path, reason }) => `- [\`${path}\`](${sectionLink(path)})${reason ? ` ${reason}` : ""}`)
   .join("\n");
+
 // const passingTestDisplay = passing_tests.map(path => `- \`${path}\``).join("\n");
 
 rmSync("report.md", { force: true });
@@ -319,9 +485,10 @@ console.log("\n" + "-".repeat(Math.min(process.stdout.columns || 40, 80)) + "\n"
 console.log(header);
 console.log("\n" + "-".repeat(Math.min(process.stdout.columns || 40, 80)) + "\n");
 
-let report = `# bun test on ${process.env["GITHUB_REF"] ??
+let report = `# bun test on ${
+  process.env["GITHUB_REF"] ??
   spawnSync("git", ["rev-parse", "--abbrev-ref", "HEAD"], { encoding: "utf-8" }).stdout.trim()
-  }
+}
 
 \`\`\`
 ${header}
@@ -345,7 +512,8 @@ if (regressions.length > 0) {
   report += regressions
     .map(
       ({ path, reason, expected_crash_reason }) =>
-        `- [\`${path}\`](${sectionLink(path)}) ${reason}${expected_crash_reason ? ` (expected: ${expected_crash_reason})` : ""
+        `- [\`${path}\`](${sectionLink(path)}) ${reason}${
+          expected_crash_reason ? ` (expected: ${expected_crash_reason})` : ""
         }`,
     )
     .join("\n");
@@ -353,7 +521,7 @@ if (regressions.length > 0) {
 }
 
 if (failingTestDisplay.length > 0) {
-  report += `## ${windows ? "Known " : ""}Failing tests\n\n`;
+  report += `## Failing tests\n\n`;
   report += failingTestDisplay;
   report += "\n\n";
 }
@@ -422,4 +590,4 @@ if (ci) {
   }
 }
 
-process.exit(failing_tests.length ? 1 : 0);
+process.exit(failing_tests.length ? 1 : process.exitCode);

packages/bun-lambda/scripts/publish-layer.ts

@@ -32,20 +32,20 @@ export class PublishCommand extends BuildCommand {
     }
     const { layer, region, arch, output, public: isPublic } = flags;
     if (region.includes("*")) {
-      // biome-ignore: format ignore
+      // prettier-ignore
       const result = this.#aws(["ec2", "describe-regions", "--query", "Regions[].RegionName", "--output", "json"]);
       region.length = 0;
       for (const name of JSON.parse(result)) {
         region.push(name);
       }
     } else if (!region.length) {
-      // biome-ignore: format ignore
+      // prettier-ignore
       region.push(this.#aws(["configure", "get", "region"]));
     }
     this.log("Publishing...");
     for (const regionName of region) {
       for (const layerName of layer) {
-        // biome-ignore: format ignore
+        // prettier-ignore
         const result = this.#aws([
           "lambda",
           "publish-layer-version",
@@ -70,7 +70,7 @@ export class PublishCommand extends BuildCommand {
         const { LayerVersionArn } = JSON.parse(result);
         this.log("Published", LayerVersionArn);
         if (isPublic) {
-          // biome-ignore: format ignore
+          // prettier-ignore
           this.#aws([
             "lambda",
             "add-layer-version-permission",

packages/bun-types/.prettierrc

@@ -1,6 +0,0 @@
-{
-  "arrowParens": "avoid",
-  "printWidth": 80,
-  "trailingComma": "all",
-  "useTabs": false
-}

packages/bun-types/bun.d.ts

@@ -47,9 +47,59 @@ declare module "bun" {
    */
   function which(command: string, options?: { PATH?: string; cwd?: string }): string | null;
 
+  /**
+   * Get the column count of a string as it would be displayed in a terminal.
+   * Supports ANSI escape codes, emoji, and wide characters.
+   *
+   * This is useful for:
+   * - Aligning text in a terminal
+   * - Quickly checking if a string contains ANSI escape codes
+   * - Measuring the width of a string in a terminal
+   *
+   * This API is designed to match the popular "string-width" package, so that
+   * existing code can be easily ported to Bun and vice versa.
+   *
+   * @returns The width of the string in columns
+   *
+   * ## Examples
+   * @example
+   * ```ts
+   * import { stringWidth } from "bun";
+   *
+   * console.log(stringWidth("abc")); // 3
+   * console.log(stringWidth("👩‍👩‍👧‍👦")); // 1
+   * console.log(stringWidth("\u001b[31mhello\u001b[39m")); // 5
+   * console.log(stringWidth("\u001b[31mhello\u001b[39m", { countAnsiEscapeCodes: false })); // 5
+   * console.log(stringWidth("\u001b[31mhello\u001b[39m", { countAnsiEscapeCodes: true })); // 13
+   * ```
+   *
+   */
+  function stringWidth(
+    /**
+     * The string to measure
+     */
+    input: string,
+    options?: {
+      /**
+       * If `true`, count ANSI escape codes as part of the string width. If `false`, ANSI escape codes are ignored when calculating the string width.
+       *
+       * @default false
+       */
+      countAnsiEscapeCodes?: boolean;
+      /**
+       * When it's ambiugous and `true`, count emoji as 1 characters wide. If `false`, emoji are counted as 2 character wide.
+       *
+       * @default true
+       */
+      ambiguousIsNarrow?: boolean;
+    },
+  ): number;
+
   export type ShellFunction = (input: Uint8Array) => Uint8Array;
 
   export type ShellExpression =
+    | { toString(): string }
+    | Array<ShellExpression>
     | string
     | { raw: string }
     | Subprocess
@@ -57,6 +107,75 @@ declare module "bun" {
     | SpawnOptions.Writable
     | ReadableStream;
 
+  class ShellError extends Error implements ShellOutput {
+    readonly stdout: Buffer;
+    readonly stderr: Buffer;
+    readonly exitCode: number;
+
+    /**
+     * Read from stdout as a string
+     *
+     * @param encoding - The encoding to use when decoding the output
+     * @returns Stdout as a string with the given encoding
+     * @example
+     *
+     * ## Read as UTF-8 string
+     *
+     * ```ts
+     * const output = await $`echo hello`;
+     * console.log(output.text()); // "hello\n"
+     * ```
+     *
+     * ## Read as base64 string
+     *
+     * ```ts
+     * const output = await $`echo ${atob("hello")}`;
+     * console.log(output.text("base64")); // "hello\n"
+     * ```
+     *
+     */
+    text(encoding?: BufferEncoding): string;
+
+    /**
+     * Read from stdout as a JSON object
+     *
+     * @returns Stdout as a JSON object
+     * @example
+     *
+     * ```ts
+     * const output = await $`echo '{"hello": 123}'`;
+     * console.log(output.json()); // { hello: 123 }
+     * ```
+     *
+     */
+    json(): any;
+
+    /**
+     * Read from stdout as an ArrayBuffer
+     *
+     * @returns Stdout as an ArrayBuffer
+     * @example
+     *
+     * ```ts
+     * const output = await $`echo hello`;
+     * console.log(output.arrayBuffer()); // ArrayBuffer { byteLength: 6 }
+     * ```
+     */
+    arrayBuffer(): ArrayBuffer;
+
+    /**
+     * Read from stdout as a Blob
+     *
+     * @returns Stdout as a blob
+     * @example
+     * ```ts
+     * const output = await $`echo hello`;
+     * console.log(output.blob()); // Blob { size: 6, type: "" }
+     * ```
+     */
+    blob(): Blob;
+  }
+
   class ShellPromise extends Promise<ShellOutput> {
     get stdin(): WritableStream;
     /**
@@ -156,6 +275,16 @@ declare module "bun" {
      * ```
      */
     blob(): Promise<Blob>;
+
+    /**
+     * Configure the shell to not throw an exception on non-zero exit codes.
+     */
+    nothrow(): this;
+
+    /**
+     * Configure whether or not the shell should throw an exception on non-zero exit codes.
+     */
+    throws(shouldThrow: boolean): this;
   }
 
   interface ShellConstructor {
@@ -207,6 +336,16 @@ declare module "bun" {
      */
     cwd(newCwd?: string): this;
 
+    /**
+     * Configure the shell to not throw an exception on non-zero exit codes.
+     */
+    nothrow(): this;
+
+    /**
+     * Configure whether or not the shell should throw an exception on non-zero exit codes.
+     */
+    throws(shouldThrow: boolean): this;
+
     readonly ShellPromise: typeof ShellPromise;
     readonly Shell: ShellConstructor;
   }
@@ -215,6 +354,69 @@ declare module "bun" {
     readonly stdout: Buffer;
     readonly stderr: Buffer;
     readonly exitCode: number;
+
+    /**
+     * Read from stdout as a string
+     *
+     * @param encoding - The encoding to use when decoding the output
+     * @returns Stdout as a string with the given encoding
+     * @example
+     *
+     * ## Read as UTF-8 string
+     *
+     * ```ts
+     * const output = await $`echo hello`;
+     * console.log(output.text()); // "hello\n"
+     * ```
+     *
+     * ## Read as base64 string
+     *
+     * ```ts
+     * const output = await $`echo ${atob("hello")}`;
+     * console.log(output.text("base64")); // "hello\n"
+     * ```
+     *
+     */
+    text(encoding?: BufferEncoding): string;
+
+    /**
+     * Read from stdout as a JSON object
+     *
+     * @returns Stdout as a JSON object
+     * @example
+     *
+     * ```ts
+     * const output = await $`echo '{"hello": 123}'`;
+     * console.log(output.json()); // { hello: 123 }
+     * ```
+     *
+     */
+    json(): any;
+
+    /**
+     * Read from stdout as an ArrayBuffer
+     *
+     * @returns Stdout as an ArrayBuffer
+     * @example
+     *
+     * ```ts
+     * const output = await $`echo hello`;
+     * console.log(output.arrayBuffer()); // ArrayBuffer { byteLength: 6 }
+     * ```
+     */
+    arrayBuffer(): ArrayBuffer;
+
+    /**
+     * Read from stdout as a Blob
+     *
+     * @returns Stdout as a blob
+     * @example
+     * ```ts
+     * const output = await $`echo hello`;
+     * console.log(output.blob()); // Blob { size: 6, type: "" }
+     * ```
+     */
+    blob(): Blob;
   }
 
   export const $: Shell;
@@ -623,7 +825,7 @@ declare module "bun" {
    * console.log(path); // "/foo/bar.txt"
    * ```
    */
-  function fileURLToPath(url: URL): string;
+  function fileURLToPath(url: URL | string): string;
 
   /**
    * Fast incremental writer that becomes an `ArrayBuffer` on end().
@@ -1242,6 +1444,14 @@ declare module "bun" {
     // origin?: string; // e.g. http://mydomain.com
     loader?: { [k in string]: Loader };
     sourcemap?: "none" | "inline" | "external"; // default: "none"
+    /**
+     * package.json `exports` conditions used when resolving imports
+     *
+     * Equivalent to `--conditions` in `bun build` or `bun run`.
+     *
+     * https://nodejs.org/api/packages.html#exports
+     */
+    conditions?: Array<string> | string;
     minify?:
       | boolean
       | {
@@ -1831,6 +2041,7 @@ declare module "bun" {
    *     return new Response("Hello World");
    *  },
    * });
+   * ```
    */
   interface WebSocketHandler<T = undefined> {
     /**
@@ -2473,6 +2684,25 @@ declare module "bun" {
      */
     requestIP(request: Request): SocketAddress | null;
 
+    /**
+     * Undo a call to {@link Server.unref}
+     *
+     * If the Server has already been stopped, this does nothing.
+     *
+     * If {@link Server.ref} is called multiple times, this does nothing. Think of it as a boolean toggle.
+     */
+    ref(): void;
+
+    /**
+     * Don't keep the process alive if this server is the only thing left.
+     * Active connections may continue to keep the process alive.
+     *
+     * By default, the server is ref'd.
+     *
+     * To prevent new connections from being accepted, use {@link Server.stop}
+     */
+    unref(): void;
+
     /**
      * How many requests are in-flight right now?
      */
@@ -3158,26 +3388,26 @@ declare module "bun" {
    * @param options Compression options to use
    * @returns The output buffer with the compressed data
    */
-  function deflateSync(data: Uint8Array, options?: ZlibCompressionOptions): Uint8Array;
+  function deflateSync(data: Uint8Array | string | ArrayBuffer, options?: ZlibCompressionOptions): Uint8Array;
   /**
    * Compresses a chunk of data with `zlib` GZIP algorithm.
    * @param data The buffer of data to compress
    * @param options Compression options to use
    * @returns The output buffer with the compressed data
    */
-  function gzipSync(data: Uint8Array, options?: ZlibCompressionOptions): Uint8Array;
+  function gzipSync(data: Uint8Array | string | ArrayBuffer, options?: ZlibCompressionOptions): Uint8Array;
   /**
    * Decompresses a chunk of data with `zlib` INFLATE algorithm.
    * @param data The buffer of data to decompress
    * @returns The output buffer with the decompressed data
    */
-  function inflateSync(data: Uint8Array): Uint8Array;
+  function inflateSync(data: Uint8Array | string | ArrayBuffer): Uint8Array;
   /**
    * Decompresses a chunk of data with `zlib` GUNZIP algorithm.
    * @param data The buffer of data to decompress
    * @returns The output buffer with the decompressed data
    */
-  function gunzipSync(data: Uint8Array): Uint8Array;
+  function gunzipSync(data: Uint8Array | string | ArrayBuffer): Uint8Array;
 
   type Target =
     /**
@@ -3902,22 +4132,33 @@ declare module "bun" {
       /**
        * If true, the subprocess will have a hidden window.
        */
-      // windowsHide?: boolean;
+      windowsHide?: boolean;
+
+      /**
+       * Path to the executable to run in the subprocess. This defaults to `cmds[0]`.
+       *
+       * One use-case for this is for applications which wrap other applications or to simulate a symlink.
+       *
+       * @default cmds[0]
+       */
+      argv0?: string;
     }
 
-    type OptionsToSubprocess<Opts extends OptionsObject> = Opts extends OptionsObject<infer In, infer Out, infer Err>
-      ? Subprocess<
-          // "Writable extends In" means "if In === Writable",
-          // aka if true that means the user didn't specify anything
-          Writable extends In ? "ignore" : In,
-          Readable extends Out ? "pipe" : Out,
-          Readable extends Err ? "inherit" : Err
-        >
-      : Subprocess<Writable, Readable, Readable>;
+    type OptionsToSubprocess<Opts extends OptionsObject> =
+      Opts extends OptionsObject<infer In, infer Out, infer Err>
+        ? Subprocess<
+            // "Writable extends In" means "if In === Writable",
+            // aka if true that means the user didn't specify anything
+            Writable extends In ? "ignore" : In,
+            Readable extends Out ? "pipe" : Out,
+            Readable extends Err ? "inherit" : Err
+          >
+        : Subprocess<Writable, Readable, Readable>;
 
-    type OptionsToSyncSubprocess<Opts extends OptionsObject> = Opts extends OptionsObject<any, infer Out, infer Err>
-      ? SyncSubprocess<Readable extends Out ? "pipe" : Out, Readable extends Err ? "pipe" : Err>
-      : SyncSubprocess<Readable, Readable>;
+    type OptionsToSyncSubprocess<Opts extends OptionsObject> =
+      Opts extends OptionsObject<any, infer Out, infer Err>
+        ? SyncSubprocess<Readable extends Out ? "pipe" : Out, Readable extends Err ? "pipe" : Err>
+        : SyncSubprocess<Readable, Readable>;
 
     type ReadableIO = ReadableStream<Uint8Array> | number | undefined;
 
@@ -3954,19 +4195,19 @@ declare module "bun" {
     };
 
     /**
-     * The amount of CPU time used by the process, in nanoseconds.
+     * The amount of CPU time used by the process, in microseconds.
      */
     cpuTime: {
       /**
-       * User CPU time used by the process, in nanoseconds.
+       * User CPU time used by the process, in microseconds.
        */
       user: number;
       /**
-       * System CPU time used by the process, in nanoseconds.
+       * System CPU time used by the process, in microseconds.
        */
       system: number;
       /**
-       * Total CPU time used by the process, in nanoseconds.
+       * Total CPU time used by the process, in microseconds.
        */
       total: number;
     };
@@ -4084,7 +4325,7 @@ declare module "bun" {
      * Kill the process
      * @param exitCode The exitCode to send to the process
      */
-    kill(exitCode?: number): void;
+    kill(exitCode?: number | NodeJS.Signals): void;
 
     /**
      * This method will tell Bun to wait for this process to exit after you already
@@ -4144,6 +4385,8 @@ declare module "bun" {
      * Get the resource usage information of the process (max RSS, CPU time, etc)
      */
     resourceUsage: ResourceUsage;
+
+    signalCode?: string;
   }
 
   /**
@@ -4239,6 +4482,8 @@ declare module "bun" {
        * ```
        */
       cmd: string[];
+
+      onExit?: never;
     },
   ): SpawnOptions.OptionsToSyncSubprocess<Opts>;
 

packages/bun-types/globals.d.ts

@@ -584,7 +584,7 @@ declare global {
       /**
        * If set, specifies the initial value of process.env inside the Worker thread. As a special value, worker.SHARE_ENV may be used to specify that the parent thread and the child thread should share their environment variables; in that case, changes to one thread's process.env object affect the other thread as well. Default: process.env.
        */
-      env?: Record<string, string> | typeof import("node:worker_threads")["SHARE_ENV"] | undefined;
+      env?: Record<string, string> | (typeof import("node:worker_threads"))["SHARE_ENV"] | undefined;
 
       /**
        * In Bun, this does nothing.

packages/bun-types/index.d.ts

@@ -7,10 +7,12 @@
 /// <reference types="ws" />
 
 // contributors: uncomment this to detect conflicts with lib.dom.d.ts
-/// <reference lib="dom" />
+//// <reference lib="dom" />
 
 /// <reference path="./globals.d.ts" />
 /// <reference path="./bun.d.ts" />
+/// <reference path="./overrides.d.ts" />
+/// <reference path="./fetch.d.ts" />
 /// <reference path="./ffi.d.ts" />
 /// <reference path="./test.d.ts" />
 /// <reference path="./html-rewriter.d.ts" />

packages/bun-types/package.json

@@ -18,9 +18,9 @@
     "@types/ws": "~8.5.10"
   },
   "devDependencies": {
+    "@biomejs/biome": "^1.5.3",
     "@definitelytyped/dtslint": "^0.0.199",
     "@definitelytyped/eslint-plugin": "^0.0.197",
-    "prettier": "^2.4.1",
     "typescript": "^5.0.2"
   },
   "scripts": {

packages/bun-types/test.d.ts

@@ -91,7 +91,9 @@ declare module "bun:test" {
 
   interface Jest {
     restoreAllMocks(): void;
+    clearAllMocks(): void;
     fn<T extends (...args: any[]) => any>(func?: T): Mock<T>;
+    setSystemTime(now?: number | Date): void;
   }
   export const jest: Jest;
   export namespace jest {
@@ -346,7 +348,7 @@ declare module "bun:test" {
       options?: number | TestOptions,
     ): void;
     /**
-     * Skips all other tests, except this test.
+     * Skips all other tests, except this test when run with the `--only` option.
      *
      * @param label the label for the test
      * @param fn the test function
@@ -545,6 +547,16 @@ declare module "bun:test" {
      * ```
      */
     unreachable(msg?: string | Error): never;
+
+    /**
+     * Ensures that an assertion is made
+     */
+    hasAssertions(): void;
+
+    /**
+     * Ensures that a specific number of assertions are made
+     */
+    assertions(neededAssertions: number): void;
   }
 
   /**
@@ -872,6 +884,19 @@ declare module "bun:test" {
      * @param expected the expected value
      */
     toStrictEqual(expected: T): void;
+    /**
+     * Asserts that the value is deep equal to an element in the expected array.
+     *
+     * The value must be an array or iterable, which includes strings.
+     *
+     * @example
+     * expect(1).toBeOneOf([1,2,3]);
+     * expect("foo").toBeOneOf(["foo", "bar"]);
+     * expect(true).toBeOneOf(new Set([true]));
+     *
+     * @param expected the expected value
+     */
+    toBeOneOf(expected: Array<unknown> | Iterable<unknown>): void;
     /**
      * Asserts that a value contains what is expected.
      *
@@ -1102,6 +1127,27 @@ declare module "bun:test" {
      * @param expected the expected error, error message, or error pattern
      */
     toThrow(expected?: unknown): void;
+    /**
+     * Asserts that a function throws an error.
+     *
+     * - If expected is a `string` or `RegExp`, it will check the `message` property.
+     * - If expected is an `Error` object, it will check the `name` and `message` properties.
+     * - If expected is an `Error` constructor, it will check the class of the `Error`.
+     * - If expected is not provided, it will check if anything as thrown.
+     *
+     * @example
+     * function fail() {
+     *   throw new Error("Oops!");
+     * }
+     * expect(fail).toThrowError("Oops!");
+     * expect(fail).toThrowError(/oops/i);
+     * expect(fail).toThrowError(Error);
+     * expect(fail).toThrowError();
+     *
+     * @param expected the expected error, error message, or error pattern
+     * @alias toThrow
+     */
+    toThrowError(expected?: unknown): void;
     /**
      * Asserts that a value matches a regular expression or includes a substring.
      *
@@ -1385,22 +1431,47 @@ declare module "bun:test" {
      * Ensures that a mock function is called.
      */
     toHaveBeenCalled(): void;
+    /**
+     * Ensures that a mock function is called an exact number of times.
+     * @alias toHaveBeenCalled
+     */
+    toBeCalled(): void;
     /**
      * Ensures that a mock function is called an exact number of times.
      */
     toHaveBeenCalledTimes(expected: number): void;
+    /**
+     * Ensure that a mock function is called with specific arguments.
+     * @alias toHaveBeenCalledTimes
+     */
+    toBeCalledTimes(expected: number): void;
     /**
      * Ensure that a mock function is called with specific arguments.
      */
     toHaveBeenCalledWith(...expected: unknown[]): void;
+    /**
+     * Ensure that a mock function is called with specific arguments.
+     * @alias toHaveBeenCalledWith
+     */
+    toBeCalledWith(...expected: unknown[]): void;
     /**
      * Ensure that a mock function is called with specific arguments for the last call.
      */
     toHaveBeenLastCalledWith(...expected: unknown[]): void;
+    /**
+     * Ensure that a mock function is called with specific arguments for the nth call.
+     * @alias toHaveBeenCalledWith
+     */
+    lastCalledWith(...expected: unknown[]): void;
     /**
      * Ensure that a mock function is called with specific arguments for the nth call.
      */
     toHaveBeenNthCalledWith(n: number, ...expected: unknown[]): void;
+    /**
+     * Ensure that a mock function is called with specific arguments for the nth call.
+     * @alias toHaveBeenCalledWith
+     */
+    nthCalledWith(n: number, ...expected: unknown[]): void;
   }
 
   /**

packages/bun-usockets/src/bsd.c

@@ -392,7 +392,12 @@ LIBUS_SOCKET_DESCRIPTOR bsd_accept_socket(LIBUS_SOCKET_DESCRIPTOR fd, struct bsd
 
     internal_finalize_bsd_addr(addr);
 
+#if defined(SOCK_CLOEXEC) && defined(SOCK_NONBLOCK)
+// skip the extra fcntl calls.
+    return accepted_fd;
+#else
     return bsd_set_nonblocking(apple_no_sigpipe(accepted_fd));
+#endif
 }
 
 int bsd_recv(LIBUS_SOCKET_DESCRIPTOR fd, void *buf, int length, int flags) {
@@ -473,7 +478,7 @@ inline __attribute__((always_inline)) LIBUS_SOCKET_DESCRIPTOR bsd_bind_listen_fd
             setsockopt(listenFd, SOL_SOCKET, SO_REUSEADDR, (void *) &optval3, sizeof(optval3));
         }
 #else
-    #if /*defined(__linux) &&*/ defined(SO_REUSEPORT)
+    #if /*defined(__linux__) &&*/ defined(SO_REUSEPORT)
         if (!(options & LIBUS_LISTEN_EXCLUSIVE_PORT)) {
             int optval = 1;
             setsockopt(listenFd, SOL_SOCKET, SO_REUSEPORT, (void *) &optval, sizeof(optval));
@@ -562,8 +567,91 @@ LIBUS_SOCKET_DESCRIPTOR bsd_create_listen_socket(const char *host, int port, int
 #endif
 #include <sys/stat.h>
 #include <stddef.h>
-LIBUS_SOCKET_DESCRIPTOR bsd_create_listen_socket_unix(const char *path, int options) {
 
+static int bsd_create_unix_socket_address(const char *path, size_t path_len, int* dirfd_linux_workaround_for_unix_path_len, struct sockaddr_un *server_address, size_t* addrlen) {
+    memset(server_address, 0, sizeof(struct sockaddr_un));
+    server_address->sun_family = AF_UNIX;
+
+    if (path_len == 0) {
+        #if defined(_WIN32)
+            // simulate ENOENT
+            SetLastError(ERROR_PATH_NOT_FOUND);
+        #else
+            errno = ENOENT;
+        #endif
+        return LIBUS_SOCKET_ERROR;
+    }
+
+    *addrlen = sizeof(struct sockaddr_un);
+
+    #if defined(__linux__)
+        // Unix socket addresses have a maximum length of 108 bytes on Linux
+        // As a workaround, we can use /proc/self/fd/ as a directory to shorten the path
+        if (path_len >= sizeof(server_address->sun_path) && path[0] != '\0') {
+            size_t dirname_len = path_len;
+            // get the basename
+            while (dirname_len > 1 && path[dirname_len - 1] != '/') {
+                dirname_len--;
+            }
+
+            // if the path is just a single character, or the path is too long, we cannot use this method
+            if (dirname_len < 2 || (path_len - dirname_len + 1) >= sizeof(server_address->sun_path)) {
+                errno = ENAMETOOLONG;
+                return LIBUS_SOCKET_ERROR;
+            }
+
+            char dirname_buf[4096];
+            if (dirname_len + 1 > sizeof(dirname_buf)) {
+                errno = ENAMETOOLONG;
+                return LIBUS_SOCKET_ERROR;
+            }
+
+            memcpy(dirname_buf, path, dirname_len);
+            dirname_buf[dirname_len] = 0;
+
+            int socket_dir_fd = open(dirname_buf, O_CLOEXEC | O_PATH | O_DIRECTORY, 0700);
+            if (socket_dir_fd == -1) {
+                errno = ENAMETOOLONG;
+                return LIBUS_SOCKET_ERROR;
+            }
+
+            int sun_path_len = snprintf(server_address->sun_path, sizeof(server_address->sun_path), "/proc/self/fd/%d/%s", socket_dir_fd, path + dirname_len);
+            if (sun_path_len >= sizeof(server_address->sun_path) || sun_path_len < 0) {
+                close(socket_dir_fd);
+                errno = ENAMETOOLONG;
+                return LIBUS_SOCKET_ERROR;
+            }
+
+            *dirfd_linux_workaround_for_unix_path_len = socket_dir_fd;
+            return 0;
+        } else if (path_len < sizeof(server_address->sun_path)) {
+            memcpy(server_address->sun_path, path, path_len);
+
+            // abstract domain sockets
+            if (server_address->sun_path[0] == 0) {
+                *addrlen = offsetof(struct sockaddr_un, sun_path) + path_len;
+            }
+
+            return 0;
+        }
+    #endif
+
+    if (path_len >= sizeof(server_address->sun_path)) {
+        #if defined(_WIN32)
+            // simulate ENAMETOOLONG
+            SetLastError(ERROR_FILENAME_EXCED_RANGE);    
+        #else
+            errno = ENAMETOOLONG;
+        #endif
+        
+        return LIBUS_SOCKET_ERROR;
+    }
+
+    memcpy(server_address->sun_path, path, path_len);
+    return 0;
+}
+
+static LIBUS_SOCKET_DESCRIPTOR internal_bsd_create_listen_socket_unix(const char* path, int options, struct sockaddr_un* server_address, size_t addrlen) {
     LIBUS_SOCKET_DESCRIPTOR listenFd = LIBUS_SOCKET_ERROR;
 
     listenFd = bsd_create_socket(AF_UNIX, SOCK_STREAM, 0);
@@ -579,25 +667,47 @@ LIBUS_SOCKET_DESCRIPTOR bsd_create_listen_socket_unix(const char *path, int opti
     _chmod(path, S_IREAD | S_IWRITE | S_IEXEC);
 #endif
 
-    struct sockaddr_un server_address;
-    memset(&server_address, 0, sizeof(server_address));
-    server_address.sun_family = AF_UNIX;
-    strcpy(server_address.sun_path, path);
-    int size = offsetof(struct sockaddr_un, sun_path) + strlen(server_address.sun_path);
 #ifdef _WIN32
     _unlink(path);
 #else
     unlink(path);
 #endif
 
-    if (bind(listenFd, (struct sockaddr *)&server_address, size) || listen(listenFd, 512)) {
+    if (bind(listenFd, (struct sockaddr *)server_address, addrlen) || listen(listenFd, 512)) {
+        #if defined(_WIN32)
+          int shouldSimulateENOENT = WSAGetLastError() == WSAENETDOWN;
+        #endif
         bsd_close_socket(listenFd);
+        #if defined(_WIN32)
+            if (shouldSimulateENOENT) {
+                SetLastError(ERROR_PATH_NOT_FOUND);
+            }
+        #endif
         return LIBUS_SOCKET_ERROR;
     }
 
     return listenFd;
 }
 
+LIBUS_SOCKET_DESCRIPTOR bsd_create_listen_socket_unix(const char *path, size_t len, int options) {
+    int dirfd_linux_workaround_for_unix_path_len = -1;
+    struct sockaddr_un server_address;
+    size_t addrlen = 0;
+    if (bsd_create_unix_socket_address(path, len, &dirfd_linux_workaround_for_unix_path_len, &server_address, &addrlen)) {
+        return LIBUS_SOCKET_ERROR;
+    }
+
+    LIBUS_SOCKET_DESCRIPTOR listenFd = internal_bsd_create_listen_socket_unix(path, options, &server_address, addrlen);
+
+#if defined(__linux__)
+    if (dirfd_linux_workaround_for_unix_path_len != -1) {
+        close(dirfd_linux_workaround_for_unix_path_len);
+    }
+#endif
+
+    return listenFd;
+}
+
 LIBUS_SOCKET_DESCRIPTOR bsd_create_udp_socket(const char *host, int port) {
     struct addrinfo hints, *result;
     memset(&hints, 0, sizeof(struct addrinfo));
@@ -614,7 +724,7 @@ LIBUS_SOCKET_DESCRIPTOR bsd_create_udp_socket(const char *host, int port) {
     }
 
     LIBUS_SOCKET_DESCRIPTOR listenFd = LIBUS_SOCKET_ERROR;
-    struct addrinfo *listenAddr;
+    struct addrinfo *listenAddr = NULL;
     for (struct addrinfo *a = result; a && listenFd == LIBUS_SOCKET_ERROR; a = a->ai_next) {
         if (a->ai_family == AF_INET6) {
             listenFd = bsd_create_socket(a->ai_family, a->ai_socktype, a->ai_protocol);
@@ -752,6 +862,64 @@ static int bsd_do_connect(struct addrinfo *rp, int *fd)
 }
 
 LIBUS_SOCKET_DESCRIPTOR bsd_create_connect_socket(const char *host, int port, const char *source_host, int options) {
+#ifdef _WIN32
+    // The caller (sometimes) uses NULL to indicate localhost. This works fine with getaddrinfo, but not with WSAConnectByName
+    if (!host) {
+        host = "localhost";
+    } else if (strcmp(host, "0.0.0.0") == 0 || strcmp(host, "::") == 0 || strcmp(host, "[::]") == 0) {
+        // windows disallows connecting to 0.0.0.0. To emulate POSIX behavior, we connect to localhost instead
+        // Also see https://docs.libuv.org/en/v1.x/tcp.html#c.uv_tcp_connect
+        host = "localhost";
+    }
+    // On windows we use WSAConnectByName to speed up connecting to localhost
+    // The other implementation also works on windows, but is slower
+    char port_string[16];
+    snprintf(port_string, 16, "%d", port);
+    SOCKET s = socket(AF_INET6, SOCK_STREAM, 0);
+    if (s == INVALID_SOCKET) {
+        return LIBUS_SOCKET_ERROR;
+    }
+
+    // https://learn.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-wsaconnectbynamea#remarks
+    DWORD zero = 0;
+    if (SOCKET_ERROR == setsockopt(s, IPPROTO_IPV6, IPV6_V6ONLY, (const char*)&zero, sizeof(DWORD))) {
+        closesocket(s);
+        return LIBUS_SOCKET_ERROR;
+    }
+    if (source_host) {
+        struct addrinfo *interface_result;
+        if (!getaddrinfo(source_host, NULL, NULL, &interface_result)) {
+            int ret = bind(s, interface_result->ai_addr, (socklen_t) interface_result->ai_addrlen);
+            freeaddrinfo(interface_result);
+            if (ret == SOCKET_ERROR) {
+                closesocket(s);
+                return LIBUS_SOCKET_ERROR;
+            }
+        }
+    }
+    SOCKADDR_STORAGE local;
+    SOCKADDR_STORAGE remote;
+    DWORD local_len = sizeof(local);
+    DWORD remote_len = sizeof(remote);
+    if (FALSE == WSAConnectByNameA(s, host, port_string, &local_len, (SOCKADDR*)&local, &remote_len, (SOCKADDR*)&remote, NULL, NULL)) {
+        closesocket(s);
+        return LIBUS_SOCKET_ERROR;
+    }
+
+    // See
+    // - https://stackoverflow.com/questions/60591081/getpeername-always-fails-with-error-code-wsaenotconn
+    // - https://learn.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-wsaconnectbynamea#remarks
+    //
+    // When the WSAConnectByName function returns TRUE, the socket s is in the default state for a connected socket. 
+    // The socket s does not enable previously set properties or options until SO_UPDATE_CONNECT_CONTEXT is set on the socket. 
+    // Use the setsockopt function to set the SO_UPDATE_CONNECT_CONTEXT option.
+    //
+    if (SOCKET_ERROR == setsockopt( s, SOL_SOCKET, SO_UPDATE_CONNECT_CONTEXT, NULL, 0 )) {
+        closesocket(s);
+        return LIBUS_SOCKET_ERROR;
+    }
+    return s;
+#else
     struct addrinfo hints, *result;
     memset(&hints, 0, sizeof(struct addrinfo));
     hints.ai_family = AF_UNSPEC;
@@ -797,26 +965,47 @@ LIBUS_SOCKET_DESCRIPTOR bsd_create_connect_socket(const char *host, int port, co
     
     freeaddrinfo(result);
     return fd;
+#endif
 }
 
-LIBUS_SOCKET_DESCRIPTOR bsd_create_connect_socket_unix(const char *server_path, int options) {
-
-    struct sockaddr_un server_address;
-    memset(&server_address, 0, sizeof(server_address));
-    server_address.sun_family = AF_UNIX;
-    strcpy(server_address.sun_path, server_path);
-    int size = offsetof(struct sockaddr_un, sun_path) + strlen(server_address.sun_path);
-
+static LIBUS_SOCKET_DESCRIPTOR internal_bsd_create_connect_socket_unix(const char *server_path, size_t len, int options, struct sockaddr_un* server_address, const size_t addrlen) {
     LIBUS_SOCKET_DESCRIPTOR fd = bsd_create_socket(AF_UNIX, SOCK_STREAM, 0);
 
     if (fd == LIBUS_SOCKET_ERROR) {
         return LIBUS_SOCKET_ERROR;
     }
 
-    if (connect(fd, (struct sockaddr *)&server_address, size) != 0 && errno != EINPROGRESS) {
+    if (connect(fd, (struct sockaddr *)server_address, addrlen) != 0 && errno != EINPROGRESS) {
+        #if defined(_WIN32)
+          int shouldSimulateENOENT = WSAGetLastError() == WSAENETDOWN;
+        #endif
         bsd_close_socket(fd);
+        #if defined(_WIN32)
+            if (shouldSimulateENOENT) {
+                SetLastError(ERROR_PATH_NOT_FOUND);
+            }
+        #endif
         return LIBUS_SOCKET_ERROR;
     }
 
     return fd;
 }
+
+LIBUS_SOCKET_DESCRIPTOR bsd_create_connect_socket_unix(const char *server_path, size_t len, int options) {
+    struct sockaddr_un server_address;
+    size_t addrlen = 0;
+    int dirfd_linux_workaround_for_unix_path_len = -1;
+    if (bsd_create_unix_socket_address(server_path, len, &dirfd_linux_workaround_for_unix_path_len, &server_address, &addrlen)) {
+        return LIBUS_SOCKET_ERROR;
+    }
+
+    LIBUS_SOCKET_DESCRIPTOR fd = internal_bsd_create_connect_socket_unix(server_path, len, options, &server_address, addrlen);
+
+    #if defined(__linux__)
+    if (dirfd_linux_workaround_for_unix_path_len != -1) {
+        close(dirfd_linux_workaround_for_unix_path_len);
+    }
+    #endif
+
+    return fd;
+}

packages/bun-usockets/src/context.c

@@ -221,19 +221,10 @@ struct us_socket_context_t *us_create_socket_context(int ssl, struct us_loop_t *
     /* This path is taken once either way - always BEFORE whatever SSL may do LATER.
      * context_ext_size will however be modified larger in case of SSL, to hold SSL extensions */
 
-    struct us_socket_context_t *context = us_malloc(sizeof(struct us_socket_context_t) + context_ext_size);
+    struct us_socket_context_t *context = us_calloc(1, sizeof(struct us_socket_context_t) + context_ext_size);
     context->loop = loop;
-    context->head_sockets = 0;
-    context->head_listen_sockets = 0;
-    context->iterator = 0;
-    context->next = 0;
     context->is_low_prio = default_is_low_prio_handler;
 
-    /* Begin at 0 */
-    context->timestamp = 0;
-    context->long_timestamp = 0;
-    context->global_tick = 0;
-
     us_internal_loop_link(loop, context);
 
     /* If we are called from within SSL code, SSL code will make further changes to us */
@@ -251,19 +242,10 @@ struct us_socket_context_t *us_create_bun_socket_context(int ssl, struct us_loop
     /* This path is taken once either way - always BEFORE whatever SSL may do LATER.
      * context_ext_size will however be modified larger in case of SSL, to hold SSL extensions */
 
-    struct us_socket_context_t *context = us_malloc(sizeof(struct us_socket_context_t) + context_ext_size);
+    struct us_socket_context_t *context = us_calloc(1, sizeof(struct us_socket_context_t) + context_ext_size);
     context->loop = loop;
-    context->head_sockets = 0;
-    context->head_listen_sockets = 0;
-    context->iterator = 0;
-    context->next = 0;
     context->is_low_prio = default_is_low_prio_handler;
 
-    /* Begin at 0 */
-    context->timestamp = 0;
-    context->long_timestamp = 0;
-    context->global_tick = 0;
-
     us_internal_loop_link(loop, context);
 
     /* If we are called from within SSL code, SSL code will make further changes to us */
@@ -330,14 +312,14 @@ struct us_listen_socket_t *us_socket_context_listen(int ssl, struct us_socket_co
     return ls;
 }
 
-struct us_listen_socket_t *us_socket_context_listen_unix(int ssl, struct us_socket_context_t *context, const char *path, int options, int socket_ext_size) {
+struct us_listen_socket_t *us_socket_context_listen_unix(int ssl, struct us_socket_context_t *context, const char *path, size_t pathlen, int options, int socket_ext_size) {
 #ifndef LIBUS_NO_SSL
     if (ssl) {
-        return us_internal_ssl_socket_context_listen_unix((struct us_internal_ssl_socket_context_t *) context, path, options, socket_ext_size);
+        return us_internal_ssl_socket_context_listen_unix((struct us_internal_ssl_socket_context_t *) context, path, pathlen, options, socket_ext_size);
     }
 #endif
 
-    LIBUS_SOCKET_DESCRIPTOR listen_socket_fd = bsd_create_listen_socket_unix(path, options);
+    LIBUS_SOCKET_DESCRIPTOR listen_socket_fd = bsd_create_listen_socket_unix(path, pathlen, options);
 
     if (listen_socket_fd == LIBUS_SOCKET_ERROR) {
         return 0;
@@ -390,14 +372,14 @@ struct us_socket_t *us_socket_context_connect(int ssl, struct us_socket_context_
     return connect_socket;
 }
 
-struct us_socket_t *us_socket_context_connect_unix(int ssl, struct us_socket_context_t *context, const char *server_path, int options, int socket_ext_size) {
+struct us_socket_t *us_socket_context_connect_unix(int ssl, struct us_socket_context_t *context, const char *server_path, size_t pathlen, int options, int socket_ext_size) {
 #ifndef LIBUS_NO_SSL
     if (ssl) {
-        return (struct us_socket_t *) us_internal_ssl_socket_context_connect_unix((struct us_internal_ssl_socket_context_t *) context, server_path, options, socket_ext_size);
+        return (struct us_socket_t *) us_internal_ssl_socket_context_connect_unix((struct us_internal_ssl_socket_context_t *) context, server_path, pathlen, options, socket_ext_size);
     }
 #endif
 
-    LIBUS_SOCKET_DESCRIPTOR connect_socket_fd = bsd_create_connect_socket_unix(server_path, options);
+    LIBUS_SOCKET_DESCRIPTOR connect_socket_fd = bsd_create_connect_socket_unix(server_path, pathlen, options);
     if (connect_socket_fd == LIBUS_SOCKET_ERROR) {
         return 0;
     }