fix(fs): handle '.' path normalization on Windows (#26634)

## Summary
- Fix path normalization for "." on Windows where `normalizeStringBuf`
was incorrectly stripping it to an empty string
- This caused `existsSync('.')`, `statSync('.')`, and other fs
operations to fail on Windows

## Test plan
- Added regression test `test/regression/issue/26631.test.ts` that tests
`existsSync`, `exists`, `statSync`, and `stat` for both `.` and `..`
paths
- All tests pass locally with `bun bd test
test/regression/issue/26631.test.ts`
- Verified code compiles on all platforms with `bun run zig:check-all`

Fixes #26631

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Bot <claude-bot@bun.sh>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

.aikido

@@ -0,0 +1,19 @@
+exclude:
+  paths:
+    - test
+    - scripts
+    - bench
+    - packages/bun-lambda
+    - packages/bun-release
+    - packages/bun-wasm
+    - packages/bun-vscode
+    - packages/bun-plugin-yaml
+    - packages/bun-plugin-svelte
+    - packages/bun-native-plugin-rs
+    - packages/bun-native-bundler-plugin-api
+    - packages/bun-inspector-protocol
+    - packages/bun-inspector-frontend
+    - packages/bun-error
+    - packages/bun-debug-adapter-protocol
+    - packages/bun-build-mdx-rs
+    - packages/@types/bun

.buildkite/Dockerfile

@@ -0,0 +1,177 @@
+ARG LLVM_VERSION="19"
+ARG REPORTED_LLVM_VERSION="19.1.7"
+ARG OLD_BUN_VERSION="1.1.38"
+ARG BUILDKITE_AGENT_TAGS="queue=linux,os=linux,arch=${TARGETARCH}"
+
+FROM --platform=$BUILDPLATFORM ubuntu:20.04 as base-arm64
+FROM --platform=$BUILDPLATFORM ubuntu:20.04 as base-amd64
+FROM base-$TARGETARCH as base
+
+ARG LLVM_VERSION
+ARG OLD_BUN_VERSION
+ARG TARGETARCH
+ARG REPORTED_LLVM_VERSION
+
+ENV DEBIAN_FRONTEND=noninteractive \
+   CI=true \
+   DOCKER=true
+
+RUN echo "Acquire::Queue-Mode \"host\";" > /etc/apt/apt.conf.d/99-apt-queue-mode.conf \
+    && echo "Acquire::Timeout \"120\";" >> /etc/apt/apt.conf.d/99-apt-timeout.conf \
+    && echo "Acquire::Retries \"3\";" >> /etc/apt/apt.conf.d/99-apt-retries.conf \
+    && echo "APT::Install-Recommends \"false\";" >> /etc/apt/apt.conf.d/99-apt-install-recommends.conf \
+    && echo "APT::Install-Suggests \"false\";" >> /etc/apt/apt.conf.d/99-apt-install-suggests.conf
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+   wget curl git python3 python3-pip ninja-build \
+   software-properties-common apt-transport-https \
+   ca-certificates gnupg lsb-release unzip \
+   libxml2-dev ruby ruby-dev bison gawk perl make golang ccache qemu-user-static \
+   && add-apt-repository ppa:ubuntu-toolchain-r/test \
+   && apt-get update \
+   && apt-get install -y gcc-13 g++-13 libgcc-13-dev libstdc++-13-dev \
+       libasan6 libubsan1 libatomic1 libtsan0 liblsan0 \
+       libgfortran5 libc6-dev \
+   && wget https://apt.llvm.org/llvm.sh \
+   && chmod +x llvm.sh \
+   && ./llvm.sh ${LLVM_VERSION} all \
+   && rm llvm.sh \
+   && rm -rf /var/lib/apt/lists/*
+
+
+RUN --mount=type=tmpfs,target=/tmp \
+    cmake_version="3.30.5" && \
+    if [ "$TARGETARCH" = "arm64" ]; then \
+        cmake_url="https://github.com/Kitware/CMake/releases/download/v${cmake_version}/cmake-${cmake_version}-linux-aarch64.sh"; \
+    else \
+        cmake_url="https://github.com/Kitware/CMake/releases/download/v${cmake_version}/cmake-${cmake_version}-linux-x86_64.sh"; \
+    fi && \
+    wget -O /tmp/cmake.sh "$cmake_url" && \
+    sh /tmp/cmake.sh --skip-license --prefix=/usr
+
+RUN update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-13 130 \
+   --slave /usr/bin/g++ g++ /usr/bin/g++-13 \
+   --slave /usr/bin/gcc-ar gcc-ar /usr/bin/gcc-ar-13 \
+   --slave /usr/bin/gcc-nm gcc-nm /usr/bin/gcc-nm-13 \
+   --slave /usr/bin/gcc-ranlib gcc-ranlib /usr/bin/gcc-ranlib-13
+
+RUN echo "ARCH_PATH=$([ "$TARGETARCH" = "arm64" ] && echo "aarch64-linux-gnu" || echo "x86_64-linux-gnu")" >> /etc/environment \
+   && echo "BUN_ARCH=$([ "$TARGETARCH" = "arm64" ] && echo "aarch64" || echo "x64")" >> /etc/environment
+
+ENV LD_LIBRARY_PATH=/usr/lib/gcc/${ARCH_PATH}/13:/usr/lib/${ARCH_PATH} \
+   LIBRARY_PATH=/usr/lib/gcc/${ARCH_PATH}/13:/usr/lib/${ARCH_PATH} \
+   CPLUS_INCLUDE_PATH=/usr/include/c++/13:/usr/include/${ARCH_PATH}/c++/13 \
+   C_INCLUDE_PATH=/usr/lib/gcc/${ARCH_PATH}/13/include
+
+RUN if [ "$TARGETARCH" = "arm64" ]; then \
+       export ARCH_PATH="aarch64-linux-gnu"; \
+   else \
+       export ARCH_PATH="x86_64-linux-gnu"; \
+   fi \
+   && mkdir -p /usr/lib/gcc/${ARCH_PATH}/13 \
+   && ln -sf /usr/lib/${ARCH_PATH}/libstdc++.so.6 /usr/lib/gcc/${ARCH_PATH}/13/ \
+   && echo "/usr/lib/gcc/${ARCH_PATH}/13" > /etc/ld.so.conf.d/gcc-13.conf \
+   && echo "/usr/lib/${ARCH_PATH}" >> /etc/ld.so.conf.d/gcc-13.conf \
+   && ldconfig
+
+RUN for f in /usr/lib/llvm-${LLVM_VERSION}/bin/*; do ln -sf "$f" /usr/bin; done \
+   && ln -sf /usr/bin/clang-${LLVM_VERSION} /usr/bin/clang \
+   && ln -sf /usr/bin/clang++-${LLVM_VERSION} /usr/bin/clang++ \
+   && ln -sf /usr/bin/lld-${LLVM_VERSION} /usr/bin/lld \
+   && ln -sf /usr/bin/lldb-${LLVM_VERSION} /usr/bin/lldb \
+   && ln -sf /usr/bin/clangd-${LLVM_VERSION} /usr/bin/clangd \
+   && ln -sf /usr/bin/llvm-ar-${LLVM_VERSION} /usr/bin/llvm-ar \
+   && ln -sf /usr/bin/ld.lld /usr/bin/ld \
+   && ln -sf /usr/bin/clang /usr/bin/cc \
+   && ln -sf /usr/bin/clang++ /usr/bin/c++
+
+ENV CC="clang" \
+   CXX="clang++" \
+   AR="llvm-ar-${LLVM_VERSION}" \
+   RANLIB="llvm-ranlib-${LLVM_VERSION}" \
+   LD="lld-${LLVM_VERSION}"
+
+RUN --mount=type=tmpfs,target=/tmp \
+   bash -c '\
+      set -euxo pipefail && \
+      source /etc/environment && \
+      echo "Downloading bun-v${OLD_BUN_VERSION}/bun-linux-$BUN_ARCH.zip from https://pub-5e11e972747a44bf9aaf9394f185a982.r2.dev/releases/bun-v${OLD_BUN_VERSION}/bun-linux-$BUN_ARCH.zip" && \
+      curl -fsSL https://pub-5e11e972747a44bf9aaf9394f185a982.r2.dev/releases/bun-v${OLD_BUN_VERSION}/bun-linux-$BUN_ARCH.zip -o /tmp/bun.zip && \
+      unzip /tmp/bun.zip -d /tmp/bun && \
+      mv /tmp/bun/*/bun /usr/bin/bun && \
+      chmod +x /usr/bin/bun'
+
+ENV LLVM_VERSION=${REPORTED_LLVM_VERSION}
+
+WORKDIR /workspace
+
+
+FROM --platform=$BUILDPLATFORM base as buildkite
+ARG BUILDKITE_AGENT_TAGS
+
+
+# Install Rust nightly
+RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y \
+    && export PATH=$HOME/.cargo/bin:$PATH \
+    && rustup install nightly \
+    && rustup default nightly
+
+
+RUN ARCH=$(if [ "$TARGETARCH" = "arm64" ]; then echo "arm64"; else echo "amd64"; fi) && \
+    echo "Downloading buildkite" && \
+    curl -fsSL "https://github.com/buildkite/agent/releases/download/v3.87.0/buildkite-agent-linux-${ARCH}-3.87.0.tar.gz" -o /tmp/buildkite-agent.tar.gz && \
+    mkdir -p /tmp/buildkite-agent && \
+    tar -xzf /tmp/buildkite-agent.tar.gz -C /tmp/buildkite-agent && \
+    mv /tmp/buildkite-agent/buildkite-agent /usr/bin/buildkite-agent
+
+RUN mkdir -p /var/cache/buildkite-agent /var/log/buildkite-agent /var/run/buildkite-agent /etc/buildkite-agent /var/lib/buildkite-agent/cache/bun
+
+# The following is necessary to configure buildkite to use a stable
+# checkout directory for ccache to be effective.
+RUN mkdir -p -m 755 /var/lib/buildkite-agent/hooks && \
+    cat <<'EOF' > /var/lib/buildkite-agent/hooks/environment
+#!/bin/sh
+set -efu
+
+export BUILDKITE_BUILD_CHECKOUT_PATH=/var/lib/buildkite-agent/build
+EOF
+
+RUN chmod 744 /var/lib/buildkite-agent/hooks/environment
+
+COPY  ../*/agent.mjs /var/bun/scripts/
+
+ENV BUN_INSTALL_CACHE=/var/lib/buildkite-agent/cache/bun
+ENV BUILDKITE_AGENT_TAGS=${BUILDKITE_AGENT_TAGS}
+
+
+WORKDIR /var/bun/scripts
+
+ENV PATH=/root/.cargo/bin:$PATH
+
+
+CMD ["bun", "/var/bun/scripts/agent.mjs", "start"]
+
+FROM --platform=$BUILDPLATFORM base as bun-build-linux-local
+
+ARG LLVM_VERSION
+WORKDIR /workspace/bun
+
+COPY . /workspace/bun
+
+
+# Install Rust nightly
+RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y \
+    && export PATH=$HOME/.cargo/bin:$PATH \
+    && rustup install nightly \
+    && rustup default nightly
+
+ENV PATH=/root/.cargo/bin:$PATH
+
+ENV LLVM_VERSION=${REPORTED_LLVM_VERSION}
+
+
+RUN --mount=type=tmpfs,target=/workspace/bun/build \
+    ls -la \
+    && bun run build:release \
+    && mkdir -p /target \
+    && cp -r /workspace/bun/build/release/bun /target/bun

.buildkite/Dockerfile-bootstrap.sh

@@ -0,0 +1,122 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Check if running as root
+if [ "$EUID" -ne 0 ]; then
+    echo "error: must run as root"
+    exit 1
+fi
+
+# Check OS compatibility
+if ! command -v dnf &> /dev/null; then
+    echo "error: this script requires dnf (RHEL/Fedora/CentOS)"
+    exit 1
+fi
+
+# Ensure /tmp/agent.mjs, /tmp/Dockerfile are present
+if [ ! -f /tmp/agent.mjs ] || [ ! -f /tmp/Dockerfile ]; then
+    # Print each missing file
+    if [ ! -f /tmp/agent.mjs ]; then
+        echo "error: /tmp/agent.mjs is missing"
+    fi
+    if [ ! -f /tmp/Dockerfile ]; then
+        echo "error: /tmp/Dockerfile is missing"
+    fi
+    exit 1
+fi
+
+# Install Docker
+dnf update -y
+dnf install -y docker
+
+systemctl enable docker
+systemctl start docker || {
+    echo "error: failed to start Docker"
+    exit 1
+}
+
+# Create builder
+docker buildx create --name builder --driver docker-container --bootstrap --use || {
+    echo "error: failed to create Docker buildx builder"
+    exit 1
+}
+
+# Set up Docker to start on boot
+cat << 'EOF' > /etc/systemd/system/buildkite-agent.service
+[Unit]
+Description=Buildkite Docker Container
+After=docker.service network-online.target
+Requires=docker.service network-online.target
+
+[Service]
+TimeoutStartSec=0
+Restart=always
+RestartSec=5
+ExecStartPre=-/usr/bin/docker stop buildkite
+ExecStartPre=-/usr/bin/docker rm buildkite
+ExecStart=/usr/bin/docker run \
+    --name buildkite \
+    --restart=unless-stopped \
+    --network host \
+    -v /var/run/docker.sock:/var/run/docker.sock \
+    -v /tmp:/tmp \
+    buildkite:latest
+
+[Install]
+WantedBy=multi-user.target
+EOF
+
+echo "Building Buildkite image"
+
+# Clean up any previous build artifacts
+rm -rf /tmp/fakebun
+mkdir -p /tmp/fakebun/scripts /tmp/fakebun/.buildkite
+
+# Copy required files
+cp /tmp/agent.mjs /tmp/fakebun/scripts/ || {
+    echo "error: failed to copy agent.mjs"
+    exit 1
+}
+cp /tmp/Dockerfile /tmp/fakebun/.buildkite/Dockerfile || {
+    echo "error: failed to copy Dockerfile"
+    exit 1
+}
+
+cd /tmp/fakebun || {
+    echo "error: failed to change directory"
+    exit 1
+}
+
+# Build the Buildkite image
+docker buildx build \
+    --platform $(uname -m | sed 's/aarch64/linux\/arm64/;s/x86_64/linux\/amd64/') \
+    --tag buildkite:latest \
+    --target buildkite \
+    -f .buildkite/Dockerfile \
+    --load \
+    . || {
+    echo "error: Docker build failed"
+    exit 1
+}
+
+# Create container to ensure image is cached in AMI
+docker container create \
+    --name buildkite \
+    --restart=unless-stopped \
+    buildkite:latest || {
+    echo "error: failed to create buildkite container"
+    exit 1
+}
+
+# Reload systemd to pick up new service
+systemctl daemon-reload
+
+# Enable the service, but don't start it yet
+systemctl enable buildkite-agent || {
+    echo "error: failed to enable buildkite-agent service"
+    exit 1
+}
+
+echo "Bootstrap complete"
+echo "To start the Buildkite agent, run: "
+echo "  systemctl start buildkite-agent"

.buildkite/bootstrap.yml

@@ -0,0 +1,16 @@
+# Uploads the latest CI workflow to Buildkite.
+# https://buildkite.com/docs/pipelines/defining-steps
+#
+# Changes to this file must be manually edited here:
+# https://buildkite.com/bun/bun/settings/steps
+steps:
+  - if: "build.pull_request.repository.fork"
+    block: ":eyes:"
+    prompt: "Did you review the PR?"
+    blocked_state: "running"
+
+  - label: ":pipeline:"
+    agents:
+      queue: "build-darwin"
+    command:
+      - "node .buildkite/ci.mjs"

.buildkite/scripts/sign-windows.ps1

@@ -0,0 +1,470 @@
+# Windows Code Signing Script for Bun
+# Uses DigiCert KeyLocker for Authenticode signing
+# Native PowerShell implementation - no path translation issues
+
+param(
+    [Parameter(Mandatory=$true)]
+    [string]$BunProfileExe,
+    
+    [Parameter(Mandatory=$true)]
+    [string]$BunExe
+)
+
+$ErrorActionPreference = "Stop"
+$ProgressPreference = "SilentlyContinue"
+
+# Logging functions
+function Log-Info {
+    param([string]$Message)
+    Write-Host "[INFO] $Message" -ForegroundColor Cyan
+}
+
+function Log-Success {
+    param([string]$Message)
+    Write-Host "[SUCCESS] $Message" -ForegroundColor Green
+}
+
+function Log-Error {
+    param([string]$Message)
+    Write-Host "[ERROR] $Message" -ForegroundColor Red
+}
+
+function Log-Debug {
+    param([string]$Message)
+    if ($env:DEBUG -eq "true" -or $env:DEBUG -eq "1") {
+        Write-Host "[DEBUG] $Message" -ForegroundColor Gray
+    }
+}
+
+# Detect system architecture
+$script:IsARM64 = [System.Runtime.InteropServices.RuntimeInformation]::OSArchitecture -eq [System.Runtime.InteropServices.Architecture]::Arm64
+$script:VsArch = if ($script:IsARM64) { "arm64" } else { "amd64" }
+
+# Load Visual Studio environment if not already loaded
+function Ensure-VSEnvironment {
+    if ($null -eq $env:VSINSTALLDIR) {
+        Log-Info "Loading Visual Studio environment for $script:VsArch..."
+
+        $vswhere = "C:\Program Files (x86)\Microsoft Visual Studio\Installer\vswhere.exe"
+        if (!(Test-Path $vswhere)) {
+            throw "Command not found: vswhere (did you install Visual Studio?)"
+        }
+
+        $vsDir = & $vswhere -prerelease -latest -property installationPath
+        if ($null -eq $vsDir) {
+            $vsDir = Get-ChildItem -Path "C:\Program Files\Microsoft Visual Studio\2022" -Directory -ErrorAction SilentlyContinue
+            if ($null -eq $vsDir) {
+                throw "Visual Studio directory not found."
+            }
+            $vsDir = $vsDir.FullName
+        }
+
+        Push-Location $vsDir
+        try {
+            $vsShell = Join-Path -Path $vsDir -ChildPath "Common7\Tools\Launch-VsDevShell.ps1"
+            . $vsShell -Arch $script:VsArch -HostArch $script:VsArch
+        } finally {
+            Pop-Location
+        }
+
+        Log-Success "Visual Studio environment loaded"
+    }
+
+    if ($env:VSCMD_ARG_TGT_ARCH -eq "x86") {
+        throw "Visual Studio environment is targeting 32 bit x86, but only 64-bit architectures (x64/arm64) are supported."
+    }
+}
+
+# Check for required environment variables
+function Check-Environment {
+    Log-Info "Checking environment variables..."
+    
+    $required = @{
+        "SM_API_KEY" = $env:SM_API_KEY
+        "SM_CLIENT_CERT_PASSWORD" = $env:SM_CLIENT_CERT_PASSWORD
+        "SM_KEYPAIR_ALIAS" = $env:SM_KEYPAIR_ALIAS
+        "SM_HOST" = $env:SM_HOST
+        "SM_CLIENT_CERT_FILE" = $env:SM_CLIENT_CERT_FILE
+    }
+    
+    $missing = @()
+    foreach ($key in $required.Keys) {
+        if ([string]::IsNullOrEmpty($required[$key])) {
+            $missing += $key
+        } else {
+            Log-Debug "$key is set (length: $($required[$key].Length))"
+        }
+    }
+    
+    if ($missing.Count -gt 0) {
+        throw "Missing required environment variables: $($missing -join ', ')"
+    }
+    
+    Log-Success "All required environment variables are present"
+}
+
+# Setup certificate file
+function Setup-Certificate {
+    Log-Info "Setting up certificate..."
+    
+    # Always try to decode as base64 first
+    # If it fails, then treat as file path
+    try {
+        Log-Info "Attempting to decode certificate as base64..."
+        Log-Debug "Input string length: $($env:SM_CLIENT_CERT_FILE.Length) characters"
+        
+        $tempCertPath = Join-Path $env:TEMP "digicert_cert_$(Get-Random).p12"
+        
+        # Try to decode as base64
+        $certBytes = [System.Convert]::FromBase64String($env:SM_CLIENT_CERT_FILE)
+        [System.IO.File]::WriteAllBytes($tempCertPath, $certBytes)
+        
+        # Validate the decoded certificate size
+        $fileSize = (Get-Item $tempCertPath).Length
+        if ($fileSize -lt 100) {
+            throw "Decoded certificate too small: $fileSize bytes (expected >100 bytes)"
+        }
+        
+        # Update environment to point to file
+        $env:SM_CLIENT_CERT_FILE = $tempCertPath
+        
+        Log-Success "Certificate decoded and written to: $tempCertPath"
+        Log-Debug "Decoded certificate file size: $fileSize bytes"
+        
+        # Register cleanup
+        $global:TEMP_CERT_PATH = $tempCertPath
+        
+    } catch {
+        # If base64 decode fails, check if it's a file path
+        Log-Info "Base64 decode failed, checking if it's a file path..."
+        Log-Debug "Decode error: $_"
+        
+        if (Test-Path $env:SM_CLIENT_CERT_FILE) {
+            $fileSize = (Get-Item $env:SM_CLIENT_CERT_FILE).Length
+            
+            # Validate file size
+            if ($fileSize -lt 100) {
+                throw "Certificate file too small: $fileSize bytes at $env:SM_CLIENT_CERT_FILE (possibly corrupted)"
+            }
+            
+            Log-Info "Using certificate file: $env:SM_CLIENT_CERT_FILE"
+            Log-Debug "Certificate file size: $fileSize bytes"
+        } else {
+            throw "SM_CLIENT_CERT_FILE is neither valid base64 nor an existing file: $env:SM_CLIENT_CERT_FILE"
+        }
+    }
+}
+
+# Install DigiCert KeyLocker tools
+function Install-KeyLocker {
+    Log-Info "Setting up DigiCert KeyLocker tools..."
+    
+    # Define our controlled installation directory
+    $installDir = "C:\BuildTools\DigiCert"
+    $smctlPath = Join-Path $installDir "smctl.exe"
+    
+    # Check if already installed in our controlled location
+    if (Test-Path $smctlPath) {
+        Log-Success "KeyLocker tools already installed at: $smctlPath"
+        
+        # Add to PATH if not already there
+        if ($env:PATH -notlike "*$installDir*") {
+            $env:PATH = "$installDir;$env:PATH"
+            Log-Info "Added to PATH: $installDir"
+        }
+        
+        return $smctlPath
+    }
+    
+    Log-Info "Installing KeyLocker tools to: $installDir"
+    
+    # Create the installation directory if it doesn't exist
+    if (!(Test-Path $installDir)) {
+        Log-Info "Creating installation directory: $installDir"
+        try {
+            New-Item -ItemType Directory -Path $installDir -Force | Out-Null
+            Log-Success "Created directory: $installDir"
+        } catch {
+            throw "Failed to create directory $installDir : $_"
+        }
+    }
+    
+    # Download MSI installer
+    # Note: KeyLocker tools currently only available for x64, but works on ARM64 via emulation
+    $msiArch = "x64"
+    $msiUrl = "https://bun-ci-assets.bun.sh/Keylockertools-windows-${msiArch}.msi"
+    $msiPath = Join-Path $env:TEMP "Keylockertools-windows-${msiArch}.msi"
+    
+    Log-Info "Downloading MSI from: $msiUrl"
+    Log-Info "Downloading to: $msiPath"
+    
+    try {
+        # Remove existing MSI if present
+        if (Test-Path $msiPath) {
+            Remove-Item $msiPath -Force
+            Log-Debug "Removed existing MSI file"
+        }
+        
+        # Download with progress tracking
+        $webClient = New-Object System.Net.WebClient
+        $webClient.DownloadFile($msiUrl, $msiPath)
+        
+        if (!(Test-Path $msiPath)) {
+            throw "MSI download failed - file not found"
+        }
+        
+        $fileSize = (Get-Item $msiPath).Length
+        Log-Success "MSI downloaded successfully (size: $fileSize bytes)"
+        
+    } catch {
+        throw "Failed to download MSI: $_"
+    }
+    
+    # Install MSI
+    Log-Info "Installing MSI..."
+    Log-Debug "MSI path: $msiPath"
+    Log-Debug "File exists: $(Test-Path $msiPath)"
+    Log-Debug "File size: $((Get-Item $msiPath).Length) bytes"
+    
+    # Check if running as administrator
+    $isAdmin = ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
+    Log-Info "Running as administrator: $isAdmin"
+    
+    # Install MSI silently to our controlled directory
+    $arguments = @(
+        "/i", "`"$msiPath`"",
+        "/quiet",
+        "/norestart",
+        "TARGETDIR=`"$installDir`"",
+        "INSTALLDIR=`"$installDir`"",
+        "ACCEPT_EULA=1",
+        "ADDLOCAL=ALL"
+    )
+    
+    Log-Debug "Running: msiexec.exe $($arguments -join ' ')"
+    Log-Info "Installing to: $installDir"
+    
+    $process = Start-Process -FilePath "msiexec.exe" -ArgumentList $arguments -Wait -PassThru -NoNewWindow
+    
+    if ($process.ExitCode -ne 0) {
+        Log-Error "MSI installation failed with exit code: $($process.ExitCode)"
+        
+        # Try to get error details from event log
+        try {
+            $events = Get-WinEvent -LogName "Application" -MaxEvents 10 | 
+                Where-Object { $_.ProviderName -eq "MsiInstaller" -and $_.TimeCreated -gt (Get-Date).AddMinutes(-1) }
+            
+            foreach ($event in $events) {
+                Log-Debug "MSI Event: $($event.Message)"
+            }
+        } catch {
+            Log-Debug "Could not retrieve MSI installation events"
+        }
+        
+        throw "MSI installation failed with exit code: $($process.ExitCode)"
+    }
+    
+    Log-Success "MSI installation completed"
+    
+    # Wait for installation to complete
+    Start-Sleep -Seconds 2
+    
+    # Verify smctl.exe exists in our controlled location
+    if (Test-Path $smctlPath) {
+        Log-Success "KeyLocker tools installed successfully at: $smctlPath"
+        
+        # Add to PATH
+        $env:PATH = "$installDir;$env:PATH"
+        Log-Info "Added to PATH: $installDir"
+        
+        return $smctlPath
+    }
+    
+    # If not in our expected location, check if it installed somewhere in the directory
+    $found = Get-ChildItem -Path $installDir -Filter "smctl.exe" -Recurse -ErrorAction SilentlyContinue | 
+        Select-Object -First 1
+    
+    if ($found) {
+        Log-Success "Found smctl.exe at: $($found.FullName)"
+        $smctlDir = $found.DirectoryName
+        $env:PATH = "$smctlDir;$env:PATH"
+        return $found.FullName
+    }
+    
+    throw "KeyLocker tools installation succeeded but smctl.exe not found in $installDir"
+}
+
+# Configure KeyLocker
+function Configure-KeyLocker {
+    param([string]$SmctlPath)
+    
+    Log-Info "Configuring KeyLocker..."
+    
+    # Verify smctl is accessible
+    try {
+        $version = & $SmctlPath --version 2>&1
+        Log-Debug "smctl version: $version"
+    } catch {
+        throw "Failed to run smctl: $_"
+    }
+    
+    # Configure KeyLocker credentials and environment
+    Log-Info "Configuring KeyLocker credentials..."
+    
+    try {
+        # Save credentials (API key and password)
+        Log-Info "Saving credentials to OS store..."
+        $saveOutput = & $SmctlPath credentials save $env:SM_API_KEY $env:SM_CLIENT_CERT_PASSWORD 2>&1 | Out-String
+        Log-Debug "Credentials save output: $saveOutput"
+        
+        if ($saveOutput -like "*Credentials saved*") {
+            Log-Success "Credentials saved successfully"
+        }
+        
+        # Set environment variables for smctl
+        Log-Info "Setting KeyLocker environment variables..."
+        $env:SM_HOST = $env:SM_HOST  # Already set, but ensure it's available
+        $env:SM_API_KEY = $env:SM_API_KEY  # Already set
+        $env:SM_CLIENT_CERT_FILE = $env:SM_CLIENT_CERT_FILE  # Path to decoded cert file
+        Log-Debug "SM_HOST: $env:SM_HOST"
+        Log-Debug "SM_CLIENT_CERT_FILE: $env:SM_CLIENT_CERT_FILE"
+        
+        # Run health check
+        Log-Info "Running KeyLocker health check..."
+        $healthOutput = & $SmctlPath healthcheck 2>&1 | Out-String
+        Log-Debug "Health check output: $healthOutput"
+        
+        if ($healthOutput -like "*Healthy*" -or $healthOutput -like "*SUCCESS*" -or $LASTEXITCODE -eq 0) {
+            Log-Success "KeyLocker health check passed"
+        } else {
+            Log-Error "Health check failed: $healthOutput"
+            # Don't throw here, sometimes healthcheck is flaky but signing still works
+        }
+        
+        # Sync certificates to Windows certificate store
+        Log-Info "Syncing certificates to Windows store..."
+        $syncOutput = & $SmctlPath windows certsync 2>&1 | Out-String
+        Log-Debug "Certificate sync output: $syncOutput"
+        
+        if ($syncOutput -like "*success*" -or $syncOutput -like "*synced*" -or $LASTEXITCODE -eq 0) {
+            Log-Success "Certificates synced to Windows store"
+        } else {
+            Log-Info "Certificate sync output: $syncOutput"
+        }
+        
+    } catch {
+        throw "Failed to configure KeyLocker: $_"
+    }
+}
+
+# Sign an executable
+function Sign-Executable {
+    param(
+        [string]$ExePath,
+        [string]$SmctlPath
+    )
+    
+    if (!(Test-Path $ExePath)) {
+        throw "Executable not found: $ExePath"
+    }
+    
+    $fileName = Split-Path $ExePath -Leaf
+    Log-Info "Signing $fileName..."
+    Log-Debug "Full path: $ExePath"
+    Log-Debug "File size: $((Get-Item $ExePath).Length) bytes"
+    
+    # Check if already signed
+    $existingSig = Get-AuthenticodeSignature $ExePath
+    if ($existingSig.Status -eq "Valid") {
+        Log-Info "$fileName is already signed by: $($existingSig.SignerCertificate.Subject)"
+        Log-Info "Skipping re-signing"
+        return
+    }
+    
+    # Sign the executable using smctl
+    try {
+        # smctl sign command with keypair-alias
+        $signArgs = @(
+            "sign",
+            "--keypair-alias", $env:SM_KEYPAIR_ALIAS,
+            "--input", $ExePath,
+            "--verbose"
+        )
+        
+        Log-Debug "Running: $SmctlPath $($signArgs -join ' ')"
+        
+        $signOutput = & $SmctlPath $signArgs 2>&1 | Out-String
+        
+        if ($LASTEXITCODE -ne 0) {
+            Log-Error "Signing output: $signOutput"
+            throw "Signing failed with exit code: $LASTEXITCODE"
+        }
+        
+        Log-Debug "Signing output: $signOutput"
+        Log-Success "Signing command completed"
+        
+    } catch {
+        throw "Failed to sign $fileName : $_"
+    }
+    
+    # Verify signature
+    $newSig = Get-AuthenticodeSignature $ExePath
+    
+    if ($newSig.Status -eq "Valid") {
+        Log-Success "$fileName signed successfully"
+        Log-Info "Signed by: $($newSig.SignerCertificate.Subject)"
+        Log-Info "Thumbprint: $($newSig.SignerCertificate.Thumbprint)"
+        Log-Info "Valid from: $($newSig.SignerCertificate.NotBefore) to $($newSig.SignerCertificate.NotAfter)"
+    } else {
+        throw "$fileName signature verification failed: $($newSig.Status) - $($newSig.StatusMessage)"
+    }
+}
+
+# Cleanup function
+function Cleanup {
+    if ($global:TEMP_CERT_PATH -and (Test-Path $global:TEMP_CERT_PATH)) {
+        try {
+            Remove-Item $global:TEMP_CERT_PATH -Force
+            Log-Info "Cleaned up temporary certificate"
+        } catch {
+            Log-Error "Failed to cleanup temporary certificate: $_"
+        }
+    }
+}
+
+# Main execution
+try {
+    Write-Host "========================================" -ForegroundColor Cyan
+    Write-Host "  Windows Code Signing for Bun" -ForegroundColor Cyan
+    Write-Host "========================================" -ForegroundColor Cyan
+    
+    # Ensure we're in a VS environment
+    Ensure-VSEnvironment
+    
+    # Check environment variables
+    Check-Environment
+    
+    # Setup certificate
+    Setup-Certificate
+    
+    # Install and configure KeyLocker
+    $smctlPath = Install-KeyLocker
+    Configure-KeyLocker -SmctlPath $smctlPath
+    
+    # Sign both executables
+    Sign-Executable -ExePath $BunProfileExe -SmctlPath $smctlPath
+    Sign-Executable -ExePath $BunExe -SmctlPath $smctlPath
+    
+    Write-Host "========================================" -ForegroundColor Green
+    Write-Host "  Code signing completed successfully!" -ForegroundColor Green
+    Write-Host "========================================" -ForegroundColor Green
+    
+    exit 0
+    
+} catch {
+    Log-Error "Code signing failed: $_"
+    exit 1
+    
+} finally {
+    Cleanup
+}

.buildkite/scripts/upload-benchmark.mjs

@@ -0,0 +1,7 @@
+import { getCommit, getSecret } from "../../scripts/utils.mjs";
+
+console.log("Submitting...");
+const response = await fetch(getSecret("BENCHMARK_URL") + "?tag=_&commit=" + getCommit() + "&artifact_url=_", {
+  method: "POST",
+});
+console.log("Got status " + response.status);

.buildkite/scripts/upload-release.sh

@@ -0,0 +1,257 @@
+#!/bin/bash
+
+set -eo pipefail
+
+function assert_main() {
+  if [ -z "$BUILDKITE_REPO" ]; then
+    echo "error: Cannot find repository for this build"
+    exit 1
+  fi
+  if [ -z "$BUILDKITE_COMMIT" ]; then
+    echo "error: Cannot find commit for this build"
+    exit 1
+  fi
+  if [ -n "$BUILDKITE_PULL_REQUEST_REPO" ] && [ "$BUILDKITE_REPO" != "$BUILDKITE_PULL_REQUEST_REPO" ]; then
+    echo "error: Cannot upload release from a fork"
+    exit 1
+  fi
+  if [ "$BUILDKITE_PULL_REQUEST" != "false" ]; then
+    echo "error: Cannot upload release from a pull request"
+    exit 1
+  fi
+  if [ "$BUILDKITE_BRANCH" != "main" ]; then
+    echo "error: Cannot upload release from a branch other than main"
+    exit 1
+  fi
+}
+
+function assert_buildkite_agent() {
+  if ! command -v "buildkite-agent" &> /dev/null; then
+    echo "error: Cannot find buildkite-agent, please install it:"
+    echo "https://buildkite.com/docs/agent/v3/install"
+    exit 1
+  fi
+}
+
+function assert_github() {
+  assert_command "gh" "gh" "https://github.com/cli/cli#installation"
+  assert_buildkite_secret "GITHUB_TOKEN"
+  # gh expects the token in $GH_TOKEN
+  export GH_TOKEN="$GITHUB_TOKEN"
+}
+
+function assert_aws() {
+  assert_command "aws" "awscli" "https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html"
+  for secret in "AWS_ACCESS_KEY_ID" "AWS_SECRET_ACCESS_KEY" "AWS_ENDPOINT"; do
+    assert_buildkite_secret "$secret"
+  done
+  assert_buildkite_secret "AWS_BUCKET" --skip-redaction
+}
+
+function assert_sentry() {
+  assert_command "sentry-cli" "getsentry/tools/sentry-cli" "https://docs.sentry.io/cli/installation/"
+  for secret in "SENTRY_AUTH_TOKEN" "SENTRY_ORG" "SENTRY_PROJECT"; do
+    assert_buildkite_secret "$secret"
+  done
+}
+
+function run_command() {
+  set -x
+  "$@"
+  { set +x; } 2>/dev/null
+}
+
+function assert_command() {
+  local command="$1"
+  local package="$2"
+  local help_url="$3"
+  if ! command -v "$command" &> /dev/null; then
+    echo "warning: $command is not installed, installing..."
+    if command -v brew &> /dev/null; then
+      HOMEBREW_NO_AUTO_UPDATE=1 run_command brew install "$package"
+    else
+      echo "error: Cannot install $command, please install it"
+      if [ -n "$help_url" ]; then
+        echo ""
+        echo "hint: See $help_url for help"
+      fi
+      exit 1
+    fi
+  fi
+}
+
+function assert_buildkite_secret() {
+  local key="$1"
+  local value=$(buildkite-agent secret get "$key" ${@:2})
+  if [ -z "$value" ]; then
+    echo "error: Cannot find $key secret"
+    echo ""
+    echo "hint: Create a secret named $key with a value:"
+    echo "https://buildkite.com/docs/pipelines/buildkite-secrets"
+    exit 1
+  fi
+  export "$key"="$value"
+}
+
+function release_tag() {
+  local version="$1"
+  if [ "$version" == "canary" ]; then
+    echo "canary"
+  else
+    echo "bun-v$version"
+  fi
+}
+
+function create_sentry_release() {
+  local version="$1"
+  local release="$version"
+  if [ "$version" == "canary" ]; then
+    release="$BUILDKITE_COMMIT-canary"
+  fi
+  run_command sentry-cli releases new "$release" --finalize
+  run_command sentry-cli releases set-commits "$release" --auto --ignore-missing
+  if [ "$version" == "canary" ]; then
+    run_command sentry-cli deploys new --env="canary" --release="$release"
+  fi
+}
+
+function download_buildkite_artifact() {
+  local name="$1"
+  local dir="$2"
+  if [ -z "$dir" ]; then
+    dir="."
+  fi
+  run_command buildkite-agent artifact download "$name" "$dir"
+  if [ ! -f "$dir/$name" ]; then
+    echo "error: Cannot find Buildkite artifact: $name"
+    exit 1
+  fi
+}
+
+function upload_github_asset() {
+  local version="$1"
+  local tag="$(release_tag "$version")"
+  local file="$2"
+  run_command gh release upload "$tag" "$file" --clobber --repo "$BUILDKITE_REPO"
+
+  # Sometimes the upload fails, maybe this is a race condition in the gh CLI?
+  while [ "$(gh release view "$tag" --repo "$BUILDKITE_REPO" | grep -c "$file")" -eq 0 ]; do
+    echo "warn: Uploading $file to $tag failed, retrying..."
+    sleep "$((RANDOM % 5 + 1))"
+    run_command gh release upload "$tag" "$file" --clobber --repo "$BUILDKITE_REPO"
+  done
+}
+
+function update_github_release() {
+  local version="$1"
+  local tag="$(release_tag "$version")"
+  if [ "$tag" == "canary" ]; then
+    sleep 5 # There is possibly a race condition where this overwrites artifacts?
+    run_command gh release edit "$tag" --repo "$BUILDKITE_REPO" \
+      --notes "This release of Bun corresponds to the commit: $BUILDKITE_COMMIT"
+  fi
+}
+
+function upload_s3_file() {
+  local folder="$1"
+  local file="$2"
+  run_command aws --endpoint-url="$AWS_ENDPOINT" s3 cp "$file" "s3://$AWS_BUCKET/$folder/$file"
+}
+
+function send_discord_announcement() {
+  local value=$(buildkite-agent secret get "BUN_ANNOUNCE_CANARY_WEBHOOK_URL")
+  if [ -z "$value" ]; then
+    echo "warn: BUN_ANNOUNCE_CANARY_WEBHOOK_URL not set, skipping Discord announcement"
+    return
+  fi
+
+  local version="$1"
+  local commit="$BUILDKITE_COMMIT"
+  local short_sha="${commit:0:7}"
+  local commit_url="https://github.com/oven-sh/bun/commit/$commit"
+
+  if [ "$version" == "canary" ]; then
+    local json_payload=$(cat <<EOF
+{
+  "embeds": [{
+    "title": "New Bun Canary now available",
+    "description": "A new canary build of Bun has been automatically uploaded ([${short_sha}](${commit_url})). To upgrade, run:\n\n\`\`\`shell\nbun upgrade --canary\n\`\`\`\nCommit: \`${commit}\`",
+    "color": 16023551,
+    "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+  }]
+}
+EOF
+)
+    
+    curl -H "Content-Type: application/json" \
+         -d "$json_payload" \
+         -sf \
+         "$value" >/dev/null
+  fi
+}
+
+function create_release() {
+  assert_main
+  assert_buildkite_agent
+  assert_github
+  assert_aws
+  assert_sentry
+
+  local tag="$1" # 'canary' or 'x.y.z'
+  local artifacts=(
+    bun-darwin-aarch64.zip
+    bun-darwin-aarch64-profile.zip
+    bun-darwin-x64.zip
+    bun-darwin-x64-profile.zip
+    bun-linux-aarch64.zip
+    bun-linux-aarch64-profile.zip
+    bun-linux-x64.zip
+    bun-linux-x64-profile.zip
+    bun-linux-x64-baseline.zip
+    bun-linux-x64-baseline-profile.zip
+    bun-linux-aarch64-musl.zip
+    bun-linux-aarch64-musl-profile.zip
+    bun-linux-x64-musl.zip
+    bun-linux-x64-musl-profile.zip
+    bun-linux-x64-musl-baseline.zip
+    bun-linux-x64-musl-baseline-profile.zip
+    bun-windows-x64.zip
+    bun-windows-x64-profile.zip
+    bun-windows-x64-baseline.zip
+    bun-windows-x64-baseline-profile.zip
+    # TODO: Enable when Windows ARM64 CI runners are ready
+    # bun-windows-aarch64.zip
+    # bun-windows-aarch64-profile.zip
+  )
+
+  function upload_artifact() {
+    local artifact="$1"
+    download_buildkite_artifact "$artifact"
+    if [ "$tag" == "canary" ]; then
+      upload_s3_file "releases/$BUILDKITE_COMMIT-canary" "$artifact" &
+    else
+      upload_s3_file "releases/$BUILDKITE_COMMIT" "$artifact" &
+    fi
+    upload_s3_file "releases/$tag" "$artifact" &
+    upload_github_asset "$tag" "$artifact" &
+    wait
+  }
+
+  for artifact in "${artifacts[@]}"; do
+    upload_artifact "$artifact"
+  done
+
+  update_github_release "$tag"
+  create_sentry_release "$tag"
+  send_discord_announcement "$tag"
+}
+
+function assert_canary() {
+  if [ -z "$CANARY" ] || [ "$CANARY" == "0" ]; then
+    echo "warn: Skipping release because this is not a canary build"
+    exit 0
+  fi
+}
+
+assert_canary
+create_release "canary"

.clang-tidy

@@ -0,0 +1,9 @@
+WarningsAsErrors: "*"
+FormatStyle: webkit
+Checks: >
+  -*,
+  clang-analyzer-*,
+  -clang-analyzer-optin.core.EnumCastOutOfRange
+  -clang-analyzer-webkit.UncountedLambdaCapturesChecker
+  -clang-analyzer-optin.core.EnumCastOutOfRange
+  -clang-analyzer-webkit.RefCntblBaseVirtualDtor

.clangd

@@ -0,0 +1,8 @@
+Index:
+  Background: Skip # Disable slow background indexing of these files.
+
+CompileFlags:
+  CompilationDatabase: build/debug
+
+Diagnostics:
+  UnusedIncludes: None

.claude/commands/dedupe.md

@@ -0,0 +1,43 @@
+---
+allowed-tools: Bash(gh issue view:*), Bash(gh search:*), Bash(gh issue list:*), Bash(gh api:*), Bash(gh issue comment:*)
+description: Find duplicate GitHub issues
+---
+
+# Issue deduplication command
+
+Find up to 3 likely duplicate issues for a given GitHub issue.
+
+To do this, follow these steps precisely:
+
+1. Use an agent to check if the GitHub issue (a) is closed, (b) does not need to be deduped (eg. because it is broad product feedback without a specific solution, or positive feedback), or (c) already has a duplicate detection comment (check for the exact HTML marker `<!-- dedupe-bot:marker -->` in the issue comments - ignore other bot comments). If so, do not proceed.
+2. Use an agent to view a GitHub issue, and ask the agent to return a summary of the issue
+3. Then, launch 5 parallel agents to search GitHub for duplicates of this issue, using diverse keywords and search approaches, using the summary from Step 2. **IMPORTANT**: Always scope searches with `repo:owner/repo` to constrain results to the current repository only.
+4. Next, feed the results from Steps 2 and 3 into another agent, so that it can filter out false positives, that are likely not actually duplicates of the original issue. If there are no duplicates remaining, do not proceed.
+5. Finally, comment back on the issue with a list of up to three duplicate issues (or zero, if there are no likely duplicates)
+
+Notes (be sure to tell this to your agents, too):
+
+- Use `gh` to interact with GitHub, rather than web fetch
+- Do not use other tools, beyond `gh` (eg. don't use other MCP servers, file edit, etc.)
+- Make a todo list first
+- Always scope searches with `repo:owner/repo` to prevent cross-repo false positives
+- For your comment, follow the following format precisely (assuming for this example that you found 3 suspected duplicates):
+
+---
+
+Found 3 possible duplicate issues:
+
+1. <link to issue>
+2. <link to issue>
+3. <link to issue>
+
+This issue will be automatically closed as a duplicate in 3 days.
+
+- If your issue is a duplicate, please close it and 👍 the existing issue instead
+- To prevent auto-closure, add a comment or 👎 this comment
+
+🤖 Generated with [Claude Code](https://claude.ai/code)
+
+<!-- dedupe-bot:marker -->
+
+---

.claude/commands/upgrade-nodejs.md

@@ -0,0 +1,92 @@
+# Upgrading Bun's Self-Reported Node.js Version
+
+This guide explains how to upgrade the Node.js version that Bun reports for compatibility with Node.js packages and native addons.
+
+## Overview
+
+Bun reports a Node.js version for compatibility with the Node.js ecosystem. This affects:
+- `process.version` output
+- Node-API (N-API) compatibility
+- Native addon ABI compatibility
+- V8 API compatibility for addons using V8 directly
+
+## Files That Always Need Updates
+
+### 1. Bootstrap Scripts
+- `scripts/bootstrap.sh` - Update `NODEJS_VERSION=`
+- `scripts/bootstrap.ps1` - Update `$NODEJS_VERSION =`
+
+### 2. CMake Configuration
+- `cmake/Options.cmake`
+  - `NODEJS_VERSION` - The Node.js version string (e.g., "24.3.0")
+  - `NODEJS_ABI_VERSION` - The ABI version number (find using command below)
+
+### 3. Version Strings
+- `src/bun.js/bindings/BunProcess.cpp`
+  - Update `Bun__versions_node` with the Node.js version
+  - Update `Bun__versions_v8` with the V8 version (find using command below)
+
+### 4. N-API Version
+- `src/napi/js_native_api.h`
+  - Update `NAPI_VERSION` define (check Node.js release notes)
+
+## Files That May Need Updates
+
+Only check these if the build fails or tests crash after updating version numbers:
+- V8 compatibility files in `src/bun.js/bindings/v8/` (if V8 API changed)
+- Test files (if Node.js requires newer C++ standard)
+
+## Quick Commands to Find Version Info
+
+```bash
+# Get latest Node.js version info
+curl -s https://nodejs.org/dist/index.json | jq '.[0]'
+
+# Get V8 version for a specific Node.js version (replace v24.3.0)
+curl -s https://nodejs.org/dist/v24.3.0/node-v24.3.0-headers.tar.gz | tar -xzO node-v24.3.0/include/node/node_version.h | grep V8_VERSION
+
+# Get ABI version for a specific Node.js version
+curl -s https://nodejs.org/dist/v24.3.0/node-v24.3.0-headers.tar.gz | tar -xzO node-v24.3.0/include/node/node_version.h | grep NODE_MODULE_VERSION
+
+# Or use the ABI registry
+curl -s https://raw.githubusercontent.com/nodejs/node/main/doc/abi_version_registry.json | jq '.NODE_MODULE_VERSION."<version>"'
+```
+
+## Update Process
+
+1. **Gather version info** using the commands above
+2. **Update the required files** listed in the sections above
+3. **Build and test**:
+   ```bash
+   bun bd
+   bun bd -e "console.log(process.version)"
+   bun bd -e "console.log(process.versions.v8)"
+   bun bd test test/v8/v8.test.ts
+   bun bd test test/napi/napi.test.ts
+   ```
+
+4. **Check for V8 API changes** only if build fails or tests crash:
+   - Compare v8-function-callback.h between versions
+   - Check v8-internal.h for Isolate size changes
+   - Look for new required APIs in build errors
+
+## If Build Fails or Tests Crash
+
+The V8 API rarely has breaking changes between minor Node.js versions. If you encounter issues:
+1. Check build errors for missing symbols or type mismatches
+2. Compare V8 headers between old and new Node.js versions
+3. Most issues can be resolved by implementing missing functions or adjusting structures
+
+## Testing Checklist
+
+- [ ] `process.version` returns correct version
+- [ ] `process.versions.v8` returns correct V8 version  
+- [ ] `process.config.variables.node_module_version` returns correct ABI
+- [ ] V8 tests pass
+- [ ] N-API tests pass
+
+## Notes
+
+- Most upgrades only require updating version numbers
+- Major V8 version changes (rare) may require API updates
+- The V8 shim implements only APIs used by common native addons

.claude/commands/upgrade-webkit.md

@@ -0,0 +1,26 @@
+Upgrade Bun's Webkit fork to the latest upstream version of Webkit.
+
+To do that:
+
+- cd vendor/WebKit
+- git fetch upstream
+- git merge upstream main
+- Fix the merge conflicts
+- bun build.ts debug
+- While it compiles, in another task review the JSC commits between the last version of Webkit and the new version. Write up a summary of the webkit changes in a file called "webkit-changes.md"
+- bun run build:local (build a build of Bun with the new Webkit, make sure it compiles)
+- After making sure it compiles, run some code to make sure things work. something like ./build/debug-local/bun-debug --print '42' should be all you need
+- cd vendor/WebKit
+- git commit -am "Upgrade Webkit to the latest version"
+- git push
+- get the commit SHA in the vendor/WebKit directory of your new commit
+- cd ../../ (back to bun)
+- Update WEBKIT_VERSION in cmake/tools/SetupWebKit.cmake to the commit SHA of your new commit
+- git checkout -b bun/webkit-upgrade-<commit-sha>
+- commit + push (without adding the webkit-changes.md file)
+- create PR titled "Upgrade Webkit to the <commit-sha>", paste your webkit-changes.md into the PR description
+- delete the webkit-changes.md file
+
+Things to check for a successful upgrade:
+- Did JSType in vendor/WebKit/Source/JavaScriptCore have any recent changes? Does the enum values align with whats present in src/bun.js/bindings/JSType.zig?
+- Were there any changes to the webcore code generator? If there are C++ compilation errors, check for differences in some of the generated code in like vendor/WebKit/source/WebCore/bindings/scripts/test/JS/

.claude/hooks/post-edit-zig-format.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env bun
+import { extname } from "path";
+import { spawnSync } from "child_process";
+
+const input = await Bun.stdin.json();
+
+const toolName = input.tool_name;
+const toolInput = input.tool_input || {};
+const filePath = toolInput.file_path;
+
+// Only process Write, Edit, and MultiEdit tools
+if (!["Write", "Edit", "MultiEdit"].includes(toolName)) {
+  process.exit(0);
+}
+
+const ext = extname(filePath);
+
+// Only format known files
+if (!filePath) {
+  process.exit(0);
+}
+
+function formatZigFile() {
+  try {
+    // Format the Zig file
+    const result = spawnSync("vendor/zig/zig.exe", ["fmt", filePath], {
+      cwd: process.env.CLAUDE_PROJECT_DIR || process.cwd(),
+      encoding: "utf-8",
+    });
+
+    if (result.error) {
+      console.error(`Failed to format ${filePath}: ${result.error.message}`);
+      process.exit(0);
+    }
+
+    if (result.status !== 0) {
+      console.error(`zig fmt failed for ${filePath}:`);
+      if (result.stderr) {
+        console.error(result.stderr);
+      }
+      process.exit(0);
+    }
+  } catch (error) {}
+}
+
+function formatTypeScriptFile() {
+  try {
+    // Format the TypeScript file
+    const result = spawnSync(
+      "./node_modules/.bin/prettier",
+      ["--plugin=prettier-plugin-organize-imports", "--config", ".prettierrc", "--write", filePath],
+      {
+        cwd: process.env.CLAUDE_PROJECT_DIR || process.cwd(),
+        encoding: "utf-8",
+      },
+    );
+  } catch (error) {}
+}
+
+if (ext === ".zig") {
+  formatZigFile();
+} else if (
+  [
+    ".cjs",
+    ".css",
+    ".html",
+    ".js",
+    ".json",
+    ".jsonc",
+    ".jsx",
+    ".less",
+    ".mjs",
+    ".pcss",
+    ".postcss",
+    ".sass",
+    ".scss",
+    ".styl",
+    ".stylus",
+    ".toml",
+    ".ts",
+    ".tsx",
+    ".yaml",
+  ].includes(ext)
+) {
+  formatTypeScriptFile();
+}
+
+process.exit(0);

.claude/hooks/pre-bash-zig-build.js

@@ -0,0 +1,207 @@
+#!/usr/bin/env bun
+import { basename, extname } from "path";
+
+const input = await Bun.stdin.json();
+
+const toolName = input.tool_name;
+const toolInput = input.tool_input || {};
+const command = toolInput.command || "";
+const timeout = toolInput.timeout;
+const cwd = input.cwd || "";
+
+// Get environment variables from the hook context
+// Note: We check process.env directly as env vars are inherited
+let useSystemBun = process.env.USE_SYSTEM_BUN;
+
+if (toolName !== "Bash" || !command) {
+  process.exit(0);
+}
+
+function denyWithReason(reason) {
+  const output = {
+    hookSpecificOutput: {
+      hookEventName: "PreToolUse",
+      permissionDecision: "deny",
+      permissionDecisionReason: reason,
+    },
+  };
+  console.log(JSON.stringify(output));
+  process.exit(0);
+}
+
+// Parse the command to extract argv0 and positional args
+let tokens;
+try {
+  // Simple shell parsing - split on spaces but respect quotes (both single and double)
+  tokens = command.match(/(?:[^\s"']+|"[^"]*"|'[^']*')+/g)?.map(t => t.replace(/^['"]|['"]$/g, "")) || [];
+} catch {
+  process.exit(0);
+}
+
+if (tokens.length === 0) {
+  process.exit(0);
+}
+
+// Strip inline environment variable assignments (e.g., FOO=1 bun test)
+const inlineEnv = new Map();
+let commandStart = 0;
+while (
+  commandStart < tokens.length &&
+  /^[A-Za-z_][A-Za-z0-9_]*=/.test(tokens[commandStart]) &&
+  !tokens[commandStart].includes("/")
+) {
+  const [name, value = ""] = tokens[commandStart].split("=", 2);
+  inlineEnv.set(name, value);
+  commandStart++;
+}
+if (commandStart >= tokens.length) {
+  process.exit(0);
+}
+tokens = tokens.slice(commandStart);
+useSystemBun = inlineEnv.get("USE_SYSTEM_BUN") ?? useSystemBun;
+
+// Get the executable name (argv0)
+const argv0 = basename(tokens[0], extname(tokens[0]));
+
+// Check if it's zig or zig.exe
+if (argv0 === "zig") {
+  // Filter out flags (starting with -) to get positional arguments
+  const positionalArgs = tokens.slice(1).filter(arg => !arg.startsWith("-"));
+
+  // Check if the positional args contain "build" followed by "obj"
+  if (positionalArgs.length >= 2 && positionalArgs[0] === "build" && positionalArgs[1] === "obj") {
+    denyWithReason("error: Use `bun bd` to build Bun and wait patiently");
+  }
+}
+
+// Check if argv0 is timeout and the command is "bun bd"
+if (argv0 === "timeout") {
+  // Find the actual command after timeout and its arguments
+  const timeoutArgEndIndex = tokens.slice(1).findIndex(t => !t.startsWith("-") && !/^\d/.test(t));
+  if (timeoutArgEndIndex === -1) {
+    process.exit(0);
+  }
+
+  const actualCommandIndex = timeoutArgEndIndex + 1;
+  if (actualCommandIndex >= tokens.length) {
+    process.exit(0);
+  }
+
+  const actualCommand = basename(tokens[actualCommandIndex]);
+  const restArgs = tokens.slice(actualCommandIndex + 1);
+
+  // Check if it's "bun bd" or "bun-debug bd" without other positional args
+  if (actualCommand === "bun" || actualCommand.includes("bun-debug")) {
+    // Claude is a sneaky fucker
+    let positionalArgs = restArgs.filter(arg => !arg.startsWith("-"));
+    const redirectStderrToStdoutIndex = positionalArgs.findIndex(arg => arg === "2>&1");
+    if (redirectStderrToStdoutIndex !== -1) {
+      positionalArgs.splice(redirectStderrToStdoutIndex, 1);
+    }
+    const redirectStdoutToStderrIndex = positionalArgs.findIndex(arg => arg === "1>&2");
+    if (redirectStdoutToStderrIndex !== -1) {
+      positionalArgs.splice(redirectStdoutToStderrIndex, 1);
+    }
+
+    const redirectToFileIndex = positionalArgs.findIndex(arg => arg === ">");
+    if (redirectToFileIndex !== -1) {
+      positionalArgs.splice(redirectToFileIndex, 2);
+    }
+
+    const redirectToFileAppendIndex = positionalArgs.findIndex(arg => arg === ">>");
+    if (redirectToFileAppendIndex !== -1) {
+      positionalArgs.splice(redirectToFileAppendIndex, 2);
+    }
+
+    const redirectTOFileInlineIndex = positionalArgs.findIndex(arg => arg.startsWith(">"));
+    if (redirectTOFileInlineIndex !== -1) {
+      positionalArgs.splice(redirectTOFileInlineIndex, 1);
+    }
+
+    const pipeIndex = positionalArgs.findIndex(arg => arg === "|");
+    if (pipeIndex !== -1) {
+      positionalArgs = positionalArgs.slice(0, pipeIndex);
+    }
+
+    positionalArgs = positionalArgs.map(arg => arg.trim()).filter(Boolean);
+
+    if (positionalArgs.length === 1 && positionalArgs[0] === "bd") {
+      denyWithReason("error: Run `bun bd` without a timeout");
+    }
+  }
+}
+
+// Check if command is "bun .* test" or "bun-debug test" with -u/--update-snapshots AND -t/--test-name-pattern
+if (argv0 === "bun" || argv0.includes("bun-debug")) {
+  const allArgs = tokens.slice(1);
+
+  // Check if "test" is in positional args or "bd" followed by "test"
+  const positionalArgs = allArgs.filter(arg => !arg.startsWith("-"));
+  const hasTest = positionalArgs.includes("test") || (positionalArgs[0] === "bd" && positionalArgs[1] === "test");
+
+  if (hasTest) {
+    const hasUpdateSnapshots = allArgs.some(arg => arg === "-u" || arg === "--update-snapshots");
+    const hasTestNamePattern = allArgs.some(arg => arg === "-t" || arg === "--test-name-pattern");
+
+    if (hasUpdateSnapshots && hasTestNamePattern) {
+      denyWithReason("error: Cannot use -u/--update-snapshots with -t/--test-name-pattern");
+    }
+  }
+}
+
+// Check if timeout option is set for "bun bd" command
+if (timeout !== undefined && (argv0 === "bun" || argv0.includes("bun-debug"))) {
+  const positionalArgs = tokens.slice(1).filter(arg => !arg.startsWith("-"));
+  if (positionalArgs.length === 1 && positionalArgs[0] === "bd") {
+    denyWithReason("error: Run `bun bd` without a timeout");
+  }
+}
+
+// Check if running "bun test <file>" without USE_SYSTEM_BUN=1
+if ((argv0 === "bun" || argv0.includes("bun-debug")) && useSystemBun !== "1") {
+  const allArgs = tokens.slice(1);
+  const positionalArgs = allArgs.filter(arg => !arg.startsWith("-"));
+
+  // Check if it's "test" (not "bd test")
+  if (positionalArgs.length >= 1 && positionalArgs[0] === "test" && positionalArgs[0] !== "bd") {
+    denyWithReason(
+      "error: In development, use `bun bd test <file>` to test your changes. If you meant to use a release version, set USE_SYSTEM_BUN=1",
+    );
+  }
+}
+
+// Check if running "bun bd test" from bun repo root or test folder without a file path
+if (argv0 === "bun" || argv0.includes("bun-debug")) {
+  const allArgs = tokens.slice(1);
+  const positionalArgs = allArgs.filter(arg => !arg.startsWith("-"));
+
+  // Check if it's "bd test"
+  if (positionalArgs.length >= 2 && positionalArgs[0] === "bd" && positionalArgs[1] === "test") {
+    // Check if cwd is the bun repo root or test folder
+    const isBunRepoRoot = cwd === "/workspace/bun" || cwd.endsWith("/bun");
+    const isTestFolder = cwd.endsWith("/bun/test");
+
+    if (isBunRepoRoot || isTestFolder) {
+      // Check if there's a file path argument (looks like a path: contains / or has test extension)
+      const hasFilePath = positionalArgs
+        .slice(2)
+        .some(
+          arg =>
+            arg.includes("/") ||
+            arg.endsWith(".test.ts") ||
+            arg.endsWith(".test.js") ||
+            arg.endsWith(".test.tsx") ||
+            arg.endsWith(".test.jsx"),
+        );
+
+      if (!hasFilePath) {
+        denyWithReason(
+          "error: `bun bd test` from repo root or test folder will run all tests. Use `bun bd test <path>` with a specific test file.",
+        );
+      }
+    }
+  }
+}
+
+// Allow the command to proceed
+process.exit(0);

.claude/settings.json

@@ -0,0 +1,26 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/pre-bash-zig-build.js"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/post-edit-zig-format.js"
+          }
+        ]
+      }
+    ]
+  }
+}

.claude/skills/implementing-jsc-classes-cpp/SKILL.md

@@ -0,0 +1,184 @@
+---
+name: implementing-jsc-classes-cpp
+description: Implements JavaScript classes in C++ using JavaScriptCore. Use when creating new JS classes with C++ bindings, prototypes, or constructors.
+---
+
+# Implementing JavaScript Classes in C++
+
+## Class Structure
+
+For publicly accessible Constructor and Prototype, create 3 classes:
+
+1. **`class Foo : public JSC::DestructibleObject`** - if C++ fields exist; otherwise use `JSC::constructEmptyObject` with `putDirectOffset`
+2. **`class FooPrototype : public JSC::JSNonFinalObject`**
+3. **`class FooConstructor : public JSC::InternalFunction`**
+
+No public constructor? Only Prototype and class needed.
+
+## Iso Subspaces
+
+Classes with C++ fields need subspaces in:
+
+- `src/bun.js/bindings/webcore/DOMClientIsoSubspaces.h`
+- `src/bun.js/bindings/webcore/DOMIsoSubspaces.h`
+
+```cpp
+template<typename MyClassT, JSC::SubspaceAccess mode>
+static JSC::GCClient::IsoSubspace* subspaceFor(JSC::VM& vm) {
+    if constexpr (mode == JSC::SubspaceAccess::Concurrently)
+        return nullptr;
+    return WebCore::subspaceForImpl<MyClassT, WebCore::UseCustomHeapCellType::No>(
+        vm,
+        [](auto& spaces) { return spaces.m_clientSubspaceForMyClassT.get(); },
+        [](auto& spaces, auto&& space) { spaces.m_clientSubspaceForMyClassT = std::forward<decltype(space)>(space); },
+        [](auto& spaces) { return spaces.m_subspaceForMyClassT.get(); },
+        [](auto& spaces, auto&& space) { spaces.m_subspaceForMyClassT = std::forward<decltype(space)>(space); });
+}
+```
+
+## Property Definitions
+
+```cpp
+static JSC_DECLARE_HOST_FUNCTION(jsFooProtoFuncMethod);
+static JSC_DECLARE_CUSTOM_GETTER(jsFooGetter_property);
+
+static const HashTableValue JSFooPrototypeTableValues[] = {
+    { "property"_s, static_cast<unsigned>(PropertyAttribute::ReadOnly | PropertyAttribute::CustomAccessor), NoIntrinsic, { HashTableValue::GetterSetterType, jsFooGetter_property, 0 } },
+    { "method"_s, static_cast<unsigned>(PropertyAttribute::Function), NoIntrinsic, { HashTableValue::NativeFunctionType, jsFooProtoFuncMethod, 1 } },
+};
+```
+
+## Prototype Class
+
+```cpp
+class JSFooPrototype final : public JSC::JSNonFinalObject {
+public:
+    using Base = JSC::JSNonFinalObject;
+    static constexpr unsigned StructureFlags = Base::StructureFlags;
+
+    static JSFooPrototype* create(JSC::VM& vm, JSC::JSGlobalObject* globalObject, JSC::Structure* structure) {
+        JSFooPrototype* prototype = new (NotNull, allocateCell<JSFooPrototype>(vm)) JSFooPrototype(vm, structure);
+        prototype->finishCreation(vm);
+        return prototype;
+    }
+
+    template<typename, JSC::SubspaceAccess>
+    static JSC::GCClient::IsoSubspace* subspaceFor(JSC::VM& vm) { return &vm.plainObjectSpace(); }
+
+    DECLARE_INFO;
+
+    static JSC::Structure* createStructure(JSC::VM& vm, JSC::JSGlobalObject* globalObject, JSC::JSValue prototype) {
+        auto* structure = JSC::Structure::create(vm, globalObject, prototype, JSC::TypeInfo(JSC::ObjectType, StructureFlags), info());
+        structure->setMayBePrototype(true);
+        return structure;
+    }
+
+private:
+    JSFooPrototype(JSC::VM& vm, JSC::Structure* structure) : Base(vm, structure) {}
+    void finishCreation(JSC::VM& vm);
+};
+
+void JSFooPrototype::finishCreation(VM& vm) {
+    Base::finishCreation(vm);
+    reifyStaticProperties(vm, JSFoo::info(), JSFooPrototypeTableValues, *this);
+    JSC_TO_STRING_TAG_WITHOUT_TRANSITION();
+}
+```
+
+## Getter/Setter/Function Definitions
+
+```cpp
+// Getter
+JSC_DEFINE_CUSTOM_GETTER(jsFooGetter_prop, (JSGlobalObject* globalObject, EncodedJSValue thisValue, PropertyName)) {
+    VM& vm = globalObject->vm();
+    auto scope = DECLARE_THROW_SCOPE(vm);
+    JSFoo* thisObject = jsDynamicCast<JSFoo*>(JSValue::decode(thisValue));
+    if (UNLIKELY(!thisObject)) {
+        Bun::throwThisTypeError(*globalObject, scope, "JSFoo"_s, "prop"_s);
+        return {};
+    }
+    return JSValue::encode(jsBoolean(thisObject->value()));
+}
+
+// Function
+JSC_DEFINE_HOST_FUNCTION(jsFooProtoFuncMethod, (JSGlobalObject* globalObject, CallFrame* callFrame)) {
+    VM& vm = globalObject->vm();
+    auto scope = DECLARE_THROW_SCOPE(vm);
+    auto* thisObject = jsDynamicCast<JSFoo*>(callFrame->thisValue());
+    if (UNLIKELY(!thisObject)) {
+        Bun::throwThisTypeError(*globalObject, scope, "Foo"_s, "method"_s);
+        return {};
+    }
+    return JSValue::encode(thisObject->doSomething(vm, globalObject));
+}
+```
+
+## Constructor Class
+
+```cpp
+class JSFooConstructor final : public JSC::InternalFunction {
+public:
+    using Base = JSC::InternalFunction;
+    static constexpr unsigned StructureFlags = Base::StructureFlags;
+
+    static JSFooConstructor* create(JSC::VM& vm, JSC::Structure* structure, JSC::JSObject* prototype) {
+        JSFooConstructor* constructor = new (NotNull, JSC::allocateCell<JSFooConstructor>(vm)) JSFooConstructor(vm, structure);
+        constructor->finishCreation(vm, prototype);
+        return constructor;
+    }
+
+    DECLARE_INFO;
+
+    template<typename CellType, JSC::SubspaceAccess>
+    static JSC::GCClient::IsoSubspace* subspaceFor(JSC::VM& vm) { return &vm.internalFunctionSpace(); }
+
+    static JSC::Structure* createStructure(JSC::VM& vm, JSC::JSGlobalObject* globalObject, JSC::JSValue prototype) {
+        return JSC::Structure::create(vm, globalObject, prototype, JSC::TypeInfo(JSC::InternalFunctionType, StructureFlags), info());
+    }
+
+private:
+    JSFooConstructor(JSC::VM& vm, JSC::Structure* structure) : Base(vm, structure, callFoo, constructFoo) {}
+
+    void finishCreation(JSC::VM& vm, JSC::JSObject* prototype) {
+        Base::finishCreation(vm, 0, "Foo"_s);
+        putDirectWithoutTransition(vm, vm.propertyNames->prototype, prototype, JSC::PropertyAttribute::DontEnum | JSC::PropertyAttribute::DontDelete | JSC::PropertyAttribute::ReadOnly);
+    }
+};
+```
+
+## Structure Caching
+
+Add to `ZigGlobalObject.h`:
+
+```cpp
+JSC::LazyClassStructure m_JSFooClassStructure;
+```
+
+Initialize in `ZigGlobalObject.cpp`:
+
+```cpp
+m_JSFooClassStructure.initLater([](LazyClassStructure::Initializer& init) {
+    Bun::initJSFooClassStructure(init);
+});
+```
+
+Visit in `visitChildrenImpl`:
+
+```cpp
+m_JSFooClassStructure.visit(visitor);
+```
+
+## Expose to Zig
+
+```cpp
+extern "C" JSC::EncodedJSValue Bun__JSFooConstructor(Zig::GlobalObject* globalObject) {
+    return JSValue::encode(globalObject->m_JSFooClassStructure.constructor(globalObject));
+}
+
+extern "C" EncodedJSValue Bun__Foo__toJS(Zig::GlobalObject* globalObject, Foo* foo) {
+    auto* structure = globalObject->m_JSFooClassStructure.get(globalObject);
+    return JSValue::encode(JSFoo::create(globalObject->vm(), structure, globalObject, WTFMove(foo)));
+}
+```
+
+Include `#include "root.h"` at the top of C++ files.

.claude/skills/implementing-jsc-classes-zig/SKILL.md

@@ -0,0 +1,206 @@
+---
+name: implementing-jsc-classes-zig
+description: Creates JavaScript classes using Bun's Zig bindings generator (.classes.ts). Use when implementing new JS APIs in Zig with JSC integration.
+---
+
+# Bun's JavaScriptCore Class Bindings Generator
+
+Bridge JavaScript and Zig through `.classes.ts` definitions and Zig implementations.
+
+## Architecture
+
+1. **Zig Implementation** (.zig files)
+2. **JavaScript Interface Definition** (.classes.ts files)
+3. **Generated Code** (C++/Zig files connecting them)
+
+## Class Definition (.classes.ts)
+
+```typescript
+define({
+  name: "TextDecoder",
+  constructor: true,
+  JSType: "object",
+  finalize: true,
+  proto: {
+    decode: { args: 1 },
+    encoding: { getter: true, cache: true },
+    fatal: { getter: true },
+  },
+});
+```
+
+Options:
+
+- `name`: Class name
+- `constructor`: Has public constructor
+- `JSType`: "object", "function", etc.
+- `finalize`: Needs cleanup
+- `proto`: Properties/methods
+- `cache`: Cache property values via WriteBarrier
+
+## Zig Implementation
+
+```zig
+pub const TextDecoder = struct {
+    pub const js = JSC.Codegen.JSTextDecoder;
+    pub const toJS = js.toJS;
+    pub const fromJS = js.fromJS;
+    pub const fromJSDirect = js.fromJSDirect;
+
+    encoding: []const u8,
+    fatal: bool,
+
+    pub fn constructor(
+        globalObject: *JSGlobalObject,
+        callFrame: *JSC.CallFrame,
+    ) bun.JSError!*TextDecoder {
+        return bun.new(TextDecoder, .{ .encoding = "utf-8", .fatal = false });
+    }
+
+    pub fn decode(
+        this: *TextDecoder,
+        globalObject: *JSGlobalObject,
+        callFrame: *JSC.CallFrame,
+    ) bun.JSError!JSC.JSValue {
+        const args = callFrame.arguments();
+        if (args.len < 1 or args.ptr[0].isUndefinedOrNull()) {
+            return globalObject.throw("Input cannot be null", .{});
+        }
+        return JSC.JSValue.jsString(globalObject, "result");
+    }
+
+    pub fn getEncoding(this: *TextDecoder, globalObject: *JSGlobalObject) JSC.JSValue {
+        return JSC.JSValue.createStringFromUTF8(globalObject, this.encoding);
+    }
+
+    fn deinit(this: *TextDecoder) void {
+        // Release resources
+    }
+
+    pub fn finalize(this: *TextDecoder) void {
+        this.deinit();
+        bun.destroy(this);
+    }
+};
+```
+
+**Key patterns:**
+
+- Use `bun.JSError!JSValue` return type for error handling
+- Use `globalObject` not `ctx`
+- `deinit()` for cleanup, `finalize()` called by GC
+- Update `src/bun.js/bindings/generated_classes_list.zig`
+
+## CallFrame Access
+
+```zig
+const args = callFrame.arguments();
+const first_arg = args.ptr[0];  // Access as slice
+const argCount = args.len;
+const thisValue = callFrame.thisValue();
+```
+
+## Property Caching
+
+For `cache: true` properties, generated accessors:
+
+```zig
+// Get cached value
+pub fn encodingGetCached(thisValue: JSC.JSValue) ?JSC.JSValue {
+    const result = TextDecoderPrototype__encodingGetCachedValue(thisValue);
+    if (result == .zero) return null;
+    return result;
+}
+
+// Set cached value
+pub fn encodingSetCached(thisValue: JSC.JSValue, globalObject: *JSC.JSGlobalObject, value: JSC.JSValue) void {
+    TextDecoderPrototype__encodingSetCachedValue(thisValue, globalObject, value);
+}
+```
+
+## Error Handling
+
+```zig
+pub fn method(this: *MyClass, globalObject: *JSGlobalObject, callFrame: *JSC.CallFrame) bun.JSError!JSC.JSValue {
+    const args = callFrame.arguments();
+    if (args.len < 1) {
+        return globalObject.throw("Missing required argument", .{});
+    }
+    return JSC.JSValue.jsString(globalObject, "Success!");
+}
+```
+
+## Memory Management
+
+```zig
+pub fn deinit(this: *TextDecoder) void {
+    this._encoding.deref();
+    if (this.buffer) |buffer| {
+        bun.default_allocator.free(buffer);
+    }
+}
+
+pub fn finalize(this: *TextDecoder) void {
+    JSC.markBinding(@src());
+    this.deinit();
+    bun.default_allocator.destroy(this);
+}
+```
+
+## Creating a New Binding
+
+1. Define interface in `.classes.ts`:
+
+```typescript
+define({
+  name: "MyClass",
+  constructor: true,
+  finalize: true,
+  proto: {
+    myMethod: { args: 1 },
+    myProperty: { getter: true, cache: true },
+  },
+});
+```
+
+2. Implement in `.zig`:
+
+```zig
+pub const MyClass = struct {
+    pub const js = JSC.Codegen.JSMyClass;
+    pub const toJS = js.toJS;
+    pub const fromJS = js.fromJS;
+
+    value: []const u8,
+
+    pub const new = bun.TrivialNew(@This());
+
+    pub fn constructor(globalObject: *JSGlobalObject, callFrame: *JSC.CallFrame) bun.JSError!*MyClass {
+        return MyClass.new(.{ .value = "" });
+    }
+
+    pub fn myMethod(this: *MyClass, globalObject: *JSGlobalObject, callFrame: *JSC.CallFrame) bun.JSError!JSC.JSValue {
+        return JSC.JSValue.jsUndefined();
+    }
+
+    pub fn getMyProperty(this: *MyClass, globalObject: *JSGlobalObject) JSC.JSValue {
+        return JSC.JSValue.jsString(globalObject, this.value);
+    }
+
+    pub fn deinit(this: *MyClass) void {}
+
+    pub fn finalize(this: *MyClass) void {
+        this.deinit();
+        bun.destroy(this);
+    }
+};
+```
+
+3. Add to `src/bun.js/bindings/generated_classes_list.zig`
+
+## Generated Components
+
+- **C++ Classes**: `JSMyClass`, `JSMyClassPrototype`, `JSMyClassConstructor`
+- **Method Bindings**: `MyClassPrototype__myMethodCallback`
+- **Property Accessors**: `MyClassPrototype__myPropertyGetterWrap`
+- **Zig Bindings**: External function declarations, cached value accessors

.claude/skills/writing-bundler-tests/SKILL.md

@@ -0,0 +1,222 @@
+---
+name: writing-bundler-tests
+description: Guides writing bundler tests using itBundled/expectBundled in test/bundler/. Use when creating or modifying bundler, transpiler, or code transformation tests.
+---
+
+# Writing Bundler Tests
+
+Bundler tests use `itBundled()` from `test/bundler/expectBundled.ts` to test Bun's bundler.
+
+## Basic Usage
+
+```typescript
+import { describe } from "bun:test";
+import { itBundled, dedent } from "./expectBundled";
+
+describe("bundler", () => {
+  itBundled("category/TestName", {
+    files: {
+      "index.js": `console.log("hello");`,
+    },
+    run: {
+      stdout: "hello",
+    },
+  });
+});
+```
+
+Test ID format: `category/TestName` (e.g., `banner/CommentBanner`, `minify/Empty`)
+
+## File Setup
+
+```typescript
+{
+  files: {
+    "index.js": `console.log("test");`,
+    "lib.ts": `export const foo = 123;`,
+    "nested/file.js": `export default {};`,
+  },
+  entryPoints: ["index.js"],  // defaults to first file
+  runtimeFiles: {             // written AFTER bundling
+    "extra.js": `console.log("added later");`,
+  },
+}
+```
+
+## Bundler Options
+
+```typescript
+{
+  outfile: "/out.js",
+  outdir: "/out",
+  format: "esm" | "cjs" | "iife",
+  target: "bun" | "browser" | "node",
+
+  // Minification
+  minifyWhitespace: true,
+  minifyIdentifiers: true,
+  minifySyntax: true,
+
+  // Code manipulation
+  banner: "// copyright",
+  footer: "// end",
+  define: { "PROD": "true" },
+  external: ["lodash"],
+
+  // Advanced
+  sourceMap: "inline" | "external",
+  splitting: true,
+  treeShaking: true,
+  drop: ["console"],
+}
+```
+
+## Runtime Verification
+
+```typescript
+{
+  run: {
+    stdout: "expected output",      // exact match
+    stdout: /regex/,                // pattern match
+    partialStdout: "contains this", // substring
+    stderr: "error output",
+    exitCode: 1,
+    env: { NODE_ENV: "production" },
+    runtime: "bun" | "node",
+
+    // Runtime errors
+    error: "ReferenceError: x is not defined",
+  },
+}
+```
+
+## Bundle Errors/Warnings
+
+```typescript
+{
+  bundleErrors: {
+    "/file.js": ["error message 1", "error message 2"],
+  },
+  bundleWarnings: {
+    "/file.js": ["warning message"],
+  },
+}
+```
+
+## Dead Code Elimination (DCE)
+
+Add markers in source code:
+
+```javascript
+// KEEP - this should survive
+const used = 1;
+
+// REMOVE - this should be eliminated
+const unused = 2;
+```
+
+```typescript
+{
+  dce: true,
+  dceKeepMarkerCount: 5,  // expected KEEP markers
+}
+```
+
+## Capture Pattern
+
+Verify exact transpilation with `capture()`:
+
+```typescript
+itBundled("string/Folding", {
+  files: {
+    "index.ts": `capture(\`\${1 + 1}\`);`,
+  },
+  capture: ['"2"'], // expected captured value
+  minifySyntax: true,
+});
+```
+
+## Post-Bundle Assertions
+
+```typescript
+{
+  onAfterBundle(api) {
+    api.expectFile("out.js").toContain("console.log");
+    api.assertFileExists("out.js");
+
+    const content = api.readFile("out.js");
+    expect(content).toMatchSnapshot();
+
+    const values = api.captureFile("out.js");
+    expect(values).toEqual(["2"]);
+  },
+}
+```
+
+## Common Patterns
+
+**Simple output verification:**
+
+```typescript
+itBundled("banner/Comment", {
+  banner: "// copyright",
+  files: { "a.js": `console.log("Hello")` },
+  onAfterBundle(api) {
+    api.expectFile("out.js").toContain("// copyright");
+  },
+});
+```
+
+**Multi-file CJS/ESM interop:**
+
+```typescript
+itBundled("cjs/ImportSyntax", {
+  files: {
+    "entry.js": `import lib from './lib.cjs'; console.log(lib);`,
+    "lib.cjs": `exports.foo = 'bar';`,
+  },
+  run: { stdout: '{"foo":"bar"}' },
+});
+```
+
+**Error handling:**
+
+```typescript
+itBundled("edgecase/InvalidLoader", {
+  files: { "index.js": `...` },
+  bundleErrors: {
+    "index.js": ["Unsupported loader type"],
+  },
+});
+```
+
+## Test Organization
+
+```text
+test/bundler/
+├── bundler_banner.test.ts
+├── bundler_string.test.ts
+├── bundler_minify.test.ts
+├── bundler_cjs.test.ts
+├── bundler_edgecase.test.ts
+├── bundler_splitting.test.ts
+├── css/
+├── transpiler/
+└── expectBundled.ts
+```
+
+## Running Tests
+
+```bash
+bun bd test test/bundler/bundler_banner.test.ts
+BUN_BUNDLER_TEST_FILTER="banner/Comment" bun bd test bundler_banner.test.ts
+BUN_BUNDLER_TEST_DEBUG=1 bun bd test bundler_minify.test.ts
+```
+
+## Key Points
+
+- Use `dedent` for readable multi-line code
+- File paths are relative (e.g., `/index.js`)
+- Use `capture()` to verify exact transpilation results
+- Use `.toMatchSnapshot()` for complex outputs
+- Pass array to `run` for multiple test scenarios

.claude/skills/writing-dev-server-tests/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: writing-dev-server-tests
+description: Guides writing HMR/Dev Server tests in test/bake/. Use when creating or modifying dev server, hot reloading, or bundling tests.
+---
+
+# Writing HMR/Dev Server Tests
+
+Dev server tests validate hot-reloading robustness and reliability.
+
+## File Structure
+
+- `test/bake/bake-harness.ts` - shared utilities: `devTest`, `prodTest`, `devAndProductionTest`, `Dev` class, `Client` class
+- `test/bake/client-fixture.mjs` - subprocess for `Client` (page loading, IPC queries)
+- `test/bake/dev/*.test.ts` - dev server and hot reload tests
+- `test/bake/dev-and-prod.ts` - tests running on both dev and production mode
+
+## Test Categories
+
+- `bundle.test.ts` - DevServer-specific bundling bugs
+- `css.test.ts` - CSS bundling issues
+- `plugins.test.ts` - development mode plugins
+- `ecosystem.test.ts` - library compatibility (prefer concrete bugs over full package tests)
+- `esm.test.ts` - ESM features in development
+- `html.test.ts` - HTML file handling
+- `react-spa.test.ts` - React, react-refresh transform, server components
+- `sourcemap.test.ts` - source map correctness
+
+## devTest Basics
+
+```ts
+import { devTest, emptyHtmlFile } from "../bake-harness";
+
+devTest("html file is watched", {
+  files: {
+    "index.html": emptyHtmlFile({
+      scripts: ["/script.ts"],
+      body: "<h1>Hello</h1>",
+    }),
+    "script.ts": `console.log("hello");`,
+  },
+  async test(dev) {
+    await dev.fetch("/").expect.toInclude("<h1>Hello</h1>");
+    await dev.patch("index.html", { find: "Hello", replace: "World" });
+    await dev.fetch("/").expect.toInclude("<h1>World</h1>");
+
+    await using c = await dev.client("/");
+    await c.expectMessage("hello");
+
+    await c.expectReload(async () => {
+      await dev.patch("index.html", { find: "World", replace: "Bar" });
+    });
+    await c.expectMessage("hello");
+  },
+});
+```
+
+## Key APIs
+
+- **`files`**: Initial filesystem state
+- **`dev.fetch()`**: HTTP requests
+- **`dev.client()`**: Opens browser instance
+- **`dev.write/patch/delete`**: Filesystem mutations (wait for hot-reload automatically)
+- **`c.expectMessage()`**: Assert console.log output
+- **`c.expectReload()`**: Wrap code that causes hard reload
+
+**Important**: Use `dev.write/patch/delete` instead of `node:fs` - they wait for hot-reload.
+
+## Testing Errors
+
+```ts
+devTest("import then create", {
+  files: {
+    "index.html": `<!DOCTYPE html><html><head></head><body><script type="module" src="/script.ts"></script></body></html>`,
+    "script.ts": `import data from "./data"; console.log(data);`,
+  },
+  async test(dev) {
+    const c = await dev.client("/", {
+      errors: ['script.ts:1:18: error: Could not resolve: "./data"'],
+    });
+    await c.expectReload(async () => {
+      await dev.write("data.ts", "export default 'data';");
+    });
+    await c.expectMessage("data");
+  },
+});
+```
+
+Specify expected errors with the `errors` option:
+
+```ts
+await dev.delete("other.ts", {
+  errors: ['index.ts:1:16: error: Could not resolve: "./other"'],
+});
+```

.claude/skills/zig-system-calls/SKILL.md

@@ -0,0 +1,268 @@
+---
+name: zig-system-calls
+description: Guides using bun.sys for system calls and file I/O in Zig. Use when implementing file operations instead of std.fs or std.posix.
+---
+
+# System Calls & File I/O in Zig
+
+Use `bun.sys` instead of `std.fs` or `std.posix` for cross-platform syscalls with proper error handling.
+
+## bun.sys.File (Preferred)
+
+For most file operations, use the `bun.sys.File` wrapper:
+
+```zig
+const File = bun.sys.File;
+
+const file = switch (File.open(path, bun.O.RDWR, 0o644)) {
+    .result => |f| f,
+    .err => |err| return .{ .err = err },
+};
+defer file.close();
+
+// Read/write
+_ = try file.read(buffer).unwrap();
+_ = try file.writeAll(data).unwrap();
+
+// Get file info
+const stat = try file.stat().unwrap();
+const size = try file.getEndPos().unwrap();
+
+// std.io compatible
+const reader = file.reader();
+const writer = file.writer();
+```
+
+### Complete Example
+
+```zig
+const File = bun.sys.File;
+
+pub fn writeFile(path: [:0]const u8, data: []const u8) File.WriteError!void {
+    const file = switch (File.open(path, bun.O.WRONLY | bun.O.CREAT | bun.O.TRUNC, 0o664)) {
+        .result => |f| f,
+        .err => |err| return err.toError(),
+    };
+    defer file.close();
+
+    _ = switch (file.writeAll(data)) {
+        .result => {},
+        .err => |err| return err.toError(),
+    };
+}
+```
+
+## Why bun.sys?
+
+| Aspect      | bun.sys                          | std.fs/std.posix    |
+| ----------- | -------------------------------- | ------------------- |
+| Return Type | `Maybe(T)` with detailed Error   | Generic error union |
+| Windows     | Full support with libuv fallback | Limited/POSIX-only  |
+| Error Info  | errno, syscall tag, path, fd     | errno only          |
+| EINTR       | Automatic retry                  | Manual handling     |
+
+## Error Handling with Maybe(T)
+
+`bun.sys` functions return `Maybe(T)` - a tagged union:
+
+```zig
+const sys = bun.sys;
+
+// Pattern 1: Switch on result/error
+switch (sys.read(fd, buffer)) {
+    .result => |bytes_read| {
+        // use bytes_read
+    },
+    .err => |err| {
+        // err.errno, err.syscall, err.fd, err.path
+        if (err.getErrno() == .AGAIN) {
+            // handle EAGAIN
+        }
+    },
+}
+
+// Pattern 2: Unwrap with try (converts to Zig error)
+const bytes = try sys.read(fd, buffer).unwrap();
+
+// Pattern 3: Unwrap with default
+const value = sys.stat(path).unwrapOr(default_stat);
+```
+
+## Low-Level File Operations
+
+Only use these when `bun.sys.File` doesn't meet your needs.
+
+### Opening Files
+
+```zig
+const sys = bun.sys;
+
+// Use bun.O flags (cross-platform normalized)
+const fd = switch (sys.open(path, bun.O.RDONLY, 0)) {
+    .result => |fd| fd,
+    .err => |err| return .{ .err = err },
+};
+defer fd.close();
+
+// Common flags
+bun.O.RDONLY, bun.O.WRONLY, bun.O.RDWR
+bun.O.CREAT, bun.O.TRUNC, bun.O.APPEND
+bun.O.NONBLOCK, bun.O.DIRECTORY
+```
+
+### Reading & Writing
+
+```zig
+// Single read (may return less than buffer size)
+switch (sys.read(fd, buffer)) {
+    .result => |n| { /* n bytes read */ },
+    .err => |err| { /* handle error */ },
+}
+
+// Read until EOF or buffer full
+const total = try sys.readAll(fd, buffer).unwrap();
+
+// Position-based read/write
+sys.pread(fd, buffer, offset)
+sys.pwrite(fd, data, offset)
+
+// Vector I/O
+sys.readv(fd, iovecs)
+sys.writev(fd, iovecs)
+```
+
+### File Info
+
+```zig
+sys.stat(path)      // Follow symlinks
+sys.lstat(path)     // Don't follow symlinks
+sys.fstat(fd)       // From file descriptor
+sys.fstatat(fd, path)
+
+// Linux-only: faster selective stat
+sys.statx(path, &.{ .size, .mtime })
+```
+
+### Path Operations
+
+```zig
+sys.unlink(path)
+sys.unlinkat(dir_fd, path)
+sys.rename(from, to)
+sys.renameat(from_dir, from, to_dir, to)
+sys.readlink(path, buf)
+sys.readlinkat(fd, path, buf)
+sys.link(T, src, dest)
+sys.linkat(src_fd, src, dest_fd, dest)
+sys.symlink(target, dest)
+sys.symlinkat(target, dirfd, dest)
+sys.mkdir(path, mode)
+sys.mkdirat(dir_fd, path, mode)
+sys.rmdir(path)
+```
+
+### Permissions
+
+```zig
+sys.chmod(path, mode)
+sys.fchmod(fd, mode)
+sys.fchmodat(fd, path, mode, flags)
+sys.chown(path, uid, gid)
+sys.fchown(fd, uid, gid)
+```
+
+### Closing File Descriptors
+
+Close is on `bun.FD`:
+
+```zig
+fd.close();  // Asserts on error (use in defer)
+
+// Or if you need error info:
+if (fd.closeAllowingBadFileDescriptor(null)) |err| {
+    // handle error
+}
+```
+
+## Directory Operations
+
+```zig
+var buf: bun.PathBuffer = undefined;
+const cwd = try sys.getcwd(&buf).unwrap();
+const cwdZ = try sys.getcwdZ(&buf).unwrap();  // Zero-terminated
+sys.chdir(path, destination)
+```
+
+### Directory Iteration
+
+Use `bun.DirIterator` instead of `std.fs.Dir.Iterator`:
+
+```zig
+var iter = bun.iterateDir(dir_fd);
+while (true) {
+    switch (iter.next()) {
+        .result => |entry| {
+            if (entry) |e| {
+                const name = e.name.slice();
+                const kind = e.kind;  // .file, .directory, .sym_link, etc.
+            } else {
+                break;  // End of directory
+            }
+        },
+        .err => |err| return .{ .err = err },
+    }
+}
+```
+
+## Socket Operations
+
+**Important**: `bun.sys` has limited socket support. For network I/O:
+
+- **Non-blocking sockets**: Use `uws.Socket` (libuwebsockets) exclusively
+- **Pipes/blocking I/O**: Use `PipeReader.zig` and `PipeWriter.zig`
+
+Available in bun.sys:
+
+```zig
+sys.setsockopt(fd, level, optname, value)
+sys.socketpair(domain, socktype, protocol, nonblocking_status)
+```
+
+Do NOT use `bun.sys` for socket read/write - use `uws.Socket` instead.
+
+## Other Operations
+
+```zig
+sys.ftruncate(fd, size)
+sys.lseek(fd, offset, whence)
+sys.dup(fd)
+sys.dupWithFlags(fd, flags)
+sys.fcntl(fd, cmd, arg)
+sys.pipe()
+sys.mmap(...)
+sys.munmap(memory)
+sys.access(path, mode)
+sys.futimens(fd, atime, mtime)
+sys.utimens(path, atime, mtime)
+```
+
+## Error Type
+
+```zig
+const err: bun.sys.Error = ...;
+err.errno      // Raw errno value
+err.getErrno() // As std.posix.E enum
+err.syscall    // Which syscall failed (Tag enum)
+err.fd         // Optional: file descriptor
+err.path       // Optional: path string
+```
+
+## Key Points
+
+- Prefer `bun.sys.File` wrapper for most file operations
+- Use low-level `bun.sys` functions only when needed
+- Use `bun.O.*` flags instead of `std.os.O.*`
+- Handle `Maybe(T)` with switch or `.unwrap()`
+- Use `defer fd.close()` for cleanup
+- EINTR is handled automatically in most functions
+- For sockets, use `uws.Socket` not `bun.sys`

.coderabbit.yaml

@@ -0,0 +1,147 @@
+language: en-US
+
+issue_enrichment:
+  auto_enrich:
+    enabled: false
+
+reviews:
+  profile: assertive
+  request_changes_workflow: false
+  high_level_summary: false
+  high_level_summary_placeholder: "@coderabbitai summary"
+  high_level_summary_in_walkthrough: true
+  auto_title_placeholder: "@coderabbitai"
+  review_status: false
+  commit_status: false
+  fail_commit_status: false
+  collapse_walkthrough: false
+  changed_files_summary: true
+  sequence_diagrams: false
+  estimate_code_review_effort: false
+  assess_linked_issues: true
+  related_issues: true
+  related_prs: true
+  suggested_labels: false
+  suggested_reviewers: true
+  in_progress_fortune: false
+  poem: false
+  abort_on_close: true
+
+  path_filters:
+    - "!test/js/node/test/"
+
+  auto_review:
+    enabled: true
+    auto_incremental_review: true
+    drafts: false
+
+  finishing_touches:
+    docstrings:
+      enabled: false
+    unit_tests:
+      enabled: false
+
+  pre_merge_checks:
+    docstrings:
+      mode: off
+    title:
+      mode: warning
+    description:
+      mode: warning
+    issue_assessment:
+      mode: warning
+
+  tools:
+    shellcheck:
+      enabled: true
+    ruff:
+      enabled: true
+    markdownlint:
+      enabled: true
+    github-checks:
+      enabled: true
+      timeout_ms: 90000
+    languagetool:
+      enabled: true
+      enabled_only: false
+      level: default
+    biome:
+      enabled: true
+    hadolint:
+      enabled: true
+    swiftlint:
+      enabled: true
+    phpstan:
+      enabled: true
+      level: default
+    phpmd:
+      enabled: true
+    phpcs:
+      enabled: true
+    golangci-lint:
+      enabled: true
+    yamllint:
+      enabled: true
+    gitleaks:
+      enabled: true
+    checkov:
+      enabled: true
+    detekt:
+      enabled: true
+    eslint:
+      enabled: true
+    flake8:
+      enabled: true
+    rubocop:
+      enabled: true
+    buf:
+      enabled: true
+    regal:
+      enabled: true
+    actionlint:
+      enabled: true
+    pmd:
+      enabled: true
+    clang:
+      enabled: true
+    cppcheck:
+      enabled: true
+    semgrep:
+      enabled: true
+    circleci:
+      enabled: true
+    clippy:
+      enabled: true
+    sqlfluff:
+      enabled: true
+    prismaLint:
+      enabled: true
+    pylint:
+      enabled: true
+    oxc:
+      enabled: true
+    shopifyThemeCheck:
+      enabled: true
+    luacheck:
+      enabled: true
+    brakeman:
+      enabled: true
+    dotenvLint:
+      enabled: true
+    htmlhint:
+      enabled: true
+    checkmake:
+      enabled: true
+    osvScanner:
+      enabled: true
+
+chat:
+  auto_reply: true
+
+knowledge_base:
+  opt_out: false
+  code_guidelines:
+    enabled: true
+    filePatterns:
+      - "**/.cursor/rules/*.mdc"
+      - "**/CLAUDE.md"

.cursor/environment.json

@@ -0,0 +1,10 @@
+{
+  "snapshot": "snapshot-20250706-71021aff-cc0d-4a7f-a468-d443b16c4bf1",
+  "install": "bun install",
+  "terminals": [
+    {
+      "name": "bun build",
+      "command": "bun run build"
+    }
+  ]
+}

.cursorignore

@@ -0,0 +1,7 @@
+# Add directories or file patterns to ignore during indexing (e.g. foo/ or *.csv)
+bench
+vendor
+*-fixture.{js,ts}
+zig-cache
+packages/bun-uws/fuzzing
+build

.docker/chromium.pref

@@ -1,14 +0,0 @@
-# Note: 2 blank lines are required between entries
- Package: *
- Pin: release a=eoan
- Pin-Priority: 500
-
- Package: *
- Pin: origin "ftp.debian.org"
- Pin-Priority: 300
-
- # Pattern includes 'chromium', 'chromium-browser' and similarly
- # named dependencies:
- Package: chromium*
- Pin: origin "ftp.debian.org"
- Pin-Priority: 700

.docker/copy-bun-binary.sh

@@ -1,8 +0,0 @@
-#!/bin/bash
-
-set -euxo pipefail
-
-name=$(openssl rand -hex 12)
-id=$(docker create --name=bun-binary-$name $CONTAINER_TAG)
-docker container cp bun-binary-$name:$BUN_RELEASE_DIR bun-binary
-echo -e "bun-binary-$name"

.docker/debian.list

@@ -1,3 +0,0 @@
- deb http://deb.debian.org/debian buster main
- deb http://deb.debian.org/debian buster-updates main
- deb http://deb.debian.org/debian-security buster/updates main

.docker/dockerfile-common.sh

@@ -1,34 +0,0 @@
-export DOCKER_BUILDKIT=1
-
-export BUILDKIT_ARCH=$(uname -m)
-export ARCH=${BUILDKIT_ARCH}
-
-if [ "$BUILDKIT_ARCH" == "amd64" ]; then
-    export BUILDKIT_ARCH="amd64"
-    export ARCH=x64
-fi
-
-if [ "$BUILDKIT_ARCH" == "x86_64" ]; then
-    export BUILDKIT_ARCH="amd64"
-    export ARCH=x64
-fi
-
-if [ "$BUILDKIT_ARCH" == "arm64" ]; then
-    export BUILDKIT_ARCH="arm64"
-    export ARCH=aarch64
-fi
-
-if [ "$BUILDKIT_ARCH" == "aarch64" ]; then
-    export BUILDKIT_ARCH="arm64"
-    export ARCH=aarch64
-fi
-
-if [ "$BUILDKIT_ARCH" == "armv7l" ]; then
-    echo "Unsupported platform: $BUILDKIT_ARCH"
-    exit 1
-fi
-
-export BUILD_ID=$(cat build-id)
-export CONTAINER_NAME=bun-linux-$ARCH
-export DEBUG_CONTAINER_NAME=debug-bun-linux-$ARCH
-export TEMP=/tmp/bun-0.0.$BUILD_ID

.docker/pull.sh

@@ -1,11 +0,0 @@
-#!/bin/bash
-
-set -euxo pipefail
-
-docker pull bunbunbunbun/bun-test-base:latest --platform=linux/amd64
-docker pull bunbunbunbun/bun-base:latest --platform=linux/amd64
-docker pull bunbunbunbun/bun-base-with-zig-and-webkit:latest --platform=linux/amd64
-
-docker tag bunbunbunbun/bun-test-base:latest bun-base:latest
-docker tag bunbunbunbun/bun-base:latest bun-base:latest
-docker tag bunbunbunbun/bun-base-with-zig-and-webkit:latest bun-base-with-zig-and-webkit:latest

.docker/run-dockerfile.sh

@@ -1,47 +0,0 @@
-#!/bin/bash
-
-source "dockerfile-common.sh"
-
-export $CONTAINER_NAME=$CONTAINER_NAME-local
-
-rm -rf $TEMP
-mkdir -p $TEMP
-
-docker build . --target release --progress=plain -t $CONTAINER_NAME:latest --build-arg BUILDKIT_INLINE_CACHE=1 --platform=linux/$BUILDKIT_ARCH --cache-from $CONTAINER_NAME:latest
-
-if (($?)); then
-  echo "Failed to build container"
-  exit 1
-fi
-
-id=$(docker create $CONTAINER_NAME:latest)
-docker cp $id:/home/ubuntu/bun-release $TEMP/$CONTAINER_NAME
-if (($?)); then
-  echo "Failed to cp container"
-  exit 1
-fi
-
-cd $TEMP
-mkdir -p $TEMP/$CONTAINER_NAME $TEMP/$DEBUG_CONTAINER_NAME
-mv $CONTAINER_NAME/bun-profile $DEBUG_CONTAINER_NAME/bun
-zip -r $CONTAINER_NAME.zip $CONTAINER_NAME
-zip -r $DEBUG_CONTAINER_NAME.zip $DEBUG_CONTAINER_NAME
-docker rm -v $id
-abs=$(realpath $TEMP/$CONTAINER_NAME.zip)
-debug_abs=$(realpath $TEMP/$DEBUG_CONTAINER_NAME.zip)
-
-case $(uname -s) in
-"Linux") target="linux" ;;
-*) target="other" ;;
-esac
-
-if [ "$target" = "linux" ]; then
-  if command -v bun --version >/dev/null; then
-    cp $TEMP/$CONTAINER_NAME/bun $(which bun)
-    cp $TEMP/$DEBUG_CONTAINER_NAME/bun $(which bun-profile)
-  fi
-fi
-
-echo "Saved to:"
-echo $debug_abs
-echo $abs

.docker/run-test.sh

@@ -1,9 +0,0 @@
-#!/bin/bash
-
-set -euxo pipefail
-
-bun install
-bun install --cwd ./test/snippets
-bun install --cwd ./test/scripts
-
-make $BUN_TEST_NAME

.docker/runner.sh

@@ -1,5 +0,0 @@
-#!/bin/bash
-
-set -euxo pipefail
-
-docker container run --security-opt seccomp=.docker/chrome.json --env GITHUB_WORKSPACE=$GITHUB_WORKSPACE --env BUN_TEST_NAME=$BUN_TEST_NAME --ulimit memlock=-1:-1 --init --rm bun-test:latest

.docker/unit-tests.sh

@@ -1,5 +0,0 @@
-#!/bin/bash
-
-set -euxo pipefail
-
-docker container run --security-opt seccomp=.docker/chrome.json --env GITHUB_WORKSPACE=$GITHUB_WORKSPACE --ulimit memlock=-1:-1 --init --rm bun-unit-tests:latest

.dockerignore

@@ -11,5 +11,11 @@ packages/**/bun-profile
 src/bun.js/WebKit
 src/bun.js/WebKit/LayoutTests
 zig-build
-zig-cache
-zig-out
+.zig-cache
+zig-out
+build
+vendor
+node_modules
+*.trace
+
+packages/bun-uws/fuzzing

.git-blame-ignore-revs

@@ -0,0 +1,10 @@
+# Add commits to ignore in `git blame`. This allows large stylistic refactors to
+# avoid mucking up blames.
+#
+# To configure git to use this, run: 
+#
+#    git config blame.ignoreRevsFile .git-blame-ignore-revs
+#
+4ec410e0d7c5f6a712c323444edbf56b48d432d8 # make @import("bun") work in zig (#19096)
+dedd433cbf2e2fe38e51bc166e08fbcc601ad42b # JSValue.undefined -> .jsUndefined()
+6b4662ff55f58247cc2fd22e85b4f9805b0950a5 # JSValue.jsUndefined() -> .js_undefined

.gitattributes

@@ -7,6 +7,7 @@
 *.cpp text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 *.cc text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 *.yml text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+*.toml text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 *.zig text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 *.rs text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 *.h text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
@@ -14,6 +15,8 @@
 *.lock text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 *.map text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 *.md text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+*.mdc text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+*.mdx text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 *.mjs text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 *.mts text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
 
@@ -43,5 +46,13 @@ test/**/* linguist-documentation
 bench/**/* linguist-documentation
 examples/**/* linguist-documentation
 
-src/deps/*.c linguist-vendored
-src/deps/brotli/** linguist-vendored
+vendor/*.c linguist-vendored
+vendor/brotli/** linguist-vendored
+
+test/js/node/test/fixtures linguist-vendored
+test/js/node/test/common linguist-vendored
+
+test/js/bun/css/files linguist-vendored
+
+.vscode/*.json linguist-language=JSON-with-Comments
+src/cli/init/tsconfig.default.json linguist-language=JSON-with-Comments

.github/CODEOWNERS

@@ -0,0 +1,9 @@
+# Project
+/.github/CODEOWNERS @Jarred-Sumner
+
+# Tests
+/test/expectations.txt @Jarred-Sumner
+
+# Types
+*.d.ts @alii
+/packages/bun-types/ @alii

.github/ISSUE_TEMPLATE/2-bug-report.yml

@@ -1,6 +1,8 @@
 name: 🐛 Bug Report
 description: Report an issue that should be fixed
-labels: [bug]
+labels:
+  - bug
+  - needs triage
 body:
   - type: markdown
     attributes:
@@ -10,7 +12,7 @@ body:
         If you need help or support using Bun, and are not reporting a bug, please
         join our [Discord](https://discord.gg/CXdq2DP29u) server, where you can ask questions in the [`#help`](https://discord.gg/32EtH6p7HN) forum.
 
-        Make sure you are running the [latest](https://bun.sh/docs/installation#upgrading) version of Bun.
+        Make sure you are running the [latest](https://bun.com/docs/installation#upgrading) version of Bun.
         The bug you are experiencing may already have been fixed.
 
         Please try to include as much information as possible.

.github/ISSUE_TEMPLATE/3-typescript-bug-report.yml

@@ -1,45 +1,45 @@
 name: 🇹 TypeScript Type Bug Report
 description: Report an issue with TypeScript types
-labels: [bug, typescript]
+labels: [bug, types]
 body:
-- type: markdown
-  attributes:
-    value: |
-      Thank you for submitting a bug report. It helps make Bun better.
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for submitting a bug report. It helps make Bun better.
 
-      If you need help or support using Bun, and are not reporting a bug, please
-      join our [Discord](https://discord.gg/CXdq2DP29u) server, where you can ask questions in the [`#help`](https://discord.gg/32EtH6p7HN) forum.
+        If you need help or support using Bun, and are not reporting a bug, please
+        join our [Discord](https://discord.gg/CXdq2DP29u) server, where you can ask questions in the [`#help`](https://discord.gg/32EtH6p7HN) forum.
 
-      Make sure you are running the [latest](https://bun.sh/docs/installation#upgrading) version of Bun.
-      The bug you are experiencing may already have been fixed.
+        Make sure you are running the [latest](https://bun.com/docs/installation#upgrading) version of Bun.
+        The bug you are experiencing may already have been fixed.
 
-      Please try to include as much information as possible.
+        Please try to include as much information as possible.
 
-- type: input
-  attributes:
-    label: What version of Bun is running?
-    description: Copy the output of `bun --revision`
-- type: input
-  attributes:
-    label: What platform is your computer?
-    description: |
-      For MacOS and Linux: copy the output of `uname -mprs`
-      For Windows: copy the output of `"$([Environment]::OSVersion | ForEach-Object VersionString) $(if ([Environment]::Is64BitOperatingSystem) { "x64" } else { "x86" })"` in the PowerShell console
-- type: textarea
-  attributes:
-    label: What steps can reproduce the bug?
-    description: Explain the bug and provide a code snippet that can reproduce it.
-  validations:
-    required: true
-- type: textarea
-  attributes:
-    label: What is the expected behavior?
-    description: If possible, please provide text instead of a screenshot.
-- type: textarea
-  attributes:
-    label: What do you see instead?
-    description: If possible, please provide text instead of a screenshot.
-- type: textarea
-  attributes:
-    label: Additional information
-    description: Is there anything else you think we should know?
+  - type: input
+    attributes:
+      label: What version of Bun is running?
+      description: Copy the output of `bun --revision`
+  - type: input
+    attributes:
+      label: What platform is your computer?
+      description: |
+        For MacOS and Linux: copy the output of `uname -mprs`
+        For Windows: copy the output of `"$([Environment]::OSVersion | ForEach-Object VersionString) $(if ([Environment]::Is64BitOperatingSystem) { "x64" } else { "x86" })"` in the PowerShell console
+  - type: textarea
+    attributes:
+      label: What steps can reproduce the bug?
+      description: Explain the bug and provide a code snippet that can reproduce it.
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: What is the expected behavior?
+      description: If possible, please provide text instead of a screenshot.
+  - type: textarea
+    attributes:
+      label: What do you see instead?
+      description: If possible, please provide text instead of a screenshot.
+  - type: textarea
+    attributes:
+      label: Additional information
+      description: Is there anything else you think we should know?

.github/ISSUE_TEMPLATE/6-crash-report.yml

@@ -0,0 +1,28 @@
+name: Prefilled crash report
+description: Report a crash in Bun
+labels:
+  - crash
+  - needs triage
+body:
+  - type: markdown
+    attributes:
+      value: |
+        **Thank you so much** for submitting a crash report. You're helping us make Bun more reliable for everyone!
+  - type: textarea
+    id: code
+    attributes:
+      label: How can we reproduce the crash?
+      description: Please provide a [minimal reproduction](https://stackoverflow.com/help/minimal-reproducible-example) using a GitHub repository, [Replit](https://replit.com/@replit/Bun) or [CodeSandbox](https://codesandbox.io/templates/bun)
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant log output
+      description: Please copy and paste any relevant log output. This will be
+        automatically formatted into code, so no need for backticks.
+      render: shell
+  - type: textarea
+    id: remapped_trace
+    attributes:
+      label: Stack Trace (bun.report)
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/7-install-crash-report.yml

@@ -0,0 +1,34 @@
+name: bun install crash report
+description: Report a crash in bun install
+labels:
+  - npm
+  - crash
+body:
+  - type: markdown
+    attributes:
+      value: |
+        **Thank you so much** for submitting a crash report. You're helping us make Bun more reliable for everyone!
+  - type: textarea
+    id: package_json
+    attributes:
+      label: "`package.json` file"
+      description: "Can you upload your `package.json` file? This helps us reproduce the crash."
+      render: json
+  - type: textarea
+    id: repro
+    attributes:
+      label: How can we reproduce the crash?
+      description: Please provide a [minimal reproduction](https://stackoverflow.com/help/minimal-reproducible-example) using a GitHub repository, [Replit](https://replit.com/@replit/Bun) or [CodeSandbox](https://codesandbox.io/templates/bun)
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant log output
+      description: Please copy and paste any relevant log output. This will be
+        automatically formatted into code, so no need for backticks.
+      render: shell
+  - type: textarea
+    id: remapped_trace
+    attributes:
+      label: Stack Trace (bun.report)
+    validations:
+      required: true

.github/actions/bump/action.yml

@@ -0,0 +1,43 @@
+name: Bump version
+description: Bump the version of Bun
+
+inputs:
+  version:
+    description: The most recent version of Bun.
+    required: true
+    type: string
+  token:
+    description: The GitHub token to use for creating a pull request.
+    required: true
+    type: string
+    default: ${{ github.token }}
+
+runs:
+  using: composite
+  steps:
+    - name: Run Bump
+      shell: bash
+      id: bump
+      run: |
+        set -euo pipefail
+        MESSAGE=$(bun ./scripts/bump.ts patch --last-version=${{ inputs.version }})
+        LATEST=$(cat LATEST)
+        echo "version=$LATEST" >> $GITHUB_OUTPUT
+        echo "message=$MESSAGE" >> $GITHUB_OUTPUT
+    - name: Create Pull Request
+      uses: peter-evans/create-pull-request@v7
+      with:
+        add-paths: |
+          CMakeLists.txt
+          LATEST
+        token: ${{ inputs.token }}
+        commit-message: Bump version to ${{ steps.bump.outputs.version }}
+        title: Bump to ${{ steps.bump.outputs.version }}
+        delete-branch: true
+        branch: github-actions/bump-version-${{ steps.bump.outputs.version }}--${{ github.run_id }}
+        body: |
+          ## What does this PR do?
+
+          ${{ steps.bump.outputs.message }}
+
+          Auto-bumped by [this workflow](https://github.com/oven-sh/bun/actions/workflows/release.yml)

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

@@ -0,0 +1,51 @@
+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.2.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=aarch64;;
+          *)                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" --retry 5
+        unzip ${target}.zip
+        mkdir -p ${{ runner.temp }}/.bun/bin
+        mv ${target}/bun* ${{ runner.temp }}/.bun/bin/
+        chmod +x ${{ runner.temp }}/.bun/bin/*
+        ln -fs ${{ runner.temp }}/.bun/bin/bun ${{ runner.temp }}/.bun/bin/bunx
+        echo "${{ runner.temp }}/.bun/bin" >> ${GITHUB_PATH}

.github/pull_request_template.md

@@ -1,50 +1,3 @@
 ### What does this PR do?
 
-<!-- **Please explain what your changes do**, example: -->
-
-<!--
-
-This adds a new flag --bail to bun test. When set, it will stop running tests after the first failure. This is useful for CI environments where you want to fail fast.
-
--->
-
-- [ ] Documentation or TypeScript types (it's okay to leave the rest blank in this case)
-- [ ] Code changes
-
 ### How did you verify your code works?
-
-<!-- **For code changes, please include automated tests**. Feel free to uncomment the line below -->
-
-<!-- I wrote automated tests -->
-
-<!-- If JavaScript/TypeScript modules or builtins changed:
-
-- [ ] I included a test for the new code, or existing tests cover it
-- [ ] I ran my tests locally and they pass (`bun-debug test test-file-name.test`)
-
--->
-
-<!-- If Zig files changed:
-
-- [ ] I checked the lifetime of memory allocated to verify it's (1) freed and (2) only freed when it should be
-- [ ] I included a test for the new code, or an existing test covers it
-- [ ] JSValue used outside outside of the stack is either wrapped in a JSC.Strong or is JSValueProtect'ed
-- [ ] I wrote TypeScript/JavaScript tests and they pass locally (`bun-debug test test-file-name.test`)
--->
-
-<!-- If new methods, getters, or setters were added to a publicly exposed class:
-
-- [ ] I added TypeScript types for the new methods, getters, or setters
--->
-
-<!-- If dependencies in tests changed:
-
-- [ ] I made sure that specific versions of dependencies are used instead of ranged or tagged versions
--->
-
-<!-- If a new builtin ESM/CJS module was added:
-
-- [ ] I updated Aliases in `module_loader.zig` to include the new module
-- [ ] I added a test that imports the module
-- [ ] I added a test that require() the module
--->

.github/workflows/CLAUDE.md

@@ -0,0 +1,103 @@
+# GitHub Actions Workflow Maintenance Guide
+
+This document provides guidance for maintaining the GitHub Actions workflows in this repository.
+
+## format.yml Workflow
+
+### Overview
+The `format.yml` workflow runs code formatters (Prettier, clang-format, and Zig fmt) on pull requests and pushes to main. It's optimized for speed by running all formatters in parallel.
+
+### Key Components
+
+#### 1. Clang-format Script (`scripts/run-clang-format.sh`)
+- **Purpose**: Formats C++ source and header files
+- **What it does**:
+  - Reads C++ files from `cmake/sources/CxxSources.txt`
+  - Finds all header files in `src/` and `packages/`
+  - Excludes third-party directories (libuv, napi, deps, vendor, sqlite, etc.)
+  - Requires specific clang-format version (no fallbacks)
+
+**Important exclusions**:
+- `src/napi/` - Node API headers (third-party)
+- `src/bun.js/bindings/libuv/` - libuv headers (third-party)
+- `src/bun.js/bindings/sqlite/` - SQLite headers (third-party)
+- `src/bun.js/api/ffi-*.h` - FFI headers (generated/third-party)
+- `src/deps/` - Dependencies (third-party)
+- Files in `vendor/`, `third_party/`, `generated/` directories
+
+#### 2. Parallel Execution
+The workflow runs all three formatters simultaneously:
+- Each formatter outputs with a prefix (`[prettier]`, `[clang-format]`, `[zig]`)
+- Output is streamed in real-time without blocking
+- Uses GitHub Actions groups (`::group::`) for collapsible sections
+
+#### 3. Tool Installation
+
+##### Clang-format-19
+- Installs ONLY `clang-format-19` package (not the entire LLVM toolchain)
+- Uses `--no-install-recommends --no-install-suggests` to skip unnecessary packages
+- Quiet installation with `-qq` and `-o=Dpkg::Use-Pty=0`
+
+##### Zig
+- Downloads from `oven-sh/zig` releases (musl build for static linking)
+- URL: `https://github.com/oven-sh/zig/releases/download/autobuild-{COMMIT}/bootstrap-x86_64-linux-musl.zip`
+- Extracts to temp directory to avoid polluting the repository
+- Directory structure: `bootstrap-x86_64-linux-musl/zig`
+
+### Updating the Workflow
+
+#### To update Zig version:
+1. Find the new commit hash from https://github.com/oven-sh/zig/releases
+2. Replace the hash in the wget URL (line 65 of format.yml)
+3. Test that the URL is valid and the binary works
+
+#### To update clang-format version:
+1. Update `LLVM_VERSION_MAJOR` environment variable at the top of format.yml
+2. Update the version check in `scripts/run-clang-format.sh`
+
+#### To add/remove file exclusions:
+1. Edit the exclusion patterns in `scripts/run-clang-format.sh` (lines 34-39)
+2. Test locally to ensure the right files are being formatted
+
+### Performance Optimizations
+1. **Parallel execution**: All formatters run simultaneously
+2. **Minimal installations**: Only required packages, no extras
+3. **Temp directories**: Tools downloaded to temp dirs, cleaned up after use
+4. **Streaming output**: Real-time feedback without buffering
+5. **Early start**: Formatting begins immediately after each tool is ready
+
+### Troubleshooting
+
+**If formatters appear to run sequentially:**
+- Check if output is being buffered (should use `sed` for line prefixing)
+- Ensure background processes use `&` and proper wait commands
+
+**If third-party files are being formatted:**
+- Review exclusion patterns in `scripts/run-clang-format.sh`
+- Check if new third-party directories were added that need exclusion
+
+**If clang-format installation is slow:**
+- Ensure using minimal package installation flags
+- Check if apt cache needs updating
+- Consider caching the clang-format binary between runs
+
+### Testing Changes Locally
+
+```bash
+# Test the clang-format script
+export LLVM_VERSION_MAJOR=19
+./scripts/run-clang-format.sh format
+
+# Test with check mode (no modifications)
+./scripts/run-clang-format.sh check
+
+# Test specific file exclusions
+./scripts/run-clang-format.sh format 2>&1 | grep -E "(libuv|napi|deps)"
+# Should return nothing if exclusions work correctly
+```
+
+### Important Notes
+- The script defaults to **format** mode (modifies files)
+- Always test locally before pushing workflow changes
+- The musl Zig build works on glibc systems due to static linking
+- Keep the exclusion list updated as new third-party code is added

.github/workflows/auto-assign-types.yml

@@ -0,0 +1,19 @@
+name: Auto Assign Types Issues
+
+on:
+  issues:
+    types: [labeled]
+
+jobs:
+  auto-assign:
+    runs-on: ubuntu-latest
+    if: github.event.label.name == 'types'
+    permissions:
+      issues: write
+    steps:
+      - name: Assign to alii
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GH_REPO: ${{ github.repository }}
+        run: |
+          gh issue edit ${{ github.event.issue.number }} --add-assignee alii

.github/workflows/auto-close-duplicates.yml

@@ -0,0 +1,29 @@
+name: Auto-close duplicate issues
+on:
+  schedule:
+    - cron: "0 9 * * *"
+  workflow_dispatch:
+
+jobs:
+  auto-close-duplicates:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    concurrency:
+      group: auto-close-duplicates-${{ github.repository }}
+      cancel-in-progress: true
+    permissions:
+      contents: read
+      issues: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+
+      - name: Auto-close duplicate issues
+        run: bun run scripts/auto-close-duplicates.ts
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_REPOSITORY: ${{ github.repository }}

.github/workflows/auto-label-claude-prs.yml

@@ -0,0 +1,24 @@
+name: Auto-label Claude PRs
+
+on:
+  pull_request:
+    types: [opened]
+
+jobs:
+  auto-label:
+    if: github.event.pull_request.user.login == 'robobun' || contains(github.event.pull_request.body, '🤖 Generated with')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+    steps:
+      - name: Add claude label to PRs from robobun
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.issues.addLabels({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              labels: ['claude']
+            });

.github/workflows/bun-deploy-site.yml

@@ -1,18 +0,0 @@
-# redeploy Vercel site when a file in `docs` changes
-# using VERCEL_DEPLOY_HOOK environment variable
-
-name: Deploy site
-on:
-  push:
-    paths:
-      - "docs/**"
-    branches: [main]
-
-jobs:
-  deploy:
-    name: Deploy site
-    runs-on: ubuntu-latest
-    if: github.repository_owner == 'oven-sh'
-    steps:
-      - name: Trigger Vercel build
-        run: curl ${{ secrets.VERCEL_DEPLOY_HOOK }}

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

@@ -1,140 +0,0 @@
-name: bun-linux
-
-concurrency:
-  group: bun-linux-aarch64-${{ github.ref }}
-  cancel-in-progress: true
-
-on:
-  push:
-    branches:
-      - main
-    paths:
-      - "src/**/*"
-      - "test/**/*"
-      - "packages/bun-usockets/src/**/*"
-      - "packages/bun-uws/src/**/*"
-      - "CMakeLists.txt"
-      - "build.zig"
-      - "Makefile"
-      - "Dockerfile"
-      - ".github/workflows/bun-linux-aarch64.yml"
-  pull_request:
-    branches:
-      - main
-    paths:
-      - "src/**/*"
-      - "test/**/*"
-      - "packages/bun-usockets/src/**/*"
-      - "packages/bun-uws/src/**/*"
-      - "CMakeLists.txt"
-      - "build.zig"
-      - "Makefile"
-      - "Dockerfile"
-      - ".github/workflows/bun-linux-aarch64.yml"
-  # Allows you to run this workflow manually from the Actions tab
-  workflow_dispatch:
-
-jobs:
-  linux:
-    name: ${{matrix.tag}}
-    runs-on: ${{matrix.runner}}
-    if: github.repository_owner == 'oven-sh'
-    timeout-minutes: 90
-    permissions: write-all
-    strategy:
-      matrix:
-        include:
-          - cpu: native
-            tag: linux-aarch64
-            arch: aarch64
-            build_arch: arm64
-            runner: linux-arm64
-            build_machine_arch: aarch64
-    steps:
-      - uses: actions/checkout@v3
-        with:
-          submodules: false
-          ref: ${{github.sha}}
-          clean: true
-      - run: |
-          bash ./scripts/update-submodules.sh
-      - 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
-        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
-        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}}
-            BUILD_MACHINE_ARCH=${{matrix.build_machine_arch}}
-            CPU_TARGET=${{matrix.cpu}}
-            GIT_SHA=${{github.sha}}
-          platforms: linux/${{matrix.build_arch}}
-          target: artifact
-          outputs: type=local,dest=${{runner.temp}}/release
-      - name: Zip
-        run: |
-          # if zip is not found
-          if [ ! -x "$(command -v zip)" ]; then
-            sudo apt-get update && sudo apt-get install -y zip --no-install-recommends
-          fi
-
-          if [ ! -x "$(command -v strip)" ]; then
-            sudo apt-get update && sudo apt-get install -y binutils --no-install-recommends
-          fi
-
-          cd ${{runner.temp}}/release
-          chmod +x bun-profile bun
-
-          mkdir bun-${{matrix.tag}}-profile
-          mkdir bun-${{matrix.tag}}
-
-          strip bun
-
-          mv bun-profile bun-${{matrix.tag}}-profile/bun-profile
-          mv bun bun-${{matrix.tag}}/bun
-
-          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
-        with:
-          name: bun-${{matrix.tag}}-profile
-          path: ${{runner.temp}}/release/bun-${{matrix.tag}}-profile.zip
-      - uses: actions/upload-artifact@v3
-        with:
-          name: bun-${{matrix.tag}}
-          path: ${{runner.temp}}/release/bun-${{matrix.tag}}.zip
-      - name: Release
-        id: release
-        uses: ncipollo/release-action@v1
-        if: |
-          github.repository_owner == 'oven-sh'
-          && github.ref == 'refs/heads/main'
-        with:
-          prerelease: true
-          body: "This canary release of Bun corresponds to the commit [${{ github.sha }}]"
-          allowUpdates: true
-          replacesArtifacts: true
-          generateReleaseNotes: true
-          artifactErrorsFailBuild: true
-          token: ${{ secrets.GITHUB_TOKEN }}
-          name: "Canary (${{github.sha}})"
-          tag: "canary"
-          artifacts: "${{runner.temp}}/release/bun-${{matrix.tag}}.zip,${{runner.temp}}/release/bun-${{matrix.tag}}-profile.zip"

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

@@ -1,335 +0,0 @@
-name: bun-linux
-
-concurrency:
-  group: bun-linux-build-${{ github.ref }}
-  cancel-in-progress: true
-
-on:
-  push:
-    branches:
-      - main
-    paths:
-      - "src/**/*"
-      - "test/**/*"
-      - "packages/bun-usockets/src/**/*"
-      - "packages/bun-uws/src/**/*"
-      - "CMakeLists.txt"
-      - "build.zig"
-      - "Makefile"
-      - "Dockerfile"
-  pull_request:
-    branches:
-      - main
-    paths:
-      - "src/**/*"
-      - "test/**/*"
-      - "packages/bun-usockets/src/**/*"
-      - "packages/bun-uws/src/**/*"
-      - "CMakeLists.txt"
-      - "build.zig"
-      - "Makefile"
-      - "Dockerfile"
-  # Allows you to run this workflow manually from the Actions tab
-  workflow_dispatch:
-
-jobs:
-  linux:
-    name: ${{matrix.tag}}
-    runs-on: ${{matrix.runner}}
-    if: github.repository_owner == 'oven-sh'
-    timeout-minutes: 90
-    permissions: write-all
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - cpu: haswell
-            tag: linux-x64
-            arch: x86_64
-            build_arch: amd64
-            runner: big-ubuntu
-            build_machine_arch: x86_64
-            assertions: "OFF"
-            zig_optimize: "ReleaseFast"
-            target: "artifact"
-          - cpu: nehalem
-            tag: linux-x64-baseline
-            arch: x86_64
-            build_arch: amd64
-            runner: big-ubuntu
-            build_machine_arch: x86_64
-            assertions: "OFF"
-            zig_optimize: "ReleaseFast"
-            target: "artifact"
-          # - cpu: haswell
-          #   tag: linux-x64-assertions
-          #   arch: x86_64
-          #   build_arch: amd64
-          #   runner: big-ubuntu
-          #   build_machine_arch: x86_64
-          #   assertions: "ON"
-          #   zig_optimize: "ReleaseSafe"
-          #   target: "artifact-assertions"
-          # - cpu: nehalem
-          #   tag: linux-x64-baseline-assertions
-          #   arch: x86_64
-          #   build_arch: amd64
-          #   runner: big-ubuntu
-          #   build_machine_arch: x86_64
-          #   assertions: "ON"
-          #   zig_optimize: "ReleaseSafe"
-          #   target: "artifact-assertions"
-
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          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
-        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
-        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}}
-            BUILD_MACHINE_ARCH=${{matrix.build_machine_arch}}
-            CPU_TARGET=${{matrix.cpu}}
-            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
-      - id: bun-version-check
-        name: Bun version check
-        run: |
-          # If this hangs, it means something is seriously wrong with the build
-          ${{runner.temp}}/release/bun-profile --version
-      - name: Zip
-        run: |
-          # if zip is not found
-          if [ ! -x "$(command -v zip)" ]; then
-            sudo apt-get update && sudo apt-get install -y zip --no-install-recommends
-          fi
-
-          if [ ! -x "$(command -v strip)" ]; then
-            sudo apt-get update && sudo apt-get install -y binutils --no-install-recommends
-          fi
-
-          cd ${{runner.temp}}/release
-          chmod +x bun-profile bun
-
-          mkdir bun-${{matrix.tag}}-profile
-          mkdir bun-${{matrix.tag}}
-
-          strip bun
-
-          mv bun-profile bun-${{matrix.tag}}-profile/bun-profile
-          mv bun bun-${{matrix.tag}}/bun
-
-          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
-        with:
-          name: bun-${{matrix.tag}}-profile
-          path: ${{runner.temp}}/release/bun-${{matrix.tag}}-profile.zip
-      - uses: actions/upload-artifact@v3
-        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
-      - name: Release
-        id: release
-        uses: ncipollo/release-action@v1
-        if: |
-          github.repository_owner == 'oven-sh'
-          && github.ref == 'refs/heads/main'
-        with:
-          prerelease: true
-          body: "This canary release of Bun corresponds to the commit [${{ github.sha }}]"
-          allowUpdates: true
-          replacesArtifacts: true
-          generateReleaseNotes: true
-          artifactErrorsFailBuild: true
-          token: ${{ secrets.GITHUB_TOKEN }}
-          name: "Canary (${{github.sha}})"
-          tag: "canary"
-          artifacts: "${{runner.temp}}/release/bun-${{matrix.tag}}.zip,${{runner.temp}}/release/bun-${{matrix.tag}}-profile.zip"
-      - uses: sarisia/actions-status-discord@v1
-        if: failure() && github.repository_owner == 'oven-sh' && github.event_name == 'pull_request'
-        with:
-          title: ""
-          webhook: ${{ secrets.DISCORD_WEBHOOK }}
-          status: ${{ job.status }}
-          noprefix: true
-          nocontext: true
-          description: |
-            Pull Request
-            ### [${{github.event.pull_request.title}}](https://github.com/oven-sh/bun/pull/${{github.event.number}})
-
-            @${{ github.actor }}
-
-            Build failed on ${{ matrix.tag }}:
-
-            **[View build output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})**
-
-            [Commit ${{github.sha}}](https://github.com/oven-sh/bun/commits/${{github.sha}})
-  linux-test:
-    name: Tests ${{matrix.tag}}
-    runs-on: ubuntu-latest
-    needs: [linux]
-    if: github.event_name == 'pull_request'
-    timeout-minutes: 20
-    permissions:
-      pull-requests: write
-    outputs:
-      failing_tests: ${{ steps.test.outputs.failing_tests }}
-      failing_tests_count: ${{ steps.test.outputs.failing_tests_count }}
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - tag: linux-x64
-          - tag: linux-x64-baseline
-          # - tag: linux-x64-assertions
-          # - tag: linux-x64-baseline-assertions
-    steps:
-      - id: checkout
-        name: Checkout
-        uses: actions/checkout@v4
-        with:
-          submodules: false
-          clean: true
-      - id: download
-        name: Download
-        uses: actions/download-artifact@v3
-        with:
-          name: bun-${{matrix.tag}}
-          path: ${{runner.temp}}/release
-      - id: install-bun
-        name: Install Bun
-        run: |
-          cd ${{runner.temp}}/release
-          unzip bun-${{matrix.tag}}.zip
-          cd bun-${{matrix.tag}}
-          chmod +x bun
-          pwd >> $GITHUB_PATH
-      - id: bun-version-check
-        name: Bun version check
-        run: |
-          # If this hangs, it means something is seriously wrong with the build
-          bun --version
-      - id: install-dependnecies
-        name: Install dependencies
-        run: |
-          sudo apt-get update && sudo apt-get install -y openssl
-          bun install --verbose
-          bun install --cwd=test --verbose
-          bun install --cwd=packages/bun-internal-test --verbose
-
-          bun install --cwd=test/js/third_party/prisma --verbose
-
-      # This is disabled because the cores are ~5.5gb each
-      # so it is easy to hit 50gb coredump downloads. Only enable if you need to retrive one
-
-      # - name: Set core dumps to get stored in /cores
-      #   run: |
-      #     sudo mkdir /cores
-      #     sudo chmod 777 /cores
-      #     # Core filenames will be of the form executable.pid.timestamp:
-      #     sudo bash -c 'echo "/cores/%e.%p.%t" > /proc/sys/kernel/core_pattern'
-
-      - id: test
-        name: Test (node runner)
-        env:
-          SMTP_SENDGRID_SENDER: ${{ secrets.SMTP_SENDGRID_SENDER }}
-          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: sarisia/actions-status-discord@v1
-        if: always() && steps.test.outputs.failing_tests != '' && github.event_name == 'pull_request'
-        with:
-          title: ""
-          webhook: ${{ secrets.DISCORD_WEBHOOK }}
-          status: "failure"
-          noprefix: true
-          nocontext: true
-          description: |
-            Pull Request
-            ### ❌ [${{github.event.pull_request.title}}](https://github.com/oven-sh/bun/pull/${{github.event.number}})
-
-            @${{ github.actor }}, there are ${{ steps.test.outputs.failing_tests_count }} files with test failures on ${{ matrix.tag }}:
-
-            ${{ steps.test.outputs.failing_tests }}
-
-            **[View test output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})**
-      - name: Comment on PR
-        if: steps.test.outputs.failing_tests != '' && github.event_name == 'pull_request'
-        uses: thollander/actions-comment-pull-request@v2
-        with:
-          comment_tag: test-failures-${{matrix.tag}}
-          message: |
-            ❌ @${{ github.actor }} ${{ steps.test.outputs.failing_tests_count }} files with test failures on ${{ matrix.tag }}:
-
-            ${{ steps.test.outputs.failing_tests }}
-
-            **[View test output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})**
-
-            <sup>[#${{github.sha}}](https://github.com/oven-sh/bun/commits/${{github.sha}})</sup>
-      - name: Uncomment on PR
-        if: steps.test.outputs.failing_tests == '' && github.event_name == 'pull_request'
-        uses: thollander/actions-comment-pull-request@v2
-        with:
-          comment_tag: test-failures-${{matrix.tag}}
-          mode: upsert
-          create_if_not_exists: false
-          message: |
-            ✅ test failures on ${{ matrix.tag }} have been resolved.
-
-            <sup>[#${{github.sha}}](https://github.com/oven-sh/bun/commits/${{github.sha}})</sup>
-      - id: fail
-        name: Fail the build
-        if: steps.test.outputs.failing_tests != ''
-        run: exit 1

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

@@ -1,478 +0,0 @@
-name: bun-macOS-aarch64
-
-concurrency:
-  group: bun-macOS-aarch64-${{ github.ref }}
-  cancel-in-progress: true
-
-env:
-  LLVM_VERSION: 16
-  BUN_DOWNLOAD_URL_BASE: https://pub-5e11e972747a44bf9aaf9394f185a982.r2.dev/releases/latest
-
-on:
-  push:
-    branches: [main]
-    paths:
-      - "src/**/*"
-      - "test/**/*"
-      - "packages/bun-usockets/src/**/*"
-      - "packages/bun-uws/src/**/*"
-      - "CMakeLists.txt"
-      - "build.zig"
-      - "Makefile"
-      - "Dockerfile"
-  pull_request:
-    branches: [main]
-    paths:
-      - "src/**/*"
-      - "test/**/*"
-      - "packages/bun-usockets/src/**/*"
-      - "packages/bun-uws/src/**/*"
-      - "CMakeLists.txt"
-      - "build.zig"
-      - "Makefile"
-      - "Dockerfile"
-  # Allows you to run this workflow manually from the Actions tab
-  workflow_dispatch:
-
-jobs:
-  macOS-zig:
-    name: macOS Zig Object
-    runs-on: med-ubuntu
-    if: github.repository_owner == 'oven-sh'
-    strategy:
-      matrix:
-        include:
-          - cpu: native
-            arch: aarch64
-            tag: bun-obj-darwin-aarch64
-    steps:
-      - uses: actions/checkout@v4
-      # - 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
-        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'
-        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
-          build-args: |
-            BUILDARCH=${{ runner.arch == 'X64' && 'amd64' || 'arm64' }}
-            BUILD_MACHINE_ARCH=${{ runner.arch == 'X64' && 'x86_64' || 'aarch64' }}
-            ARCH=${{ matrix.arch }}
-            CPU_TARGET=${{ matrix.cpu }}
-            TRIPLET=${{ matrix.arch }}-macos-none
-            GIT_SHA=${{ github.sha }}
-          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
-        with:
-          name: ${{ matrix.tag }}
-          path: ${{runner.temp}}/release/bun-zig.o
-
-  macOS-dependencies:
-    name: macOS Dependencies
-    runs-on: ${{ matrix.runner }}
-    if: github.repository_owner == 'oven-sh'
-    timeout-minutes: 15
-    strategy:
-      matrix:
-        include:
-          - cpu: native
-            arch: aarch64
-            tag: bun-darwin-aarch64
-            obj: bun-obj-darwin-aarch64
-            artifact: bun-obj-darwin-aarch64
-            runner: macos-13-xlarge
-    steps:
-      - uses: actions/checkout@v4
-      - name: Checkout submodules
-        run: git submodule update --init --recursive --depth=1 --progress --force
-
-      - name: Install system dependencies
-        env:
-          HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK: 1
-          HOMEBREW_NO_AUTO_UPDATE: 1
-          HOMEBREW_NO_INSTALL_CLEANUP: 1
-        run: |
-          brew install go sccache ccache rust llvm@$LLVM_VERSION pkg-config coreutils libtool cmake libiconv automake openssl@1.1 ninja gnu-sed pkg-config --force
-          echo "$(brew --prefix ccache)/bin" >> $GITHUB_PATH
-          # echo "$(brew --prefix sccache)/bin" >> $GITHUB_PATH
-          echo "$(brew --prefix coreutils)/libexec/gnubin" >> $GITHUB_PATH
-          echo "$(brew --prefix llvm@$LLVM_VERSION)/bin" >> $GITHUB_PATH
-          brew link --overwrite llvm@$LLVM_VERSION
-
-          curl -LO "$BUN_DOWNLOAD_URL_BASE/bun-darwin-aarch64.zip"
-          unzip bun-darwin-aarch64.zip
-          mkdir -p ${{ runner.temp }}/.bun/bin
-          mv bun-darwin-aarch64/bun ${{ runner.temp }}/.bun/bin/bun
-          chmod +x ${{ runner.temp }}/.bun/bin/bun
-          echo "${{ runner.temp }}/.bun/bin" >> $GITHUB_PATH
-
-      - name: Hash submodule versions
-        run: |
-          print_data() {
-            git submodule | grep -v WebKit
-            llvm-config --version
-            rustc --version
-            cat $(echo scripts/build*.sh scripts/all-dependencies.sh | tr " " "\n" | sort)
-          }
-          echo "sha=$(print_data | sha1sum | cut -c 1-10)" >> $GITHUB_OUTPUT
-        id: submodule-versions
-
-      - name: Cache submodule dependencies
-        id: cache-deps-restore
-        uses: actions/cache/restore@v3
-        with:
-          path: ${{runner.temp}}/bun-deps
-          key: bun-deps-${{ matrix.tag }}-${{ steps.submodule-versions.outputs.sha }}
-
-      - name: Compile submodule dependencies
-        if: ${{ !steps.cache-deps-restore.outputs.cache-hit }}
-        env:
-          CPU_TARGET: ${{ matrix.cpu }}
-          BUN_DEPS_OUT_DIR: ${{runner.temp}}/bun-deps
-        run: |
-          mkdir -p $BUN_DEPS_OUT_DIR
-          bash ./scripts/clean-dependencies.sh
-          bash ./scripts/all-dependencies.sh
-
-      - name: Cache submodule dependencies
-        if: ${{ !steps.cache-deps-restore.outputs.cache-hit }}
-        id: cache-deps-save
-        uses: actions/cache/save@v3
-        with:
-          path: ${{runner.temp}}/bun-deps
-          key: ${{ steps.cache-deps-restore.outputs.cache-primary-key }}
-
-      - name: Upload submodule dependencies
-        uses: actions/upload-artifact@v3
-        with:
-          name: ${{ matrix.tag }}-deps
-          path: ${{runner.temp}}/bun-deps
-
-  macOS-cpp:
-    name: macOS C++
-    runs-on: ${{ matrix.runner }}
-    if: github.repository_owner == 'oven-sh'
-    timeout-minutes: 90
-    strategy:
-      matrix:
-        include:
-          - cpu: native
-            arch: aarch64
-            tag: bun-darwin-aarch64
-            obj: bun-obj-darwin-aarch64
-            artifact: bun-obj-darwin-aarch64
-            runner: macos-13-xlarge
-    steps:
-      - uses: actions/checkout@v4
-      - name: Checkout submodules
-        run: git submodule update --init --recursive --depth=1 --progress --force
-
-      - name: Install system dependencies
-        env:
-          HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK: 1
-          HOMEBREW_NO_AUTO_UPDATE: 1
-          HOMEBREW_NO_INSTALL_CLEANUP: 1
-        run: |
-          brew install go sccache ccache rust llvm@$LLVM_VERSION pkg-config coreutils libtool cmake libiconv automake openssl@1.1 ninja gnu-sed pkg-config --force
-          echo "$(brew --prefix ccache)/bin" >> $GITHUB_PATH
-          # echo "$(brew --prefix sccache)/bin" >> $GITHUB_PATH
-          echo "$(brew --prefix coreutils)/libexec/gnubin" >> $GITHUB_PATH
-          echo "$(brew --prefix llvm@$LLVM_VERSION)/bin" >> $GITHUB_PATH
-          brew link --overwrite llvm@$LLVM_VERSION
-
-          curl -LO "$BUN_DOWNLOAD_URL_BASE/bun-darwin-aarch64.zip"
-          unzip bun-darwin-aarch64.zip
-          mkdir -p ${{ runner.temp }}/.bun/bin
-          mv bun-darwin-aarch64/bun ${{ runner.temp }}/.bun/bin/bun
-          chmod +x ${{ runner.temp }}/.bun/bin/bun
-          echo "${{ runner.temp }}/.bun/bin" >> $GITHUB_PATH
-
-      # TODO: replace with sccache
-      - name: ccache
-        uses: hendrikmuhs/ccache-action@v1.2
-        with:
-          key: ${{ runner.os }}-ccache-${{ matrix.tag }}
-          restore-keys: ${{ runner.os }}-ccache-${{ matrix.tag }}
-
-      - name: Compile C++
-        env:
-          CPU_TARGET: ${{ matrix.cpu }}
-          SOURCE_DIR: ${{ github.workspace }}
-          OBJ_DIR: ${{ runner.temp }}/bun-cpp-obj
-          BUN_DEPS_OUT_DIR: ${{runner.temp}}/bun-deps
-        run: |
-          mkdir -p $OBJ_DIR
-          cd $OBJ_DIR
-
-          cmake -S $SOURCE_DIR -B $OBJ_DIR \
-            -G Ninja \
-            -DCMAKE_BUILD_TYPE=Release \
-            -DBUN_CPP_ONLY=1 \
-            -DNO_CONFIGURE_DEPENDS=1
-
-          bash compile-cpp-only.sh -v
-
-      - name: Upload C++
-        uses: actions/upload-artifact@v3
-        with:
-          name: ${{ matrix.tag }}-cpp
-          path: ${{ runner.temp }}/bun-cpp-obj/bun-cpp-objects.a
-  macOS-link:
-    name: macOS Link
-    runs-on: ${{ matrix.runner }}
-    if: github.repository_owner == 'oven-sh'
-    needs: [macOS-zig, macOS-cpp, macOS-dependencies]
-    timeout-minutes: 60
-    permissions: write-all
-    strategy:
-      matrix:
-        include:
-          - cpu: native
-            arch: aarch64
-            tag: bun-darwin-aarch64
-            obj: bun-obj-darwin-aarch64
-            package: bun-darwin-aarch64
-            artifact: bun-obj-darwin-aarch64
-            runner: macos-13-xlarge
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          submodules: recursive
-          ref: ${{github.sha}}
-          clean: true
-      - name: Checkout submodules
-        run: git submodule update --init --recursive --depth=1 --progress --force
-
-      - name: Install system dependencies
-        env:
-          HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK: 1
-          HOMEBREW_NO_AUTO_UPDATE: 1
-          HOMEBREW_NO_INSTALL_CLEANUP: 1
-        run: |
-          brew install ccache llvm@$LLVM_VERSION pkg-config coreutils libtool cmake libiconv openssl@1.1 ninja --force
-          echo "$(brew --prefix ccache)/bin" >> $GITHUB_PATH
-          echo "$(brew --prefix coreutils)/libexec/gnubin" >> $GITHUB_PATH
-          echo "$(brew --prefix llvm@$LLVM_VERSION)/bin" >> $GITHUB_PATH
-          brew link --overwrite llvm@$LLVM_VERSION
-
-          curl -LO "$BUN_DOWNLOAD_URL_BASE/bun-darwin-${{matrix.arch}}.zip"
-          unzip bun-darwin-${{matrix.arch}}.zip
-          mkdir -p ${{ runner.temp }}/.bun/bin
-          mv bun-darwin-${{matrix.arch}}/bun ${{ runner.temp }}/.bun/bin/bun
-          chmod +x ${{ runner.temp }}/.bun/bin/bun
-          echo "${{ runner.temp }}/.bun/bin" >> $GITHUB_PATH
-
-      - name: Download C++
-        uses: actions/download-artifact@v3
-        with:
-          name: ${{ matrix.tag }}-cpp
-          path: ${{ runner.temp }}/bun-cpp-obj
-
-      - name: Download Zig Object
-        uses: actions/download-artifact@v3
-        with:
-          name: ${{ matrix.obj }}
-          path: ${{ runner.temp }}/release
-
-      - name: Downloaded submodule dependencies
-        uses: actions/download-artifact@v3
-        with:
-          name: ${{ matrix.tag }}-deps
-          path: ${{runner.temp}}/bun-deps
-
-      - name: Link
-        env:
-          CPU_TARGET: ${{ matrix.cpu }}
-        run: |
-          SRC_DIR=$PWD
-          mkdir ${{runner.temp}}/link-build
-          cd ${{runner.temp}}/link-build
-          cmake $SRC_DIR \
-            -G Ninja \
-            -DCMAKE_BUILD_TYPE=Release \
-            -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" \
-            -DBUN_DEPS_OUT_DIR="${{runner.temp}}/bun-deps" \
-            -DNO_CONFIGURE_DEPENDS=1
-          ninja -v
-      - name: Zip
-        run: |
-          cd ${{runner.temp}}/link-build
-          chmod +x bun-profile bun
-
-          mkdir -p ${{matrix.tag}}-profile/ ${{matrix.tag}}/
-
-          mv bun-profile ${{matrix.tag}}-profile/bun-profile
-          mv bun ${{matrix.tag}}/bun
-
-          zip -r ${{matrix.tag}}-profile.zip ${{matrix.tag}}-profile
-          zip -r ${{matrix.tag}}.zip ${{matrix.tag}}
-      - uses: actions/upload-artifact@v3
-        with:
-          name: ${{matrix.tag}}-profile
-          path: ${{runner.temp}}/link-build/${{matrix.tag}}-profile.zip
-      - uses: actions/upload-artifact@v3
-        with:
-          name: ${{matrix.tag}}
-          path: ${{runner.temp}}/link-build/${{matrix.tag}}.zip
-      - name: Release
-        id: release
-        uses: ncipollo/release-action@v1
-        if: |
-          github.repository_owner == 'oven-sh'
-          && github.ref == 'refs/heads/main'
-        with:
-          prerelease: true
-          body: "This canary release of Bun corresponds to the commit [${{ github.sha }}]"
-          allowUpdates: true
-          replacesArtifacts: true
-          generateReleaseNotes: true
-          artifactErrorsFailBuild: true
-          token: ${{ secrets.GITHUB_TOKEN }}
-          name: "Canary (${{github.sha}})"
-          tag: "canary"
-          artifacts: "${{runner.temp}}/link-build/${{matrix.tag}}.zip,${{runner.temp}}/link-build/${{matrix.tag}}-profile.zip"
-      - uses: sarisia/actions-status-discord@v1
-        if: failure() && github.repository_owner == 'oven-sh' && github.event_name == 'pull_request'
-        with:
-          title: ""
-          webhook: ${{ secrets.DISCORD_WEBHOOK }}
-          status: ${{ job.status }}
-          noprefix: true
-          nocontext: true
-          description: |
-            Pull Request
-            ### [${{github.event.pull_request.title}}](https://github.com/oven-sh/bun/pull/${{github.event.number}})
-
-            @${{ github.actor }}
-
-            Build failed on ${{ matrix.tag }}:
-
-            **[View build output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})**
-
-            [Commit ${{github.sha}}](https://github.com/oven-sh/bun/commits/${{github.sha}})
-  macOS-test:
-    name: Tests ${{matrix.tag}}
-    runs-on: ${{ matrix.runner }}
-    needs: [macOS-link]
-    if: github.event_name == 'pull_request' && github.repository_owner == 'oven-sh'
-    permissions:
-      pull-requests: write
-    timeout-minutes: 30
-    outputs:
-      failing_tests: ${{ steps.test.outputs.failing_tests }}
-      failing_tests_count: ${{ steps.test.outputs.failing_tests_count }}
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - tag: bun-darwin-aarch64
-            runner: macos-13-xlarge
-    steps:
-      - id: checkout
-        name: Checkout
-        uses: actions/checkout@v3
-        with:
-          submodules: false
-      - id: download
-        name: Download
-        uses: actions/download-artifact@v3
-        with:
-          name: ${{matrix.tag}}
-          path: ${{runner.temp}}/release
-      - id: install-bun
-        name: Install Bun
-        run: |
-          cd ${{runner.temp}}/release
-          unzip ${{matrix.tag}}.zip
-          cd ${{matrix.tag}}
-          chmod +x bun
-          pwd >> $GITHUB_PATH
-      - id: bun-version-check
-        name: Bun version check
-        run: |
-          # If this hangs, it means something is seriously wrong with the build
-          bun --version
-      - id: install
-        name: Install dependencies
-        run: |
-          bun install --verbose
-          bun install --cwd=test --verbose
-          bun install --cwd=packages/bun-internal-test --verbose
-      - id: test
-        name: Test (node runner)
-        env:
-          SMTP_SENDGRID_SENDER: ${{ secrets.SMTP_SENDGRID_SENDER }}
-          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: |
-          node packages/bun-internal-test/src/runner.node.mjs || true
-      - uses: sarisia/actions-status-discord@v1
-        if: always() && steps.test.outputs.failing_tests != '' && github.event_name == 'pull_request'
-        with:
-          title: ""
-          webhook: ${{ secrets.DISCORD_WEBHOOK }}
-          status: "failure"
-          noprefix: true
-          nocontext: true
-          description: |
-            Pull Request
-            ### ❌ [${{github.event.pull_request.title}}](https://github.com/oven-sh/bun/pull/${{github.event.number}})
-
-            @${{ github.actor }}, there are ${{ steps.test.outputs.failing_tests_count }} files with test failures on ${{ matrix.tag }}:
-
-            ${{ steps.test.outputs.failing_tests }}
-
-            **[View test output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})**
-      - name: Comment on PR
-        if: steps.test.outputs.failing_tests != '' && github.event_name == 'pull_request'
-        uses: thollander/actions-comment-pull-request@v2
-        with:
-          comment_tag: test-failures-${{matrix.tag}}
-          message: |
-            ❌ @${{ github.actor }} ${{ steps.test.outputs.failing_tests_count }} files with test failures on ${{ matrix.tag }}:
-
-            ${{ steps.test.outputs.failing_tests }}
-
-            **[View test output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})**
-
-            <sup>[#${{github.sha}}](https://github.com/oven-sh/bun/commits/${{github.sha}})</sup>
-      - name: Uncomment on PR
-        if: steps.test.outputs.failing_tests == '' && github.event_name == 'pull_request'
-        uses: thollander/actions-comment-pull-request@v2
-        with:
-          comment_tag: test-failures-${{matrix.tag}}
-          mode: upsert
-          create_if_not_exists: false
-          message: |
-            ✅ test failures on ${{ matrix.tag }} have been resolved.
-
-            <sup>[#${{github.sha}}](https://github.com/oven-sh/bun/commits/${{github.sha}})</sup>
-      - id: fail
-        name: Fail the build
-        if: steps.test.outputs.failing_tests != ''
-        run: exit 1

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

@@ -1,483 +0,0 @@
-name: bun-macOS-x64-baseline
-
-concurrency:
-  group: bun-macOS-x64-baseline-${{ github.ref }}
-  cancel-in-progress: true
-
-env:
-  LLVM_VERSION: 16
-  BUN_DOWNLOAD_URL_BASE: https://pub-5e11e972747a44bf9aaf9394f185a982.r2.dev/releases/latest
-
-on:
-  push:
-    branches: [main]
-    paths:
-      - "src/**/*"
-      - "test/**/*"
-      - "packages/bun-usockets/src/**/*"
-      - "packages/bun-uws/src/**/*"
-      - "CMakeLists.txt"
-      - "build.zig"
-      - "Makefile"
-      - "Dockerfile"
-  pull_request:
-    branches: [main]
-    paths:
-      - "src/**/*"
-      - "test/**/*"
-      - "packages/bun-usockets/src/**/*"
-      - "packages/bun-uws/src/**/*"
-      - "CMakeLists.txt"
-      - "build.zig"
-      - "Makefile"
-      - "Dockerfile"
-  # Allows you to run this workflow manually from the Actions tab
-  workflow_dispatch:
-
-jobs:
-  macos-object-files:
-    name: macOS Object
-    runs-on: med-ubuntu
-    if: github.repository_owner == 'oven-sh'
-    strategy:
-      matrix:
-        include:
-          - cpu: nehalem
-            arch: x86_64
-            tag: bun-obj-darwin-x64-baseline
-          # - cpu: haswell
-          #   arch: x86_64
-          #   tag: bun-obj-darwin-x64
-          # - cpu: native
-          #   arch: aarch64
-          #   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
-        with:
-          registry: ghcr.io
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Compile Zig Object
-        uses: docker/build-push-action@v3
-        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' }}
-            ARCH=${{ matrix.arch }}
-            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
-        with:
-          name: ${{ matrix.tag }}
-          path: ${{runner.temp}}/release/bun-zig.o
-  macOS-dependencies:
-    name: macOS Dependencies
-    runs-on: ${{ matrix.runner }}
-    if: github.repository_owner == 'oven-sh'
-    timeout-minutes: 15
-    strategy:
-      matrix:
-        include:
-          - cpu: nehalem
-            arch: x86_64
-            tag: bun-darwin-x64-baseline
-            obj: bun-obj-darwin-x64-baseline
-            runner: macos-12-large
-            artifact: bun-obj-darwin-x64-baseline
-    steps:
-      - uses: actions/checkout@v4
-      - name: Checkout submodules
-        run: git submodule update --init --recursive --depth=1 --progress --force
-
-      - name: Install system dependencies
-        env:
-          HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK: 1
-          HOMEBREW_NO_AUTO_UPDATE: 1
-          HOMEBREW_NO_INSTALL_CLEANUP: 1
-        run: |
-          brew install sccache ccache rust llvm@$LLVM_VERSION pkg-config coreutils libtool cmake libiconv automake openssl@1.1 ninja gnu-sed pkg-config --force
-          echo "$(brew --prefix ccache)/bin" >> $GITHUB_PATH
-          # echo "$(brew --prefix sccache)/bin" >> $GITHUB_PATH
-          echo "$(brew --prefix coreutils)/libexec/gnubin" >> $GITHUB_PATH
-          echo "$(brew --prefix llvm@$LLVM_VERSION)/bin" >> $GITHUB_PATH
-          brew link --overwrite llvm@$LLVM_VERSION
-
-      - name: Hash submodule versions
-        run: |
-          print_data() {
-            git submodule | grep -v WebKit
-            llvm-config --version
-            rustc --version
-            cat $(echo scripts/build*.sh scripts/all-dependencies.sh | tr " " "\n" | sort)
-          }
-          echo "sha=$(print_data | sha1sum | cut -c 1-10)" >> $GITHUB_OUTPUT
-        id: submodule-versions
-
-      - name: Cache submodule dependencies
-        id: cache-deps-restore
-        uses: actions/cache/restore@v3
-        with:
-          path: ${{runner.temp}}/bun-deps
-          key: bun-deps-${{ matrix.tag }}-${{ steps.submodule-versions.outputs.sha }}
-
-      - name: Compile submodule dependencies
-        if: ${{ !steps.cache-deps-restore.outputs.cache-hit }}
-        env:
-          CPU_TARGET: ${{ matrix.cpu }}
-          BUN_DEPS_OUT_DIR: ${{runner.temp}}/bun-deps
-        run: |
-          mkdir -p $BUN_DEPS_OUT_DIR
-          bash ./scripts/clean-dependencies.sh
-          bash ./scripts/all-dependencies.sh
-
-      - name: Cache submodule dependencies
-        if: ${{ !steps.cache-deps-restore.outputs.cache-hit }}
-        id: cache-deps-save
-        uses: actions/cache/save@v3
-        with:
-          path: ${{runner.temp}}/bun-deps
-          key: ${{ steps.cache-deps-restore.outputs.cache-primary-key }}
-
-      - name: Upload submodule dependencies
-        uses: actions/upload-artifact@v3
-        with:
-          name: ${{ matrix.tag }}-deps
-          path: ${{runner.temp}}/bun-deps
-
-  macOS-cpp:
-    name: macOS C++
-    runs-on: ${{ matrix.runner }}
-    if: github.repository_owner == 'oven-sh'
-    timeout-minutes: 90
-    strategy:
-      matrix:
-        include:
-          - cpu: nehalem
-            arch: x86_64
-            tag: bun-darwin-x64-baseline
-            obj: bun-obj-darwin-x64-baseline
-            runner: macos-12-large
-            artifact: bun-obj-darwin-x64-baseline
-    steps:
-      - uses: actions/checkout@v4
-      - name: Checkout submodules
-        run: git submodule update --init --recursive --depth=1 --progress --force
-
-      - name: Install system dependencies
-        env:
-          HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK: 1
-          HOMEBREW_NO_AUTO_UPDATE: 1
-          HOMEBREW_NO_INSTALL_CLEANUP: 1
-        run: |
-          brew install sccache ccache rust llvm@$LLVM_VERSION pkg-config coreutils libtool cmake libiconv automake openssl@1.1 ninja gnu-sed pkg-config --force
-          echo "$(brew --prefix ccache)/bin" >> $GITHUB_PATH
-          # echo "$(brew --prefix sccache)/bin" >> $GITHUB_PATH
-          echo "$(brew --prefix coreutils)/libexec/gnubin" >> $GITHUB_PATH
-          echo "$(brew --prefix llvm@$LLVM_VERSION)/bin" >> $GITHUB_PATH
-          brew link --overwrite llvm@$LLVM_VERSION
-
-          curl -LO "$BUN_DOWNLOAD_URL_BASE/bun-darwin-x64-baseline.zip"
-          unzip bun-darwin-x64-baseline.zip
-          mkdir -p ${{ runner.temp }}/.bun/bin
-          mv bun-darwin-x64-baseline/bun ${{ runner.temp }}/.bun/bin/bun
-          chmod +x ${{ runner.temp }}/.bun/bin/bun
-          echo "${{ runner.temp }}/.bun/bin" >> $GITHUB_PATH
-
-      # TODO: replace with sccache
-      - name: ccache
-        uses: hendrikmuhs/ccache-action@v1.2
-        with:
-          key: ${{ runner.os }}-ccache-${{ matrix.tag }}
-          restore-keys: ${{ runner.os }}-ccache-${{ matrix.tag }}
-
-      - name: Compile C++
-        env:
-          CPU_TARGET: ${{ matrix.cpu }}
-          SOURCE_DIR: ${{ github.workspace }}
-          OBJ_DIR: ${{ runner.temp }}/bun-cpp-obj
-          BUN_DEPS_OUT_DIR: ${{runner.temp}}/bun-deps
-        run: |
-          mkdir -p $OBJ_DIR
-          cd $OBJ_DIR
-
-          cmake -S $SOURCE_DIR -B $OBJ_DIR \
-            -G Ninja \
-            -DCMAKE_BUILD_TYPE=Release \
-            -DBUN_CPP_ONLY=1 \
-            -DNO_CONFIGURE_DEPENDS=1
-
-          bash compile-cpp-only.sh -v
-
-      - name: Upload C++
-        uses: actions/upload-artifact@v3
-        with:
-          name: ${{ matrix.tag }}-cpp
-          path: ${{ runner.temp }}/bun-cpp-obj/bun-cpp-objects.a
-  macOS:
-    name: macOS Link
-    runs-on: ${{ matrix.runner }}
-    if: github.repository_owner == 'oven-sh'
-    needs: [macOS-cpp, macos-object-files, macOS-dependencies]
-    timeout-minutes: 90
-    permissions: write-all
-    strategy:
-      matrix:
-        include:
-          - cpu: nehalem
-            arch: x86_64
-            tag: bun-darwin-x64-baseline
-            obj: bun-obj-darwin-x64-baseline
-            package: bun-darwin-x64
-            runner: macos-12-large
-            artifact: bun-obj-darwin-x64-baseline
-    steps:
-      - uses: actions/checkout@v3
-      - name: Checkout submodules
-        run: git submodule update --init --recursive --depth=1 --progress --force
-
-      - name: Install system dependencies
-        env:
-          HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK: 1
-          HOMEBREW_NO_AUTO_UPDATE: 1
-          HOMEBREW_NO_INSTALL_CLEANUP: 1
-        run: |
-          brew install ccache llvm@$LLVM_VERSION pkg-config coreutils libtool cmake libiconv openssl@1.1 ninja --force
-          echo "$(brew --prefix ccache)/bin" >> $GITHUB_PATH
-          echo "$(brew --prefix coreutils)/libexec/gnubin" >> $GITHUB_PATH
-          echo "$(brew --prefix llvm@$LLVM_VERSION)/bin" >> $GITHUB_PATH
-          brew link --overwrite llvm@$LLVM_VERSION
-
-          curl -LO "$BUN_DOWNLOAD_URL_BASE/bun-darwin-x64-baseline.zip"
-          unzip bun-darwin-x64-baseline.zip
-          mkdir -p ${{ runner.temp }}/.bun/bin
-          mv bun-darwin-x64-baseline/bun ${{ runner.temp }}/.bun/bin/bun
-          chmod +x ${{ runner.temp }}/.bun/bin/bun
-          echo "${{ runner.temp }}/.bun/bin" >> $GITHUB_PATH
-
-      - name: Download C++
-        uses: actions/download-artifact@v3
-        with:
-          name: ${{ matrix.tag }}-cpp
-          path: ${{ runner.temp }}/bun-cpp-obj
-
-      - name: Download Zig Object
-        uses: actions/download-artifact@v3
-        with:
-          name: ${{ matrix.obj }}
-          path: ${{ runner.temp }}/release
-
-      - name: Downloaded submodule dependencies
-        uses: actions/download-artifact@v3
-        with:
-          name: ${{ matrix.tag }}-deps
-          path: ${{runner.temp}}/bun-deps
-
-      - name: Link
-        env:
-          CPU_TARGET: ${{ matrix.cpu }}
-        run: |
-          SRC_DIR=$PWD
-          mkdir ${{runner.temp}}/link-build
-          cd ${{runner.temp}}/link-build
-          cmake $SRC_DIR \
-            -G Ninja \
-            -DCMAKE_BUILD_TYPE=Release \
-            -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" \
-            -DBUN_DEPS_OUT_DIR="${{runner.temp}}/bun-deps" \
-            -DNO_CONFIGURE_DEPENDS=1
-          ninja -v
-      - name: Zip
-        run: |
-          cd ${{runner.temp}}/link-build
-          chmod +x bun-profile bun
-
-          mkdir -p ${{matrix.tag}}-profile/ ${{matrix.tag}}/
-
-          mv bun-profile ${{matrix.tag}}-profile/bun-profile
-          mv bun ${{matrix.tag}}/bun
-
-          zip -r ${{matrix.tag}}-profile.zip ${{matrix.tag}}-profile
-          zip -r ${{matrix.tag}}.zip ${{matrix.tag}}
-      - uses: actions/upload-artifact@v3
-        with:
-          name: ${{matrix.tag}}-profile
-          path: ${{runner.temp}}/link-build/${{matrix.tag}}-profile.zip
-      - uses: actions/upload-artifact@v3
-        with:
-          name: ${{matrix.tag}}
-          path: ${{runner.temp}}/link-build/${{matrix.tag}}.zip
-      - name: Release
-        id: release
-        uses: ncipollo/release-action@v1
-        if: |
-          github.repository_owner == 'oven-sh'
-          && github.ref == 'refs/heads/main'
-        with:
-          prerelease: true
-          body: "This canary release of Bun corresponds to the commit [${{ github.sha }}]"
-          allowUpdates: true
-          replacesArtifacts: true
-          generateReleaseNotes: true
-          artifactErrorsFailBuild: true
-          token: ${{ secrets.GITHUB_TOKEN }}
-          name: "Canary (${{github.sha}})"
-          tag: "canary"
-          artifacts: "${{runner.temp}}/link-build/${{matrix.tag}}.zip,${{runner.temp}}/link-build/${{matrix.tag}}-profile.zip"
-      - uses: sarisia/actions-status-discord@v1
-        if: failure() && github.repository_owner == 'oven-sh' && github.event_name == 'pull_request'
-        with:
-          title: ""
-          webhook: ${{ secrets.DISCORD_WEBHOOK }}
-          status: ${{ job.status }}
-          noprefix: true
-          nocontext: true
-          description: |
-            Pull Request
-            ### [${{github.event.pull_request.title}}](https://github.com/oven-sh/bun/pull/${{github.event.number}})
-
-            @${{ github.actor }}
-
-            Build failed on ${{ matrix.tag }}:
-
-            **[View build output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})**
-
-            [Commit ${{github.sha}}](https://github.com/oven-sh/bun/commits/${{github.sha}})
-  macOS-test:
-    name: macOS Test
-    runs-on: ${{ matrix.runner }}
-    needs: [macOS]
-    # if: github.event_name == 'pull_request' && github.repository_owner == 'oven-sh'
-    if: false
-    permissions:
-      pull-requests: write
-    timeout-minutes: 30
-    outputs:
-      failing_tests: ${{ steps.test.outputs.failing_tests }}
-      failing_tests_count: ${{ steps.test.outputs.failing_tests_count }}
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - tag: bun-darwin-x64-baseline
-            runner: macos-12-large
-    steps:
-      - id: checkout
-        name: Checkout
-        uses: actions/checkout@v3
-        with:
-          submodules: false
-      - id: download
-        name: Download
-        uses: actions/download-artifact@v3
-        with:
-          name: ${{matrix.tag}}
-          path: ${{runner.temp}}/release
-      - id: install-bun
-        name: Install Bun
-        run: |
-          cd ${{runner.temp}}/release
-          unzip ${{matrix.tag}}.zip
-          cd ${{matrix.tag}}
-          chmod +x bun
-          pwd >> $GITHUB_PATH
-      - id: bun-version-check
-        name: Bun version check
-        run: |
-          # If this hangs, it means something is seriously wrong with the build
-          bun --version
-      - id: install
-        name: Install dependencies
-        run: |
-          bun install --verbose
-          bun install --cwd=test --verbose
-          bun install --cwd=packages/bun-internal-test --verbose
-      - id: test
-        name: Test (node runner)
-        env:
-          SMTP_SENDGRID_SENDER: ${{ secrets.SMTP_SENDGRID_SENDER }}
-          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: |
-          node packages/bun-internal-test/src/runner.node.mjs || true
-      - uses: sarisia/actions-status-discord@v1
-        if: always() && steps.test.outputs.failing_tests != '' && github.event_name == 'pull_request'
-        with:
-          title: ""
-          webhook: ${{ secrets.DISCORD_WEBHOOK }}
-          status: "failure"
-          noprefix: true
-          nocontext: true
-          description: |
-            Pull Request
-            ### ❌ [${{github.event.pull_request.title}}](https://github.com/oven-sh/bun/pull/${{github.event.number}})
-
-            Hey @${{ github.actor }},
-
-            ${{ steps.test.outputs.failing_tests_count }} files with test failures on ${{ matrix.tag }}:
-
-            ${{ steps.test.outputs.failing_tests }}
-
-            **[View test output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})**
-
-      - name: Comment on PR
-        if: steps.test.outputs.failing_tests != '' && github.event_name == 'pull_request'
-        uses: thollander/actions-comment-pull-request@v2
-        with:
-          comment_tag: test-failures-${{matrix.tag}}
-          message: |
-            ❌ @${{ github.actor }} ${{ steps.test.outputs.failing_tests_count }} files with test failures on ${{ matrix.tag }}:
-
-            ${{ steps.test.outputs.failing_tests }}
-
-            **[View test output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})**
-
-            <sup>[#${{github.sha}}](https://github.com/oven-sh/bun/commits/${{github.sha}})</sup>
-      - name: Uncomment on PR
-        if: steps.test.outputs.failing_tests == '' && github.event_name == 'pull_request'
-        uses: thollander/actions-comment-pull-request@v2
-        with:
-          comment_tag: test-failures-${{matrix.tag}}
-          mode: upsert
-          create_if_not_exists: false
-          message: |
-            ✅ test failures on ${{ matrix.tag }} have been resolved.
-
-            <sup>[#${{github.sha}}](https://github.com/oven-sh/bun/commits/${{github.sha}})</sup>
-      - id: fail
-        name: Fail the build
-        if: steps.test.outputs.failing_tests != ''
-        run: exit 1

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

@@ -1,477 +0,0 @@
-name: bun-macOS-x64
-
-concurrency:
-  group: bun-macOS-x64-${{ github.ref }}
-  cancel-in-progress: true
-
-env:
-  LLVM_VERSION: 16
-  BUN_DOWNLOAD_URL_BASE: https://pub-5e11e972747a44bf9aaf9394f185a982.r2.dev/releases/latest
-
-on:
-  push:
-    branches: [main]
-    paths:
-      - "src/**/*"
-      - "test/**/*"
-      - "packages/bun-usockets/src/**/*"
-      - "packages/bun-uws/src/**/*"
-      - "CMakeLists.txt"
-      - "build.zig"
-      - "Makefile"
-      - "Dockerfile"
-  pull_request:
-    branches: [main]
-    paths:
-      - "src/**/*"
-      - "test/**/*"
-      - "packages/bun-usockets/src/**/*"
-      - "packages/bun-uws/src/**/*"
-      - "CMakeLists.txt"
-      - "build.zig"
-      - "Makefile"
-      - "Dockerfile"
-  # Allows you to run this workflow manually from the Actions tab
-  workflow_dispatch:
-
-jobs:
-  macOS-zig:
-    name: macOS Zig Object
-    runs-on: med-ubuntu
-    if: github.repository_owner == 'oven-sh'
-    strategy:
-      matrix:
-        include:
-          # - cpu: nehalem
-          #   arch: x86_64
-          #   tag: bun-obj-darwin-x64-baseline
-          - cpu: haswell
-            arch: x86_64
-            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
-        with:
-          registry: ghcr.io
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Compile Zig Object
-        uses: docker/build-push-action@v3
-        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' }}
-            ARCH=${{ matrix.arch }}
-            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
-        with:
-          name: ${{ matrix.tag }}
-          path: ${{runner.temp}}/release/bun-zig.o
-
-  macOS-dependencies:
-    name: macOS Dependencies
-    runs-on: ${{ matrix.runner }}
-    if: github.repository_owner == 'oven-sh'
-    timeout-minutes: 15
-    strategy:
-      matrix:
-        include:
-          - cpu: haswell
-            arch: x86_64
-            tag: bun-darwin-x64
-            obj: bun-obj-darwin-x64
-            runner: macos-12-large
-            artifact: bun-obj-darwin-x64
-    steps:
-      - uses: actions/checkout@v4
-      - name: Checkout submodules
-        run: git submodule update --init --recursive --depth=1 --progress --force
-
-      - name: Install system dependencies
-        env:
-          HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK: 1
-          HOMEBREW_NO_AUTO_UPDATE: 1
-          HOMEBREW_NO_INSTALL_CLEANUP: 1
-        run: |
-          brew install sccache ccache rust llvm@$LLVM_VERSION pkg-config coreutils libtool cmake libiconv automake openssl@1.1 ninja gnu-sed pkg-config --force
-          echo "$(brew --prefix ccache)/bin" >> $GITHUB_PATH
-          # echo "$(brew --prefix sccache)/bin" >> $GITHUB_PATH
-          echo "$(brew --prefix coreutils)/libexec/gnubin" >> $GITHUB_PATH
-          echo "$(brew --prefix llvm@$LLVM_VERSION)/bin" >> $GITHUB_PATH
-          brew link --overwrite llvm@$LLVM_VERSION
-
-      - name: Hash submodule versions
-        run: |
-          print_data() {
-            git submodule | grep -v WebKit
-            llvm-config --version
-            rustc --version
-            cat $(echo scripts/build*.sh scripts/all-dependencies.sh | tr " " "\n" | sort)
-          }
-          echo "sha=$(print_data | sha1sum | cut -c 1-10)" >> $GITHUB_OUTPUT
-        id: submodule-versions
-
-      - name: Cache submodule dependencies
-        id: cache-deps-restore
-        uses: actions/cache/restore@v3
-        with:
-          path: ${{runner.temp}}/bun-deps
-          key: bun-deps-${{ matrix.tag }}-${{ steps.submodule-versions.outputs.sha }}
-
-      - name: Compile submodule dependencies
-        if: ${{ !steps.cache-deps-restore.outputs.cache-hit }}
-        env:
-          CPU_TARGET: ${{ matrix.cpu }}
-          BUN_DEPS_OUT_DIR: ${{runner.temp}}/bun-deps
-        run: |
-          mkdir -p $BUN_DEPS_OUT_DIR
-          bash ./scripts/clean-dependencies.sh
-          bash ./scripts/all-dependencies.sh
-
-      - name: Cache submodule dependencies
-        if: ${{ !steps.cache-deps-restore.outputs.cache-hit }}
-        id: cache-deps-save
-        uses: actions/cache/save@v3
-        with:
-          path: ${{runner.temp}}/bun-deps
-          key: ${{ steps.cache-deps-restore.outputs.cache-primary-key }}
-
-      - name: Upload submodule dependencies
-        uses: actions/upload-artifact@v3
-        with:
-          name: ${{ matrix.tag }}-deps
-          path: ${{runner.temp}}/bun-deps
-
-  macOS-cpp:
-    name: macOS C++
-    runs-on: ${{ matrix.runner }}
-    if: github.repository_owner == 'oven-sh'
-    timeout-minutes: 90
-    strategy:
-      matrix:
-        include:
-          - cpu: haswell
-            arch: x86_64
-            tag: bun-darwin-x64
-            obj: bun-obj-darwin-x64
-            runner: macos-12-large
-            artifact: bun-obj-darwin-x64
-    steps:
-      - uses: actions/checkout@v4
-      - name: Checkout submodules
-        run: git submodule update --init --recursive --depth=1 --progress --force
-
-      - name: Install system dependencies
-        env:
-          HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK: 1
-          HOMEBREW_NO_AUTO_UPDATE: 1
-          HOMEBREW_NO_INSTALL_CLEANUP: 1
-        run: |
-          brew install sccache ccache rust llvm@$LLVM_VERSION pkg-config coreutils libtool cmake libiconv automake openssl@1.1 ninja gnu-sed pkg-config --force
-          # echo "$(brew --prefix sccache)/bin" >> $GITHUB_PATH
-          echo "$(brew --prefix ccache)/bin" >> $GITHUB_PATH
-          echo "$(brew --prefix coreutils)/libexec/gnubin" >> $GITHUB_PATH
-          echo "$(brew --prefix llvm@$LLVM_VERSION)/bin" >> $GITHUB_PATH
-          brew link --overwrite llvm@$LLVM_VERSION
-
-          curl -LO "$BUN_DOWNLOAD_URL_BASE/bun-darwin-x64.zip"
-          unzip bun-darwin-x64.zip
-          mkdir -p ${{ runner.temp }}/.bun/bin
-          mv bun-darwin-x64/bun ${{ runner.temp }}/.bun/bin/bun
-          chmod +x ${{ runner.temp }}/.bun/bin/bun
-          echo "${{ runner.temp }}/.bun/bin" >> $GITHUB_PATH
-
-      # TODO: replace with sccache
-      - name: ccache
-        uses: hendrikmuhs/ccache-action@v1.2
-        with:
-          key: ${{ runner.os }}-ccache-${{ matrix.tag }}
-          restore-keys: ${{ runner.os }}-ccache-${{ matrix.tag }}
-
-      - name: Compile C++
-        env:
-          CPU_TARGET: ${{ matrix.cpu }}
-          SOURCE_DIR: ${{ github.workspace }}
-          OBJ_DIR: ${{ runner.temp }}/bun-cpp-obj
-          BUN_DEPS_OUT_DIR: ${{runner.temp}}/bun-deps
-        run: |
-          mkdir -p $OBJ_DIR
-          cd $OBJ_DIR
-
-          cmake -S $SOURCE_DIR -B $OBJ_DIR \
-            -G Ninja \
-            -DCMAKE_BUILD_TYPE=Release \
-            -DBUN_CPP_ONLY=1 \
-            -DNO_CONFIGURE_DEPENDS=1
-
-          bash compile-cpp-only.sh -v
-
-      - name: Upload C++
-        uses: actions/upload-artifact@v3
-        with:
-          name: ${{ matrix.tag }}-cpp
-          path: ${{ runner.temp }}/bun-cpp-obj/bun-cpp-objects.a
-  macOS:
-    name: macOS Link
-    runs-on: ${{ matrix.runner }}
-    if: github.repository_owner == 'oven-sh'
-    needs: [macOS-cpp, macOS-zig, macOS-dependencies]
-    timeout-minutes: 90
-    permissions: write-all
-    strategy:
-      matrix:
-        include:
-          - cpu: haswell
-            arch: x86_64
-            tag: bun-darwin-x64
-            obj: bun-obj-darwin-x64
-            package: bun-darwin-x64
-            runner: macos-12-large
-            artifact: bun-obj-darwin-x64
-    steps:
-      - uses: actions/checkout@v3
-      - name: Checkout submodules
-        run: git submodule update --init --recursive --depth=1 --progress --force
-
-      - name: Install system dependencies
-        env:
-          HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK: 1
-          HOMEBREW_NO_AUTO_UPDATE: 1
-          HOMEBREW_NO_INSTALL_CLEANUP: 1
-        run: |
-          brew install ccache llvm@$LLVM_VERSION pkg-config coreutils libtool cmake libiconv openssl@1.1 ninja --force
-          echo "$(brew --prefix ccache)/bin" >> $GITHUB_PATH
-          echo "$(brew --prefix coreutils)/libexec/gnubin" >> $GITHUB_PATH
-          echo "$(brew --prefix llvm@$LLVM_VERSION)/bin" >> $GITHUB_PATH
-          brew link --overwrite llvm@$LLVM_VERSION
-
-          curl -LO "$BUN_DOWNLOAD_URL_BASE/bun-darwin-x64-baseline.zip"
-          unzip bun-darwin-x64-baseline.zip
-          mkdir -p ${{ runner.temp }}/.bun/bin
-          mv bun-darwin-x64-baseline/bun ${{ runner.temp }}/.bun/bin/bun
-          chmod +x ${{ runner.temp }}/.bun/bin/bun
-          echo "${{ runner.temp }}/.bun/bin" >> $GITHUB_PATH
-
-      - name: Download C++
-        uses: actions/download-artifact@v3
-        with:
-          name: ${{ matrix.tag }}-cpp
-          path: ${{ runner.temp }}/bun-cpp-obj
-
-      - name: Download Zig Object
-        uses: actions/download-artifact@v3
-        with:
-          name: ${{ matrix.obj }}
-          path: ${{ runner.temp }}/release
-
-      - name: Downloaded submodule dependencies
-        uses: actions/download-artifact@v3
-        with:
-          name: ${{ matrix.tag }}-deps
-          path: ${{runner.temp}}/bun-deps
-
-      - name: Link
-        env:
-          CPU_TARGET: ${{ matrix.cpu }}
-        run: |
-          SRC_DIR=$PWD
-          mkdir ${{runner.temp}}/link-build
-          cd ${{runner.temp}}/link-build
-          cmake $SRC_DIR \
-            -G Ninja \
-            -DCMAKE_BUILD_TYPE=Release \
-            -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" \
-            -DBUN_DEPS_OUT_DIR="${{runner.temp}}/bun-deps" \
-            -DNO_CONFIGURE_DEPENDS=1
-          ninja -v
-      - name: Zip
-        run: |
-          cd ${{runner.temp}}/link-build
-          chmod +x bun-profile bun
-
-          mkdir -p ${{matrix.tag}}-profile/ ${{matrix.tag}}/
-
-          mv bun-profile ${{matrix.tag}}-profile/bun-profile
-          mv bun ${{matrix.tag}}/bun
-
-          zip -r ${{matrix.tag}}-profile.zip ${{matrix.tag}}-profile
-          zip -r ${{matrix.tag}}.zip ${{matrix.tag}}
-      - uses: actions/upload-artifact@v3
-        with:
-          name: ${{matrix.tag}}-profile
-          path: ${{runner.temp}}/link-build/${{matrix.tag}}-profile.zip
-      - uses: actions/upload-artifact@v3
-        with:
-          name: ${{matrix.tag}}
-          path: ${{runner.temp}}/link-build/${{matrix.tag}}.zip
-      - name: Release
-        id: release
-        uses: ncipollo/release-action@v1
-        if: |
-          github.repository_owner == 'oven-sh'
-          && github.ref == 'refs/heads/main'
-        with:
-          prerelease: true
-          body: "This canary release of Bun corresponds to the commit [${{ github.sha }}]"
-          allowUpdates: true
-          replacesArtifacts: true
-          generateReleaseNotes: true
-          artifactErrorsFailBuild: true
-          token: ${{ secrets.GITHUB_TOKEN }}
-          name: "Canary (${{github.sha}})"
-          tag: "canary"
-          artifacts: "${{runner.temp}}/link-build/${{matrix.tag}}.zip,${{runner.temp}}/link-build/${{matrix.tag}}-profile.zip"
-      - uses: sarisia/actions-status-discord@v1
-        if: failure() && github.repository_owner == 'oven-sh' && github.event_name == 'pull_request'
-        with:
-          title: ""
-          webhook: ${{ secrets.DISCORD_WEBHOOK }}
-          status: ${{ job.status }}
-          noprefix: true
-          nocontext: true
-          description: |
-            Pull Request
-            ### [${{github.event.pull_request.title}}](https://github.com/oven-sh/bun/pull/${{github.event.number}})
-
-            @${{ github.actor }}
-
-            Build failed on ${{ matrix.tag }}:
-
-            **[View build output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})**
-
-            [Commit ${{github.sha}}](https://github.com/oven-sh/bun/commits/${{github.sha}})
-  macOS-test:
-    name: Tests ${{matrix.tag}}
-    runs-on: ${{ matrix.runner }}
-    needs: [macOS]
-    if: github.event_name == 'pull_request' && github.repository_owner == 'oven-sh'
-    permissions:
-      pull-requests: write
-    timeout-minutes: 30
-    outputs:
-      failing_tests: ${{ steps.test.outputs.failing_tests }}
-      failing_tests_count: ${{ steps.test.outputs.failing_tests_count }}
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - tag: bun-darwin-x64
-            runner: macos-12-large
-    steps:
-      - id: checkout
-        name: Checkout
-        uses: actions/checkout@v3
-        with:
-          submodules: false
-      - id: download
-        name: Download
-        uses: actions/download-artifact@v3
-        with:
-          name: ${{matrix.tag}}
-          path: ${{runner.temp}}/release
-      - id: install-bun
-        name: Install Bun
-        run: |
-          cd ${{runner.temp}}/release
-          unzip ${{matrix.tag}}.zip
-          cd ${{matrix.tag}}
-          chmod +x bun
-          pwd >> $GITHUB_PATH
-      - id: bun-version-check
-        name: Bun version check
-        run: |
-          # If this hangs, it means something is seriously wrong with the build
-          bun --version
-      - id: install
-        name: Install dependencies
-        run: |
-          bun install --verbose
-          bun install --cwd=test --verbose
-          bun install --cwd=packages/bun-internal-test --verbose
-      - id: test
-        name: Test (node runner)
-        env:
-          SMTP_SENDGRID_SENDER: ${{ secrets.SMTP_SENDGRID_SENDER }}
-          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: |
-          node packages/bun-internal-test/src/runner.node.mjs || true
-      - uses: sarisia/actions-status-discord@v1
-        if: always() && steps.test.outputs.failing_tests != '' && github.event_name == 'pull_request'
-        with:
-          title: ""
-          webhook: ${{ secrets.DISCORD_WEBHOOK }}
-          status: "failure"
-          noprefix: true
-          nocontext: true
-          description: |
-            Pull Request
-            ### ❌ [${{github.event.pull_request.title}}](https://github.com/oven-sh/bun/pull/${{github.event.number}})
-
-            @${{ github.actor }}, there are ${{ steps.test.outputs.failing_tests_count }} files with test failures on ${{ matrix.tag }}:
-
-            ${{ steps.test.outputs.failing_tests }}
-
-            **[View test output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})**
-      - name: Comment on PR
-        if: steps.test.outputs.failing_tests != '' && github.event_name == 'pull_request'
-        uses: thollander/actions-comment-pull-request@v2
-        with:
-          comment_tag: test-failures-${{matrix.tag}}
-          message: |
-            ❌ @${{ github.actor }} ${{ steps.test.outputs.failing_tests_count }} files with test failures on ${{ matrix.tag }}:
-
-            ${{ steps.test.outputs.failing_tests }}
-
-            **[View test output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})**
-
-            <sup>[#${{github.sha}}](https://github.com/oven-sh/bun/commits/${{github.sha}})</sup>
-      - name: Uncomment on PR
-        if: steps.test.outputs.failing_tests == '' && github.event_name == 'pull_request'
-        uses: thollander/actions-comment-pull-request@v2
-        with:
-          comment_tag: test-failures-${{matrix.tag}}
-          mode: upsert
-          create_if_not_exists: false
-          message: |
-            ✅ test failures on ${{ matrix.tag }} have been resolved.
-
-            <sup>[#${{github.sha}}](https://github.com/oven-sh/bun/commits/${{github.sha}})</sup>
-      - id: fail
-        name: Fail the build
-        if: steps.test.outputs.failing_tests != ''
-        run: exit 1

.github/workflows/bun-release.yml

@@ -1,269 +0,0 @@
-name: bun-release
-concurrency: release
-env:
-  BUN_VERSION: ${{ github.event.inputs.tag || github.event.release.tag_name || 'canary' }}
-  BUN_LATEST: ${{ (github.event.inputs.is-latest || github.event.release.tag_name) && 'true' || 'false' }}
-on:
-  release:
-    types:
-      - published
-  schedule:
-    - cron: "0 14 * * *" # every day at 6am PST
-  workflow_dispatch:
-    inputs:
-      is-latest:
-        description: Is this the latest release?
-        type: boolean
-        default: false
-      tag:
-        type: string
-        description: What is the release tag? (e.g. "1.0.2", "canary")
-        required: true
-      use-docker:
-        description: Should Docker images be released?
-        type: boolean
-        default: false
-      use-npm:
-        description: Should npm packages be published?
-        type: boolean
-        default: false
-      use-homebrew:
-        description: Should binaries be released to Homebrew?
-        type: boolean
-        default: false
-      use-s3:
-        description: Should binaries be uploaded to S3?
-        type: boolean
-        default: false
-      use-types:
-        description: Should types be released to npm?
-        type: boolean
-        default: false
-jobs:
-  sign:
-    name: Sign Release
-    runs-on: ubuntu-latest
-    if: ${{ github.repository_owner == 'oven-sh' }}
-    permissions:
-      contents: write
-    defaults:
-      run:
-        working-directory: packages/bun-release
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v3
-      - name: Setup GPG
-        uses: crazy-max/ghaction-import-gpg@v5
-        with:
-          gpg_private_key: ${{ secrets.GPG_PRIVATE_KEY }}
-          passphrase: ${{ secrets.GPG_PASSPHRASE }}
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v1
-        with:
-          bun-version: "1.0.21"
-      - name: Install Dependencies
-        run: bun install
-      - name: Sign Release
-        run: |
-          echo "$GPG_PASSPHRASE" | bun upload-assets -- "${{ env.BUN_VERSION }}"
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GPG_PASSPHRASE: ${{ secrets.GPG_PASSPHRASE }}
-  npm:
-    name: Release to NPM
-    runs-on: ubuntu-latest
-    needs: sign
-    if: ${{ github.event_name != 'workflow_dispatch' || github.event.inputs.use-npm == 'true' }}
-    permissions:
-      contents: read
-    defaults:
-      run:
-        working-directory: packages/bun-release
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v3
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v1
-        with:
-          bun-version: "1.0.21"
-      - name: Install Dependencies
-        run: bun install
-      - name: Release
-        run: bun upload-npm -- "${{ env.BUN_VERSION }}" publish
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
-  npm-types:
-    name: Release types to NPM
-    runs-on: ubuntu-latest
-    needs: sign
-    if: ${{ github.event_name != 'workflow_dispatch' || github.event.inputs.use-types == 'true' }}
-    permissions:
-      contents: read
-    defaults:
-      run:
-        working-directory: packages/bun-types
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v3
-      - name: Setup Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: latest
-      - name: Setup Bun
-        if: ${{ env.BUN_VERSION != 'canary' }}
-        uses: oven-sh/setup-bun@v1
-        with:
-          bun-version: "1.0.21"
-      - name: Setup Bun
-        if: ${{ env.BUN_VERSION == 'canary' }}
-        uses: oven-sh/setup-bun@v1
-        with:
-          bun-version: "canary" # Must be 'canary' so tag is correct
-      - name: Install Dependencies
-        run: bun install
-      - name: Setup Tag
-        if: ${{ env.BUN_VERSION == 'canary' }}
-        run: |
-          VERSION=$(bun --version)
-          TAG="${VERSION}-canary.$(date +'%Y%m%dT%H%M%S')"
-          echo "Setup tag: ${TAG}"
-          echo "TAG=${TAG}" >> ${GITHUB_ENV}
-      - name: Build
-        run: bun run build
-        env:
-          BUN_VERSION: ${{ env.TAG || env.BUN_VERSION }}
-      - name: Release (canary)
-        if: ${{ env.BUN_VERSION == 'canary' }}
-        uses: JS-DevTools/npm-publish@v1
-        with:
-          package: packages/bun-types/package.json
-          token: ${{ secrets.NPM_TOKEN }}
-          tag: canary
-      - name: Release (latest)
-        if: ${{ env.BUN_LATEST == 'true' }}
-        uses: JS-DevTools/npm-publish@v1
-        with:
-          package: packages/bun-types/package.json
-          token: ${{ secrets.NPM_TOKEN }}
-  docker:
-    name: Release to Dockerhub
-    runs-on: ubuntu-latest
-    needs: sign
-    if: ${{ github.event_name != 'workflow_dispatch' || github.event.inputs.use-docker == 'true' }}
-    permissions:
-      contents: read
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - variant: debian
-            suffix: ""
-          - variant: debian
-            suffix: -debian
-          - variant: slim
-            suffix: -slim
-            dir: debian-slim
-          - variant: alpine
-            suffix: -alpine
-          - variant: distroless
-            suffix: -distroless
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v3
-      - name: Setup Docker emulator
-        uses: docker/setup-qemu-action@v2
-      - id: buildx
-        name: Setup Docker buildx
-        uses: docker/setup-buildx-action@v2
-        with:
-          platforms: linux/amd64,linux/arm64
-      - id: metadata
-        name: Setup Docker metadata
-        uses: docker/metadata-action@v4
-        with:
-          images: oven/bun
-          flavor: |
-            latest=false
-          tags: |
-            type=raw,value=latest,enable=${{ env.BUN_LATEST == 'true' && matrix.suffix == '' }}
-            type=raw,value=${{ matrix.variant }},enable=${{ env.BUN_LATEST == 'true' }}
-            type=match,pattern=(bun-v)?(canary|\d+.\d+.\d+),group=2,value=${{ env.BUN_VERSION }},suffix=${{ matrix.suffix }}
-            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
-        with:
-          username: ${{ secrets.DOCKER_USERNAME }}
-          password: ${{ secrets.DOCKER_PASSWORD }}
-      - name: Push to Docker
-        uses: docker/build-push-action@v3
-        with:
-          context: ./dockerhub/${{ matrix.dir || matrix.variant }}
-          platforms: linux/amd64,linux/arm64
-          builder: ${{ steps.buildx.outputs.name }}
-          push: true
-          tags: ${{ steps.metadata.outputs.tags }}
-          labels: ${{ steps.metadata.outputs.labels }}
-          build-args: |
-            BUN_VERSION=${{ env.BUN_VERSION }}
-  homebrew:
-    name: Release to Homebrew
-    runs-on: ubuntu-latest
-    needs: sign
-    permissions:
-      contents: read
-    if: ${{ github.event_name == 'release' || github.event.inputs.use-homebrew == 'true' }}
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v3
-        with:
-          repository: oven-sh/homebrew-bun
-          token: ${{ secrets.ROBOBUN_TOKEN }}
-      - id: gpg
-        name: Setup GPG
-        uses: crazy-max/ghaction-import-gpg@v5
-        with:
-          gpg_private_key: ${{ secrets.GPG_PRIVATE_KEY }}
-          passphrase: ${{ secrets.GPG_PASSPHRASE }}
-      - name: Setup Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: "2.6"
-      - name: Update Tap
-        run: ruby scripts/release.rb "${{ env.BUN_VERSION }}"
-      - name: Commit Tap
-        uses: stefanzweifel/git-auto-commit-action@v4
-        with:
-          commit_options: --gpg-sign=${{ steps.gpg.outputs.keyid }}
-          commit_message: Release ${{ env.BUN_VERSION }}
-          commit_user_name: robobun
-          commit_user_email: robobun@oven.sh
-          commit_author: robobun <robobun@oven.sh>
-  s3:
-    name: Upload to S3
-    runs-on: ubuntu-latest
-    needs: sign
-    if: ${{ github.event_name != 'workflow_dispatch' || github.event.inputs.use-s3 == 'true' }}
-    permissions:
-      contents: read
-    defaults:
-      run:
-        working-directory: packages/bun-release
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v3
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v1
-        with:
-          bun-version: "1.0.21"
-      - name: Install Dependencies
-        run: bun install
-      - name: Release
-        run: bun upload-s3 -- "${{ env.BUN_VERSION }}"
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
-          AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY}}
-          AWS_ENDPOINT: ${{ secrets.AWS_ENDPOINT }}
-          AWS_BUCKET: bun

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

@@ -1,41 +0,0 @@
-name: bun-types
-on:
-  push:
-    paths:
-      - "packages/bun-types/**"
-    branches: [main]
-  pull_request:
-    paths:
-      - "packages/bun-types/**"
-
-jobs:
-  tests:
-    name: type-tests
-    runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: packages/bun-types
-
-    steps:
-      - name: Checkout repo
-        uses: actions/checkout@v3
-
-      - name: Install bun
-        uses: oven-sh/setup-bun@v1
-        with:
-          bun-version: canary
-
-      - name: Install node
-        uses: actions/setup-node@v3
-        with:
-          node-version: latest
-
-      - name: Install dependencies
-        run: |
-          bun install
-
-      - name: Generate package
-        run: bun run build
-
-      - name: Tests
-        run: bun run test

.github/workflows/bun-windows.yml

@@ -1,492 +0,0 @@
-name: bun-windows
-
-concurrency:
-  group: bun-windows-${{ github.ref }}
-  cancel-in-progress: true
-
-env:
-  # note: in other files, this version is only the major version, but for windows it is the full version
-  LLVM_VERSION: 16.0.6
-  BUN_DOWNLOAD_URL_BASE: https://pub-5e11e972747a44bf9aaf9394f185a982.r2.dev/releases/latest
-
-  tag: bun-windows
-  # TODO: wire this up to workflow_dispatch.
-  # github's expression syntax makes this hard to set a default to true
-  canary: true
-
-on:
-  push:
-    branches: [main]
-    paths:
-      - "src/**/*"
-      - "test/**/*"
-      - "packages/bun-usockets/src/**/*"
-      - "packages/bun-uws/src/**/*"
-      - "CMakeLists.txt"
-      - "build.zig"
-      - "Makefile"
-      - "Dockerfile"
-  pull_request:
-    branches: [main]
-    paths:
-      - "src/**/*"
-      - "test/**/*"
-      - "packages/bun-usockets/src/**/*"
-      - "packages/bun-uws/src/**/*"
-      - "CMakeLists.txt"
-      - "build.zig"
-      - "Makefile"
-      - "Dockerfile"
-  # Allows you to run this workflow manually from the Actions tab
-  workflow_dispatch:
-    # inputs:
-    #   is-canary:
-    #     type: boolean
-    #     description: Is Canary Build?
-    #     default: true
-
-jobs:
-  windows-zig:
-    strategy:
-      fail-fast: false
-      matrix:
-        cpu: [haswell, nehalem]
-        arch: [x86_64]
-    name: Zig Build
-    runs-on: med-ubuntu
-    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
-        with:
-          registry: ghcr.io
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Calculate Canary Revision
-        if: ${{ env.canary == 'true' }}
-        id: canary
-        run: |
-          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'
-        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
-          build-args: |
-            BUILDARCH=${{ runner.arch == 'X64' && 'amd64' || 'arm64' }}
-            BUILD_MACHINE_ARCH=${{ runner.arch == 'X64' && 'x86_64' || 'aarch64' }}
-            ARCH=${{ matrix.arch }}
-            CPU_TARGET=${{ matrix.cpu }}
-            TRIPLET=${{ matrix.arch }}-windows-msvc
-            GIT_SHA=${{ github.sha }}
-            CANARY=${{ env.canary == 'true' && steps.canary.outputs.canary_revision || '0' }}
-            ZIG_OPTIMIZE=ReleaseSafe
-          # TODO(@paperdave): enable ASSERTIONS=1
-          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
-        with:
-          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-zig${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
-          path: ${{runner.temp}}/release/bun-zig.o
-
-  windows-dependencies:
-    name: Dependencies
-    runs-on: windows
-    timeout-minutes: 60
-    strategy:
-      fail-fast: false
-      matrix:
-        cpu: [haswell, nehalem]
-        arch: [x86_64]
-    steps:
-      - run: git config --global core.autocrlf false && git config --global core.eol lf
-      - name: Checkout
-        uses: actions/checkout@v4
-      - name: Clone Submodules
-        run: .\scripts\update-submodules.ps1
-      - name: Hash submodule versions
-        shell: pwsh
-        run: |
-          $data = "$(& {
-            git submodule | Where-Object { $_ -notmatch 'WebKit' }
-            clang --version
-            rustc --version
-            Get-Content -Path (Get-ChildItem -Path 'scripts/build*.ps1', 'scripts/all-dependencies.ps1', 'scripts/env.ps1' | Sort-Object -Property Name).FullName | Out-String
-            echo 1
-          })"
-          $hash = ( -join ((New-Object -TypeName System.Security.Cryptography.SHA1CryptoServiceProvider).ComputeHash([System.Text.Encoding]::UTF8.GetBytes($data)) | ForEach-Object { $_.ToString("x2") } )).Substring(0, 10)
-          echo "sha=${hash}" >> $env:GITHUB_OUTPUT
-        id: submodule-versions
-
-      - name: Try fetch dependencies
-        id: cache-deps-restore
-        uses: actions/cache/restore@v3
-        with:
-          path: bun-deps
-          key: bun-deps-${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-${{ steps.submodule-versions.outputs.sha }}
-
-      - name: Install LLVM ${{ env.LLVM_VERSION }}
-        if: ${{ !steps.cache-deps-restore.outputs.cache-hit }}
-        uses: KyleMayes/install-llvm-action@1a3da29f56261a1e1f937ec88f0856a9b8321d7e
-        with:
-          version: ${{ env.LLVM_VERSION }}
-
-      - name: Install Ninja
-        if: ${{ !steps.cache-deps-restore.outputs.cache-hit }}
-        run: choco install -y ninja
-
-      - name: Build Dependencies
-        if: ${{ !steps.cache-deps-restore.outputs.cache-hit }}
-        run: |
-          .\scripts\env.ps1 ${{ matrix.cpu == 'nehalem' && '-Baseline' || '' }}
-          Invoke-WebRequest -Uri "https://www.nasm.us/pub/nasm/releasebuilds/2.16.01/win64/nasm-2.16.01-win64.zip" -OutFile nasm.zip
-          Expand-Archive nasm.zip (mkdir -Force "nasm")
-          $Nasm = (Get-ChildItem "nasm")
-          $env:Path += ";${Nasm}"
-          $env:BUN_DEPS_OUT_DIR = (mkdir -Force "./bun-deps")
-          .\scripts\all-dependencies.ps1
-
-      - name: Upload Dependencies
-        uses: actions/upload-artifact@v3
-        with:
-          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-deps${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
-          path: bun-deps/
-
-      - name: Cache Dependencies
-        if: ${{ !steps.cache-deps-restore.outputs.cache-hit }}
-        id: cache-deps-save
-        uses: actions/cache/save@v3
-        with:
-          path: bun-deps
-          key: ${{ steps.cache-deps-restore.outputs.cache-primary-key }}
-
-  windows-codegen:
-    name: Codegen
-    runs-on: ubuntu-latest
-    timeout-minutes: 10
-    if: github.repository_owner == 'oven-sh'
-    strategy:
-      fail-fast: false
-      matrix:
-        arch: [x86_64]
-    steps:
-      - uses: actions/checkout@v4
-      - run: |
-          curl -fsSL $BUN_DOWNLOAD_URL_BASE/bun-linux-x64.zip > bun.zip
-          unzip bun.zip
-          export PATH="$PWD/bun-linux-x64:$PATH"
-          ./scripts/cross-compile-codegen.sh win32 x64
-      # Sort of a hack to do this step in the codegen stage
-      - name: Calculate Canary Revision
-        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
-        with:
-          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-codegen
-          path: build-codegen-win32-x64/
-
-  windows-cpp:
-    name: C++ Build
-    needs: [windows-codegen]
-    runs-on: windows
-    if: github.repository_owner == 'oven-sh'
-    timeout-minutes: 90
-    strategy:
-      fail-fast: false
-      matrix:
-        cpu: [haswell, nehalem]
-        arch: [x86_64]
-    steps:
-      - run: git config --global core.autocrlf false && git config --global core.eol lf
-      - uses: actions/checkout@v4
-      - uses: KyleMayes/install-llvm-action@1a3da29f56261a1e1f937ec88f0856a9b8321d7e
-        with:
-          version: ${{ env.LLVM_VERSION }}
-      - run: choco install -y ninja
-      - name: Download Codegen
-        uses: actions/download-artifact@v3
-        with:
-          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-codegen
-          path: build
-      - name: Build C++
-        run: |
-          # Using SCCache was blocked by an issue that is fixed in a newer version.
-          # TODO UPDATE
-          # $sczip = "sccache-v0.6.0-x86_64-pc-windows-msvc"
-                    
-          # Invoke-WebRequest -Uri "https://github.com/mozilla/sccache/releases/download/v0.6.0/${sczip}.zip" -OutFile "${sczip}.zip"
-          # Expand-Archive "${sczip}.zip"
-          # $env:SCCACHE_BUCKET="bun"
-          # $env:SCCACHE_REGION="auto"
-          # $env:SCCACHE_S3_USE_SSL="true"
-          # $env:SCCACHE_ENDPOINT="${{ secrets.CACHE_S3_ENDPOINT }}"
-          # $env:AWS_ACCESS_KEY_ID="${{ secrets.CACHE_S3_ACCESS_KEY_ID }}"
-          # $env:AWS_SECRET_ACCESS_KEY="${{ secrets.CACHE_S3_SECRET_ACCESS_KEY }}"
-          # $SCCACHE="$PWD/${sczip}/${sczip}/sccache.exe"
-
-          $CANARY_REVISION = if (Test-Path build/.canary_revision) { Get-Content build/.canary_revision } else { "0" }
-
-          .\scripts\env.ps1 ${{ matrix.cpu == 'nehalem' && '-Baseline' || '' }}
-          .\scripts\update-submodules.ps1
-          .\scripts\build-libuv.ps1 -CloneOnly $True
-          cd build
-          # "-DCCACHE_PROGRAM=${SCCACHE}"
-          cmake .. -G Ninja -DCMAKE_BUILD_TYPE=Release `
-            -DNO_CODEGEN=1 `
-            -DNO_CONFIGURE_DEPENDS=1 `
-            "-DCANARY=${CANARY_REVISION}" `
-            -DBUN_CPP_ONLY=1 ${{ matrix.cpu == 'nehalem' && '-DUSE_BASELINE_BUILD=1' || '' }}
-          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
-        with:
-          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-cpp${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
-          path: build/bun-cpp-objects.a
-
-  windows-link:
-    strategy:
-      fail-fast: false
-      matrix:
-        cpu: [haswell, nehalem]
-        arch: [x86_64]
-    name: Link
-    needs: [windows-dependencies, windows-codegen, windows-cpp, windows-zig]
-    runs-on: windows-small
-    if: github.repository_owner == 'oven-sh'
-    timeout-minutes: 30
-    permissions: write-all
-    steps:
-      - run: git config --global core.autocrlf false && git config --global core.eol lf
-      - uses: actions/checkout@v4
-      - uses: KyleMayes/install-llvm-action@1a3da29f56261a1e1f937ec88f0856a9b8321d7e
-        with:
-          version: ${{ env.LLVM_VERSION }}
-      - run: choco install -y ninja
-      - name: Download Codegen
-        uses: actions/download-artifact@v3
-        with:
-          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-codegen
-          path: build
-      - name: Download Dependencies
-        uses: actions/download-artifact@v3
-        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
-        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
-        with:
-          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}-cpp${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}
-          path: bun-cpp
-      - name: Link
-        run: |
-          .\scripts\update-submodules.ps1
-          .\scripts\env.ps1 ${{ matrix.cpu == 'nehalem' && '-Baseline' || '' }}
-          Set-Location build
-          $CANARY_REVISION = if (Test-Path build/.canary_revision) { Get-Content build/.canary_revision } else { "0" }
-          cmake .. -G Ninja -DCMAKE_BUILD_TYPE=Release `
-            -DNO_CODEGEN=1 `
-            -DNO_CONFIGURE_DEPENDS=1 `
-            "-DCANARY=${CANARY_REVISION}" `
-            -DBUN_LINK_ONLY=1 `
-            "-DBUN_DEPS_OUT_DIR=$(Resolve-Path ../bun-deps)" `
-            "-DBUN_CPP_ARCHIVE=$(Resolve-Path ../bun-cpp/bun-cpp-objects.a)" `
-            "-DBUN_ZIG_OBJ=$(Resolve-Path ../bun-zig/bun-zig.o)" `
-            ${{ matrix.cpu == 'nehalem' && '-DUSE_BASELINE_BUILD=1' || '' }}
-          if ($LASTEXITCODE -ne 0) { throw "CMake configuration failed" }
-          ninja -v
-          if ($LASTEXITCODE -ne 0) { throw "Link failed!" }
-      - name: Package
-        run: |
-          $Dist = mkdir -Force "${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}"
-          cp -r build\bun.exe "$Dist\bun.exe"
-          Compress-Archive "$Dist" "${Dist}.zip"
-          $Dist = "$Dist-profile"
-          MkDir -Force "$Dist"
-          cp -r build\bun.exe "$Dist\bun.exe"
-          cp -r build\bun.pdb "$Dist\bun.pdb"
-          Compress-Archive "$Dist" "$Dist.zip"
-
-      - uses: actions/upload-artifact@v3
-        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
-        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
-      - name: Release
-        id: release
-        uses: ncipollo/release-action@v1
-        if: |
-          github.repository_owner == 'oven-sh'
-          && github.ref == 'refs/heads/main'
-        with:
-          prerelease: true
-          body: "This canary release of Bun corresponds to the commit [${{ github.sha }}]"
-          allowUpdates: true
-          replacesArtifacts: true
-          generateReleaseNotes: true
-          artifactErrorsFailBuild: true
-          token: ${{ secrets.GITHUB_TOKEN }}
-          name: "Canary (${{github.sha}})"
-          tag: "canary"
-          artifacts: "${{env.tag}}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}.zip,${{env.tag}}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-profile.zip"
-      - uses: sarisia/actions-status-discord@v1
-        if: failure() && github.repository_owner == 'oven-sh' && github.event_name == 'pull_request'
-        with:
-          title: ""
-          webhook: ${{ secrets.DISCORD_WEBHOOK }}
-          status: ${{ job.status }}
-          noprefix: true
-          nocontext: true
-          description: |
-            ### [${{github.event.pull_request.title}}](https://github.com/oven-sh/bun/pull/${{github.event.number}})
-
-            @${{ github.actor }}
-
-            Build failed on Windows ${{ matrix.arch }}${{ matrix.cpu == 'nehalem' && ' Baseline' || '' }}
-
-            **[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-small
-    needs: [windows-link]
-    if: github.event_name == 'pull_request' && github.repository_owner == 'oven-sh'
-    permissions:
-      pull-requests: write
-    timeout-minutes: 180
-    outputs:
-      failing_tests: ${{ steps.test.outputs.failing_tests }}
-      failing_tests_count: ${{ steps.test.outputs.failing_tests_count }}
-    strategy:
-      fail-fast: false
-      matrix:
-        # TODO: test baseline, disabled due to noise
-        cpu: [haswell]
-        arch: [x86_64]
-    steps:
-      - run: git config --global core.autocrlf false && git config --global core.eol lf
-      - id: checkout
-        name: Checkout
-        uses: actions/checkout@v3
-        with:
-          submodules: false
-      - id: download
-        name: Download Release
-        uses: actions/download-artifact@v3
-        with:
-          name: ${{ env.tag }}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-profile
-          path: ${{runner.temp}}/release
-      - name: Install Bun
-        run: |
-          cd ${{runner.temp}}/release
-          unzip ${{env.tag}}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-profile.zip
-          cd ${{env.tag}}-${{ matrix.arch == 'x86_64' && 'x64' || 'aarch64' }}${{ matrix.cpu == 'nehalem' && '-baseline' || '' }}-profile
-          pwd >> $env:GITHUB_PATH
-      - name: Install Node
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-      - name: Install dependencies
-        run: |
-          # bun install --verbose
-          # bun install --cwd=test --verbose
-          # bun install --cwd=packages/bun-internal-test --verbose
-
-          npm install
-          cd test && npm install
-          cd ../packages/bun-internal-test && npm install
-          cd ../..
-      - id: test
-        name: Run tests
-        env:
-          SMTP_SENDGRID_SENDER: ${{ secrets.SMTP_SENDGRID_SENDER }}
-          TLS_MONGODB_DATABASE_URL: ${{ secrets.TLS_MONGODB_DATABASE_URL }}
-          TLS_POSTGRES_DATABASE_URL: ${{ secrets.TLS_POSTGRES_DATABASE_URL }}
-        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"
-      - uses: sarisia/actions-status-discord@v1
-        if: always() && steps.test.outputs.failing_tests != '' && github.event_name == 'pull_request'
-        with:
-          title: ""
-          webhook: ${{ secrets.DISCORD_WEBHOOK_WINTEST }}
-          status: "failure"
-          noprefix: true
-          nocontext: true
-          description: |
-            ### ❌🪟 [${{github.event.pull_request.title}}](https://github.com/oven-sh/bun/pull/${{github.event.number}})
-
-            @${{ github.actor }}, there are **${{ steps.test.outputs.failing_test_count }} failing tests** on Windows ${{ matrix.arch }}${{ matrix.cpu == 'nehalem' && ' Baseline' || '' }}
-
-            ${{ steps.test.outputs.failing_tests }}
-
-            [Full Test Output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})
-      - uses: sarisia/actions-status-discord@v1
-        if: always() && steps.test.outputs.regressing_tests != '' && github.event_name == 'pull_request'
-        with:
-          title: ""
-          webhook: ${{ secrets.DISCORD_WEBHOOK }}
-          status: "failure"
-          noprefix: true
-          nocontext: true
-          description: |
-            ### ❌🪟 [${{github.event.pull_request.title}}](https://github.com/oven-sh/bun/pull/${{github.event.number}})
-
-            @${{ github.actor }}, there are **${{ steps.test.outputs.regressing_test_count }} test regressions** on Windows ${{ matrix.arch }}${{ matrix.cpu == 'nehalem' && ' Baseline' || '' }}
-
-            ${{ steps.test.outputs.regressing_tests }}
-
-            [Full Test Output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})
-      - name: Comment on PR
-        if: always() && steps.test.outputs.regressing_tests != '' && github.event_name == 'pull_request'
-        uses: thollander/actions-comment-pull-request@v2
-        with:
-          comment_tag: test-windows-${{ matrix.arch }}-${{ matrix.cpu }}
-          message: |
-            ### ❌🪟 @${{ github.actor }}, there are **${{ steps.test.outputs.regressing_test_count }} test regressions** on Windows ${{ matrix.arch }}${{ matrix.cpu == 'nehalem' && ' Baseline' || '' }}
-
-            ${{ steps.test.outputs.regressing_tests }}
-
-            [Full Test Output](https://github.com/oven-sh/bun/actions/runs/${{github.run_id}})
-      - name: Uncomment on PR
-        if: steps.test.outputs.regressing_tests == '' && github.event_name == 'pull_request'
-        uses: thollander/actions-comment-pull-request@v2
-        with:
-          comment_tag: test-windows-${{ matrix.arch }}-${{ matrix.cpu }}
-          mode: upsert
-          create_if_not_exists: false
-          message: |
-            ✅🪟 Test regressions on Windows ${{ matrix.arch }}${{ matrix.cpu == 'nehalem' && ' Baseline' || '' }} have been resolved.
-      - id: fail
-        name: Fail the build
-        if: steps.test.outputs.regressing_tests != '' && github.event_name == 'pull_request'
-        run: exit 1

.github/workflows/claude-dedupe-issues.yml

@@ -0,0 +1,34 @@
+name: Claude Issue Dedupe
+on:
+  issues:
+    types: [opened]
+  workflow_dispatch:
+    inputs:
+      issue_number:
+        description: 'Issue number to process for duplicate detection'
+        required: true
+        type: string
+
+jobs:
+  claude-dedupe-issues:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    concurrency:
+      group: claude-dedupe-issues-${{ github.event.issue.number || inputs.issue_number }}
+      cancel-in-progress: true
+    permissions:
+      contents: read
+      issues: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Run Claude Code slash command
+        uses: anthropics/claude-code-base-action@beta
+        with:
+          prompt: "/dedupe ${{ github.repository }}/issues/${{ github.event.issue.number || inputs.issue_number }}"
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          claude_args: "--model claude-sonnet-4-5-20250929"
+          claude_env: |
+            GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/comment-lint.yml.disabled

@@ -0,0 +1,85 @@
+name: C++ Linter comment
+
+permissions:
+  actions: read
+  pull-requests: write
+
+on:
+  workflow_run:
+    workflows:
+      - lint-cpp
+    types:
+      - completed
+
+jobs:
+  comment-lint:
+    if: ${{ github.repository_owner == 'oven-sh' }}
+    name: Comment
+    runs-on: ubuntu-latest
+    steps:
+      - name: Download Comment
+        uses: actions/download-artifact@v4
+        with:
+          name: format.log
+          github-token: ${{ github.token }}
+          run-id: ${{ github.event.workflow_run.id }}
+      - name: PR Number
+        uses: actions/download-artifact@v4
+        with:
+          name: pr-number.txt
+          github-token: ${{ github.token }}
+          run-id: ${{ github.event.workflow_run.id }}
+      - name: Did Fail
+        uses: actions/download-artifact@v4
+        with:
+          name: did_fail.txt
+          github-token: ${{ github.token }}
+          run-id: ${{ github.event.workflow_run.id }}
+      - name: Setup Environment
+        id: env
+        shell: bash
+        run: |
+          # Copy to outputs
+          echo "pr-number=$(cat pr-number.txt)" >> $GITHUB_OUTPUT
+          {
+            echo 'text_output<<EOF'
+            cat format.log
+            echo EOF
+          } >> "$GITHUB_OUTPUT"
+          echo "did_fail=$(cat did_fail.txt)" >> $GITHUB_OUTPUT
+
+      - name: Find Comment
+        id: comment
+        uses: peter-evans/find-comment@v3
+        with:
+          issue-number: ${{ steps.env.outputs.pr-number }}
+          comment-author: github-actions[bot]
+          body-includes: <!-- generated-comment lint-cpp-workflow=${{ github.workflow }} -->
+      - name: Update Comment
+        uses: peter-evans/create-or-update-comment@v4
+        if: steps.env.outputs.did_fail != '0'
+        with:
+          comment-id: ${{ steps.comment.outputs.comment-id }}
+          issue-number: ${{ steps.env.outputs.pr-number }}
+          body: |
+            @${{ github.actor }}, `clang-tidy` had something to share with you about your code:
+
+            ```cpp
+            ${{ steps.env.outputs.text_output }}
+            ```
+
+            Commit: ${{ github.event.workflow_run.head_sha || github.sha }}
+
+            <!-- generated-comment lint-cpp-workflow=${{ github.workflow }} -->
+          edit-mode: replace
+      - name: Update Previous Comment
+        uses: peter-evans/create-or-update-comment@v4
+        if: steps.env.outputs.did_fail == '0' && steps.comment.outputs.comment-id != ''
+        with:
+          comment-id: ${{ steps.comment.outputs.comment-id }}
+          issue-number: ${{ steps.env.outputs.pr-number }}
+          body: |
+            clang-tidy nits are fixed! Thank you.
+
+            <!-- generated-comment lint-cpp-workflow=${{ github.workflow }} -->
+          edit-mode: replace

.github/workflows/format.yml

@@ -1,45 +1,109 @@
-name: autofix.ci # Must be named this for autofix.ci to work
-
-on:
-  workflow_dispatch:
-  pull_request:
-  push:
-    branches:
-      - main
-
-env:
-  ZIG_VERSION: 0.12.0-dev.1828+225fe6ddb
+name: autofix.ci
 
 permissions:
   contents: read
 
+on:
+  workflow_call:
+  workflow_dispatch:
+  pull_request:
+  merge_group:
+env:
+  BUN_VERSION: "1.3.2"
+  LLVM_VERSION: "19.1.7"
+  LLVM_VERSION_MAJOR: "19"
+
 jobs:
-  format:
-    name: format
+  autofix:
+    name: Format
     runs-on: ubuntu-latest
+    concurrency:
+      group: ${{ github.workflow }}-${{ github.ref }}
+      cancel-in-progress: true
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-        with:
-          sparse-checkout: |
-            src
-            packages
-            test
-            bench
+      - name: Configure Git
+        run: |
+          git config --global core.autocrlf true
+          git config --global core.ignorecase true
+          git config --global core.precomposeUnicode true
       - name: Setup Bun
-        uses: oven-sh/setup-bun@v1
+        uses: ./.github/actions/setup-bun
         with:
-          bun-version: "1.0.21"
-      - name: Setup Zig
-        uses: goto-bus-stop/setup-zig@c7b6cdd3adba8f8b96984640ff172c37c93f73ee
-        with:
-          version: ${{ env.ZIG_VERSION }}
-      - name: Install Dependencies
+          bun-version: ${{ env.BUN_VERSION }}
+      - name: Setup Dependencies
         run: |
           bun install
-      - name: Format
+          bun scripts/glob-sources.mjs
+      - name: Format Code
         run: |
-          bun fmt
-          bun fmt:zig
-      - name: Commit # https://autofix.ci/
-        uses: autofix-ci/action@d3e591514b99d0fca6779455ff8338516663f7cc
+          # Start prettier in background with prefixed output
+          echo "::group::Prettier"
+          (bun run prettier 2>&1 | sed 's/^/[prettier] /' || echo "[prettier] Failed with exit code $?") &
+          PRETTIER_PID=$!
+
+          # Start clang-format installation and formatting in background with prefixed output
+          echo "::group::Clang-format"
+          (
+            echo "[clang-format] Installing clang-format-${{ env.LLVM_VERSION_MAJOR }}..."
+            wget -qO- https://apt.llvm.org/llvm-snapshot.gpg.key | sudo tee /etc/apt/trusted.gpg.d/apt.llvm.org.asc > /dev/null
+            echo "deb http://apt.llvm.org/$(lsb_release -cs)/ llvm-toolchain-$(lsb_release -cs)-${{ env.LLVM_VERSION_MAJOR }} main" | sudo tee /etc/apt/sources.list.d/llvm.list > /dev/null
+            sudo apt-get update -qq
+            sudo apt-get install -y -qq --no-install-recommends --no-install-suggests -o=Dpkg::Use-Pty=0 clang-format-${{ env.LLVM_VERSION_MAJOR }}
+            echo "[clang-format] Running clang-format..."
+            LLVM_VERSION_MAJOR=${{ env.LLVM_VERSION_MAJOR }} ./scripts/run-clang-format.sh format 2>&1 | sed 's/^/[clang-format] /'
+          ) &
+          CLANG_PID=$!
+
+          # Setup Zig in temp directory and run zig fmt in background with prefixed output
+          echo "::group::Zig fmt"
+          (
+            ZIG_TEMP=$(mktemp -d)
+            echo "[zig] Downloading Zig (musl build)..."
+            wget -q -O "$ZIG_TEMP/zig.zip" https://github.com/oven-sh/zig/releases/download/autobuild-e0b7c318f318196c5f81fdf3423816a7b5bb3112/bootstrap-x86_64-linux-musl.zip
+            unzip -q -d "$ZIG_TEMP" "$ZIG_TEMP/zig.zip"
+            export PATH="$ZIG_TEMP/bootstrap-x86_64-linux-musl:$PATH"
+            echo "[zig] Running zig fmt..."
+            zig fmt src 2>&1 | sed 's/^/[zig] /'
+            ./scripts/sort-imports.ts src 2>&1 | sed 's/^/[zig] /'
+            zig fmt src 2>&1 | sed 's/^/[zig] /'
+            rm -rf "$ZIG_TEMP"
+          ) &
+          ZIG_PID=$!
+
+          # Wait for all formatting tasks to complete
+          echo ""
+          echo "Running formatters in parallel..."
+          FAILED=0
+
+          if ! wait $PRETTIER_PID; then
+            echo "::error::Prettier failed"
+            FAILED=1
+          fi
+          echo "::endgroup::"
+
+          if ! wait $CLANG_PID; then
+            echo "::error::Clang-format failed"
+            FAILED=1
+          fi
+          echo "::endgroup::"
+
+          if ! wait $ZIG_PID; then
+            echo "::error::Zig fmt failed"
+            FAILED=1
+          fi
+          echo "::endgroup::"
+
+          # Exit with error if any formatter failed
+          if [ $FAILED -eq 1 ]; then
+            echo "::error::One or more formatters failed"
+            exit 1
+          fi
+
+          echo "✅ All formatters completed successfully"
+      - name: Ban Words
+        run: |
+          bun ./test/internal/ban-words.test.ts
+          git rm -f cmake/sources/*.txt || true
+      - uses: autofix-ci/action@635ffb0c9798bd160680f18fd73371e355b85f27

.github/workflows/labeled.yml.disabled

@@ -0,0 +1,278 @@
+name: Issue Labeled
+env:
+  BUN_VERSION: 1.1.44
+
+on:
+  issues:
+    types: [labeled]
+  pull_request_target:
+    types: [labeled, opened, reopened, synchronize, unlabeled]
+
+jobs:
+  # on-bug:
+  #   runs-on: ubuntu-latest
+  #   if: github.event.label.name == 'bug' || github.event.label.name == 'crash'
+  #   permissions:
+  #     issues: write
+  #   steps:
+  #     - name: Checkout
+  #       uses: actions/checkout@v4
+  #       with:
+  #         sparse-checkout: |
+  #           scripts
+  #           .github
+  #           CMakeLists.txt
+  #     - name: Setup Bun
+  #       uses: ./.github/actions/setup-bun
+  #       with:
+  #         bun-version: ${{ env.BUN_VERSION }}
+  #     - name: "categorize bug"
+  #       id: add-labels
+  #       env:
+  #         GITHUB_ISSUE_BODY: ${{ github.event.issue.body }}
+  #         GITHUB_ISSUE_TITLE: ${{ github.event.issue.title }}
+  #         ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+  #       shell: bash
+  #       run: |
+  #         echo '{"dependencies": { "@anthropic-ai/sdk": "latest" }}' > scripts/package.json && bun install --cwd=./scripts
+  #         LABELS=$(bun scripts/label-issue.ts)
+  #         echo "labels=$LABELS" >> $GITHUB_OUTPUT
+  #     - name: Add labels
+  #       uses: actions-cool/issues-helper@v3
+  #       if: steps.add-labels.outputs.labels != ''
+  #       with:
+  #         actions: "add-labels"
+  #         token: ${{ secrets.GITHUB_TOKEN }}
+  #         issue-number: ${{ github.event.issue.number }}
+  #         labels: ${{ steps.add-labels.outputs.labels }}
+  on-slop:
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request_target' && contains(github.event.pull_request.labels.*.name, 'slop')
+    permissions:
+      issues: write
+      pull-requests: write
+      contents: write
+    steps:
+      - name: Update PR title and body for slop and close
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const pr = await github.rest.pulls.get({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              pull_number: context.issue.number
+            });
+
+            await github.rest.pulls.update({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              pull_number: context.issue.number,
+              title: 'ai slop',
+              body: 'This PR has been marked as AI slop and the description has been updated to avoid confusion or misleading reviewers.\n\nMany AI PRs are fine, but sometimes they submit a PR too early, fail to test if the problem is real, fail to reproduce the problem, or fail to test that the problem is fixed. If you think this PR is not AI slop, please leave a comment.',
+              state: 'closed'
+            });
+
+            // Delete the branch if it's from a fork or if it's not a protected branch
+            try {
+              await github.rest.git.deleteRef({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                ref: `heads/${pr.data.head.ref}`
+              });
+            } catch (error) {
+              console.log('Could not delete branch:', error.message);
+            }
+  on-labeled:
+    runs-on: ubuntu-latest
+    if: github.event_name == 'issues' && (github.event.label.name == 'crash' || github.event.label.name == 'needs repro')
+    permissions:
+      issues: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          sparse-checkout: |
+            scripts
+            .github
+            CMakeLists.txt
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: ${{ env.BUN_VERSION }}
+      - name: "add platform and command label"
+        id: add-labels
+        if: github.event.label.name == 'crash'
+        env:
+          GITHUB_ISSUE_BODY: ${{ github.event.issue.body }}
+          GITHUB_ISSUE_TITLE: ${{ github.event.issue.title }}
+          GITHUB_ISSUE_NUMBER: ${{ github.event.issue.number }}
+        shell: bash
+        run: |
+          LABELS=$(bun scripts/read-issue.ts)
+          bun scripts/is-outdated.ts
+
+          # Check for patterns that should close the issue
+          CLOSE_ACTION=$(bun scripts/handle-crash-patterns.ts)
+          echo "close-action=$CLOSE_ACTION" >> $GITHUB_OUTPUT
+
+          if [[ -f "is-outdated.txt" ]]; then
+            echo "is-outdated=true" >> $GITHUB_OUTPUT
+          fi
+
+          if [[ -f "outdated.txt" ]]; then
+            echo "outdated=$(cat outdated.txt)" >> $GITHUB_OUTPUT
+          fi
+
+          if [[ -f "is-standalone.txt" ]]; then
+            echo "is-standalone=true" >> $GITHUB_OUTPUT
+          fi
+
+          if [[ -f "is-very-outdated.txt" ]]; then
+            echo "is-very-outdated=true" >> $GITHUB_OUTPUT
+            LABELS="$LABELS,old-version"
+          else
+            echo "is-very-outdated=false" >> $GITHUB_OUTPUT
+          fi
+
+          echo "latest=$(cat LATEST)" >> $GITHUB_OUTPUT
+          echo "labels=$LABELS" >> $GITHUB_OUTPUT
+          rm -rf is-outdated.txt outdated.txt latest.txt is-very-outdated.txt is-standalone.txt
+      - name: Close issue if pattern detected
+        if: github.event.label.name == 'crash' && fromJson(steps.add-labels.outputs.close-action).close == true
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const closeAction = ${{ fromJson(steps.add-labels.outputs.close-action) }};
+
+            // Comment with the reason
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body: closeAction.comment
+            });
+
+            // Close the issue
+            await github.rest.issues.update({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              state: 'closed',
+              state_reason: closeAction.reason
+            });
+      - name: Generate comment text with Sentry Link
+        if: github.event.label.name == 'crash' && fromJson(steps.add-labels.outputs.close-action).close != true
+        # ignore if fail
+        continue-on-error: true
+        id: generate-comment-text
+        env:
+          GITHUB_ISSUE_BODY: ${{ github.event.issue.body }}
+          SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_EVENTS_SECRET }}
+        shell: bash
+        run: |
+          bun scripts/associate-issue-with-sentry.ts
+
+          if [[ -f "sentry-link.txt" ]]; then
+            echo "sentry-link=$(cat sentry-link.txt)" >> $GITHUB_OUTPUT
+          fi
+
+          if [[ -f "sentry-id.txt" ]]; then
+            echo "sentry-id=$(cat sentry-id.txt)" >> $GITHUB_OUTPUT
+          fi
+      - name: Remove old labels
+        uses: actions-cool/issues-helper@v3
+        if: github.event.label.name == 'crash' && steps.add-labels.outputs.is-very-outdated == 'false'
+        with:
+          actions: "remove-labels"
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.issue.number }}
+          labels: old-version
+      - name: Add labels
+        uses: actions-cool/issues-helper@v3
+        if: github.event.label.name == 'crash'
+        with:
+          actions: "add-labels"
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.issue.number }}
+          labels: ${{ steps.add-labels.outputs.labels }}
+      - name: Comment outdated (standalone executable)
+        if: steps.add-labels.outputs.is-outdated == 'true' && steps.add-labels.outputs.is-standalone == 'true' && github.event.label.name == 'crash' && steps.generate-comment-text.outputs.sentry-link == ''
+        uses: actions-cool/issues-helper@v3
+        with:
+          actions: "create-comment"
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.issue.number }}
+          body: |
+            @${{ github.event.issue.user.login }}, the latest version of Bun is v${{ steps.add-labels.outputs.latest }}, but the standalone executable is running Bun v${{ steps.add-labels.outputs.outdated }}. When the CLI using Bun's single-file executable next updates it might be fixed.
+      - name: Comment outdated
+        if: steps.add-labels.outputs.is-outdated == 'true' && steps.add-labels.outputs.is-standalone != 'true' && github.event.label.name == 'crash' && steps.generate-comment-text.outputs.sentry-link == ''
+        uses: actions-cool/issues-helper@v3
+        with:
+          actions: "create-comment"
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.issue.number }}
+          body: |
+            @${{ github.event.issue.user.login }}, the latest version of Bun is v${{ steps.add-labels.outputs.latest }}, but this crash was reported on Bun v${{ steps.add-labels.outputs.outdated }}.
+
+            Are you able to reproduce this crash on the latest version of Bun?
+
+            ```sh
+            bun upgrade
+            ```
+      - name: Comment with Sentry Link and outdated version (standalone executable)
+        if: steps.generate-comment-text.outputs.sentry-link != '' && github.event.label.name == 'crash' && steps.add-labels.outputs.is-outdated == 'true' && steps.add-labels.outputs.is-standalone == 'true'
+        uses: actions-cool/issues-helper@v3
+        with:
+          actions: "create-comment"
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.issue.number }}
+          body: |
+            @${{ github.event.issue.user.login }}, thank you for reporting this crash. The latest version of Bun is v${{ steps.add-labels.outputs.latest }}, but the standalone executable is running Bun v${{ steps.add-labels.outputs.outdated }}. When the CLI using Bun's single-file executable next updates it might be fixed.
+
+            For Bun's internal tracking, this issue is [${{ steps.generate-comment-text.outputs.sentry-id }}](${{ steps.generate-comment-text.outputs.sentry-link }}).
+
+            <!-- sentry-id: ${{ steps.generate-comment-text.outputs.sentry-id }} -->
+            <!-- sentry-link: ${{ steps.generate-comment-text.outputs.sentry-link }} -->
+      - name: Comment with Sentry Link and outdated version
+        if: steps.generate-comment-text.outputs.sentry-link != '' && github.event.label.name == 'crash' && steps.add-labels.outputs.is-outdated == 'true' && steps.add-labels.outputs.is-standalone != 'true'
+        uses: actions-cool/issues-helper@v3
+        with:
+          actions: "create-comment"
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.issue.number }}
+          body: |
+            @${{ github.event.issue.user.login }}, thank you for reporting this crash. The latest version of Bun is v${{ steps.add-labels.outputs.latest }}, but this crash was reported on Bun v${{ steps.add-labels.outputs.outdated }}.
+
+            Are you able to reproduce this crash on the latest version of Bun?
+
+            ```sh
+            bun upgrade
+            ```
+
+            For Bun's internal tracking, this issue is [${{ steps.generate-comment-text.outputs.sentry-id }}](${{ steps.generate-comment-text.outputs.sentry-link }}).
+
+            <!-- sentry-id: ${{ steps.generate-comment-text.outputs.sentry-id }} -->
+            <!-- sentry-link: ${{ steps.generate-comment-text.outputs.sentry-link }} -->
+      - name: Comment with Sentry Link
+        if: steps.generate-comment-text.outputs.sentry-link != '' && github.event.label.name == 'crash' && steps.add-labels.outputs.is-outdated != 'true'
+        uses: actions-cool/issues-helper@v3
+        with:
+          actions: "create-comment"
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.issue.number }}
+          body: |
+            Thank you for reporting this crash.
+
+            For Bun's internal tracking, this issue is [${{ steps.generate-comment-text.outputs.sentry-id }}](${{ steps.generate-comment-text.outputs.sentry-link }}).
+
+            <!-- sentry-id: ${{ steps.generate-comment-text.outputs.sentry-id }} -->
+            <!-- sentry-link: ${{ steps.generate-comment-text.outputs.sentry-link }} -->
+      - name: Comment needs repro
+        if: github.event.label.name == 'needs repro'
+        uses: actions-cool/issues-helper@v3
+        with:
+          actions: "create-comment"
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.issue.number }}
+          body: |
+            Hello @${{ github.event.issue.user.login }}. Please provide a [minimal reproduction](https://stackoverflow.com/help/minimal-reproducible-example) using a GitHub repository, [Replit](https://replit.com/@replit/Bun), [CodeSandbox](https://codesandbox.io/templates/bun), or provide a bulleted list of commands to run that reproduce this issue. Issues marked with `needs repro` will be closed if they have no activity within 3 days.

.github/workflows/lint.yml

@@ -0,0 +1,21 @@
+name: Lint
+
+on:
+  pull_request:
+  workflow_dispatch:
+
+env:
+  BUN_VERSION: "1.2.10"
+
+jobs:
+  lint-js:
+    name: "Lint JavaScript"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: ${{ env.BUN_VERSION }}
+      - name: Lint
+        run: bun lint

.github/workflows/packages-ci.yml

@@ -0,0 +1,55 @@
+name: Packages CI
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "packages/**"
+      - .prettierrc
+      - .prettierignore
+      - tsconfig.json
+      - oxlint.json
+      - "!**/*.md"
+  pull_request:
+    branches:
+      - main
+    paths:
+      - "packages/**"
+      - .prettierrc
+      - .prettierignore
+      - tsconfig.json
+      - oxlint.json
+      - "!**/*.md"
+
+env:
+  BUN_VERSION: "canary"
+
+jobs:
+  bun-plugin-svelte:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: ${{ env.BUN_VERSION }}
+
+      - name: Install dependencies
+        run: |
+          bun install
+          pushd ./packages/bun-plugin-svelte && bun install
+
+      - name: Lint
+        run: |
+          bunx oxlint@0.15 --format github --deny-warnings
+          bunx prettier --config ../../.prettierrc --check .
+        working-directory: ./packages/bun-plugin-svelte
+
+      - name: Check types
+        run: bun check:types
+        working-directory: ./packages/bun-plugin-svelte
+
+      - name: Test
+        run: bun test
+        working-directory: ./packages/bun-plugin-svelte

.github/workflows/release.yml

@@ -0,0 +1,368 @@
+# TODO: Move this to bash scripts intead of Github Actions
+# so it can be run from Buildkite, see: .buildkite/scripts/release.sh
+
+name: Release
+concurrency: release
+
+env:
+  BUN_VERSION: ${{ github.event.inputs.tag || github.event.release.tag_name || 'canary' }}
+  BUN_LATEST: ${{ (github.event.inputs.is-latest || github.event.release.tag_name) && 'true' || 'false' }}
+
+on:
+  release:
+    types:
+      - published
+  schedule:
+    - cron: "0 14 * * *" # every day at 6am PST
+  workflow_dispatch:
+    inputs:
+      is-latest:
+        description: Is this the latest release?
+        type: boolean
+        default: false
+      tag:
+        type: string
+        description: What is the release tag? (e.g. "1.0.2", "canary")
+        required: true
+      use-docker:
+        description: Should Docker images be released?
+        type: boolean
+        default: false
+      use-npm:
+        description: Should npm packages be published?
+        type: boolean
+        default: false
+      use-homebrew:
+        description: Should binaries be released to Homebrew?
+        type: boolean
+        default: false
+      use-s3:
+        description: Should binaries be uploaded to S3?
+        type: boolean
+        default: false
+      use-types:
+        description: Should types be released to npm?
+        type: boolean
+        default: false
+      use-definitelytyped:
+        description: "Should types be PR'd to DefinitelyTyped?"
+        type: boolean
+        default: false
+
+jobs:
+  sign:
+    name: Sign Release
+    runs-on: ubuntu-latest
+    if: ${{ github.repository_owner == 'oven-sh' }}
+    permissions:
+      contents: write
+    defaults:
+      run:
+        working-directory: packages/bun-release
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup GPG
+        uses: crazy-max/ghaction-import-gpg@v5
+        with:
+          gpg_private_key: ${{ secrets.GPG_PRIVATE_KEY }}
+          passphrase: ${{ secrets.GPG_PASSPHRASE }}
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: "1.2.3"
+      - name: Install Dependencies
+        run: bun install
+      - name: Sign Release
+        run: |
+          echo "$GPG_PASSPHRASE" | bun upload-assets -- "${{ env.BUN_VERSION }}"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GPG_PASSPHRASE: ${{ secrets.GPG_PASSPHRASE }}
+  npm:
+    name: Release to NPM
+    runs-on: ubuntu-latest
+    needs: sign
+    if: ${{ github.event_name != 'workflow_dispatch' || github.event.inputs.use-npm == 'true' }}
+    permissions:
+      contents: read
+    defaults:
+      run:
+        working-directory: packages/bun-release
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          # To workaround issue
+          ref: main
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: "1.2.3"
+      - name: Install Dependencies
+        run: bun install
+      - name: Release
+        run: bun upload-npm -- "${{ env.BUN_VERSION }}" publish
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+  npm-types:
+    name: Release types to NPM
+    runs-on: ubuntu-latest
+    needs: sign
+    if: ${{ github.event_name != 'workflow_dispatch' || github.event.inputs.use-types == 'true' }}
+    permissions:
+      contents: read
+    defaults:
+      run:
+        working-directory: packages/bun-types
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: latest
+      - name: Setup Bun
+        if: ${{ env.BUN_VERSION != 'canary' }}
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: "1.2.3"
+      - name: Setup Bun
+        if: ${{ env.BUN_VERSION == 'canary' }}
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: "canary" # Must be 'canary' so tag is correct
+      - name: Install Dependencies
+        run: bun install
+      - name: Setup Tag
+        if: ${{ env.BUN_VERSION == 'canary' }}
+        run: |
+          VERSION=$(bun --version)
+          TAG="${VERSION}-canary.$(date +'%Y%m%dT%H%M%S')"
+          echo "Setup tag: ${TAG}"
+          echo "TAG=${TAG}" >> ${GITHUB_ENV}
+      - name: Build
+        run: bun run build
+        env:
+          BUN_VERSION: ${{ env.TAG || env.BUN_VERSION }}
+      - name: Release (canary)
+        if: ${{ env.BUN_VERSION == 'canary' }}
+        uses: JS-DevTools/npm-publish@v1
+        with:
+          package: packages/bun-types/package.json
+          token: ${{ secrets.NPM_TOKEN }}
+          tag: canary
+      - name: Release (latest)
+        if: ${{ env.BUN_LATEST == 'true' }}
+        uses: JS-DevTools/npm-publish@v1
+        with:
+          package: packages/bun-types/package.json
+          token: ${{ secrets.NPM_TOKEN }}
+  definitelytyped:
+    name: Make pr to DefinitelyTyped to update `bun-types` version
+    runs-on: ubuntu-latest
+    needs: npm-types
+    if: ${{ github.event_name == 'release' || github.event.inputs.use-definitelytyped == 'true' }}
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout (DefinitelyTyped)
+        uses: actions/checkout@v4
+        with:
+          repository: DefinitelyTyped/DefinitelyTyped
+      - name: Checkout (bun)
+        uses: actions/checkout@v4
+        with:
+          path: bun
+      - name: Setup Bun
+        uses: ./bun/.github/actions/setup-bun
+        with:
+          bun-version: "1.2.0"
+      - id: bun-version
+        run: echo "BUN_VERSION=${BUN_VERSION#bun-v}" >> "$GITHUB_OUTPUT"
+      - name: Update bun-types version in package.json
+        run: |
+          bun -e '
+          const file = Bun.file("./types/bun/package.json");
+          const json = await file.json();
+          const version = "${{ steps.bun-version.outputs.BUN_VERSION }}"; 
+          json.dependencies["bun-types"] = version;
+          json.version = version.slice(0, version.lastIndexOf(".")) + ".9999";
+          await file.write(JSON.stringify(json, null, 4) + "\n");
+          '
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v7
+        if: ${{ env.BUN_LATEST == 'true' && env.BUN_VERSION != 'canary'}}
+        with:
+          token: ${{ secrets.ROBOBUN_TOKEN }}
+          add-paths: ./types/bun/package.json
+          title: "[bun] update to ${{ steps.bun-version.outputs.BUN_VERSION }}"
+          commit-message: "[bun] update to ${{ steps.bun-version.outputs.BUN_VERSION }}"
+          body: |
+            Update `bun-types` version to ${{ steps.bun-version.outputs.BUN_VERSION }}
+
+            https://bun.com/blog/${{ env.BUN_VERSION }}
+          push-to-fork: oven-sh/DefinitelyTyped
+          branch: ${{env.BUN_VERSION}}
+  docker:
+    name: Release to Dockerhub
+    runs-on: ubuntu-latest
+    needs: sign
+    if: ${{ github.event_name != 'workflow_dispatch' || github.event.inputs.use-docker == 'true' }}
+    permissions:
+      contents: read
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - variant: debian
+            suffix: ""
+          - variant: debian
+            suffix: -debian
+          - variant: slim
+            suffix: -slim
+            dir: debian-slim
+          - variant: alpine
+            suffix: -alpine
+          - variant: distroless
+            suffix: -distroless
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Docker emulator
+        uses: docker/setup-qemu-action@v3
+      - id: buildx
+        name: Setup Docker buildx
+        uses: docker/setup-buildx-action@v3
+        with:
+          platforms: linux/amd64,linux/arm64
+      - id: metadata
+        name: Setup Docker metadata
+        uses: docker/metadata-action@v5
+        with:
+          images: oven/bun
+          flavor: |
+            latest=false
+          tags: |
+            type=raw,value=latest,enable=${{ env.BUN_LATEST == 'true' && matrix.suffix == '' }}
+            type=raw,value=${{ matrix.variant }},enable=${{ env.BUN_LATEST == 'true' }}
+            type=match,pattern=(bun-v)?(canary|\d+.\d+.\d+),group=2,value=${{ env.BUN_VERSION }},suffix=${{ matrix.suffix }}
+            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@v3
+        with:
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+      - name: Push to Docker
+        uses: docker/build-push-action@v6
+        with:
+          context: ./dockerhub/${{ matrix.dir || matrix.variant }}
+          platforms: linux/amd64,linux/arm64
+          builder: ${{ steps.buildx.outputs.name }}
+          push: true
+          tags: ${{ steps.metadata.outputs.tags }}
+          labels: ${{ steps.metadata.outputs.labels }}
+          build-args: |
+            BUN_VERSION=${{ env.BUN_VERSION }}
+  homebrew:
+    name: Release to Homebrew
+    runs-on: ubuntu-latest
+    needs: sign
+    permissions:
+      contents: read
+    if: ${{ github.event_name == 'release' || github.event.inputs.use-homebrew == 'true' }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          repository: oven-sh/homebrew-bun
+          token: ${{ secrets.ROBOBUN_TOKEN }}
+      - id: gpg
+        name: Setup GPG
+        uses: crazy-max/ghaction-import-gpg@v5
+        with:
+          gpg_private_key: ${{ secrets.GPG_PRIVATE_KEY }}
+          passphrase: ${{ secrets.GPG_PASSPHRASE }}
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "2.6"
+      - name: Update Tap
+        run: ruby scripts/release.rb "${{ env.BUN_VERSION }}"
+      - name: Commit Tap
+        uses: stefanzweifel/git-auto-commit-action@v4
+        with:
+          commit_options: --gpg-sign=${{ steps.gpg.outputs.keyid }}
+          commit_message: Release ${{ env.BUN_VERSION }}
+          commit_user_name: robobun
+          commit_user_email: robobun@oven.sh
+          commit_author: robobun <robobun@oven.sh>
+  s3:
+    name: Upload to S3
+    runs-on: ubuntu-latest
+    needs: sign
+    if: ${{ github.event_name != 'workflow_dispatch' || github.event.inputs.use-s3 == 'true' }}
+    permissions:
+      contents: read
+    defaults:
+      run:
+        working-directory: packages/bun-release
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: "1.2.0"
+      - name: Install Dependencies
+        run: bun install
+      - name: Release
+        run: bun upload-s3 -- "${{ env.BUN_VERSION }}"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
+          AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY}}
+          AWS_ENDPOINT: ${{ secrets.AWS_ENDPOINT }}
+          AWS_BUCKET: bun
+
+  notify-sentry:
+    name: Notify Sentry
+    runs-on: ubuntu-latest
+    needs: s3
+    steps:
+      - name: Notify Sentry
+        uses: getsentry/action-release@v1.7.0
+        env:
+          SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
+          SENTRY_ORG: ${{ secrets.SENTRY_ORG }}
+          SENTRY_PROJECT: ${{ secrets.SENTRY_PROJECT }}
+        with:
+          ignore_missing: true
+          ignore_empty: true
+          version: ${{ env.BUN_VERSION }}
+          environment: production
+
+  bump:
+    name: "Bump version"
+    runs-on: ubuntu-latest
+    if: ${{ github.event_name != 'schedule' }}
+    permissions:
+      pull-requests: write
+      contents: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        if: ${{ env.BUN_LATEST == 'true' }}
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        if: ${{ env.BUN_LATEST == 'true' }}
+        with:
+          bun-version: "1.2.0"
+      - name: Bump version
+        uses: ./.github/actions/bump
+        if: ${{ env.BUN_LATEST == 'true' }}
+        with:
+          version: ${{ env.BUN_VERSION }}
+          token: ${{ github.token }}

.github/workflows/stale.yaml

@@ -0,0 +1,30 @@
+name: Close inactive issues
+on:
+  # schedule:
+  #   - cron: "15 * * * *"
+  workflow_dispatch:
+
+jobs:
+  close-issues:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+    steps:
+      - uses: actions/stale@v5
+        with:
+          days-before-issue-close: 5
+          any-of-issue-labels: "needs repro,waiting-for-author"
+          exempt-issue-labels: "neverstale"
+          exempt-pr-labels: "neverstale"
+          remove-stale-when-updated: true
+          stale-issue-label: "stale"
+          stale-pr-label: "stale"
+          stale-issue-message: "This issue is stale and may be closed due to inactivity. If you're still running into this, please leave a comment."
+          close-issue-message: "This issue was closed because it has been inactive for 5 days since being marked as stale."
+          days-before-pr-stale: 30
+          days-before-pr-close: 14
+          stale-pr-message: "This pull request is stale and may be closed due to inactivity."
+          close-pr-message: "This pull request has been closed due to inactivity."
+          repo-token: ${{ github.token }}
+          operations-per-run: 1000

.github/workflows/test-bump.yml

@@ -0,0 +1,32 @@
+name: Test Bump version
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        type: string
+        description: What is the release tag? (e.g. "1.0.2", "canary")
+        required: true
+
+env:
+  BUN_VERSION: "1.2.0"
+
+jobs:
+  bump:
+    name: "Bump version"
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+      contents: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: ${{ env.BUN_VERSION }}
+      - name: Bump version
+        uses: ./.github/actions/bump
+        with:
+          version: ${{ inputs.version }}
+          token: ${{ github.token }}

.github/workflows/update-cares.yml

@@ -0,0 +1,99 @@
+name: Update c-ares
+
+on:
+  schedule:
+    - cron: "0 4 * * 0"
+  workflow_dispatch:
+
+jobs:
+  check-update:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check c-ares version
+        id: check-version
+        run: |
+          set -euo pipefail
+
+          # Extract the commit hash from the line after COMMIT
+          CURRENT_VERSION=$(awk '/[[:space:]]*COMMIT[[:space:]]*$/{getline; gsub(/^[[:space:]]+|[[:space:]]+$/,"",$0); print}' cmake/targets/BuildCares.cmake)
+
+          if [ -z "$CURRENT_VERSION" ]; then
+            echo "Error: Could not find COMMIT line in BuildCares.cmake"
+            exit 1
+          fi
+
+          # Validate that it looks like a git hash
+          if ! [[ $CURRENT_VERSION =~ ^[0-9a-f]{40}$ ]]; then
+            echo "Error: Invalid git hash format in BuildCares.cmake"
+            echo "Found: $CURRENT_VERSION"
+            echo "Expected: 40 character hexadecimal string"
+            exit 1
+          fi
+
+          echo "current=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+
+          LATEST_RELEASE=$(curl -sL https://api.github.com/repos/c-ares/c-ares/releases/latest)
+          if [ -z "$LATEST_RELEASE" ]; then
+            echo "Error: Failed to fetch latest release from GitHub API"
+            exit 1
+          fi
+
+          LATEST_TAG=$(echo "$LATEST_RELEASE" | jq -r '.tag_name')
+          if [ -z "$LATEST_TAG" ] || [ "$LATEST_TAG" = "null" ]; then
+            echo "Error: Could not extract tag name from GitHub API response"
+            exit 1
+          fi
+
+          LATEST_TAG_SHA=$(curl -sL "https://api.github.com/repos/c-ares/c-ares/git/refs/tags/$LATEST_TAG" | jq -r '.object.sha')
+          if [ -z "$LATEST_TAG_SHA" ] || [ "$LATEST_TAG_SHA" = "null" ]; then
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
+            exit 1
+          fi
+          LATEST_SHA=$(curl -sL "https://api.github.com/repos/c-ares/c-ares/git/tags/$LATEST_TAG_SHA" | jq -r '.object.sha')
+          if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG @ $LATEST_TAG_SHA"
+            exit 1
+          fi
+
+          if ! [[ $LATEST_SHA =~ ^[0-9a-f]{40}$ ]]; then
+            echo "Error: Invalid SHA format received from GitHub"
+            echo "Found: $LATEST_SHA"
+            echo "Expected: 40 character hexadecimal string"
+            exit 1
+          fi
+
+          echo "latest=$LATEST_SHA" >> $GITHUB_OUTPUT
+          echo "tag=$LATEST_TAG" >> $GITHUB_OUTPUT
+
+      - name: Update version if needed
+        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
+        run: |
+          set -euo pipefail
+          # Handle multi-line format where COMMIT and its value are on separate lines
+          sed -i -E '/[[:space:]]*COMMIT[[:space:]]*$/{n;s/[[:space:]]*([0-9a-f]+)[[:space:]]*$/    ${{ steps.check-version.outputs.latest }}/}' cmake/targets/BuildCares.cmake
+
+      - name: Create Pull Request
+        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
+        uses: peter-evans/create-pull-request@v7
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          add-paths: |
+            cmake/targets/BuildCares.cmake
+          commit-message: "deps: update c-ares to ${{ steps.check-version.outputs.tag }} (${{ steps.check-version.outputs.latest }})"
+          title: "deps: update c-ares to ${{ steps.check-version.outputs.tag }}"
+          delete-branch: true
+          branch: deps/update-cares
+          body: |
+            ## What does this PR do?
+
+            Updates c-ares to version ${{ steps.check-version.outputs.tag }}
+
+            Compare: https://github.com/c-ares/c-ares/compare/${{ steps.check-version.outputs.current }}...${{ steps.check-version.outputs.latest }}
+
+            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-cares.yml)

.github/workflows/update-hdrhistogram.yml

@@ -0,0 +1,102 @@
+name: Update hdrhistogram
+
+on:
+  schedule:
+    - cron: "0 4 * * 0"
+  workflow_dispatch:
+
+jobs:
+  check-update:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check hdrhistogram version
+        id: check-version
+        run: |
+          set -euo pipefail
+
+          # Extract the commit hash from the line after COMMIT
+          CURRENT_VERSION=$(awk '/[[:space:]]*COMMIT[[:space:]]*$/{getline; gsub(/^[[:space:]]+|[[:space:]]+$/,"",$0); print}' cmake/targets/BuildHdrHistogram.cmake)
+
+          if [ -z "$CURRENT_VERSION" ]; then
+            echo "Error: Could not find COMMIT line in BuildHdrHistogram.cmake"
+            exit 1
+          fi
+
+          # Validate that it looks like a git hash
+          if ! [[ $CURRENT_VERSION =~ ^[0-9a-f]{40}$ ]]; then
+            echo "Error: Invalid git hash format in BuildHdrHistogram.cmake"
+            echo "Found: $CURRENT_VERSION"
+            echo "Expected: 40 character hexadecimal string"
+            exit 1
+          fi
+
+          echo "current=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+
+          LATEST_RELEASE=$(curl -sL https://api.github.com/repos/HdrHistogram/HdrHistogram_c/releases/latest)
+          if [ -z "$LATEST_RELEASE" ]; then
+            echo "Error: Failed to fetch latest release from GitHub API"
+            exit 1
+          fi
+
+          LATEST_TAG=$(echo "$LATEST_RELEASE" | jq -r '.tag_name')
+          if [ -z "$LATEST_TAG" ] || [ "$LATEST_TAG" = "null" ]; then
+            echo "Error: Could not extract tag name from GitHub API response"
+            exit 1
+          fi
+
+          LATEST_TAG_SHA=$(curl -sL "https://api.github.com/repos/HdrHistogram/HdrHistogram_c/git/refs/tags/$LATEST_TAG" | jq -r '.object.sha')
+          if [ -z "$LATEST_TAG_SHA" ] || [ "$LATEST_TAG_SHA" = "null" ]; then
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
+            exit 1
+          fi
+
+          # Try to get commit SHA from tag object (for annotated tags)
+          # If it fails, assume it's a lightweight tag pointing directly to commit
+          LATEST_SHA=$(curl -sL "https://api.github.com/repos/HdrHistogram/HdrHistogram_c/git/tags/$LATEST_TAG_SHA" 2>/dev/null | jq -r '.object.sha // empty')
+          if [ -z "$LATEST_SHA" ]; then
+            # Lightweight tag - SHA points directly to commit
+            LATEST_SHA="$LATEST_TAG_SHA"
+          fi
+
+          if ! [[ $LATEST_SHA =~ ^[0-9a-f]{40}$ ]]; then
+            echo "Error: Invalid SHA format received from GitHub"
+            echo "Found: $LATEST_SHA"
+            echo "Expected: 40 character hexadecimal string"
+            exit 1
+          fi
+
+          echo "latest=$LATEST_SHA" >> $GITHUB_OUTPUT
+          echo "tag=$LATEST_TAG" >> $GITHUB_OUTPUT
+
+      - name: Update version if needed
+        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
+        run: |
+          set -euo pipefail
+          # Handle multi-line format where COMMIT and its value are on separate lines
+          sed -i -E '/[[:space:]]*COMMIT[[:space:]]*$/{n;s/[[:space:]]*([0-9a-f]+)[[:space:]]*$/    ${{ steps.check-version.outputs.latest }}/}' cmake/targets/BuildHdrHistogram.cmake
+
+      - name: Create Pull Request
+        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
+        uses: peter-evans/create-pull-request@v7
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          add-paths: |
+            cmake/targets/BuildHdrHistogram.cmake
+          commit-message: "deps: update hdrhistogram to ${{ steps.check-version.outputs.tag }} (${{ steps.check-version.outputs.latest }})"
+          title: "deps: update hdrhistogram to ${{ steps.check-version.outputs.tag }}"
+          delete-branch: true
+          branch: deps/update-hdrhistogram
+          body: |
+            ## What does this PR do?
+
+            Updates hdrhistogram to version ${{ steps.check-version.outputs.tag }}
+
+            Compare: https://github.com/HdrHistogram/HdrHistogram_c/compare/${{ steps.check-version.outputs.current }}...${{ steps.check-version.outputs.latest }}
+
+            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-hdrhistogram.yml)

.github/workflows/update-highway.yml

@@ -0,0 +1,118 @@
+name: Update highway
+
+on:
+  schedule:
+    - cron: "0 4 * * 0"
+  workflow_dispatch:
+
+jobs:
+  check-update:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check highway version
+        id: check-version
+        run: |
+          set -euo pipefail
+
+          # Extract the commit hash from the line after COMMIT
+          CURRENT_VERSION=$(awk '/[[:space:]]*COMMIT[[:space:]]*$/{getline; gsub(/^[[:space:]]+|[[:space:]]+$/,"",$0); print}' cmake/targets/BuildHighway.cmake)
+
+          if [ -z "$CURRENT_VERSION" ]; then
+            echo "Error: Could not find COMMIT line in BuildHighway.cmake"
+            exit 1
+          fi
+
+          # Validate that it looks like a git hash
+          if ! [[ $CURRENT_VERSION =~ ^[0-9a-f]{40}$ ]]; then
+            echo "Error: Invalid git hash format in BuildHighway.cmake"
+            echo "Found: $CURRENT_VERSION"
+            echo "Expected: 40 character hexadecimal string"
+            exit 1
+          fi
+
+          echo "current=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+
+          LATEST_RELEASE=$(curl -sL https://api.github.com/repos/google/highway/releases/latest)
+          if [ -z "$LATEST_RELEASE" ]; then
+            echo "Error: Failed to fetch latest release from GitHub API"
+            exit 1
+          fi
+
+          LATEST_TAG=$(echo "$LATEST_RELEASE" | jq -r '.tag_name')
+          if [ -z "$LATEST_TAG" ] || [ "$LATEST_TAG" = "null" ]; then
+            echo "Error: Could not extract tag name from GitHub API response"
+            exit 1
+          fi
+
+          TAG_REF=$(curl -sL "https://api.github.com/repos/google/highway/git/refs/tags/$LATEST_TAG")
+          if [ -z "$TAG_REF" ]; then
+            echo "Error: Could not fetch tag reference for $LATEST_TAG"
+            exit 1
+          fi
+
+          TAG_OBJECT_SHA=$(echo "$TAG_REF" | jq -r '.object.sha')
+          TAG_OBJECT_TYPE=$(echo "$TAG_REF" | jq -r '.object.type')
+
+          if [ -z "$TAG_OBJECT_SHA" ] || [ "$TAG_OBJECT_SHA" = "null" ]; then
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
+            exit 1
+          fi
+
+          # Handle both lightweight tags (type: commit) and annotated tags (type: tag)
+          if [ "$TAG_OBJECT_TYPE" = "commit" ]; then
+            # Lightweight tag - object.sha is already the commit SHA
+            LATEST_SHA="$TAG_OBJECT_SHA"
+          elif [ "$TAG_OBJECT_TYPE" = "tag" ]; then
+            # Annotated tag - need to fetch the tag object to get the commit SHA
+            LATEST_SHA=$(curl -sL "https://api.github.com/repos/google/highway/git/tags/$TAG_OBJECT_SHA" | jq -r '.object.sha')
+            if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
+              echo "Error: Could not fetch commit SHA for annotated tag $LATEST_TAG @ $TAG_OBJECT_SHA"
+              exit 1
+            fi
+          else
+            echo "Error: Unexpected tag object type: $TAG_OBJECT_TYPE"
+            exit 1
+          fi
+
+          if ! [[ $LATEST_SHA =~ ^[0-9a-f]{40}$ ]]; then
+            echo "Error: Invalid SHA format received from GitHub"
+            echo "Found: $LATEST_SHA"
+            echo "Expected: 40 character hexadecimal string"
+            exit 1
+          fi
+
+          echo "latest=$LATEST_SHA" >> $GITHUB_OUTPUT
+          echo "tag=$LATEST_TAG" >> $GITHUB_OUTPUT
+
+      - name: Update version if needed
+        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
+        run: |
+          set -euo pipefail
+          # Handle multi-line format where COMMIT and its value are on separate lines
+          sed -i -E '/[[:space:]]*COMMIT[[:space:]]*$/{n;s/[[:space:]]*([0-9a-f]+)[[:space:]]*$/    ${{ steps.check-version.outputs.latest }}/}' cmake/targets/BuildHighway.cmake
+
+      - name: Create Pull Request
+        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
+        uses: peter-evans/create-pull-request@v7
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          add-paths: |
+            cmake/targets/BuildHighway.cmake
+          commit-message: "deps: update highway to ${{ steps.check-version.outputs.tag }} (${{ steps.check-version.outputs.latest }})"
+          title: "deps: update highway to ${{ steps.check-version.outputs.tag }}"
+          delete-branch: true
+          branch: deps/update-highway
+          body: |
+            ## What does this PR do?
+
+            Updates highway to version ${{ steps.check-version.outputs.tag }}
+
+            Compare: https://github.com/google/highway/compare/${{ steps.check-version.outputs.current }}...${{ steps.check-version.outputs.latest }}
+
+            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-highway.yml)

.github/workflows/update-libarchive.yml

@@ -0,0 +1,99 @@
+name: Update libarchive
+
+on:
+  schedule:
+    - cron: "0 3 * * 0"
+  workflow_dispatch:
+
+jobs:
+  check-update:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check libarchive version
+        id: check-version
+        run: |
+          set -euo pipefail
+
+          # Extract the commit hash from the line after COMMIT
+          CURRENT_VERSION=$(awk '/[[:space:]]*COMMIT[[:space:]]*$/{getline; gsub(/^[[:space:]]+|[[:space:]]+$/,"",$0); print}' cmake/targets/BuildLibArchive.cmake)
+
+          if [ -z "$CURRENT_VERSION" ]; then
+            echo "Error: Could not find COMMIT line in BuildLibArchive.cmake"
+            exit 1
+          fi
+
+          # Validate that it looks like a git hash
+          if ! [[ $CURRENT_VERSION =~ ^[0-9a-f]{40}$ ]]; then
+            echo "Error: Invalid git hash format in BuildLibArchive.cmake"
+            echo "Found: $CURRENT_VERSION"
+            echo "Expected: 40 character hexadecimal string"
+            exit 1
+          fi
+
+          echo "current=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+
+          LATEST_RELEASE=$(curl -sL https://api.github.com/repos/libarchive/libarchive/releases/latest)
+          if [ -z "$LATEST_RELEASE" ]; then
+            echo "Error: Failed to fetch latest release from GitHub API"
+            exit 1
+          fi
+
+          LATEST_TAG=$(echo "$LATEST_RELEASE" | jq -r '.tag_name')
+          if [ -z "$LATEST_TAG" ] || [ "$LATEST_TAG" = "null" ]; then
+            echo "Error: Could not extract tag name from GitHub API response"
+            exit 1
+          fi
+
+          LATEST_TAG_SHA=$(curl -sL "https://api.github.com/repos/libarchive/libarchive/git/refs/tags/$LATEST_TAG" | jq -r '.object.sha')
+          if [ -z "$LATEST_TAG_SHA" ] || [ "$LATEST_TAG_SHA" = "null" ]; then
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
+            exit 1
+          fi
+          LATEST_SHA=$(curl -sL "https://api.github.com/repos/libarchive/libarchive/git/tags/$LATEST_TAG_SHA" | jq -r '.object.sha')
+          if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG @ $LATEST_TAG_SHA"
+            exit 1
+          fi
+
+          if ! [[ $LATEST_SHA =~ ^[0-9a-f]{40}$ ]]; then
+            echo "Error: Invalid SHA format received from GitHub"
+            echo "Found: $LATEST_SHA"
+            echo "Expected: 40 character hexadecimal string"
+            exit 1
+          fi
+
+          echo "latest=$LATEST_SHA" >> $GITHUB_OUTPUT
+          echo "tag=$LATEST_TAG" >> $GITHUB_OUTPUT
+
+      - name: Update version if needed
+        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
+        run: |
+          set -euo pipefail
+          # Handle multi-line format where COMMIT and its value are on separate lines
+          sed -i -E '/[[:space:]]*COMMIT[[:space:]]*$/{n;s/[[:space:]]*([0-9a-f]+)[[:space:]]*$/    ${{ steps.check-version.outputs.latest }}/}' cmake/targets/BuildLibArchive.cmake
+
+      - name: Create Pull Request
+        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
+        uses: peter-evans/create-pull-request@v7
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          add-paths: |
+            cmake/targets/BuildLibArchive.cmake
+          commit-message: "deps: update libarchive to ${{ steps.check-version.outputs.tag }} (${{ steps.check-version.outputs.latest }})"
+          title: "deps: update libarchive to ${{ steps.check-version.outputs.tag }}"
+          delete-branch: true
+          branch: deps/update-libarchive
+          body: |
+            ## What does this PR do?
+
+            Updates libarchive to version ${{ steps.check-version.outputs.tag }}
+
+            Compare: https://github.com/libarchive/libarchive/compare/${{ steps.check-version.outputs.current }}...${{ steps.check-version.outputs.latest }}
+
+            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-libarchive.yml)

.github/workflows/update-libdeflate.yml

@@ -0,0 +1,99 @@
+name: Update libdeflate
+
+on:
+  schedule:
+    - cron: "0 2 * * 0"
+  workflow_dispatch:
+
+jobs:
+  check-update:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check libdeflate version
+        id: check-version
+        run: |
+          set -euo pipefail
+
+          # Extract the commit hash from the line after COMMIT
+          CURRENT_VERSION=$(awk '/[[:space:]]*COMMIT[[:space:]]*$/{getline; gsub(/^[[:space:]]+|[[:space:]]+$/,"",$0); print}' cmake/targets/BuildLibDeflate.cmake)
+
+          if [ -z "$CURRENT_VERSION" ]; then
+            echo "Error: Could not find COMMIT line in BuildLibDeflate.cmake"
+            exit 1
+          fi
+
+          # Validate that it looks like a git hash
+          if ! [[ $CURRENT_VERSION =~ ^[0-9a-f]{40}$ ]]; then
+            echo "Error: Invalid git hash format in BuildLibDeflate.cmake"
+            echo "Found: $CURRENT_VERSION"
+            echo "Expected: 40 character hexadecimal string"
+            exit 1
+          fi
+
+          echo "current=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+
+          LATEST_RELEASE=$(curl -sL https://api.github.com/repos/ebiggers/libdeflate/releases/latest)
+          if [ -z "$LATEST_RELEASE" ]; then
+            echo "Error: Failed to fetch latest release from GitHub API"
+            exit 1
+          fi
+
+          LATEST_TAG=$(echo "$LATEST_RELEASE" | jq -r '.tag_name')
+          if [ -z "$LATEST_TAG" ] || [ "$LATEST_TAG" = "null" ]; then
+            echo "Error: Could not extract tag name from GitHub API response"
+            exit 1
+          fi
+
+          LATEST_TAG_SHA=$(curl -sL "https://api.github.com/repos/ebiggers/libdeflate/git/refs/tags/$LATEST_TAG" | jq -r '.object.sha')
+          if [ -z "$LATEST_TAG_SHA" ] || [ "$LATEST_TAG_SHA" = "null" ]; then
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
+            exit 1
+          fi
+          LATEST_SHA=$(curl -sL "https://api.github.com/repos/ebiggers/libdeflate/git/tags/$LATEST_TAG_SHA" | jq -r '.object.sha')
+          if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG @ $LATEST_TAG_SHA"
+            exit 1
+          fi
+
+          if ! [[ $LATEST_SHA =~ ^[0-9a-f]{40}$ ]]; then
+            echo "Error: Invalid SHA format received from GitHub"
+            echo "Found: $LATEST_SHA"
+            echo "Expected: 40 character hexadecimal string"
+            exit 1
+          fi
+
+          echo "latest=$LATEST_SHA" >> $GITHUB_OUTPUT
+          echo "tag=$LATEST_TAG" >> $GITHUB_OUTPUT
+
+      - name: Update version if needed
+        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
+        run: |
+          set -euo pipefail
+          # Handle multi-line format where COMMIT and its value are on separate lines
+          sed -i -E '/[[:space:]]*COMMIT[[:space:]]*$/{n;s/[[:space:]]*([0-9a-f]+)[[:space:]]*$/    ${{ steps.check-version.outputs.latest }}/}' cmake/targets/BuildLibDeflate.cmake
+
+      - name: Create Pull Request
+        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
+        uses: peter-evans/create-pull-request@v7
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          add-paths: |
+            cmake/targets/BuildLibDeflate.cmake
+          commit-message: "deps: update libdeflate to ${{ steps.check-version.outputs.tag }} (${{ steps.check-version.outputs.latest }})"
+          title: "deps: update libdeflate to ${{ steps.check-version.outputs.tag }}"
+          delete-branch: true
+          branch: deps/update-libdeflate
+          body: |
+            ## What does this PR do?
+
+            Updates libdeflate to version ${{ steps.check-version.outputs.tag }}
+
+            Compare: https://github.com/ebiggers/libdeflate/compare/${{ steps.check-version.outputs.current }}...${{ steps.check-version.outputs.latest }}
+
+            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-libdeflate.yml)

.github/workflows/update-lolhtml.yml

@@ -0,0 +1,111 @@
+name: Update lolhtml
+
+on:
+  schedule:
+    - cron: "0 1 * * 0"
+  workflow_dispatch:
+
+jobs:
+  check-update:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check lolhtml version
+        id: check-version
+        run: |
+          set -euo pipefail
+
+          # Extract the commit hash from the line after COMMIT
+          CURRENT_VERSION=$(awk '/[[:space:]]*COMMIT[[:space:]]*$/{getline; gsub(/^[[:space:]]+|[[:space:]]+$/,"",$0); print}' cmake/targets/BuildLolHtml.cmake)
+
+          if [ -z "$CURRENT_VERSION" ]; then
+            echo "Error: Could not find COMMIT line in BuildLolHtml.cmake"
+            exit 1
+          fi
+
+          # Validate that it looks like a git hash
+          if ! [[ $CURRENT_VERSION =~ ^[0-9a-f]{40}$ ]]; then
+            echo "Error: Invalid git hash format in BuildLolHtml.cmake"
+            echo "Found: $CURRENT_VERSION"
+            echo "Expected: 40 character hexadecimal string"
+            exit 1
+          fi
+
+          echo "current=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+
+          LATEST_RELEASE=$(curl -sL https://api.github.com/repos/cloudflare/lol-html/releases/latest)
+          if [ -z "$LATEST_RELEASE" ]; then
+            echo "Error: Failed to fetch latest release from GitHub API"
+            exit 1
+          fi
+
+          LATEST_TAG=$(echo "$LATEST_RELEASE" | jq -r '.tag_name')
+          if [ -z "$LATEST_TAG" ] || [ "$LATEST_TAG" = "null" ]; then
+            echo "Error: Could not extract tag name from GitHub API response"
+            exit 1
+          fi
+
+          # Get the commit SHA that the tag points to
+          # This handles both lightweight tags (direct commit refs) and annotated tags (tag objects)
+          TAG_REF_RESPONSE=$(curl -sL "https://api.github.com/repos/cloudflare/lol-html/git/refs/tags/$LATEST_TAG")
+          LATEST_TAG_SHA=$(echo "$TAG_REF_RESPONSE" | jq -r '.object.sha')
+          TAG_OBJECT_TYPE=$(echo "$TAG_REF_RESPONSE" | jq -r '.object.type')
+
+          if [ -z "$LATEST_TAG_SHA" ] || [ "$LATEST_TAG_SHA" = "null" ]; then
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
+            exit 1
+          fi
+
+          if [ "$TAG_OBJECT_TYPE" = "tag" ]; then
+            # This is an annotated tag, we need to get the commit it points to
+            LATEST_SHA=$(curl -sL "https://api.github.com/repos/cloudflare/lol-html/git/tags/$LATEST_TAG_SHA" | jq -r '.object.sha')
+            if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
+              echo "Error: Could not fetch commit SHA for annotated tag $LATEST_TAG @ $LATEST_TAG_SHA"
+              exit 1
+            fi
+          else
+            # This is a lightweight tag pointing directly to a commit
+            LATEST_SHA="$LATEST_TAG_SHA"
+          fi
+
+          if ! [[ $LATEST_SHA =~ ^[0-9a-f]{40}$ ]]; then
+            echo "Error: Invalid SHA format received from GitHub"
+            echo "Found: $LATEST_SHA"
+            echo "Expected: 40 character hexadecimal string"
+            exit 1
+          fi
+
+          echo "latest=$LATEST_SHA" >> $GITHUB_OUTPUT
+          echo "tag=$LATEST_TAG" >> $GITHUB_OUTPUT
+
+      - name: Update version if needed
+        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
+        run: |
+          set -euo pipefail
+          # Handle multi-line format where COMMIT and its value are on separate lines
+          sed -i -E '/[[:space:]]*COMMIT[[:space:]]*$/{n;s/[[:space:]]*([0-9a-f]+)[[:space:]]*$/    ${{ steps.check-version.outputs.latest }}/}' cmake/targets/BuildLolHtml.cmake
+
+      - name: Create Pull Request
+        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
+        uses: peter-evans/create-pull-request@v7
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          add-paths: |
+            cmake/targets/BuildLolHtml.cmake
+          commit-message: "deps: update lolhtml to ${{ steps.check-version.outputs.tag }} (${{ steps.check-version.outputs.latest }})"
+          title: "deps: update lolhtml to ${{ steps.check-version.outputs.tag }}"
+          delete-branch: true
+          branch: deps/update-lolhtml
+          body: |
+            ## What does this PR do?
+
+            Updates lolhtml to version ${{ steps.check-version.outputs.tag }}
+
+            Compare: https://github.com/cloudflare/lol-html/compare/${{ steps.check-version.outputs.current }}...${{ steps.check-version.outputs.latest }}
+
+            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-lolhtml.yml)

.github/workflows/update-lshpack.yml

@@ -0,0 +1,116 @@
+name: Update lshpack
+
+on:
+  schedule:
+    - cron: "0 5 * * 0"
+  workflow_dispatch:
+
+jobs:
+  check-update:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check lshpack version
+        id: check-version
+        run: |
+          set -euo pipefail
+
+          # Extract the commit hash from the line after COMMIT
+          CURRENT_VERSION=$(awk '/[[:space:]]*COMMIT[[:space:]]*$/{getline; gsub(/^[[:space:]]+|[[:space:]]+$/,"",$0); print}' cmake/targets/BuildLshpack.cmake)
+
+          if [ -z "$CURRENT_VERSION" ]; then
+            echo "Error: Could not find COMMIT line in BuildLshpack.cmake"
+            exit 1
+          fi
+
+          # Validate that it looks like a git hash
+          if ! [[ $CURRENT_VERSION =~ ^[0-9a-f]{40}$ ]]; then
+            echo "Error: Invalid git hash format in BuildLshpack.cmake"
+            echo "Found: $CURRENT_VERSION"
+            echo "Expected: 40 character hexadecimal string"
+            exit 1
+          fi
+
+          echo "current=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+
+          LATEST_RELEASE=$(curl -sL https://api.github.com/repos/litespeedtech/ls-hpack/releases/latest)
+          if [ -z "$LATEST_RELEASE" ]; then
+            echo "Error: Failed to fetch latest release from GitHub API"
+            exit 1
+          fi
+
+          LATEST_TAG=$(echo "$LATEST_RELEASE" | jq -r '.tag_name')
+          if [ -z "$LATEST_TAG" ] || [ "$LATEST_TAG" = "null" ]; then
+            echo "Error: Could not extract tag name from GitHub API response"
+            exit 1
+          fi
+
+          # Get the tag reference, which contains both SHA and type
+          TAG_REF=$(curl -sL "https://api.github.com/repos/litespeedtech/ls-hpack/git/refs/tags/$LATEST_TAG")
+          if [ -z "$TAG_REF" ]; then
+            echo "Error: Could not fetch tag reference for $LATEST_TAG"
+            exit 1
+          fi
+
+          LATEST_TAG_SHA=$(echo "$TAG_REF" | jq -r '.object.sha')
+          TAG_TYPE=$(echo "$TAG_REF" | jq -r '.object.type')
+
+          if [ -z "$LATEST_TAG_SHA" ] || [ "$LATEST_TAG_SHA" = "null" ]; then
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
+            exit 1
+          fi
+
+          # If it's an annotated tag, we need to dereference it to get the commit SHA
+          # If it's a lightweight tag, the SHA already points to the commit
+          if [ "$TAG_TYPE" = "tag" ]; then
+            LATEST_SHA=$(curl -sL "https://api.github.com/repos/litespeedtech/ls-hpack/git/tags/$LATEST_TAG_SHA" | jq -r '.object.sha')
+            if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
+              echo "Error: Could not fetch commit SHA for annotated tag $LATEST_TAG"
+              exit 1
+            fi
+          else
+            # For lightweight tags, the SHA is already the commit SHA
+            LATEST_SHA="$LATEST_TAG_SHA"
+          fi
+
+          if ! [[ $LATEST_SHA =~ ^[0-9a-f]{40}$ ]]; then
+            echo "Error: Invalid SHA format received from GitHub"
+            echo "Found: $LATEST_SHA"
+            echo "Expected: 40 character hexadecimal string"
+            exit 1
+          fi
+
+          echo "latest=$LATEST_SHA" >> $GITHUB_OUTPUT
+          echo "tag=$LATEST_TAG" >> $GITHUB_OUTPUT
+
+      - name: Update version if needed
+        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
+        run: |
+          set -euo pipefail
+          # Handle multi-line format where COMMIT and its value are on separate lines
+          sed -i -E '/[[:space:]]*COMMIT[[:space:]]*$/{n;s/[[:space:]]*([0-9a-f]+)[[:space:]]*$/    ${{ steps.check-version.outputs.latest }}/}' cmake/targets/BuildLshpack.cmake
+
+      - name: Create Pull Request
+        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
+        uses: peter-evans/create-pull-request@v7
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          add-paths: |
+            cmake/targets/BuildLshpack.cmake
+          commit-message: "deps: update lshpack to ${{ steps.check-version.outputs.tag }} (${{ steps.check-version.outputs.latest }})"
+          title: "deps: update lshpack to ${{ steps.check-version.outputs.tag }}"
+          delete-branch: true
+          branch: deps/update-lshpack
+          body: |
+            ## What does this PR do?
+
+            Updates lshpack to version ${{ steps.check-version.outputs.tag }}
+
+            Compare: https://github.com/litespeedtech/ls-hpack/compare/${{ steps.check-version.outputs.current }}...${{ steps.check-version.outputs.latest }}
+
+            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-lshpack.yml)

.github/workflows/update-root-certs.yml

@@ -0,0 +1,82 @@
+name: Daily Root Certs Update Check
+
+on:
+  schedule:
+    - cron: "0 0 * * *" # Runs at 00:00 UTC every day
+  workflow_dispatch: # Allows manual trigger
+
+jobs:
+  check-and-update:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
+      - name: Generate root certs and capture output
+        id: generate-certs
+        run: |
+          cd packages/bun-usockets/
+          OUTPUT=$(bun generate-root-certs.mjs -v)
+          echo "cert_output<<EOF" >> $GITHUB_ENV
+          echo "$OUTPUT" >> $GITHUB_ENV
+          echo "EOF" >> $GITHUB_ENV
+
+      - name: Check for changes and stage files
+        id: check-changes
+        run: |
+          if [[ -n "$(git status --porcelain)" ]]; then
+            echo "Found changes, staging modified files..."
+            git config --global user.name "github-actions[bot]"
+            git config --global user.email "github-actions[bot]@users.noreply.github.com"
+            
+            # Get list of modified files and add them
+            git status --porcelain | while read -r status file; do
+              # Remove leading status and whitespace
+              file=$(echo "$file" | sed 's/^.* //')
+              echo "Adding changed file: $file"
+              git add "$file"
+            done
+            
+            echo "changes=true" >> $GITHUB_OUTPUT
+            
+            # Store the list of changed files
+            CHANGED_FILES=$(git status --porcelain)
+            echo "changed_files<<EOF" >> $GITHUB_ENV
+            echo "$CHANGED_FILES" >> $GITHUB_ENV
+            echo "EOF" >> $GITHUB_ENV
+          else
+            echo "No changes detected"
+            echo "changes=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Create Pull Request
+        if: steps.check-changes.outputs.changes == 'true'
+        uses: peter-evans/create-pull-request@v5
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: "update(root_certs): Update root certificates $(date +'%Y-%m-%d')"
+          title: "update(root_certs) $(date +'%Y-%m-%d')"
+          body: |
+            Automated root certificates update
+
+            ${{ env.cert_output }}
+
+            ## Changed Files:
+            ```
+            ${{ env.changed_files }}
+            ```
+          branch: certs/update-root-certs
+          base: main
+          delete-branch: true
+          labels:
+            - "automation"
+            - "root-certs"

.github/workflows/update-sqlite3.yml

@@ -0,0 +1,94 @@
+name: Update SQLite3
+
+on:
+  schedule:
+    - cron: "0 6 * * 0" # Run weekly
+  workflow_dispatch:
+
+jobs:
+  check-update:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check SQLite version
+        id: check-version
+        run: |
+          set -euo pipefail
+
+          # Get current version from the header file using SQLITE_VERSION_NUMBER
+          CURRENT_VERSION_NUM=$(grep -o '#define SQLITE_VERSION_NUMBER [0-9]\+' src/bun.js/bindings/sqlite/sqlite3_local.h | awk '{print $3}' | tr -d '\n\r')
+          if [ -z "$CURRENT_VERSION_NUM" ]; then
+            echo "Error: Could not find SQLITE_VERSION_NUMBER in sqlite3_local.h"
+            exit 1
+          fi
+
+          # Convert numeric version to semantic version for display
+          CURRENT_MAJOR=$((CURRENT_VERSION_NUM / 1000000))
+          CURRENT_MINOR=$((($CURRENT_VERSION_NUM / 1000) % 1000))
+          CURRENT_PATCH=$((CURRENT_VERSION_NUM % 1000))
+          CURRENT_VERSION="$CURRENT_MAJOR.$CURRENT_MINOR.$CURRENT_PATCH"
+
+          echo "current=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+          echo "current_num=$CURRENT_VERSION_NUM" >> $GITHUB_OUTPUT
+
+          # Fetch SQLite download page
+          DOWNLOAD_PAGE=$(curl -sL https://sqlite.org/download.html)
+          if [ -z "$DOWNLOAD_PAGE" ]; then
+            echo "Error: Failed to fetch SQLite download page"
+            exit 1
+          fi
+
+          # Extract latest version and year from the amalgamation link
+          LATEST_INFO=$(echo "$DOWNLOAD_PAGE" | grep -o 'sqlite-amalgamation-[0-9]\{7\}.zip' | head -n1)
+          LATEST_YEAR=$(echo "$DOWNLOAD_PAGE" | grep -o '[0-9]\{4\}/sqlite-amalgamation-[0-9]\{7\}.zip' | head -n1 | cut -d'/' -f1 | tr -d '\n\r')
+          LATEST_VERSION_NUM=$(echo "$LATEST_INFO" | grep -o '[0-9]\{7\}' | tr -d '\n\r')
+
+          if [ -z "$LATEST_VERSION_NUM" ] || [ -z "$LATEST_YEAR" ]; then
+            echo "Error: Could not extract latest version info"
+            exit 1
+          fi
+
+          # Convert numeric version to semantic version for display
+          LATEST_MAJOR=$((10#$LATEST_VERSION_NUM / 1000000))
+          LATEST_MINOR=$((($LATEST_VERSION_NUM / 10000) % 100))
+          LATEST_PATCH=$((10#$LATEST_VERSION_NUM % 1000))
+          LATEST_VERSION="$LATEST_MAJOR.$LATEST_MINOR.$LATEST_PATCH"
+
+          echo "latest=$LATEST_VERSION" >> $GITHUB_OUTPUT
+          echo "latest_year=$LATEST_YEAR" >> $GITHUB_OUTPUT
+          echo "latest_num=$LATEST_VERSION_NUM" >> $GITHUB_OUTPUT
+
+          # Debug output
+          echo "Current version: $CURRENT_VERSION ($CURRENT_VERSION_NUM)"
+          echo "Latest version: $LATEST_VERSION ($LATEST_VERSION_NUM)"
+
+      - name: Update SQLite if needed
+        if: success() && steps.check-version.outputs.current_num < steps.check-version.outputs.latest_num
+        run: |
+          ./scripts/update-sqlite-amalgamation.sh ${{ steps.check-version.outputs.latest_num }} ${{ steps.check-version.outputs.latest_year }}
+
+      - name: Create Pull Request
+        if: success() && steps.check-version.outputs.current_num < steps.check-version.outputs.latest_num
+        uses: peter-evans/create-pull-request@v7
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          add-paths: |
+            src/bun.js/bindings/sqlite/sqlite3.c
+            src/bun.js/bindings/sqlite/sqlite3_local.h
+          commit-message: "deps: update sqlite to ${{ steps.check-version.outputs.latest }}"
+          title: "deps: update sqlite to ${{ steps.check-version.outputs.latest }}"
+          delete-branch: true
+          branch: deps/update-sqlite
+          body: |
+            ## What does this PR do?
+
+            Updates SQLite to version ${{ steps.check-version.outputs.latest }}
+
+            Compare: https://sqlite.org/src/vdiff?from=${{ steps.check-version.outputs.current }}&to=${{ steps.check-version.outputs.latest }}
+
+            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-sqlite3.yml)

.github/workflows/update-vendor.yml

@@ -0,0 +1,79 @@
+name: Update vendor
+
+on:
+  schedule:
+    - cron: "0 4 * * 0"
+  workflow_dispatch:
+
+jobs:
+  check-update:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    strategy:
+      matrix:
+        package:
+          - elysia
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+
+      - name: Check version
+        id: check-version
+        run: |
+          set -euo pipefail
+
+          # Extract the commit hash from the line after COMMIT
+          current=$(bun -p '(await Bun.file("test/vendor.json").json()).filter(v=>v.package===process.argv[1])[0].tag' ${{ matrix.package }})
+          repository=$(bun -p '(await Bun.file("test/vendor.json").json()).filter(v=>v.package===process.argv[1])[0].repository' ${{ matrix.package }} | cut -d'/' -f4,5)
+
+          if [ -z "$current" ]; then
+            echo "Error: Could not find COMMIT line in test/vendor.json"
+            exit 1
+          fi
+
+          echo "current=$current" >> $GITHUB_OUTPUT
+          echo "repository=$repository" >> $GITHUB_OUTPUT
+
+          LATEST_RELEASE=$(curl -sL https://api.github.com/repos/${repository}/releases/latest)
+          if [ -z "$LATEST_RELEASE" ]; then
+            echo "Error: Failed to fetch latest release from GitHub API"
+            exit 1
+          fi
+
+          LATEST_TAG=$(echo "$LATEST_RELEASE" | jq -r '.tag_name')
+          if [ -z "$LATEST_TAG" ] || [ "$LATEST_TAG" = "null" ]; then
+            echo "Error: Could not extract tag name from GitHub API response"
+            exit 1
+          fi
+
+          echo "latest=$LATEST_TAG" >> $GITHUB_OUTPUT
+
+      - name: Update version if needed
+        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
+        run: |
+          set -euo pipefail
+          bun -e 'await Bun.write("test/vendor.json", JSON.stringify((await Bun.file("test/vendor.json").json()).map(v=>{if(v.package===process.argv[1])v.tag=process.argv[2];return v;}), null, 2) + "\n")' ${{ matrix.package }} ${{ steps.check-version.outputs.latest }}
+
+      - name: Create Pull Request
+        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
+        uses: peter-evans/create-pull-request@v7
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          add-paths: |
+            test/vendor.json
+          commit-message: "deps: update ${{ matrix.package }} to ${{ steps.check-version.outputs.latest }} (${{ steps.check-version.outputs.latest }})"
+          title: "deps: update ${{ matrix.package }} to ${{ steps.check-version.outputs.latest }}"
+          delete-branch: true
+          branch: deps/update-${{ matrix.package }}
+          body: |
+            ## What does this PR do?
+
+            Updates ${{ matrix.package }} to version ${{ steps.check-version.outputs.latest }}
+
+            Compare: https://github.com/${{ steps.check-version.outputs.repository }}/compare/${{ steps.check-version.outputs.current }}...${{ steps.check-version.outputs.latest }}
+
+            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-vendor.yml)

.github/workflows/update-zstd.yml

@@ -0,0 +1,99 @@
+name: Update zstd
+
+on:
+  schedule:
+    - cron: "0 1 * * 0"
+  workflow_dispatch:
+
+jobs:
+  check-update:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check zstd version
+        id: check-version
+        run: |
+          set -euo pipefail
+
+          # Extract the commit hash from the line after COMMIT
+          CURRENT_VERSION=$(awk '/[[:space:]]*COMMIT[[:space:]]*$/{getline; gsub(/^[[:space:]]+|[[:space:]]+$/,"",$0); print}' cmake/targets/CloneZstd.cmake)
+
+          if [ -z "$CURRENT_VERSION" ]; then
+            echo "Error: Could not find COMMIT line in CloneZstd.cmake"
+            exit 1
+          fi
+
+          # Validate that it looks like a git hash
+          if ! [[ $CURRENT_VERSION =~ ^[0-9a-f]{40}$ ]]; then
+            echo "Error: Invalid git hash format in CloneZstd.cmake"
+            echo "Found: $CURRENT_VERSION"
+            echo "Expected: 40 character hexadecimal string"
+            exit 1
+          fi
+
+          echo "current=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+
+          LATEST_RELEASE=$(curl -sL https://api.github.com/repos/facebook/zstd/releases/latest)
+          if [ -z "$LATEST_RELEASE" ]; then
+            echo "Error: Failed to fetch latest release from GitHub API"
+            exit 1
+          fi
+
+          LATEST_TAG=$(echo "$LATEST_RELEASE" | jq -r '.tag_name')
+          if [ -z "$LATEST_TAG" ] || [ "$LATEST_TAG" = "null" ]; then
+            echo "Error: Could not extract tag name from GitHub API response"
+            exit 1
+          fi
+
+          LATEST_TAG_SHA=$(curl -sL "https://api.github.com/repos/facebook/zstd/git/refs/tags/$LATEST_TAG" | jq -r '.object.sha')
+          if [ -z "$LATEST_TAG_SHA" ] || [ "$LATEST_TAG_SHA" = "null" ]; then
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG"
+            exit 1
+          fi
+          LATEST_SHA=$(curl -sL "https://api.github.com/repos/facebook/zstd/git/tags/$LATEST_TAG_SHA" | jq -r '.object.sha')
+          if [ -z "$LATEST_SHA" ] || [ "$LATEST_SHA" = "null" ]; then
+            echo "Error: Could not fetch SHA for tag $LATEST_TAG @ $LATEST_TAG_SHA"
+            exit 1
+          fi
+
+          if ! [[ $LATEST_SHA =~ ^[0-9a-f]{40}$ ]]; then
+            echo "Error: Invalid SHA format received from GitHub"
+            echo "Found: $LATEST_SHA"
+            echo "Expected: 40 character hexadecimal string"
+            exit 1
+          fi
+
+          echo "latest=$LATEST_SHA" >> $GITHUB_OUTPUT
+          echo "tag=$LATEST_TAG" >> $GITHUB_OUTPUT
+
+      - name: Update version if needed
+        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
+        run: |
+          set -euo pipefail
+          # Handle multi-line format where COMMIT and its value are on separate lines
+          sed -i -E '/[[:space:]]*COMMIT[[:space:]]*$/{n;s/[[:space:]]*([0-9a-f]+)[[:space:]]*$/    ${{ steps.check-version.outputs.latest }}/}' cmake/targets/CloneZstd.cmake
+
+      - name: Create Pull Request
+        if: success() && steps.check-version.outputs.current != steps.check-version.outputs.latest
+        uses: peter-evans/create-pull-request@v7
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          add-paths: |
+            cmake/targets/CloneZstd.cmake
+          commit-message: "deps: update zstd to ${{ steps.check-version.outputs.tag }} (${{ steps.check-version.outputs.latest }})"
+          title: "deps: update zstd to ${{ steps.check-version.outputs.tag }}"
+          delete-branch: true
+          branch: deps/update-zstd
+          body: |
+            ## What does this PR do?
+
+            Updates zstd to version ${{ steps.check-version.outputs.tag }}
+
+            Compare: https://github.com/facebook/zstd/compare/${{ steps.check-version.outputs.current }}...${{ steps.check-version.outputs.latest }}
+
+            Auto-updated by [this workflow](https://github.com/oven-sh/bun/actions/workflows/update-zstd.yml)

.github/workflows/vscode-release.yml

@@ -0,0 +1,52 @@
+name: VSCode Extension Publish
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Version to publish (e.g. 0.0.25) - Check the marketplace for the latest version"
+        required: true
+        type: string
+
+jobs:
+  publish:
+    name: "Publish to VS Code Marketplace"
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: "1.2.18"
+
+      - name: Install dependencies (root)
+        run: bun install
+
+      - name: Install dependencies
+        run: bun install
+        working-directory: packages/bun-vscode
+
+      - name: Set Version
+        run: bun pm version ${{ github.event.inputs.version }} --no-git-tag-version --allow-same-version
+        working-directory: packages/bun-vscode
+
+      - name: Build (inspector protocol)
+        run: bun install && bun run build
+        working-directory: packages/bun-inspector-protocol
+
+      - name: Build (vscode extension)
+        run: bun run build
+        working-directory: packages/bun-vscode
+
+      - name: Publish
+        if: success()
+        run: bunx vsce publish
+        env:
+          VSCE_PAT: ${{ secrets.VSCODE_EXTENSION }}
+        working-directory: packages/bun-vscode/extension
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: bun-vscode-${{ github.event.inputs.version }}.vsix
+          path: packages/bun-vscode/extension/bun-vscode-${{ github.event.inputs.version }}.vsix

.gitignore

@@ -1,167 +1,196 @@
-.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
-
-/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-*/
-
-.vs
-
-**/.verdaccio-db.json
-/test-report.md
-/test-report.json
+.claude/settings.local.json
+.direnv
+.DS_Store
+.env
+.envrc
+.eslintcache
+.gdb_history
+.idea
+.next
+.ninja_deps
+.ninja_log
+.npm
+.npmrc
+.npm.gz
+.parcel-cache
+.swcrc
+.trace
+.uuid
+.vs
+.vscode/clang*
+.vscode/cpp*
+.zig-cache
+.bake-debug
+*.a
+*.bc
+*.big
+*.blob
+*.bun
+*.crash
+*.database
+*.db
+*.dmg
+*.dSYM
+*.generated.ts
+*.jsb
+*.lib
+*.log
+*.o
+*.out.js
+*.out.refresh.js
+*.pdb
+*.sqlite
+*.swp
+*.tmp
+*.trace
+*.wat
+*.zip
+**/.verdaccio-db.json
+**/*.dir
+**/*.pdb
+**/*.sln*
+**/*.vcxproj*
+**/package-lock.json
+/.cache
+/.webkit-cache
+/build-*/
+/bun-webkit
+/kcov-out
+/test-report.json
+/test-report.md
+/test.js
+/test.ts
+/test.zig
+/testdir
+build
+build.ninja
+bun-binary
+bun-mimalloc
+bun-nomimalloc
+bun-singlehtreaded
+bun-test-scratch
+bun-zigld
+cmake_install.cmake
+CMakeCache.txt
+CMakeFiles
+cold-jsc-start
+cold-jsc-start.d
+compile_commands.json
+cover
+coverage
+coverv
+dist
+esbuilddir
+examples/lotta-modules/bun-nofscache
+examples/lotta-modules/bun-old
+examples/lotta-modules/bun-yday
+failing-tests.txt
+github
+make-dev-stats.csv
+misctools/fetch
+misctools/machbench
+misctools/sha
+myscript.sh
+node_modules
+node_modules_*
+out
+out.*
+outcss
+outdir
+outdir/
+packages/*/*.wasm
+packages/bun-*/*.o
+packages/bun-*/bun
+packages/bun-*/bun-profile
+packages/bun-*/debug-bun
+packages/bun-cli/bin/*
+packages/bun-cli/postinstall.js
+packages/bun-wasm/*.cjs
+packages/bun-wasm/*.d.cts
+packages/bun-wasm/*.d.mts
+packages/bun-wasm/*.d.ts
+packages/bun-wasm/*.js
+packages/bun-wasm/*.map
+packages/bun-wasm/*.mjs
+packages/debug-*
+parceldist
+pnpm-lock.yaml
+profile.json
+README.md.template
+release/
+scripts/env.local
+sign.*.json
+sign.json
+src/bake/generated.ts
+src/generated_enum_extractor.zig
+src/bun.js/bindings-obj
+src/bun.js/bindings/GeneratedJS2Native.zig
+src/bun.js/bindings/GeneratedBindings.zig
+src/bun.js/debug-bindings-obj
+src/deps/zig-clap/.gitattributes
+src/deps/zig-clap/.github
+src/deps/zig-clap/example
+src/deps/zig-clap/README.md
+src/fallback.version
+src/js/out/DebugPath.h
+src/js/out/functions*
+src/js/out/modules*
+src/js/out/tmp
+src/node-fallbacks/node_modules
+src/node-fallbacks/out/*
+src/runtime.version
+src/tests.zig
+test.txt
+test/js/bun/glob/fixtures
+test/node.js/upstream
+tsconfig.tsbuildinfo
+txt.js
+x64
+yarn.lock
+zig-cache
+zig-out
+test/node.js/upstream
+.zig-cache
+scripts/env.local
+*.generated.ts
+src/bake/generated.ts
+test/cli/install/registry/packages/publish-pkg-*
+test/cli/install/registry/packages/@secret/publish-pkg-8
+test/js/third_party/prisma/prisma/sqlite/dev.db-journal
+tmp
+codegen-for-zig-team.tar.gz
+
+# Dependencies
+/vendor
+
+# Dependencies (before CMake)
+# These can be removed in the far future
+/src/bun.js/WebKit
+/src/deps/boringssl
+/src/deps/brotli
+/src/deps/c*ares
+/src/deps/libarchive
+/src/deps/libdeflate
+/src/deps/libuv
+/src/deps/lol*html
+/src/deps/ls*hpack
+/src/deps/mimalloc
+/src/deps/picohttpparser
+/src/deps/tinycc
+/src/deps/WebKit
+/src/deps/zig
+/src/deps/zlib
+/src/deps/zstd
+
+# Generated files
+
+.buildkite/ci.yml
+*.sock
+scratch*.{js,ts,tsx,cjs,mjs}
+
+*.bun-build
+
+scripts/lldb-inline
+
+# We regenerate these in all the build scripts
+cmake/sources/*.txt

.gitmodules

@@ -1,85 +0,0 @@
-[submodule "src/javascript/jsc/WebKit"]
-path = src/bun.js/WebKit
-url = https://github.com/oven-sh/WebKit.git
-ignore = dirty
-depth = 1
-update = none
-shallow = true
-fetchRecurseSubmodules = false
-[submodule "src/deps/picohttpparser"]
-path = src/deps/picohttpparser
-url = https://github.com/h2o/picohttpparser.git
-ignore = dirty
-depth = 1
-shallow = true
-fetchRecurseSubmodules = false
-[submodule "src/deps/mimalloc"]
-path = src/deps/mimalloc
-url = https://github.com/Jarred-Sumner/mimalloc.git
-ignore = dirty
-depth = 1
-shallow = true
-fetchRecurseSubmodules = false
-[submodule "src/deps/zlib"]
-path = src/deps/zlib
-url = https://github.com/cloudflare/zlib.git
-ignore = dirty
-depth = 1
-shallow = true
-fetchRecurseSubmodules = false
-[submodule "src/deps/libarchive"]
-path = src/deps/libarchive
-url = https://github.com/libarchive/libarchive.git
-ignore = dirty
-depth = 1
-shallow = true
-fetchRecurseSubmodules = false
-[submodule "src/deps/boringssl"]
-path = src/deps/boringssl
-url = https://github.com/oven-sh/boringssl.git
-ignore = dirty
-depth = 1
-shallow = true
-fetchRecurseSubmodules = false
-[submodule "src/deps/lol-html"]
-path = src/deps/lol-html
-url = https://github.com/cloudflare/lol-html
-ignore = dirty
-depth = 1
-shallow = true
-fetchRecurseSubmodules = false
-[submodule "src/deps/tinycc"]
-path = src/deps/tinycc
-url = https://github.com/Jarred-Sumner/tinycc.git
-ignore = dirty
-depth = 1
-shallow = true
-fetchRecurseSubmodules = false
-[submodule "src/deps/c-ares"]
-path = src/deps/c-ares
-url = https://github.com/c-ares/c-ares.git
-ignore = dirty
-depth = 1
-shallow = true
-fetchRecurseSubmodules = false
-[submodule "src/deps/zstd"]
-path = src/deps/zstd
-url = https://github.com/facebook/zstd.git
-ignore = dirty
-depth = 1
-shallow = true
-fetchRecurseSubmodules = false
-[submodule "src/deps/base64"]
-path = src/deps/base64
-url = https://github.com/aklomp/base64.git
-ignore = dirty
-depth = 1
-shallow = true
-fetchRecurseSubmodules = false
-[submodule "src/deps/ls-hpack"]
-path = src/deps/ls-hpack
-url = https://github.com/litespeedtech/ls-hpack.git
-ignore = dirty
-depth = 1
-shallow = true
-fetchRecurseSubmodules = false

.lldbinit

@@ -0,0 +1 @@
+command source -C -s true -e true misctools/lldb/init.lldb

.mailmap

@@ -0,0 +1,2 @@
+# To learn more about git's mailmap: https://ntietz.com/blog/git-mailmap-for-name-changes
+chloe caruso <git@paperclover.net> <me@paperdave.net>

.prettierignore

@@ -0,0 +1,14 @@
+src/bun.js/WebKit
+vendor
+test/snapshots
+test/js/deno
+test/node.js
+src/react-refresh.js
+*.min.js
+test/snippets
+test/js/node/test
+test/napi/node-napi-tests
+bun.lock
+
+# the output codeblocks need to stay minified
+docs/bundler/minifier.mdx

.prettierrc

@@ -0,0 +1,30 @@
+{
+  "arrowParens": "avoid",
+  "printWidth": 120,
+  "trailingComma": "all",
+  "useTabs": false,
+  "quoteProps": "preserve",
+  "overrides": [
+    {
+      "files": [".vscode/*.json"],
+      "options": {
+        "parser": "jsonc",
+        "quoteProps": "preserve",
+        "singleQuote": false,
+        "trailingComma": "all"
+      }
+    },
+    {
+      "files": ["*.md"],
+      "options": {
+        "printWidth": 80
+      }
+    },
+    {
+      "files": ["src/codegen/bindgenv2/**/*.ts", "*.bindv2.ts"],
+      "options": {
+        "printWidth": 100
+      }
+    }
+  ]
+}

.typos.toml

@@ -0,0 +1,2 @@
+[type.md]
+extend-ignore-words-re = ["^ba"]

.vscode/c_cpp_properties.json

@@ -3,21 +3,21 @@
     {
       "name": "Debug",
       "forcedInclude": ["${workspaceFolder}/src/bun.js/bindings/root.h"],
-      "compileCommands": "${workspaceFolder}/build/compile_commands.json",
+      "compileCommands": "${workspaceFolder}/build/debug/compile_commands.json",
       "includePath": [
         "${workspaceFolder}/build/bun-webkit/include",
-        "${workspaceFolder}/build/codegen",
+        "${workspaceFolder}/build/debug/codegen",
         "${workspaceFolder}/src/bun.js/bindings/",
         "${workspaceFolder}/src/bun.js/bindings/webcore/",
         "${workspaceFolder}/src/bun.js/bindings/sqlite/",
         "${workspaceFolder}/src/bun.js/bindings/webcrypto/",
         "${workspaceFolder}/src/bun.js/modules/",
         "${workspaceFolder}/src/js/builtins/",
-        "${workspaceFolder}/src/deps/boringssl/include/",
-        "${workspaceFolder}/src/deps",
+        "${workspaceFolder}/vendor/boringssl/include/",
+        "${workspaceFolder}/vendor",
         "${workspaceFolder}/src/napi/*",
         "${workspaceFolder}/packages/bun-usockets/src",
-        "${workspaceFolder}/packages/"
+        "${workspaceFolder}/packages/",
       ],
       "browse": {
         "path": [
@@ -26,14 +26,14 @@
           "${workspaceFolder}/src/napi/*",
           "${workspaceFolder}/src/js/builtins/*",
           "${workspaceFolder}/src/bun.js/modules/*",
-          "${workspaceFolder}/src/deps/*",
-          "${workspaceFolder}/src/deps/boringssl/include/*",
+          "${workspaceFolder}/vendor/*",
+          "${workspaceFolder}/vendor/boringssl/include/*",
           "${workspaceFolder}/packages/bun-usockets/*",
           "${workspaceFolder}/packages/bun-uws/*",
-          "${workspaceFolder}/src/napi/*"
+          "${workspaceFolder}/src/napi/*",
         ],
         "limitSymbolsToIncludedHeaders": true,
-        "databaseFilename": ".vscode/cppdb"
+        "databaseFilename": ".vscode/cppdb",
       },
       "defines": [
         "STATICALLY_LINKED_WITH_JavaScriptCore=1",
@@ -44,22 +44,23 @@
         "BUILDING_JSCONLY__",
         "USE_FOUNDATION=1",
         "ASSERT_ENABLED=1",
-        "DU_DISABLE_RENAMING=1"
+        "DU_DISABLE_RENAMING=1",
       ],
       "macFrameworkPath": [],
       "compilerPath": "${workspaceFolder}/.vscode/clang++",
       "cStandard": "c17",
-      "cppStandard": "c++20"
+      "cppStandard": "c++20",
     },
     {
       "name": "BunWithJSCDebug",
       "forcedInclude": ["${workspaceFolder}/src/bun.js/bindings/root.h"],
       "includePath": [
-        "${workspaceFolder}/src/bun.js/WebKit/WebKitBuild/Debug/",
-        "${workspaceFolder}/src/bun.js/WebKit/WebKitBuild/Debug/ICU/Headers/",
-        "${workspaceFolder}/src/bun.js/WebKit/WebKitBuild/Debug/JavaScriptCore/PrivateHeaders/",
-        "${workspaceFolder}/src/bun.js/WebKit/WebKitBuild/Debug/WTF/Headers",
-        "${workspaceFolder}/src/bun.js/WebKit/WebKitBuild/Debug/bmalloc/Headers/",
+        "${workspaceFolder}/build/debug/codegen",
+        "${workspaceFolder}/vendor/WebKit/WebKitBuild/Debug/",
+        "${workspaceFolder}/vendor/WebKit/WebKitBuild/Debug/ICU/Headers/",
+        "${workspaceFolder}/vendor/WebKit/WebKitBuild/Debug/JavaScriptCore/PrivateHeaders/",
+        "${workspaceFolder}/vendor/WebKit/WebKitBuild/Debug/WTF/Headers",
+        "${workspaceFolder}/vendor/WebKit/WebKitBuild/Debug/bmalloc/Headers/",
         "${workspaceFolder}/src/bun.js/bindings/",
         "${workspaceFolder}/src/bun.js/bindings/webcore/",
         "${workspaceFolder}/src/bun.js/bindings/sqlite/",
@@ -67,19 +68,19 @@
         "${workspaceFolder}/src/bun.js/modules/",
         "${workspaceFolder}/src/js/builtins/",
         "${workspaceFolder}/src/js/out",
-        "${workspaceFolder}/src/deps/boringssl/include/",
-        "${workspaceFolder}/src/deps",
+        "${workspaceFolder}/vendor/boringssl/include/",
+        "${workspaceFolder}/vendor",
         "${workspaceFolder}/src/napi/*",
         "${workspaceFolder}/packages/bun-usockets/src",
-        "${workspaceFolder}/packages/"
+        "${workspaceFolder}/packages/",
       ],
       "browse": {
         "path": [
-          "${workspaceFolder}/src/bun.js/WebKit/WebKitBuild/Debug/",
-          "${workspaceFolder}/src/bun.js/WebKit/WebKitBuild/Debug/ICU/Headers/",
-          "${workspaceFolder}/src/bun.js/WebKit/WebKitBuild/Debug/JavaScriptCore/PrivateHeaders/**",
-          "${workspaceFolder}/src/bun.js/WebKit/WebKitBuild/Debug/WTF/Headers/**",
-          "${workspaceFolder}/src/bun.js/WebKit/WebKitBuild/Debug/bmalloc/Headers/**",
+          "${workspaceFolder}/vendor/WebKit/WebKitBuild/Debug/",
+          "${workspaceFolder}/vendor/WebKit/WebKitBuild/Debug/ICU/Headers/",
+          "${workspaceFolder}/vendor/WebKit/WebKitBuild/Debug/JavaScriptCore/PrivateHeaders/**",
+          "${workspaceFolder}/vendor/WebKit/WebKitBuild/Debug/WTF/Headers/**",
+          "${workspaceFolder}/vendor/WebKit/WebKitBuild/Debug/bmalloc/Headers/**",
           "${workspaceFolder}/src/bun.js/bindings/*",
           "${workspaceFolder}/src/bun.js/bindings/*",
           "${workspaceFolder}/src/napi/*",
@@ -89,14 +90,14 @@
           "${workspaceFolder}/src/js/builtins/*",
           "${workspaceFolder}/src/js/out/*",
           "${workspaceFolder}/src/bun.js/modules/*",
-          "${workspaceFolder}/src/deps",
-          "${workspaceFolder}/src/deps/boringssl/include/",
+          "${workspaceFolder}/vendor",
+          "${workspaceFolder}/vendor/boringssl/include/",
           "${workspaceFolder}/packages/bun-usockets/",
           "${workspaceFolder}/packages/bun-uws/",
-          "${workspaceFolder}/src/napi"
+          "${workspaceFolder}/src/napi",
         ],
         "limitSymbolsToIncludedHeaders": true,
-        "databaseFilename": ".vscode/cppdb_debug"
+        "databaseFilename": ".vscode/cppdb_debug",
       },
       "defines": [
         "STATICALLY_LINKED_WITH_JavaScriptCore=1",
@@ -107,13 +108,13 @@
         "BUILDING_JSCONLY__",
         "USE_FOUNDATION=1",
         "ASSERT_ENABLED=1",
-        "DU_DISABLE_RENAMING=1"
+        "DU_DISABLE_RENAMING=1",
       ],
       "macFrameworkPath": [],
       "compilerPath": "${workspaceFolder}/.vscode/clang++",
       "cStandard": "c17",
-      "cppStandard": "c++20"
-    }
+      "cppStandard": "c++20",
+    },
   ],
-  "version": 4
+  "version": 4,
 }

.vscode/extensions.json

@@ -11,7 +11,7 @@
 
     // JavaScript
     "oven.bun-vscode",
-    "biomejs.biome",
+    "esbenp.prettier-vscode",
 
     // TypeScript
     "better-ts-errors.better-ts-errors",
@@ -29,5 +29,5 @@
 
     // Other
     "bierner.comment-tagged-templates",
-  ]
+  ],
 }

.vscode/settings.json

@@ -12,8 +12,11 @@
   "search.exclude": {
     "node_modules": true,
     ".git": true,
-    "src/bun.js/WebKit": true,
-    "src/deps/*/**": true
+    "vendor/*/**": true,
+    "test/node.js/upstream": true,
+    // This will fill up your whole search history.
+    "test/js/node/test/fixtures": true,
+    "test/js/node/test/common": true,
   },
   "search.followSymlinks": false,
   "search.useIgnoreFiles": true,
@@ -24,82 +27,108 @@
   "git.ignoreLimitWarning": true,
 
   // Zig
-  "zig.initialSetupDone": true,
-  "zig.buildOnSave": false,
-  "zig.buildOption": "build",
-  "zig.buildFilePath": "${workspaceFolder}/build.zig",
-  "zig.path": "${workspaceFolder}/.cache/zig/zig.exe",
+  // "zig.initialSetupDone": true,
+  // "zig.buildOption": "build",
+  "zig.zls.zigLibPath": "${workspaceFolder}/vendor/zig/lib",
+  "zig.buildOnSaveArgs": [
+    "-Dgenerated-code=./build/debug/codegen",
+    "--watch",
+    "-fincremental"
+  ],
+  // "zig.zls.buildOnSaveStep": "check",
+  // "zig.zls.enableBuildOnSave": true,
+  // "zig.buildOnSave": true,
+  // "zig.buildFilePath": "${workspaceFolder}/build.zig",
+  "zig.path": "${workspaceFolder}/vendor/zig/zig.exe",
+  "zig.zls.path": "${workspaceFolder}/vendor/zig/zls.exe",
   "zig.formattingProvider": "zls",
-  "zig.zls.enableInlayHints": false,
+  // "zig.zls.enableInlayHints": false,
   "[zig]": {
     "editor.tabSize": 4,
     "editor.useTabStops": false,
-    "editor.defaultFormatter": "ziglang.vscode-zig"
+    "editor.defaultFormatter": "ziglang.vscode-zig",
+    "editor.codeActionsOnSave": {
+      "source.organizeImports": "never",
+    },
   },
 
+  // lldb
+  "lldb.launch.initCommands": ["command source ${workspaceFolder}/.lldbinit"],
+  "lldb.verboseLogging": false,
+
   // C++
-  "lldb.verboseLogging": false,
   "cmake.configureOnOpen": false,
-  "C_Cpp.errorSquiggles": "enabled",  
+  "C_Cpp.errorSquiggles": "enabled",
   "[cpp]": {
-    "editor.defaultFormatter": "xaver.clang-format"
+    "editor.tabSize": 4,
+    "editor.defaultFormatter": "xaver.clang-format",
   },
   "[c]": {
-    "editor.defaultFormatter": "xaver.clang-format"
+    "editor.tabSize": 4,
+    "editor.defaultFormatter": "xaver.clang-format",
   },
   "[h]": {
-    "editor.defaultFormatter": "xaver.clang-format"
+    "editor.tabSize": 4,
+    "editor.defaultFormatter": "xaver.clang-format",
   },
+  "clangd.arguments": ["--header-insertion=never"],
 
   // JavaScript
-  "prettier.enable": false,
+  "prettier.enable": true,
+  "prettier.configPath": ".prettierrc",
   "eslint.workingDirectories": ["${workspaceFolder}/packages/bun-types"],
   "[javascript]": {
-    "editor.defaultFormatter": "biomejs.biome",
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
   },
   "[javascriptreact]": {
-    "editor.defaultFormatter": "biomejs.biome"
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
   },
+  "prettier.prettierPath": "./node_modules/prettier",
 
   // TypeScript
-  "typescript.tsdk": "${workspaceFolder}/node_modules/typescript/lib",
+  "typescript.tsdk": "node_modules/typescript/lib",
   "[typescript]": {
-    "editor.defaultFormatter": "biomejs.biome"
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
   },
   "[typescriptreact]": {
-    "editor.defaultFormatter": "biomejs.biome"
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
   },
 
   // JSON
   "[json]": {
-    "editor.defaultFormatter": "biomejs.biome",
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
   },
   "[jsonc]": {
-    "editor.defaultFormatter": "biomejs.biome",
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
   },
-  
+
   // Markdown
   "[markdown]": {
-    "editor.defaultFormatter": "biomejs.biome",
-    "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.wordWrap": "on",
     "editor.quickSuggestions": {
       "comments": "off",
       "strings": "off",
-      "other": "off"
-    }
+      "other": "off",
+    },
   },
 
   // TOML
   "[toml]": {
-    "editor.defaultFormatter": "biomejs.biome",
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
   },
 
   // YAML
   "[yaml]": {
-    "editor.defaultFormatter": "biomejs.biome",
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+  },
+
+  // Docker
+  "[dockerfile]": {
+    "editor.formatOnSave": false,
   },
 
   // Files
@@ -112,141 +141,17 @@
     "**/Thumbs.db": true,
     "**/*.xcworkspacedata": true,
     "**/*.xcscheme": true,
-    "**/*.pem": true,
     "**/*.xcodeproj": true,
-    "src/bun.js/WebKit": true,
-    "src/deps/libarchive": true,
-    "src/deps/mimalloc": true,
-    "src/deps/s2n-tls": true,
-    "src/deps/boringssl": true,
-    "src/deps/openssl": true,
-    "src/deps/uws": true,
-    "src/deps/zlib": true,
-    "src/deps/lol-html": true,
-    "src/deps/c-ares": true,
-    "src/deps/tinycc": true,
-    "src/deps/zstd": true,
     "**/*.i": true,
-    "packages/bun-uws/fuzzing/seed-corpus/**/*": true
   },
   "files.associations": {
-    "*.lock": "yarnlock",
+    "*.css": "tailwindcss",
     "*.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",
+    "*.mdc": "markdown",
     "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"
+    "ios": "cpp",
+    "oxlint.json": "jsonc",
+    "bun.lock": "jsonc",
   },
   "C_Cpp.files.exclude": {
     "**/.vscode": true,
@@ -264,6 +169,8 @@
     "WebKit/WebCore": true,
     "WebKit/WebDriver": true,
     "WebKit/WebKitBuild": true,
-    "WebKit/WebInspectorUI": true
+    "WebKit/WebInspectorUI": true,
   },
+  "git.detectSubmodules": false,
+  "bun.test.customScript": "./build/debug/bun-debug test",
 }

.vscode/tasks.json

@@ -2,51 +2,58 @@
   "version": "2.0.0",
   "tasks": [
     {
-      "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"
+      "type": "shell",
+      "command": "bun run build",
+      "group": {
+        "kind": "build",
+        "isDefault": true,
       },
-      "options": {
-        "cwd": "${workspaceFolder}"
-      },
-      "isBuildCommand": true,
-      "runOptions": {
-        "instanceLimit": 1,
-        "reevaluateOnRerun": true,
+      "problemMatcher": [
+        {
+          "owner": "zig",
+          "fileLocation": ["relative", "${workspaceFolder}"],
+          "pattern": [
+            {
+              "regexp": "^(.+?):(\\d+):(\\d+): (error|warning|note): (.+)$",
+              "file": 1,
+              "line": 2,
+              "column": 3,
+              "severity": 4,
+              "message": 5,
+            },
+            {
+              "regexp": "^\\s+(.+)$",
+              "message": 1,
+              "loop": true,
+            },
+          ],
+        },
+        {
+          "owner": "clang",
+          "fileLocation": ["relative", "${workspaceFolder}"],
+          "pattern": [
+            {
+              "regexp": "^([^:]+):(\\d+):(\\d+):\\s+(warning|error|note|remark):\\s+(.*)$",
+              "file": 1,
+              "line": 2,
+              "column": 3,
+              "severity": 4,
+              "message": 5,
+            },
+            {
+              "regexp": "^\\s*(.*)$",
+              "message": 1,
+              "loop": true,
+            },
+          ],
+        },
+      ],
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared",
+        "clear": true,
       },
     },
-  ]
+  ],
 }

AGENTS.md

@@ -0,0 +1 @@
+CLAUDE.md

CLAUDE.md

@@ -0,0 +1,234 @@
+This is the Bun repository - an all-in-one JavaScript runtime & toolkit designed for speed, with a bundler, test runner, and Node.js-compatible package manager. It's written primarily in Zig with C++ for JavaScriptCore integration, powered by WebKit's JavaScriptCore engine.
+
+## Building and Running Bun
+
+### Build Commands
+
+- **Build Bun**: `bun bd`
+  - Creates a debug build at `./build/debug/bun-debug`
+  - **CRITICAL**: do not set a timeout when running `bun bd`
+- **Run tests with your debug build**: `bun bd test <test-file>`
+  - **CRITICAL**: Never use `bun test` directly - it won't include your changes
+- **Run any command with debug build**: `bun bd <command>`
+- **Run with JavaScript exception scope verification**: `BUN_JSC_validateExceptionChecks=1
+BUN_JSC_dumpSimulatedThrows=1 bun bd <command>`
+
+Tip: Bun is already installed and in $PATH. The `bd` subcommand is a package.json script.
+
+## Testing
+
+### Running Tests
+
+- **Single test file**: `bun bd test test/js/bun/http/serve.test.ts`
+- **Fuzzy match test file**: `bun bd test http/serve.test.ts`
+- **With filter**: `bun bd test test/js/bun/http/serve.test.ts -t "should handle"`
+
+### Test Organization
+
+If a test is for a specific numbered GitHub Issue, it should be placed in `test/regression/issue/${issueNumber}.test.ts`. Ensure the issue number is **REAL** and not a placeholder!
+
+If no valid issue number is provided, find the best existing file to modify instead, such as;
+
+- `test/js/bun/` - Bun-specific API tests (http, crypto, ffi, shell, etc.)
+- `test/js/node/` - Node.js compatibility tests
+- `test/js/web/` - Web API tests (fetch, WebSocket, streams, etc.)
+- `test/cli/` - CLI command tests (install, run, test, etc.)
+- `test/bundler/` - Bundler and transpiler tests. Use `itBundled` helper.
+- `test/integration/` - End-to-end integration tests
+- `test/napi/` - N-API compatibility tests
+- `test/v8/` - V8 C++ API compatibility tests
+
+### Writing Tests
+
+Tests use Bun's Jest-compatible test runner with proper test fixtures.
+
+- For **single-file tests**, prefer `-e` over `tempDir`.
+- For **multi-file tests**, prefer `tempDir` and `Bun.spawn`.
+
+```typescript
+import { test, expect } from "bun:test";
+import { bunEnv, bunExe, normalizeBunSnapshot, tempDir } from "harness";
+
+test("(single-file test) my feature", async () => {
+  await using proc = Bun.spawn({
+    cmd: [bunExe(), "-e", "console.log('Hello, world!')"],
+    env: bunEnv,
+  });
+
+  const [stdout, stderr, exitCode] = await Promise.all([
+    proc.stdout.text(),
+    proc.stderr.text(),
+    proc.exited,
+  ]);
+
+  expect(normalizeBunSnapshot(stdout)).toMatchInlineSnapshot(`"Hello, world!"`);
+  expect(exitCode).toBe(0);
+});
+
+test("(multi-file test) my feature", async () => {
+  // Create temp directory with test files
+  using dir = tempDir("test-prefix", {
+    "index.js": `import { foo } from "./foo.ts"; foo();`,
+    "foo.ts": `export function foo() { console.log("foo"); }`,
+  });
+
+  // Spawn Bun process
+  await using proc = Bun.spawn({
+    cmd: [bunExe(), "index.js"],
+    env: bunEnv,
+    cwd: String(dir),
+    stderr: "pipe",
+  });
+
+  const [stdout, stderr, exitCode] = await Promise.all([
+    proc.stdout.text(),
+    proc.stderr.text(),
+    proc.exited,
+  ]);
+
+  // Prefer snapshot tests over expect(stdout).toBe("hello\n");
+  expect(normalizeBunSnapshot(stdout, dir)).toMatchInlineSnapshot(`"hello"`);
+
+  // Assert the exit code last. This gives you a more useful error message on test failure.
+  expect(exitCode).toBe(0);
+});
+```
+
+- Always use `port: 0`. Do not hardcode ports. Do not use your own random port number function.
+- Use `normalizeBunSnapshot` to normalize snapshot output of the test.
+- NEVER write tests that check for no "panic" or "uncaught exception" or similar in the test output. These tests will never fail in CI.
+- Use `tempDir` from `"harness"` to create a temporary directory. **Do not** use `tmpdirSync` or `fs.mkdtempSync` to create temporary directories.
+- When spawning processes, tests should expect(stdout).toBe(...) BEFORE expect(exitCode).toBe(0). This gives you a more useful error message on test failure.
+- **CRITICAL**: Do not write flaky tests. Do not use `setTimeout` in tests. Instead, `await` the condition to be met. You are not testing the TIME PASSING, you are testing the CONDITION.
+- **CRITICAL**: Verify your test fails with `USE_SYSTEM_BUN=1 bun test <file>` and passes with `bun bd test <file>`. Your test is NOT VALID if it passes with `USE_SYSTEM_BUN=1`.
+
+## Code Architecture
+
+### Language Structure
+
+- **Zig code** (`src/*.zig`): Core runtime, JavaScript bindings, package manager
+- **C++ code** (`src/bun.js/bindings/*.cpp`): JavaScriptCore bindings, Web APIs
+- **TypeScript** (`src/js/`): Built-in JavaScript modules with special syntax (see JavaScript Modules section)
+- **Generated code**: Many files are auto-generated from `.classes.ts` and other sources. Bun will automatically rebuild these files when you make changes to them.
+
+### Core Source Organization
+
+#### Runtime Core (`src/`)
+
+- `bun.zig` - Main entry point
+- `cli.zig` - CLI command orchestration
+- `js_parser.zig`, `js_lexer.zig`, `js_printer.zig` - JavaScript parsing/printing
+- `transpiler.zig` - Wrapper around js_parser with sourcemap support
+- `resolver/` - Module resolution system
+- `allocators/` - Custom memory allocators for performance
+
+#### JavaScript Runtime (`src/bun.js/`)
+
+- `bindings/` - C++ JavaScriptCore bindings
+  - Generated classes from `.classes.ts` files
+  - Manual bindings for complex APIs
+- `api/` - Bun-specific APIs
+  - `server.zig` - HTTP server implementation
+  - `FFI.zig` - Foreign Function Interface
+  - `crypto.zig` - Cryptographic operations
+  - `glob.zig` - File pattern matching
+- `node/` - Node.js compatibility layer
+  - Module implementations (fs, path, crypto, etc.)
+  - Process and Buffer APIs
+- `webcore/` - Web API implementations
+  - `fetch.zig` - Fetch API
+  - `streams.zig` - Web Streams
+  - `Blob.zig`, `Response.zig`, `Request.zig`
+- `event_loop/` - Event loop and task management
+
+#### Build Tools & Package Manager
+
+- `src/bundler/` - JavaScript bundler
+  - Advanced tree-shaking
+  - CSS processing
+  - HTML handling
+- `src/install/` - Package manager
+  - `lockfile/` - Lockfile handling
+  - `npm.zig` - npm registry client
+  - `lifecycle_script_runner.zig` - Package scripts
+
+#### Other Key Components
+
+- `src/shell/` - Cross-platform shell implementation
+- `src/css/` - CSS parser and processor
+- `src/http/` - HTTP client implementation
+  - `websocket_client/` - WebSocket client (including deflate support)
+- `src/sql/` - SQL database integrations
+- `src/bake/` - Server-side rendering framework
+
+### JavaScript Class Implementation (C++)
+
+When implementing JavaScript classes in C++:
+
+1. Create three classes if there's a public constructor:
+   - `class Foo : public JSC::JSDestructibleObject` (if has C++ fields)
+   - `class FooPrototype : public JSC::JSNonFinalObject`
+   - `class FooConstructor : public JSC::InternalFunction`
+
+2. Define properties using HashTableValue arrays
+3. Add iso subspaces for classes with C++ fields
+4. Cache structures in ZigGlobalObject
+
+### Code Generation
+
+Code generation happens automatically as part of the build process. The main scripts are:
+
+- `src/codegen/generate-classes.ts` - Generates Zig & C++ bindings from `*.classes.ts` files
+- `src/codegen/generate-jssink.ts` - Generates stream-related classes
+- `src/codegen/bundle-modules.ts` - Bundles built-in modules like `node:fs`
+- `src/codegen/bundle-functions.ts` - Bundles global functions like `ReadableStream`
+
+In development, bundled modules can be reloaded without rebuilding Zig by running `bun run build`.
+
+## JavaScript Modules (`src/js/`)
+
+Built-in JavaScript modules use special syntax and are organized as:
+
+- `node/` - Node.js compatibility modules (`node:fs`, `node:path`, etc.)
+- `bun/` - Bun-specific modules (`bun:ffi`, `bun:sqlite`, etc.)
+- `thirdparty/` - NPM modules we replace (like `ws`)
+- `internal/` - Internal modules not exposed to users
+- `builtins/` - Core JavaScript builtins (streams, console, etc.)
+
+## Important Development Notes
+
+1. **Never use `bun test` or `bun <file>` directly** - always use `bun bd test` or `bun bd <command>`. `bun bd` compiles & runs the debug build.
+2. **All changes must be tested** - if you're not testing your changes, you're not done.
+3. **Get your tests to pass**. If you didn't run the tests, your code does not work.
+4. **Follow existing code style** - check neighboring files for patterns
+5. **Create tests in the right folder** in `test/` and the test must end in `.test.ts` or `.test.tsx`
+6. **Use absolute paths** - Always use absolute paths in file operations
+7. **Avoid shell commands** - Don't use `find` or `grep` in tests; use Bun's Glob and built-in tools
+8. **Memory management** - In Zig code, be careful with allocators and use defer for cleanup
+9. **Cross-platform** - Run `bun run zig:check-all` to compile the Zig code on all platforms when making platform-specific changes
+10. **Debug builds** - Use `BUN_DEBUG_QUIET_LOGS=1` to disable debug logging, or `BUN_DEBUG_<scopeName>=1` to enable specific `Output.scoped(.${scopeName}, .visible)`s
+11. **Be humble & honest** - NEVER overstate what you got done or what actually works in commits, PRs or in messages to the user.
+12. **Branch names must start with `claude/`** - This is a requirement for the CI to work.
+
+**ONLY** push up changes after running `bun bd test <file>` and ensuring your tests pass.
+
+## Debugging CI Failures
+
+Use `scripts/buildkite-failures.ts` to fetch and analyze CI build failures:
+
+```bash
+# View failures for current branch
+bun run scripts/buildkite-failures.ts
+
+# View failures for a specific build number
+bun run scripts/buildkite-failures.ts 35051
+
+# View failures for a GitHub PR
+bun run scripts/buildkite-failures.ts #26173
+bun run scripts/buildkite-failures.ts https://github.com/oven-sh/bun/pull/26173
+
+# Wait for build to complete (polls every 10s until pass/fail)
+bun run scripts/buildkite-failures.ts --wait
+```
+
+The script fetches logs from BuildKite's public API and saves complete logs to `/tmp/bun-build-{number}-{platform}-{step}.log`. It displays a summary of errors and the file path for each failed job. Use `--wait` to poll continuously until the build completes or fails.

CONTRIBUTING.md

@@ -1,76 +1,356 @@
-# Contributing to Bun
+Configuring a development environment for Bun can take 10-30 minutes depending on your internet connection and computer speed. You will need ~10GB of free disk space for the repository and build artifacts.
 
-> **Important:** All contributions need test coverage. If you are adding a new feature, please add a test. If you are fixing a bug, please add a test that fails before your fix and passes after your fix.
+If you are using Windows, please refer to [this guide](https://bun.com/docs/project/building-windows)
 
-## Bun's codebase
+## Using Nix (Alternative)
 
-Bun is written mostly in Zig, but WebKit & JavaScriptCore (the JavaScript engine) is written in C++.
+A Nix flake is provided as an alternative to manual dependency installation:
 
-Today (February 2023), Bun's codebase has five distinct parts:
+```bash
+nix develop
+# or explicitly use the pure shell
+# nix develop .#pure
+export CMAKE_SYSTEM_PROCESSOR=$(uname -m)
+bun bd
+```
 
-- JavaScript, JSX, & TypeScript transpiler, module resolver, and related code
-- JavaScript runtime ([`src/bun.js/`](src/bun.js/))
-- JavaScript runtime bindings ([`src/bun.js/bindings/**/*.cpp`](src/bun.js/bindings/))
-- Package manager ([`src/install/`](src/install/))
-- Shared utilities ([`src/string_immutable.zig`](src/string_immutable.zig))
+This provides all dependencies in an isolated, reproducible environment without requiring sudo.
 
-The JavaScript transpiler & module resolver is mostly independent from the runtime. It predates the runtime and is entirely in Zig. The JavaScript parser is mostly in [`src/js_parser.zig`](src/js_parser.zig). The JavaScript AST data structures are mostly in [`src/js_ast.zig`](src/js_ast.zig). The JavaScript lexer is in [`src/js_lexer.zig`](src/js_lexer.zig). A lot of this code started as a port of esbuild's equivalent code from Go to Zig, but has had many small changes since then.
+## Install Dependencies (Manual)
 
-## Getting started
+Using your system's package manager, install Bun's dependencies:
 
-Please refer to [Bun's Development Guide](https://bun.sh/docs/project/contributing) to get your dev environment setup!
+{% codetabs group="os" %}
 
-## Memory management in Bun
+```bash#macOS (Homebrew)
+$ brew install automake ccache cmake coreutils gnu-sed go icu4c libiconv libtool ninja pkg-config rust ruby
+```
 
-For the Zig code, please:
+```bash#Ubuntu/Debian
+$ sudo apt install curl wget lsb-release software-properties-common cargo cmake git golang libtool ninja-build pkg-config rustc ruby-full xz-utils
+```
 
-1. Do your best to avoid dynamically allocating memory.
-2. If we need to allocate memory, carefully consider the owner of that memory. If it's a JavaScript object, it will need a finalizer. If it's in Zig, it will need to be freed either via an arena or manually.
-3. Prefer arenas over manual memory management. Manually freeing memory is leak & crash prone.
-4. If the memory needs to be accessed across threads, use `bun.default_allocator`. Mimalloc threadlocal heaps are not safe to free across threads.
+```bash#Arch
+$ sudo pacman -S base-devel cmake git go libiconv libtool make ninja pkg-config python rust sed unzip ruby
+```
 
-The JavaScript transpiler has special-handling for memory management. The parser allocates into a single arena and the memory is recycled after each parse.
+```bash#Fedora
+$ sudo dnf install cargo clang19 llvm19 lld19 cmake git golang libtool ninja-build pkg-config rustc ruby libatomic-static libstdc++-static sed unzip which libicu-devel 'perl(Math::BigInt)'
+```
 
-## JavaScript runtime
+```bash#openSUSE Tumbleweed
+$ sudo zypper install go cmake ninja automake git icu rustup && rustup toolchain install stable
+```
 
-Most of Bun's JavaScript runtime code lives in [`src/bun.js`](src/bun.js).
+{% /codetabs %}
 
-### Calling C++ from Zig & Zig from C++
+> **Note**: The Zig compiler is automatically installed and updated by the build scripts. Manual installation is not required.
 
-TODO: document this (see [`bindings.zig`](src/bun.js/bindings/bindings.zig) and [`bindings.cpp`](src/bun.js/bindings/bindings.cpp) for now)
+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.
 
-### Adding a new JavaScript class
+{% codetabs %}
 
-1. Add a new file in [`src/bun.js/*.classes.ts`](src/bun.js) to define the instance and static methods for the class.
-2. Add a new file in [`src/bun.js/**/*.zig`](src/bun.js) and expose the struct in [`src/bun.js/generated_classes_list.zig`](src/bun.js/generated_classes_list.zig)
-3. Run `make codegen`
+```bash#Native
+$ curl -fsSL https://bun.com/install | bash
+```
 
-Copy from examples like `Subprocess` or `Response`.
+```bash#npm
+$ npm install -g bun
+```
 
-### ESM Modules and Builtins JS
+```bash#Homebrew
+$ brew tap oven-sh/bun
+$ brew install bun
+```
 
-Bun implements ESM modules in a mix of native code and JavaScript.
+{% /codetabs %}
 
-Several Node.js modules are implemented in JavaScript and loosely based on browserify polyfills.
+### Optional: Install `ccache`
 
-Builtin modules in Bun are located in [`src/js`](src/js/). These files are transpiled and support a JavaScriptCore-only syntax for internal slots, which is explained further in [`src/js/README.md`](src/js/README.md).
+ccache is used to cache compilation artifacts, significantly speeding up builds:
 
-Native C++ modules are in `src/bun.js/modules/`.
+```bash
+# For macOS
+$ brew install ccache
 
-The module loader is in [`src/bun.js/module_loader.zig`](src/bun.js/module_loader.zig).
+# For Ubuntu/Debian
+$ sudo apt install ccache
 
-### Memory management in Bun's JavaScript runtime
+# For Arch
+$ sudo pacman -S ccache
 
-TODO: fill this out (for now, use `JSC.Strong` in most cases)
+# For Fedora
+$ sudo dnf install ccache
 
-### Strings
+# For openSUSE
+$ sudo zypper install ccache
+```
 
-TODO: fill this out (for now, use `JSValue.toSlice()` in most cases)
+Our build scripts will automatically detect and use `ccache` if available. You can check cache statistics with `ccache --show-stats`.
 
-#### JavaScriptCore C API
+## Install LLVM
 
-Do not copy from examples leveraging the JavaScriptCore C API. Please do not use this in new code. We will not accept PRs that add new code that uses the JavaScriptCore C API.
+Bun requires LLVM 19 (`clang` is part of LLVM). This version requirement is to match WebKit (precompiled), as mismatching versions will cause memory allocation failures at runtime. In most cases, you can install LLVM through your system package manager:
 
-## Testing
+{% codetabs group="os" %}
 
-See [`test/README.md`](test/README.md) for information on how to run tests.
+```bash#macOS (Homebrew)
+$ brew install llvm@19
+```
+
+```bash#Ubuntu/Debian
+$ # LLVM has an automatic installation script that is compatible with all versions of Ubuntu
+$ wget https://apt.llvm.org/llvm.sh -O - | sudo bash -s -- 19 all
+```
+
+```bash#Arch
+$ sudo pacman -S llvm clang lld
+```
+
+```bash#Fedora
+$ sudo dnf install llvm clang lld-devel
+```
+
+```bash#openSUSE Tumbleweed
+$ sudo zypper install clang19 lld19 llvm19
+```
+
+{% /codetabs %}
+
+If none of the above solutions apply, you will have to install it [manually](https://github.com/llvm/llvm-project/releases/tag/llvmorg-19.1.7).
+
+Make sure Clang/LLVM 19 is in your path:
+
+```bash
+$ which clang-19
+```
+
+If not, run this to manually add it:
+
+{% codetabs group="os" %}
+
+```bash#macOS (Homebrew)
+# use fish_add_path if you're using fish
+# use path+="$(brew --prefix llvm@19)/bin" if you are using zsh
+$ export PATH="$(brew --prefix llvm@19)/bin:$PATH"
+```
+
+```bash#Arch
+# use fish_add_path if you're using fish
+$ export PATH="$PATH:/usr/lib/llvm19/bin"
+```
+
+{% /codetabs %}
+
+> ⚠️ Ubuntu distributions (<= 20.04) 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 build. This may take a while as it will clone submodules and build dependencies.
+
+```bash
+$ bun run build
+```
+
+The binary will be located at `./build/debug/bun-debug`. It is recommended to add this to your `$PATH`. To verify the build worked, let's print the version number on the development build of Bun.
+
+```bash
+$ build/debug/bun-debug --version
+x.y.z_debug
+```
+
+## 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 `./vendor/zig/zig.exe`. The filename is `zig.exe` so that it works as expected on Windows, but it still works on macOS/Linux (it just has a surprising file extension).
+
+We recommend adding `./build/debug` to your `$PATH` so that you can run `bun-debug` in your terminal:
+
+```sh
+$ bun-debug
+```
+
+## Running debug builds
+
+The `bd` package.json script compiles and runs a debug build of Bun, only printing the output of the build process if it fails.
+
+```sh
+$ bun bd <args>
+$ bun bd test foo.test.ts
+$ bun bd ./foo.ts
+```
+
+Bun generally takes about 2.5 minutes to compile a debug build when there are Zig changes. If your development workflow is "change one line, save, rebuild", you will spend too much time waiting for the build to finish. Instead:
+
+- Batch up your changes
+- Ensure zls is running with incremental watching for LSP errors (if you use VSCode and install Zig and run `bun run build` once to download Zig, this should just work)
+- Prefer using the debugger ("CodeLLDB" in VSCode) to step through the code.
+- Use debug logs. `BUN_DEBUG_<scope>=1` will enable debug logging for the corresponding `Output.scoped(.<scope>, .hidden)` logs. You can also set `BUN_DEBUG_QUIET_LOGS=1` to disable all debug logging that isn't explicitly enabled. To dump debug logs into a file, `BUN_DEBUG=<path-to-file>.log`. Debug logs are aggressively removed in release builds.
+- src/js/\*\*.ts changes are pretty much instant to rebuild. C++ changes are a bit slower, but still much faster than the Zig code (Zig is one compilation unit, C++ is many).
+
+## Code generation scripts
+
+Several code generation scripts are used during Bun's build process. These are run automatically when changes are made to certain files.
+
+In particular, these are:
+
+- `./src/codegen/generate-jssink.ts` -- Generates `build/debug/codegen/JSSink.cpp`, `build/debug/codegen/JSSink.h` which implement various classes for interfacing with `ReadableStream`. This is internally how `FileSink`, `ArrayBufferSink`, `"type": "direct"` streams and other code related to streams works.
+- `./src/codegen/generate-classes.ts` -- Generates `build/debug/codegen/ZigGeneratedClasses*`, which generates Zig & C++ bindings for JavaScriptCore classes implemented in Zig. In `**/*.classes.ts` files, we define the interfaces for various classes, methods, prototypes, getters/setters etc which the code generator reads to generate boilerplate code implementing the JavaScript objects in C++ and wiring them up to Zig
+- `./src/codegen/cppbind.ts` -- Generates automatic Zig bindings for C++ functions marked with `[[ZIG_EXPORT]]` attributes.
+- `./src/codegen/bundle-modules.ts` -- Bundles built-in modules like `node:fs`, `bun:ffi` into files we can include in the final binary. In development, these can be reloaded without rebuilding Zig (you still need to run `bun run build`, but it re-reads the transpiled files from disk afterwards). In release builds, these are embedded into the binary.
+- `./src/codegen/bundle-functions.ts` -- Bundles globally-accessible functions implemented in JavaScript/TypeScript like `ReadableStream`, `WritableStream`, and a handful more. These are used similarly to the builtin modules, but the output more closely aligns with what WebKit/Safari does for Safari's built-in functions so that we can copy-paste the implementations from WebKit as a starting point.
+
+## Modifying ESM modules
+
+Certain modules like `node:fs`, `node:stream`, `bun:sqlite`, and `ws` are implemented in JavaScript. These live in `src/js/{node,bun,thirdparty}` files and are pre-bundled using Bun.
+
+## Release build
+
+To compile a release build of Bun, run:
+
+```bash
+$ bun run build:release
+```
+
+The binary will be located at `./build/release/bun` and `./build/release/bun-profile`.
+
+### Download release build from pull requests
+
+To save you time spent building a release build locally, we provide a way to run release builds from pull requests. This is useful for manually testing changes in a release build before they are merged.
+
+To run a release build from a pull request, you can use the `bun-pr` npm package:
+
+```sh
+bunx bun-pr <pr-number>
+bunx bun-pr <branch-name>
+bunx bun-pr "https://github.com/oven-sh/bun/pull/1234566"
+bunx bun-pr --asan <pr-number> # Linux x64 only
+```
+
+This will download the release build from the pull request and add it to `$PATH` as `bun-${pr-number}`. You can then run the build with `bun-${pr-number}`.
+
+```sh
+bun-1234566 --version
+```
+
+This works by downloading the release build from the GitHub Actions artifacts on the linked pull request. You may need the `gh` CLI installed to authenticate with GitHub.
+
+## AddressSanitizer
+
+[AddressSanitizer](https://en.wikipedia.org/wiki/AddressSanitizer) helps find memory issues, and is enabled by default in debug builds of Bun on Linux and macOS. This includes the Zig code and all dependencies. It makes the Zig code take about 2x longer to build, if that's stopping you from being productive you can disable it by setting `-Denable_asan=$<IF:$<BOOL:${ENABLE_ASAN}>,true,false>` to `-Denable_asan=false` in the `cmake/targets/BuildBun.cmake` file, but generally we recommend batching your changes up between builds.
+
+To build a release build with Address Sanitizer, run:
+
+```bash
+$ bun run build:release:asan
+```
+
+In CI, we run our test suite with at least one target that is built with Address Sanitizer.
+
+## Building WebKit locally + Debug mode of JSC
+
+WebKit is not cloned by default (to save time and disk space). To clone and build WebKit locally, run:
+
+```bash
+# Clone WebKit into ./vendor/WebKit
+$ git clone https://github.com/oven-sh/WebKit vendor/WebKit
+
+# Check out the commit hash specified in `set(WEBKIT_VERSION <commit_hash>)` in cmake/tools/SetupWebKit.cmake
+$ git -C vendor/WebKit checkout <commit_hash>
+
+# Build bun with the local JSC build — this automatically configures and builds JSC
+$ bun run build:local
+```
+
+`bun run build:local` handles everything: configuring JSC, building JSC, and building Bun. On subsequent runs, JSC will incrementally rebuild if any WebKit sources changed. `ninja -Cbuild/debug-local` also works after the first build, and will build Bun+JSC.
+
+The build output goes to `./build/debug-local` (instead of `./build/debug`), so you'll need to update a couple of places:
+
+- The first line in [`src/js/builtins.d.ts`](/src/js/builtins.d.ts)
+- The `CompilationDatabase` line in [`.clangd` config](/.clangd) should be `CompilationDatabase: build/debug-local`
+- In [`build.zig`](/build.zig), the `codegen_path` option should be `build/debug-local/codegen` (instead of `build/debug/codegen`)
+- In [`.vscode/launch.json`](/.vscode/launch.json), many configurations use `./build/debug/`, change them as you see fit
+
+Note that the WebKit folder, including build artifacts, is 8GB+ in size.
+
+If you are using a JSC debug build and using VScode, make sure to run the `C/C++: Select a Configuration` command to configure intellisense to find the debug headers.
+
+Note that if you make changes to our [WebKit fork](https://github.com/oven-sh/WebKit), you will also have to change [`SetupWebKit.cmake`](/cmake/tools/SetupWebKit.cmake) to point to the commit hash.
+
+## Troubleshooting
+
+### 'span' file not found on Ubuntu
+
+> ⚠️ Please note that the instructions below are specific to issues occurring on Ubuntu. It is unlikely that the same issues will occur on other Linux distributions.
+
+The Clang compiler typically uses the `libstdc++` C++ standard library by default. `libstdc++` is the default C++ Standard Library implementation provided by the GNU Compiler Collection (GCC). While Clang may link against the `libc++` library, this requires explicitly providing the `-stdlib` flag when running Clang.
+
+Bun relies on C++20 features like `std::span`, which are not available in GCC versions lower than 11. GCC 10 doesn't have all of the C++20 features implemented. As a result, running `make setup` may fail with the following error:
+
+```
+fatal error: 'span' file not found
+#include <span>
+         ^~~~~~
+```
+
+The issue may manifest when initially running `bun setup` as Clang being unable to compile a simple program:
+
+```
+The C++ compiler
+
+  "/usr/bin/clang++-19"
+
+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
+$ sudo apt update
+$ sudo apt install gcc-11 g++-11
+# If the above command fails with `Unable to locate package gcc-11` we need
+# to add the APT repository
+$ sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
+# Now run `apt install` again
+$ sudo apt install gcc-11 g++-11
+```
+
+Now, we need to set GCC 11 as the default compiler:
+
+```bash
+$ sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-11 100
+$ sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-11 100
+```
+
+### libarchive
+
+If you see an error on macOS when compiling `libarchive`, run:
+
+```bash
+$ brew install pkg-config
+```
+
+### macOS `library not found for -lSystem`
+
+If you see this error when compiling, run:
+
+```bash
+$ xcode-select --install
+```
+
+### Cannot find `libatomic.a`
+
+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
+$ bun run build -DUSE_STATIC_LIBATOMIC=OFF
+```
+
+The built version of Bun may not work on other systems if compiled this way.
+
+## Using bun-debug
+
+- Disable logging: `BUN_DEBUG_QUIET_LOGS=1 bun-debug ...` (to disable all debug logging)
+- Enable logging for a specific zig scope: `BUN_DEBUG_EventLoop=1 bun-debug ...` (to allow `std.log.scoped(.EventLoop)`)
+- Bun transpiles every file it runs, to see the actual executed source in a debug build find it in `/tmp/bun-debug-src/...path/to/file`, for example the transpiled version of `/home/bun/index.ts` would be in `/tmp/bun-debug-src/home/bun/index.ts`

Dockerfile

@@ -1,551 +0,0 @@
-# This Dockerfile is used by CI workflows to build Bun. It is not intended as a development
-# environment, or to be used as a base image for other projects.
-#
-# You likely want this image instead: https://hub.docker.com/r/oven/bun
-#
-# TODO: move this file to reduce confusion
-ARG DEBIAN_FRONTEND=noninteractive
-ARG GITHUB_WORKSPACE=/build
-ARG WEBKIT_DIR=${GITHUB_WORKSPACE}/bun-webkit 
-ARG BUN_RELEASE_DIR=${GITHUB_WORKSPACE}/bun-release
-ARG BUN_DEPS_OUT_DIR=${GITHUB_WORKSPACE}/bun-deps
-ARG BUN_DIR=${GITHUB_WORKSPACE}/bun
-ARG CPU_TARGET=native
-ARG ARCH=x86_64
-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_DOWNLOAD_URL_BASE="https://pub-5e11e972747a44bf9aaf9394f185a982.r2.dev/releases/${BUN_VERSION}"
-ARG CANARY=0
-ARG ASSERTIONS=OFF
-ARG ZIG_OPTIMIZE=ReleaseFast
-ARG CMAKE_BUILD_TYPE=Release
-
-ARG NODE_VERSION="20"
-ARG LLVM_VERSION="16"
-ARG ZIG_VERSION="0.12.0-dev.1828+225fe6ddb"
-
-ARG SCCACHE_BUCKET
-ARG SCCACHE_REGION
-ARG SCCACHE_S3_USE_SSL
-ARG SCCACHE_ENDPOINT
-ARG AWS_ACCESS_KEY_ID
-ARG AWS_SECRET_ACCESS_KEY
-
-FROM bitnami/minideb:bullseye as bun-base
-
-ARG BUN_DOWNLOAD_URL_BASE
-ARG DEBIAN_FRONTEND
-ARG BUN_VERSION
-ARG NODE_VERSION
-ARG LLVM_VERSION
-ARG BUILD_MACHINE_ARCH
-ARG BUN_DIR
-ARG BUN_DEPS_OUT_DIR
-ARG CPU_TARGET
-
-ENV CI 1
-ENV CPU_TARGET=${CPU_TARGET}
-ENV BUILDARCH=${BUILDARCH}
-ENV BUN_DEPS_OUT_DIR=${BUN_DEPS_OUT_DIR}
-
-ENV CXX=clang++-16
-ENV CC=clang-16
-ENV AR=/usr/bin/llvm-ar-16
-ENV LD=lld-16
-
-ENV SCCACHE_BUCKET=${SCCACHE_BUCKET}
-ENV SCCACHE_REGION=${SCCACHE_REGION}
-ENV SCCACHE_S3_USE_SSL=${SCCACHE_S3_USE_SSL}
-ENV SCCACHE_ENDPOINT=${SCCACHE_ENDPOINT}
-ENV AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID}
-ENV AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY}
-
-RUN apt-get update -y \
-  && install_packages \
-  ca-certificates \
-  curl \
-  gnupg \
-  && echo "deb https://apt.llvm.org/bullseye/ llvm-toolchain-bullseye-${LLVM_VERSION} main" > /etc/apt/sources.list.d/llvm.list \
-  && echo "deb-src https://apt.llvm.org/bullseye/ llvm-toolchain-bullseye-${LLVM_VERSION} main" >> /etc/apt/sources.list.d/llvm.list \
-  && curl -fsSL "https://apt.llvm.org/llvm-snapshot.gpg.key" | apt-key add - \
-  && echo "deb https://deb.nodesource.com/node_${NODE_VERSION}.x nodistro main" > /etc/apt/sources.list.d/nodesource.list \
-  && curl -fsSL "https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key" | apt-key add - \
-  && echo "deb https://apt.kitware.com/ubuntu/ focal main" > /etc/apt/sources.list.d/kitware.list \
-  && curl -fsSL "https://apt.kitware.com/keys/kitware-archive-latest.asc" | apt-key add - \
-  && install_packages \
-  wget \
-  bash \
-  software-properties-common \
-  build-essential \
-  autoconf \
-  automake \
-  libtool \
-  pkg-config \
-  clang-${LLVM_VERSION} \
-  lld-${LLVM_VERSION} \
-  lldb-${LLVM_VERSION} \
-  clangd-${LLVM_VERSION} \
-  make \
-  cmake \
-  ninja-build \
-  file \
-  libc-dev \
-  libxml2 \
-  libxml2-dev \
-  xz-utils \
-  git \
-  tar \
-  rsync \
-  gzip \
-  unzip \
-  perl \
-  python3 \
-  ruby \
-  golang \
-  nodejs \
-  && ln -s /usr/bin/clang-${LLVM_VERSION} /usr/bin/clang \
-  && ln -s /usr/bin/clang++-${LLVM_VERSION} /usr/bin/clang++ \
-  && ln -s /usr/bin/lld-${LLVM_VERSION} /usr/bin/lld \
-  && ln -s /usr/bin/lldb-${LLVM_VERSION} /usr/bin/lldb \
-  && ln -s /usr/bin/clangd-${LLVM_VERSION} /usr/bin/clangd \
-  && ln -s /usr/bin/llvm-ar-${LLVM_VERSION} /usr/bin/llvm-ar \
-  && arch="$(dpkg --print-architecture)" \
-  && case "${arch##*-}" in \
-  amd64) variant="x64";; \
-  arm64) variant="aarch64";; \
-  *) echo "error: unsupported architecture: $arch"; exit 1 ;; \
-  esac \
-  && wget "${BUN_DOWNLOAD_URL_BASE}/bun-linux-${variant}.zip" \
-  && unzip bun-linux-${variant}.zip \
-  && mv bun-linux-${variant}/bun /usr/bin/bun \
-  && ln -s /usr/bin/bun /usr/bin/bunx \
-  && rm -rf bun-linux-${variant} bun-linux-${variant}.zip \
-  && mkdir -p ${BUN_DIR} ${BUN_DEPS_OUT_DIR}
-# && if [ -n "${SCCACHE_BUCKET}" ]; then \
-#   echo "Setting up sccache" \
-#   && wget https://github.com/mozilla/sccache/releases/download/v0.5.4/sccache-v0.5.4-${BUILD_MACHINE_ARCH}-unknown-linux-musl.tar.gz \
-#   && tar xf sccache-v0.5.4-${BUILD_MACHINE_ARCH}-unknown-linux-musl.tar.gz \
-#   && mv sccache-v0.5.4-${BUILD_MACHINE_ARCH}-unknown-linux-musl/sccache /usr/bin/sccache \
-#   && rm -rf sccache-v0.5.4-${BUILD_MACHINE_ARCH}-unknown-linux-musl.tar.gz sccache-v0.5.4-${BUILD_MACHINE_ARCH}-unknown-linux-musl \
-
-FROM bun-base as bun-base-with-zig
-
-ARG ZIG_VERSION
-ARG BUILD_MACHINE_ARCH
-ARG ZIG_FOLDERNAME=zig-linux-${BUILD_MACHINE_ARCH}-${ZIG_VERSION}
-ARG ZIG_FILENAME=${ZIG_FOLDERNAME}.tar.xz
-ARG ZIG_URL="https://ziglang.org/builds/${ZIG_FILENAME}"
-
-WORKDIR $GITHUB_WORKSPACE
-
-ADD $ZIG_URL .
-RUN tar xf ${ZIG_FILENAME} \
-  && mv ${ZIG_FOLDERNAME}/lib /usr/lib/zig \
-  && mv ${ZIG_FOLDERNAME}/zig /usr/bin/zig \
-  && rm -rf ${ZIG_FILENAME} ${ZIG_FOLDERNAME}
-
-FROM bun-base as c-ares
-
-ARG BUN_DIR
-ARG CPU_TARGET
-ENV CPU_TARGET=${CPU_TARGET}
-ENV CCACHE_DIR=/ccache
-
-COPY Makefile ${BUN_DIR}/Makefile
-COPY src/deps/c-ares ${BUN_DIR}/src/deps/c-ares
-
-WORKDIR $BUN_DIR
-
-RUN --mount=type=cache,target=/ccache cd $BUN_DIR && make c-ares && rm -rf ${BUN_DIR}/src/deps/c-ares ${BUN_DIR}/Makefile
-
-FROM bun-base as lolhtml
-
-RUN curl https://sh.rustup.rs -sSf | sh -s -- -y
-
-ARG BUN_DIR
-ARG CPU_TARGET
-ENV CPU_TARGET=${CPU_TARGET}
-
-COPY Makefile ${BUN_DIR}/Makefile
-COPY src/deps/lol-html ${BUN_DIR}/src/deps/lol-html
-
-ENV CCACHE_DIR=/ccache
-
-RUN --mount=type=cache,target=/ccache export PATH=$PATH:$HOME/.cargo/bin && cd ${BUN_DIR} && \
-  make lolhtml && rm -rf src/deps/lol-html Makefile
-
-FROM bun-base as mimalloc
-
-ARG BUN_DIR
-ARG CPU_TARGET
-ARG ASSERTIONS
-ENV CPU_TARGET=${CPU_TARGET}
-
-COPY Makefile ${BUN_DIR}/Makefile
-COPY src/deps/mimalloc ${BUN_DIR}/src/deps/mimalloc
-
-ENV CCACHE_DIR=/ccache
-
-RUN --mount=type=cache,target=/ccache cd ${BUN_DIR} && \ 
-  make mimalloc && rm -rf src/deps/mimalloc Makefile;
-
-FROM bun-base as mimalloc-debug
-
-ARG BUN_DIR
-ARG CPU_TARGET
-ARG ASSERTIONS
-ENV CPU_TARGET=${CPU_TARGET}
-
-COPY Makefile ${BUN_DIR}/Makefile
-COPY src/deps/mimalloc ${BUN_DIR}/src/deps/mimalloc
-
-ENV CCACHE_DIR=/ccache
-
-RUN --mount=type=cache,target=/ccache cd ${BUN_DIR} && \ 
-  make mimalloc-debug && rm -rf src/deps/mimalloc Makefile;
-
-FROM bun-base as zlib
-
-ARG BUN_DIR
-ARG CPU_TARGET
-ENV CPU_TARGET=${CPU_TARGET}
-ENV CCACHE_DIR=/ccache
-
-COPY Makefile ${BUN_DIR}/Makefile
-COPY src/deps/zlib ${BUN_DIR}/src/deps/zlib
-
-WORKDIR $BUN_DIR
-
-RUN --mount=type=cache,target=/ccache cd $BUN_DIR && \
-  make zlib && rm -rf src/deps/zlib Makefile
-
-FROM bun-base as libarchive
-
-ARG BUN_DIR
-ARG CPU_TARGET
-ENV CPU_TARGET=${CPU_TARGET}
-ENV CCACHE_DIR=/ccache
-
-RUN install_packages autoconf automake libtool pkg-config 
-
-COPY Makefile ${BUN_DIR}/Makefile
-COPY src/deps/libarchive ${BUN_DIR}/src/deps/libarchive
-
-WORKDIR $BUN_DIR
-
-RUN --mount=type=cache,target=/ccache cd $BUN_DIR && \
-  make libarchive && rm -rf src/deps/libarchive Makefile
-
-FROM bun-base as tinycc
-
-ARG BUN_DEPS_OUT_DIR
-ARG BUN_DIR
-ARG CPU_TARGET
-ENV CPU_TARGET=${CPU_TARGET}
-
-RUN install_packages libtcc-dev && cp /usr/lib/$(uname -m)-linux-gnu/libtcc.a ${BUN_DEPS_OUT_DIR}
-
-FROM bun-base as boringssl
-
-RUN install_packages golang
-
-ARG BUN_DIR
-ARG CPU_TARGET
-ENV CPU_TARGET=${CPU_TARGET}
-
-COPY Makefile ${BUN_DIR}/Makefile
-COPY src/deps/boringssl ${BUN_DIR}/src/deps/boringssl
-
-WORKDIR $BUN_DIR
-
-ENV CCACHE_DIR=/ccache
-
-RUN --mount=type=cache,target=/ccache cd ${BUN_DIR} && make boringssl && rm -rf src/deps/boringssl Makefile
-
-FROM bun-base as base64
-
-ARG BUN_DIR
-ARG CPU_TARGET
-ENV CPU_TARGET=${CPU_TARGET}
-
-COPY Makefile ${BUN_DIR}/Makefile
-COPY src/deps/base64 ${BUN_DIR}/src/deps/base64
-
-WORKDIR $BUN_DIR
-
-RUN cd $BUN_DIR && \
-  make base64 && rm -rf src/deps/base64 Makefile
-
-FROM bun-base as zstd
-
-ARG BUN_DIR
-
-ARG CPU_TARGET
-ENV CPU_TARGET=${CPU_TARGET}
-
-ENV CCACHE_DIR=/ccache
-
-COPY Makefile ${BUN_DIR}/Makefile
-COPY src/deps/zstd ${BUN_DIR}/src/deps/zstd
-
-WORKDIR $BUN_DIR
-
-RUN --mount=type=cache,target=/ccache cd $BUN_DIR && make zstd
-
-FROM bun-base as ls-hpack
-
-ARG BUN_DIR
-
-ARG CPU_TARGET
-ENV CPU_TARGET=${CPU_TARGET}
-
-ENV CCACHE_DIR=/ccache
-
-COPY Makefile ${BUN_DIR}/Makefile
-COPY src/deps/ls-hpack ${BUN_DIR}/src/deps/ls-hpack
-
-WORKDIR $BUN_DIR
-
-RUN --mount=type=cache,target=/ccache cd $BUN_DIR && make lshpack
-
-FROM bun-base-with-zig as bun-identifier-cache
-
-ARG DEBIAN_FRONTEND
-ARG GITHUB_WORKSPACE
-ARG CPU_TARGET
-ARG BUN_DIR
-ENV CPU_TARGET=${CPU_TARGET}
-
-WORKDIR $BUN_DIR
-
-COPY src/js_lexer/identifier_data.zig ${BUN_DIR}/src/js_lexer/identifier_data.zig
-COPY src/js_lexer/identifier_cache.zig ${BUN_DIR}/src/js_lexer/identifier_cache.zig
-
-RUN cd $BUN_DIR \
-  && zig run src/js_lexer/identifier_data.zig \
-  && rm -rf zig-cache
-
-FROM bun-base as bun-node-fallbacks
-
-ARG BUN_DIR
-
-WORKDIR $BUN_DIR
-
-COPY src/node-fallbacks ${BUN_DIR}/src/node-fallbacks
-
-RUN cd $BUN_DIR/src/node-fallbacks \
-  && bun install --frozen-lockfile \
-  && bun run build \
-  && rm -rf src/node-fallbacks/node_modules
-
-FROM bun-base as bun-webkit
-
-ARG BUILDARCH
-ARG ASSERTIONS
-
-COPY CMakeLists.txt ${BUN_DIR}/CMakeLists.txt
-
-RUN mkdir ${BUN_DIR}/bun-webkit \
-  && WEBKIT_TAG=$(grep 'set(WEBKIT_TAG' "${BUN_DIR}/CMakeLists.txt" | awk '{print $2}' | cut -f 1 -d ')') \
-  && WEBKIT_SUFFIX=$(if [ "${ASSERTIONS}" = "ON" ]; then echo "debug"; else echo "lto"; fi) \
-  && WEBKIT_URL="https://github.com/oven-sh/WebKit/releases/download/autobuild-${WEBKIT_TAG}/bun-webkit-linux-${BUILDARCH}-${WEBKIT_SUFFIX}.tar.gz" \
-  && echo "Downloading ${WEBKIT_URL}" \
-  && curl -fsSL "${WEBKIT_URL}" | tar -xz -C ${BUN_DIR}/bun-webkit --strip-components=1
-
-FROM bun-base as bun-cpp-objects
-
-ARG CANARY
-ARG ASSERTIONS
-
-COPY --from=bun-webkit ${BUN_DIR}/bun-webkit ${BUN_DIR}/bun-webkit
-
-COPY packages ${BUN_DIR}/packages
-COPY src ${BUN_DIR}/src
-COPY CMakeLists.txt ${BUN_DIR}/CMakeLists.txt
-COPY src/deps/boringssl/include ${BUN_DIR}/src/deps/boringssl/include
-
-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 \
-  && bash compile-cpp-only.sh -v
-
-FROM bun-base-with-zig as bun-codegen-for-zig
-
-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
-COPY src/fallback.ts ${BUN_DIR}/src/fallback.ts
-COPY src/api ${BUN_DIR}/src/api
-
-WORKDIR $BUN_DIR
-
-# TODO: move away from Makefile entirely
-RUN bun install --frozen-lockfile \
-  && make runtime_js fallback_decoder bun_error \
-  && rm -rf src/runtime src/fallback.ts node_modules bun.lockb package.json Makefile
-
-FROM bun-base-with-zig as bun-compile-zig-obj
-
-ARG ZIG_PATH
-ARG TRIPLET
-ARG GIT_SHA
-ARG CPU_TARGET
-ARG CANARY=0
-ARG ASSERTIONS=OFF
-ARG ZIG_OPTIMIZE=ReleaseFast
-
-COPY *.zig package.json CMakeLists.txt ${BUN_DIR}/
-COPY completions ${BUN_DIR}/completions
-COPY packages ${BUN_DIR}/packages
-COPY src ${BUN_DIR}/src
-
-COPY --from=bun-identifier-cache ${BUN_DIR}/src/js_lexer/*.blob ${BUN_DIR}/src/js_lexer/
-COPY --from=bun-node-fallbacks ${BUN_DIR}/src/node-fallbacks/out ${BUN_DIR}/src/node-fallbacks/out
-COPY --from=bun-codegen-for-zig ${BUN_DIR}/src/*.out.js ${BUN_DIR}/src/*.out.refresh.js ${BUN_DIR}/src/
-COPY --from=bun-codegen-for-zig ${BUN_DIR}/packages/bun-error/dist ${BUN_DIR}/packages/bun-error/dist
-
-WORKDIR $BUN_DIR
-
-RUN mkdir -p build \
-  && bun run $BUN_DIR/src/codegen/bundle-modules-fast.ts $BUN_DIR/build \
-  && cd build \
-  && cmake .. \
-  -G Ninja \
-  -DCMAKE_BUILD_TYPE=Release \
-  -DZIG_OPTIMIZE="${ZIG_OPTIMIZE}" \
-  -DCPU_TARGET="${CPU_TARGET}" \
-  -DZIG_TARGET="${TRIPLET}" \
-  -DWEBKIT_DIR="omit" \
-  -DNO_CONFIGURE_DEPENDS=1 \
-  -DNO_CODEGEN=1 \
-  -DBUN_ZIG_OBJ="/tmp/bun-zig.o" \
-  -DCANARY="${CANARY}" \
-  -DZIG_COMPILER=system \
-  && ONLY_ZIG=1 ninja "/tmp/bun-zig.o" -v
-
-FROM scratch as build_release_obj
-
-ARG CPU_TARGET
-ENV CPU_TARGET=${CPU_TARGET}
-
-COPY --from=bun-compile-zig-obj /tmp/bun-zig.o /
-
-FROM bun-base as bun-link
-
-ARG CPU_TARGET
-ARG CANARY
-ARG ASSERTIONS
-
-ENV CPU_TARGET=${CPU_TARGET}
-
-WORKDIR $BUN_DIR
-
-RUN mkdir -p build bun-webkit
-
-# lol
-COPY src/bun.js/bindings/sqlite/sqlite3.c ${BUN_DIR}/src/bun.js/bindings/sqlite/sqlite3.c
-
-COPY src/symbols.dyn src/linker.lds ${BUN_DIR}/src/
-
-COPY CMakeLists.txt ${BUN_DIR}/CMakeLists.txt
-COPY --from=zlib ${BUN_DEPS_OUT_DIR}/* ${BUN_DEPS_OUT_DIR}/
-COPY --from=base64 ${BUN_DEPS_OUT_DIR}/* ${BUN_DEPS_OUT_DIR}/
-COPY --from=libarchive ${BUN_DEPS_OUT_DIR}/* ${BUN_DEPS_OUT_DIR}/
-COPY --from=boringssl ${BUN_DEPS_OUT_DIR}/* ${BUN_DEPS_OUT_DIR}/
-COPY --from=lolhtml ${BUN_DEPS_OUT_DIR}/* ${BUN_DEPS_OUT_DIR}/
-COPY --from=mimalloc ${BUN_DEPS_OUT_DIR}/* ${BUN_DEPS_OUT_DIR}/
-COPY --from=zstd ${BUN_DEPS_OUT_DIR}/*  ${BUN_DEPS_OUT_DIR}/
-COPY --from=tinycc ${BUN_DEPS_OUT_DIR}/* ${BUN_DEPS_OUT_DIR}/
-COPY --from=c-ares ${BUN_DEPS_OUT_DIR}/* ${BUN_DEPS_OUT_DIR}/
-COPY --from=ls-hpack ${BUN_DEPS_OUT_DIR}/* ${BUN_DEPS_OUT_DIR}/
-COPY --from=bun-compile-zig-obj /tmp/bun-zig.o ${BUN_DIR}/build/bun-zig.o
-COPY --from=bun-cpp-objects ${BUN_DIR}/build/bun-cpp-objects.a ${BUN_DIR}/build/bun-cpp-objects.a
-COPY --from=bun-cpp-objects ${BUN_DIR}/bun-webkit/lib ${BUN_DIR}/bun-webkit/lib
-
-WORKDIR $BUN_DIR/build
-
-RUN cmake .. \
-  -G Ninja \
-  -DCMAKE_BUILD_TYPE=Release \
-  -DBUN_LINK_ONLY=1 \
-  -DBUN_ZIG_OBJ="${BUN_DIR}/build/bun-zig.o" \
-  -DUSE_DEBUG_JSC=${ASSERTIONS} \
-  -DBUN_CPP_ARCHIVE="${BUN_DIR}/build/bun-cpp-objects.a" \
-  -DWEBKIT_DIR="${BUN_DIR}/bun-webkit" \
-  -DBUN_DEPS_OUT_DIR="${BUN_DEPS_OUT_DIR}" \
-  -DCPU_TARGET="${CPU_TARGET}" \
-  -DNO_CONFIGURE_DEPENDS=1 \
-  -DCANARY="${CANARY}" \
-  -DZIG_COMPILER=system \
-  && ninja -v \
-  && ./bun --revision \
-  && mkdir -p /build/out \
-  && mv bun bun-profile /build/out \
-  && rm -rf ${BUN_DIR} ${BUN_DEPS_OUT_DIR}
-
-FROM scratch as artifact
-
-COPY --from=bun-link /build/out /
-
-FROM bun-base as bun-link-assertions
-
-ARG CPU_TARGET
-ARG CANARY
-ARG ASSERTIONS
-
-ENV CPU_TARGET=${CPU_TARGET}
-
-WORKDIR $BUN_DIR
-
-RUN mkdir -p build bun-webkit
-
-# lol
-COPY src/bun.js/bindings/sqlite/sqlite3.c ${BUN_DIR}/src/bun.js/bindings/sqlite/sqlite3.c
-
-COPY src/symbols.dyn src/linker.lds ${BUN_DIR}/src/
-
-COPY CMakeLists.txt ${BUN_DIR}/CMakeLists.txt
-COPY --from=zlib ${BUN_DEPS_OUT_DIR}/* ${BUN_DEPS_OUT_DIR}/
-COPY --from=base64 ${BUN_DEPS_OUT_DIR}/* ${BUN_DEPS_OUT_DIR}/
-COPY --from=libarchive ${BUN_DEPS_OUT_DIR}/* ${BUN_DEPS_OUT_DIR}/
-COPY --from=boringssl ${BUN_DEPS_OUT_DIR}/* ${BUN_DEPS_OUT_DIR}/
-COPY --from=lolhtml ${BUN_DEPS_OUT_DIR}/* ${BUN_DEPS_OUT_DIR}/
-COPY --from=mimalloc-debug ${BUN_DEPS_OUT_DIR}/* ${BUN_DEPS_OUT_DIR}/
-COPY --from=zstd ${BUN_DEPS_OUT_DIR}/*  ${BUN_DEPS_OUT_DIR}/
-COPY --from=tinycc ${BUN_DEPS_OUT_DIR}/* ${BUN_DEPS_OUT_DIR}/
-COPY --from=c-ares ${BUN_DEPS_OUT_DIR}/* ${BUN_DEPS_OUT_DIR}/
-COPY --from=bun-compile-zig-obj /tmp/bun-zig.o ${BUN_DIR}/build/bun-zig.o
-COPY --from=bun-cpp-objects ${BUN_DIR}/build/bun-cpp-objects.a ${BUN_DIR}/build/bun-cpp-objects.a
-COPY --from=bun-cpp-objects ${BUN_DIR}/bun-webkit/lib ${BUN_DIR}/bun-webkit/lib
-
-WORKDIR $BUN_DIR/build
-
-RUN cmake .. \
-  -G Ninja \
-  -DCMAKE_BUILD_TYPE=Release \
-  -DBUN_LINK_ONLY=1 \
-  -DBUN_ZIG_OBJ="${BUN_DIR}/build/bun-zig.o" \
-  -DUSE_DEBUG_JSC=ON \
-  -DBUN_CPP_ARCHIVE="${BUN_DIR}/build/bun-cpp-objects.a" \
-  -DWEBKIT_DIR="${BUN_DIR}/bun-webkit" \
-  -DBUN_DEPS_OUT_DIR="${BUN_DEPS_OUT_DIR}" \
-  -DCPU_TARGET="${CPU_TARGET}" \
-  -DNO_CONFIGURE_DEPENDS=1 \
-  -DCANARY="${CANARY}" \
-  -DZIG_COMPILER=system \
-  && ninja -v \
-  && ./bun --revision \
-  && mkdir -p /build/out \
-  && mv bun bun-profile /build/out \
-  && rm -rf ${BUN_DIR} ${BUN_DEPS_OUT_DIR}
-
-FROM scratch as artifact-assertions
-
-COPY --from=bun-link-assertions /build/out /

LATEST

@@ -0,0 +1 @@
+1.3.8

LICENSE.md

@@ -0,0 +1,74 @@
+Bun itself is MIT-licensed.
+
+## JavaScriptCore
+
+Bun statically links JavaScriptCore (and WebKit) which is LGPL-2 licensed. WebCore files from WebKit are also licensed under LGPL2. Per LGPL2:
+
+> (1) If you statically link against an LGPL’d library, you must also provide your application in an object (not necessarily source) format, so that a user has the opportunity to modify the library and relink the application.
+
+You can find the patched version of WebKit used by Bun here: <https://github.com/oven-sh/webkit>. If you would like to relink Bun with changes:
+
+- `git submodule update --init --recursive`
+- `make jsc`
+- `zig build`
+
+This compiles JavaScriptCore, compiles Bun’s `.cpp` bindings for JavaScriptCore (which are the object files using JavaScriptCore) and outputs a new `bun` binary with your changes.
+
+## Linked libraries
+
+Bun statically links these libraries:
+
+| Library | License |
+|---------|---------|
+| [`boringssl`](https://boringssl.googlesource.com/boringssl/) | [several licenses](https://boringssl.googlesource.com/boringssl/+/refs/heads/master/LICENSE) |
+| [`brotli`](https://github.com/google/brotli) | MIT |
+| [`libarchive`](https://github.com/libarchive/libarchive) | [several licenses](https://github.com/libarchive/libarchive/blob/master/COPYING) |
+| [`lol-html`](https://github.com/cloudflare/lol-html/tree/master/c-api) | BSD 3-Clause |
+| [`mimalloc`](https://github.com/microsoft/mimalloc) | MIT |
+| [`picohttp`](https://github.com/h2o/picohttpparser) | dual-licensed under the Perl License or the MIT License |
+| [`zstd`](https://github.com/facebook/zstd) | dual-licensed under the BSD License or GPLv2 license |
+| [`simdutf`](https://github.com/simdutf/simdutf) | Apache 2.0 |
+| [`tinycc`](https://github.com/tinycc/tinycc) | LGPL v2.1 |
+| [`uSockets`](https://github.com/uNetworking/uSockets) | Apache 2.0 |
+| [`zlib-cloudflare`](https://github.com/cloudflare/zlib) | zlib |
+| [`c-ares`](https://github.com/c-ares/c-ares) | MIT licensed |
+| [`libicu`](https://github.com/unicode-org/icu) 72 | [license here](https://github.com/unicode-org/icu/blob/main/icu4c/LICENSE) |
+| [`libbase64`](https://github.com/aklomp/base64/blob/master/LICENSE) | BSD 2-Clause |
+| [`libuv`](https://github.com/libuv/libuv) (on Windows) | MIT |
+| [`libdeflate`](https://github.com/ebiggers/libdeflate) | MIT |
+| [`uucode`](https://github.com/jacobsandlund/uucode) | MIT |
+| A fork of [`uWebsockets`](https://github.com/jarred-sumner/uwebsockets) | Apache 2.0 licensed |
+| Parts of [Tigerbeetle's IO code](https://github.com/tigerbeetle/tigerbeetle/blob/532c8b70b9142c17e07737ab6d3da68d7500cbca/src/io/windows.zig#L1) | Apache 2.0 licensed |
+
+## Polyfills
+
+For compatibility reasons, the following packages are embedded into Bun's binary and injected if imported.
+
+| Package | License |
+|---------|---------|
+| [`assert`](https://npmjs.com/package/assert) | MIT |
+| [`browserify-zlib`](https://npmjs.com/package/browserify-zlib) | MIT |
+| [`buffer`](https://npmjs.com/package/buffer) | MIT |
+| [`constants-browserify`](https://npmjs.com/package/constants-browserify) | MIT |
+| [`crypto-browserify`](https://npmjs.com/package/crypto-browserify) | MIT |
+| [`domain-browser`](https://npmjs.com/package/domain-browser) | MIT |
+| [`events`](https://npmjs.com/package/events) | MIT |
+| [`https-browserify`](https://npmjs.com/package/https-browserify) | MIT |
+| [`os-browserify`](https://npmjs.com/package/os-browserify) | MIT |
+| [`path-browserify`](https://npmjs.com/package/path-browserify) | MIT |
+| [`process`](https://npmjs.com/package/process) | MIT |
+| [`punycode`](https://npmjs.com/package/punycode) | MIT |
+| [`querystring-es3`](https://npmjs.com/package/querystring-es3) | MIT |
+| [`stream-browserify`](https://npmjs.com/package/stream-browserify) | MIT |
+| [`stream-http`](https://npmjs.com/package/stream-http) | MIT |
+| [`string_decoder`](https://npmjs.com/package/string_decoder) | MIT |
+| [`timers-browserify`](https://npmjs.com/package/timers-browserify) | MIT |
+| [`tty-browserify`](https://npmjs.com/package/tty-browserify) | MIT |
+| [`url`](https://npmjs.com/package/url) | MIT |
+| [`util`](https://npmjs.com/package/util) | MIT |
+| [`vm-browserify`](https://npmjs.com/package/vm-browserify) | MIT |
+
+## Additional credits
+
+- Bun's JS transpiler, CSS lexer, and Node.js module resolver source code is a Zig port of [@evanw](https://github.com/evanw)’s [esbuild](https://github.com/evanw/esbuild) project.
+- Credit to [@kipply](https://github.com/kipply) for the name "Bun"!

README.md

@@ -1,16 +1,16 @@
 <p align="center">
-  <a href="https://bun.sh"><img src="https://user-images.githubusercontent.com/709451/182802334-d9c42afe-f35d-4a7b-86ea-9985f73f20c3.png" alt="Logo" height=170></a>
+  <a href="https://bun.com"><img src="https://github.com/user-attachments/assets/50282090-adfd-4ddb-9e27-c30753c6b161" alt="Logo" height=170></a>
 </p>
 <h1 align="center">Bun</h1>
 
 <p align="center">
-<a href="https://bun.sh/discord" target="_blank"><img height=20 src="https://img.shields.io/discord/876711213126520882" /></a>
+<a href="https://bun.com/discord" target="_blank"><img height=20 src="https://img.shields.io/discord/876711213126520882" /></a>
 <img src="https://img.shields.io/github/stars/oven-sh/bun" alt="stars">
 <a href="https://twitter.com/jarredsumner/status/1542824445810642946"><img src="https://img.shields.io/static/v1?label=speed&message=fast&color=success" alt="Bun speed" /></a>
 </p>
 
 <div align="center">
-  <a href="https://bun.sh/docs">Documentation</a>
+  <a href="https://bun.com/docs">Documentation</a>
   <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
   <a href="https://discord.com/invite/CXdq2DP29u">Discord</a>
   <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
@@ -20,40 +20,41 @@
   <br />
 </div>
 
-### [Read the docs →](https://bun.sh/docs)
+### [Read the docs →](https://bun.com/docs)
 
 ## 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 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.
+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.
 
 ```bash
 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
 ```
 
 ## Install
 
-Bun supports Linux (x64 & arm64) and macOS (x64 & Apple Silicon).
+Bun supports Linux (x64 & arm64), macOS (x64 & Apple Silicon) and Windows (x64).
 
 > **Linux users** — Kernel version 5.6 or higher is strongly recommended, but the minimum is 5.1.
->
-> **Windows users** — Bun does not currently provide a native Windows build. We're working on this; progress can be tracked at [this issue](https://github.com/oven-sh/bun/issues/43). In the meantime, use one of the installation methods below for Windows Subsystem for Linux.
+
+> **x64 users** — if you see "illegal instruction" or similar errors, check our [CPU requirements](https://bun.com/docs/installation#cpu-requirements-and-baseline-builds)
 
 ```sh
 # with install script (recommended)
-curl -fsSL https://bun.sh/install | bash
+curl -fsSL https://bun.com/install | bash
+
+# on windows
+powershell -c "irm bun.sh/install.ps1 | iex"
 
 # with npm
 npm install -g bun
@@ -86,50 +87,329 @@ bun upgrade --canary
 ## Quick links
 
 - Intro
-  - [What is Bun?](https://bun.sh/docs/index)
-  - [Installation](https://bun.sh/docs/installation)
-  - [Quickstart](https://bun.sh/docs/quickstart)
+  - [What is Bun?](https://bun.com/docs/index)
+  - [Installation](https://bun.com/docs/installation)
+  - [Quickstart](https://bun.com/docs/quickstart)
+  - [TypeScript](https://bun.com/docs/typescript)
+
+- Templating
+  - [`bun init`](https://bun.com/docs/cli/init)
+  - [`bun create`](https://bun.com/docs/cli/bun-create)
+
 - CLI
-  - [`bun run`](https://bun.sh/docs/cli/run)
-  - [`bun install`](https://bun.sh/docs/cli/install)
-  - [`bun test`](https://bun.sh/docs/cli/test)
-  - [`bun init`](https://bun.sh/docs/cli/init)
-  - [`bun create`](https://bun.sh/docs/cli/bun-create)
-  - [`bunx`](https://bun.sh/docs/cli/bunx)
+  - [`bun upgrade`](https://bun.com/docs/cli/bun-upgrade)
+
 - Runtime
-  - [Runtime](https://bun.sh/docs/runtime/index)
-  - [Module resolution](https://bun.sh/docs/runtime/modules)
-  - [Hot &amp; live reloading](https://bun.sh/docs/runtime/hot)
-  - [Plugins](https://bun.sh/docs/bundler/plugins)
-- Ecosystem
-  - [Node.js](https://bun.sh/docs/ecosystem/nodejs)
-  - [TypeScript](https://bun.sh/docs/ecosystem/typescript)
-  - [React](https://bun.sh/docs/ecosystem/react)
-  - [Elysia](https://bun.sh/docs/ecosystem/elysia)
-  - [Hono](https://bun.sh/docs/ecosystem/hono)
-  - [Express](https://bun.sh/docs/ecosystem/express)
-  - [awesome-bun](https://github.com/apvarun/awesome-bun)
+  - [`bun run`](https://bun.com/docs/cli/run)
+  - [File types (Loaders)](https://bun.com/docs/runtime/loaders)
+  - [TypeScript](https://bun.com/docs/runtime/typescript)
+  - [JSX](https://bun.com/docs/runtime/jsx)
+  - [Environment variables](https://bun.com/docs/runtime/environment-variables)
+  - [Bun APIs](https://bun.com/docs/runtime/bun-apis)
+  - [Web APIs](https://bun.com/docs/runtime/web-apis)
+  - [Node.js compatibility](https://bun.com/docs/runtime/nodejs-compat)
+  - [Single-file executable](https://bun.com/docs/bundler/executables)
+  - [Plugins](https://bun.com/docs/runtime/plugins)
+  - [Watch mode / Hot Reloading](https://bun.com/docs/runtime/watch-mode)
+  - [Module resolution](https://bun.com/docs/runtime/modules)
+  - [Auto-install](https://bun.com/docs/runtime/autoimport)
+  - [bunfig.toml](https://bun.com/docs/runtime/bunfig)
+  - [Debugger](https://bun.com/docs/runtime/debugger)
+  - [$ Shell](https://bun.com/docs/runtime/shell)
+
+- Package manager
+  - [`bun install`](https://bun.com/docs/cli/install)
+  - [`bun add`](https://bun.com/docs/cli/add)
+  - [`bun remove`](https://bun.com/docs/cli/remove)
+  - [`bun update`](https://bun.com/docs/cli/update)
+  - [`bun link`](https://bun.com/docs/cli/link)
+  - [`bun unlink`](https://bun.com/docs/cli/unlink)
+  - [`bun pm`](https://bun.com/docs/cli/pm)
+  - [`bun outdated`](https://bun.com/docs/cli/outdated)
+  - [`bun publish`](https://bun.com/docs/cli/publish)
+  - [`bun patch`](https://bun.com/docs/install/patch)
+  - [`bun patch-commit`](https://bun.com/docs/cli/patch-commit)
+  - [Global cache](https://bun.com/docs/install/cache)
+  - [Workspaces](https://bun.com/docs/install/workspaces)
+  - [Lifecycle scripts](https://bun.com/docs/install/lifecycle)
+  - [Filter](https://bun.com/docs/cli/filter)
+  - [Lockfile](https://bun.com/docs/install/lockfile)
+  - [Scopes and registries](https://bun.com/docs/install/registries)
+  - [Overrides and resolutions](https://bun.com/docs/install/overrides)
+  - [`.npmrc`](https://bun.com/docs/install/npmrc)
+
+- Bundler
+  - [`Bun.build`](https://bun.com/docs/bundler)
+  - [Loaders](https://bun.com/docs/bundler/loaders)
+  - [Plugins](https://bun.com/docs/bundler/plugins)
+  - [Macros](https://bun.com/docs/bundler/macros)
+  - [vs esbuild](https://bun.com/docs/bundler/vs-esbuild)
+  - [Single-file executable](https://bun.com/docs/bundler/executables)
+  - [CSS](https://bun.com/docs/bundler/css)
+  - [HTML](https://bun.com/docs/bundler/html)
+  - [Hot Module Replacement (HMR)](https://bun.com/docs/bundler/hmr)
+  - [Full-stack with HTML imports](https://bun.com/docs/bundler/fullstack)
+
+- Test runner
+  - [`bun test`](https://bun.com/docs/cli/test)
+  - [Writing tests](https://bun.com/docs/test/writing)
+  - [Watch mode](https://bun.com/docs/test/hot)
+  - [Lifecycle hooks](https://bun.com/docs/test/lifecycle)
+  - [Mocks](https://bun.com/docs/test/mocks)
+  - [Snapshots](https://bun.com/docs/test/snapshots)
+  - [Dates and times](https://bun.com/docs/test/time)
+  - [DOM testing](https://bun.com/docs/test/dom)
+  - [Code coverage](https://bun.com/docs/test/coverage)
+  - [Configuration](https://bun.com/docs/test/configuration)
+  - [Discovery](https://bun.com/docs/test/discovery)
+  - [Reporters](https://bun.com/docs/test/reporters)
+  - [Runtime Behavior](https://bun.com/docs/test/runtime-behavior)
+
+- Package runner
+  - [`bunx`](https://bun.com/docs/cli/bunx)
+
 - API
-  - [HTTP](https://bun.sh/docs/api/http)
-  - [WebSockets](https://bun.sh/docs/api/websockets)
-  - [TCP Sockets](https://bun.sh/docs/api/tcp)
-  - [File I/O](https://bun.sh/docs/api/file-io)
-  - [SQLite](https://bun.sh/docs/api/sqlite)
-  - [FileSystemRouter](https://bun.sh/docs/api/file-system-router)
-  - [Globals](https://bun.sh/docs/api/globals)
-  - [Spawn](https://bun.sh/docs/api/spawn)
-  - [Transpiler](https://bun.sh/docs/api/transpiler)
-  - [Console](https://bun.sh/docs/api/console)
-  - [FFI](https://bun.sh/docs/api/ffi)
-  - [HTMLRewriter](https://bun.sh/docs/api/html-rewriter)
-  - [Testing](https://bun.sh/docs/api/test)
-  - [Utils](https://bun.sh/docs/api/utils)
-  - [Node-API](https://bun.sh/docs/api/node-api)
+  - [HTTP server (`Bun.serve`)](https://bun.com/docs/api/http)
+  - [WebSockets](https://bun.com/docs/api/websockets)
+  - [Workers](https://bun.com/docs/api/workers)
+  - [Binary data](https://bun.com/docs/api/binary-data)
+  - [Streams](https://bun.com/docs/api/streams)
+  - [File I/O (`Bun.file`)](https://bun.com/docs/api/file-io)
+  - [import.meta](https://bun.com/docs/api/import-meta)
+  - [SQLite (`bun:sqlite`)](https://bun.com/docs/api/sqlite)
+  - [PostgreSQL (`Bun.sql`)](https://bun.com/docs/api/sql)
+  - [Redis (`Bun.redis`)](https://bun.com/docs/api/redis)
+  - [S3 Client (`Bun.s3`)](https://bun.com/docs/api/s3)
+  - [FileSystemRouter](https://bun.com/docs/api/file-system-router)
+  - [TCP sockets](https://bun.com/docs/api/tcp)
+  - [UDP sockets](https://bun.com/docs/api/udp)
+  - [Globals](https://bun.com/docs/api/globals)
+  - [$ Shell](https://bun.com/docs/runtime/shell)
+  - [Child processes (spawn)](https://bun.com/docs/api/spawn)
+  - [Transpiler (`Bun.Transpiler`)](https://bun.com/docs/api/transpiler)
+  - [Hashing](https://bun.com/docs/api/hashing)
+  - [Colors (`Bun.color`)](https://bun.com/docs/api/color)
+  - [Console](https://bun.com/docs/api/console)
+  - [FFI (`bun:ffi`)](https://bun.com/docs/api/ffi)
+  - [C Compiler (`bun:ffi` cc)](https://bun.com/docs/api/cc)
+  - [HTMLRewriter](https://bun.com/docs/api/html-rewriter)
+  - [Testing (`bun:test`)](https://bun.com/docs/api/test)
+  - [Cookies (`Bun.Cookie`)](https://bun.com/docs/api/cookie)
+  - [Utils](https://bun.com/docs/api/utils)
+  - [Node-API](https://bun.com/docs/api/node-api)
+  - [Glob (`Bun.Glob`)](https://bun.com/docs/api/glob)
+  - [Semver (`Bun.semver`)](https://bun.com/docs/api/semver)
+  - [DNS](https://bun.com/docs/api/dns)
+  - [fetch API extensions](https://bun.com/docs/api/fetch)
+
+## Guides
+
+- Binary
+  - [Convert a Blob to a string](https://bun.com/guides/binary/blob-to-string)
+  - [Convert a Buffer to a blob](https://bun.com/guides/binary/buffer-to-blob)
+  - [Convert a Blob to a DataView](https://bun.com/guides/binary/blob-to-dataview)
+  - [Convert a Buffer to a string](https://bun.com/guides/binary/buffer-to-string)
+  - [Convert a Blob to a ReadableStream](https://bun.com/guides/binary/blob-to-stream)
+  - [Convert a Blob to a Uint8Array](https://bun.com/guides/binary/blob-to-typedarray)
+  - [Convert a DataView to a string](https://bun.com/guides/binary/dataview-to-string)
+  - [Convert a Uint8Array to a Blob](https://bun.com/guides/binary/typedarray-to-blob)
+  - [Convert a Blob to an ArrayBuffer](https://bun.com/guides/binary/blob-to-arraybuffer)
+  - [Convert an ArrayBuffer to a Blob](https://bun.com/guides/binary/arraybuffer-to-blob)
+  - [Convert a Buffer to a Uint8Array](https://bun.com/guides/binary/buffer-to-typedarray)
+  - [Convert a Uint8Array to a Buffer](https://bun.com/guides/binary/typedarray-to-buffer)
+  - [Convert a Uint8Array to a string](https://bun.com/guides/binary/typedarray-to-string)
+  - [Convert a Buffer to an ArrayBuffer](https://bun.com/guides/binary/buffer-to-arraybuffer)
+  - [Convert an ArrayBuffer to a Buffer](https://bun.com/guides/binary/arraybuffer-to-buffer)
+  - [Convert an ArrayBuffer to a string](https://bun.com/guides/binary/arraybuffer-to-string)
+  - [Convert a Uint8Array to a DataView](https://bun.com/guides/binary/typedarray-to-dataview)
+  - [Convert a Buffer to a ReadableStream](https://bun.com/guides/binary/buffer-to-readablestream)
+  - [Convert a Uint8Array to an ArrayBuffer](https://bun.com/guides/binary/typedarray-to-arraybuffer)
+  - [Convert an ArrayBuffer to a Uint8Array](https://bun.com/guides/binary/arraybuffer-to-typedarray)
+  - [Convert an ArrayBuffer to an array of numbers](https://bun.com/guides/binary/arraybuffer-to-array)
+  - [Convert a Uint8Array to a ReadableStream](https://bun.com/guides/binary/typedarray-to-readablestream)
+
+- Ecosystem
+  - [Use React and JSX](https://bun.com/guides/ecosystem/react)
+  - [Use Gel with Bun](https://bun.com/guides/ecosystem/gel)
+  - [Use Prisma with Bun](https://bun.com/guides/ecosystem/prisma)
+  - [Add Sentry to a Bun app](https://bun.com/guides/ecosystem/sentry)
+  - [Create a Discord bot](https://bun.com/guides/ecosystem/discordjs)
+  - [Run Bun as a daemon with PM2](https://bun.com/guides/ecosystem/pm2)
+  - [Use Drizzle ORM with Bun](https://bun.com/guides/ecosystem/drizzle)
+  - [Build an app with Nuxt and Bun](https://bun.com/guides/ecosystem/nuxt)
+  - [Build an app with Qwik and Bun](https://bun.com/guides/ecosystem/qwik)
+  - [Build an app with Astro and Bun](https://bun.com/guides/ecosystem/astro)
+  - [Build an app with Remix and Bun](https://bun.com/guides/ecosystem/remix)
+  - [Build a frontend using Vite and Bun](https://bun.com/guides/ecosystem/vite)
+  - [Build an app with Next.js and Bun](https://bun.com/guides/ecosystem/nextjs)
+  - [Run Bun as a daemon with systemd](https://bun.com/guides/ecosystem/systemd)
+  - [Deploy a Bun application on Render](https://bun.com/guides/ecosystem/render)
+  - [Build an HTTP server using Hono and Bun](https://bun.com/guides/ecosystem/hono)
+  - [Build an app with SvelteKit and Bun](https://bun.com/guides/ecosystem/sveltekit)
+  - [Build an app with SolidStart and Bun](https://bun.com/guides/ecosystem/solidstart)
+  - [Build an HTTP server using Elysia and Bun](https://bun.com/guides/ecosystem/elysia)
+  - [Build an HTTP server using StricJS and Bun](https://bun.com/guides/ecosystem/stric)
+  - [Containerize a Bun application with Docker](https://bun.com/guides/ecosystem/docker)
+  - [Build an HTTP server using Express and Bun](https://bun.com/guides/ecosystem/express)
+  - [Use Neon Postgres through Drizzle ORM](https://bun.com/guides/ecosystem/neon-drizzle)
+  - [Server-side render (SSR) a React component](https://bun.com/guides/ecosystem/ssr-react)
+  - [Read and write data to MongoDB using Mongoose and Bun](https://bun.com/guides/ecosystem/mongoose)
+  - [Use Neon's Serverless Postgres with Bun](https://bun.com/guides/ecosystem/neon-serverless-postgres)
+
+- HTMLRewriter
+  - [Extract links from a webpage using HTMLRewriter](https://bun.com/guides/html-rewriter/extract-links)
+  - [Extract social share images and Open Graph tags](https://bun.com/guides/html-rewriter/extract-social-meta)
+
+- HTTP
+  - [Hot reload an HTTP server](https://bun.com/guides/http/hot)
+  - [Common HTTP server usage](https://bun.com/guides/http/server)
+  - [Write a simple HTTP server](https://bun.com/guides/http/simple)
+  - [Configure TLS on an HTTP server](https://bun.com/guides/http/tls)
+  - [Send an HTTP request using fetch](https://bun.com/guides/http/fetch)
+  - [Proxy HTTP requests using fetch()](https://bun.com/guides/http/proxy)
+  - [Start a cluster of HTTP servers](https://bun.com/guides/http/cluster)
+  - [Stream a file as an HTTP Response](https://bun.com/guides/http/stream-file)
+  - [fetch with unix domain sockets in Bun](https://bun.com/guides/http/fetch-unix)
+  - [Upload files via HTTP using FormData](https://bun.com/guides/http/file-uploads)
+  - [Streaming HTTP Server with Async Iterators](https://bun.com/guides/http/stream-iterator)
+  - [Streaming HTTP Server with Node.js Streams](https://bun.com/guides/http/stream-node-streams-in-bun)
+
+- Install
+  - [Add a dependency](https://bun.com/guides/install/add)
+  - [Add a Git dependency](https://bun.com/guides/install/add-git)
+  - [Add a peer dependency](https://bun.com/guides/install/add-peer)
+  - [Add a trusted dependency](https://bun.com/guides/install/trusted)
+  - [Add a development dependency](https://bun.com/guides/install/add-dev)
+  - [Add a tarball dependency](https://bun.com/guides/install/add-tarball)
+  - [Add an optional dependency](https://bun.com/guides/install/add-optional)
+  - [Generate a yarn-compatible lockfile](https://bun.com/guides/install/yarnlock)
+  - [Configuring a monorepo using workspaces](https://bun.com/guides/install/workspaces)
+  - [Install a package under a different name](https://bun.com/guides/install/npm-alias)
+  - [Install dependencies with Bun in GitHub Actions](https://bun.com/guides/install/cicd)
+  - [Using bun install with Artifactory](https://bun.com/guides/install/jfrog-artifactory)
+  - [Configure git to diff Bun's lockb lockfile](https://bun.com/guides/install/git-diff-bun-lockfile)
+  - [Override the default npm registry for bun install](https://bun.com/guides/install/custom-registry)
+  - [Using bun install with an Azure Artifacts npm registry](https://bun.com/guides/install/azure-artifacts)
+  - [Migrate from npm install to bun install](https://bun.com/guides/install/from-npm-install-to-bun-install)
+  - [Configure a private registry for an organization scope with bun install](https://bun.com/guides/install/registry-scope)
+
+- Process
+  - [Read from stdin](https://bun.com/guides/process/stdin)
+  - [Listen for CTRL+C](https://bun.com/guides/process/ctrl-c)
+  - [Spawn a child process](https://bun.com/guides/process/spawn)
+  - [Listen to OS signals](https://bun.com/guides/process/os-signals)
+  - [Parse command-line arguments](https://bun.com/guides/process/argv)
+  - [Read stderr from a child process](https://bun.com/guides/process/spawn-stderr)
+  - [Read stdout from a child process](https://bun.com/guides/process/spawn-stdout)
+  - [Get the process uptime in nanoseconds](https://bun.com/guides/process/nanoseconds)
+  - [Spawn a child process and communicate using IPC](https://bun.com/guides/process/ipc)
+
+- Read file
+  - [Read a JSON file](https://bun.com/guides/read-file/json)
+  - [Check if a file exists](https://bun.com/guides/read-file/exists)
+  - [Read a file as a string](https://bun.com/guides/read-file/string)
+  - [Read a file to a Buffer](https://bun.com/guides/read-file/buffer)
+  - [Get the MIME type of a file](https://bun.com/guides/read-file/mime)
+  - [Watch a directory for changes](https://bun.com/guides/read-file/watch)
+  - [Read a file as a ReadableStream](https://bun.com/guides/read-file/stream)
+  - [Read a file to a Uint8Array](https://bun.com/guides/read-file/uint8array)
+  - [Read a file to an ArrayBuffer](https://bun.com/guides/read-file/arraybuffer)
+
+- Runtime
+  - [Delete files](https://bun.com/guides/runtime/delete-file)
+  - [Run a Shell Command](https://bun.com/guides/runtime/shell)
+  - [Import a JSON file](https://bun.com/guides/runtime/import-json)
+  - [Import a TOML file](https://bun.com/guides/runtime/import-toml)
+  - [Set a time zone in Bun](https://bun.com/guides/runtime/timezone)
+  - [Set environment variables](https://bun.com/guides/runtime/set-env)
+  - [Re-map import paths](https://bun.com/guides/runtime/tsconfig-paths)
+  - [Delete directories](https://bun.com/guides/runtime/delete-directory)
+  - [Read environment variables](https://bun.com/guides/runtime/read-env)
+  - [Import a HTML file as text](https://bun.com/guides/runtime/import-html)
+  - [Install and run Bun in GitHub Actions](https://bun.com/guides/runtime/cicd)
+  - [Debugging Bun with the web debugger](https://bun.com/guides/runtime/web-debugger)
+  - [Install TypeScript declarations for Bun](https://bun.com/guides/runtime/typescript)
+  - [Debugging Bun with the VS Code extension](https://bun.com/guides/runtime/vscode-debugger)
+  - [Inspect memory usage using V8 heap snapshots](https://bun.com/guides/runtime/heap-snapshot)
+  - [Define and replace static globals & constants](https://bun.com/guides/runtime/define-constant)
+  - [Codesign a single-file JavaScript executable on macOS](https://bun.com/guides/runtime/codesign-macos-executable)
+
+- Streams
+  - [Convert a ReadableStream to JSON](https://bun.com/guides/streams/to-json)
+  - [Convert a ReadableStream to a Blob](https://bun.com/guides/streams/to-blob)
+  - [Convert a ReadableStream to a Buffer](https://bun.com/guides/streams/to-buffer)
+  - [Convert a ReadableStream to a string](https://bun.com/guides/streams/to-string)
+  - [Convert a ReadableStream to a Uint8Array](https://bun.com/guides/streams/to-typedarray)
+  - [Convert a ReadableStream to an array of chunks](https://bun.com/guides/streams/to-array)
+  - [Convert a Node.js Readable to JSON](https://bun.com/guides/streams/node-readable-to-json)
+  - [Convert a ReadableStream to an ArrayBuffer](https://bun.com/guides/streams/to-arraybuffer)
+  - [Convert a Node.js Readable to a Blob](https://bun.com/guides/streams/node-readable-to-blob)
+  - [Convert a Node.js Readable to a string](https://bun.com/guides/streams/node-readable-to-string)
+  - [Convert a Node.js Readable to an Uint8Array](https://bun.com/guides/streams/node-readable-to-uint8array)
+  - [Convert a Node.js Readable to an ArrayBuffer](https://bun.com/guides/streams/node-readable-to-arraybuffer)
+
+- Test
+  - [Spy on methods in `bun test`](https://bun.com/guides/test/spy-on)
+  - [Bail early with the Bun test runner](https://bun.com/guides/test/bail)
+  - [Mock functions in `bun test`](https://bun.com/guides/test/mock-functions)
+  - [Run tests in watch mode with Bun](https://bun.com/guides/test/watch-mode)
+  - [Use snapshot testing in `bun test`](https://bun.com/guides/test/snapshot)
+  - [Skip tests with the Bun test runner](https://bun.com/guides/test/skip-tests)
+  - [Using Testing Library with Bun](https://bun.com/guides/test/testing-library)
+  - [Update snapshots in `bun test`](https://bun.com/guides/test/update-snapshots)
+  - [Run your tests with the Bun test runner](https://bun.com/guides/test/run-tests)
+  - [Set the system time in Bun's test runner](https://bun.com/guides/test/mock-clock)
+  - [Set a per-test timeout with the Bun test runner](https://bun.com/guides/test/timeout)
+  - [Migrate from Jest to Bun's test runner](https://bun.com/guides/test/migrate-from-jest)
+  - [Write browser DOM tests with Bun and happy-dom](https://bun.com/guides/test/happy-dom)
+  - [Mark a test as a "todo" with the Bun test runner](https://bun.com/guides/test/todo-tests)
+  - [Re-run tests multiple times with the Bun test runner](https://bun.com/guides/test/rerun-each)
+  - [Generate code coverage reports with the Bun test runner](https://bun.com/guides/test/coverage)
+  - [import, require, and test Svelte components with bun test](https://bun.com/guides/test/svelte-test)
+  - [Set a code coverage threshold with the Bun test runner](https://bun.com/guides/test/coverage-threshold)
+
+- Util
+  - [Generate a UUID](https://bun.com/guides/util/javascript-uuid)
+  - [Hash a password](https://bun.com/guides/util/hash-a-password)
+  - [Escape an HTML string](https://bun.com/guides/util/escape-html)
+  - [Get the current Bun version](https://bun.com/guides/util/version)
+  - [Encode and decode base64 strings](https://bun.com/guides/util/base64)
+  - [Compress and decompress data with gzip](https://bun.com/guides/util/gzip)
+  - [Sleep for a fixed number of milliseconds](https://bun.com/guides/util/sleep)
+  - [Detect when code is executed with Bun](https://bun.com/guides/util/detect-bun)
+  - [Check if two objects are deeply equal](https://bun.com/guides/util/deep-equals)
+  - [Compress and decompress data with DEFLATE](https://bun.com/guides/util/deflate)
+  - [Get the absolute path to the current entrypoint](https://bun.com/guides/util/main)
+  - [Get the directory of the current file](https://bun.com/guides/util/import-meta-dir)
+  - [Check if the current file is the entrypoint](https://bun.com/guides/util/entrypoint)
+  - [Get the file name of the current file](https://bun.com/guides/util/import-meta-file)
+  - [Convert a file URL to an absolute path](https://bun.com/guides/util/file-url-to-path)
+  - [Convert an absolute path to a file URL](https://bun.com/guides/util/path-to-file-url)
+  - [Get the absolute path of the current file](https://bun.com/guides/util/import-meta-path)
+  - [Get the path to an executable bin file](https://bun.com/guides/util/which-path-to-executable-bin)
+
+- WebSocket
+  - [Build a publish-subscribe WebSocket server](https://bun.com/guides/websocket/pubsub)
+  - [Build a simple WebSocket server](https://bun.com/guides/websocket/simple)
+  - [Enable compression for WebSocket messages](https://bun.com/guides/websocket/compression)
+  - [Set per-socket contextual data on a WebSocket](https://bun.com/guides/websocket/context)
+
+- Write file
+  - [Delete a file](https://bun.com/guides/write-file/unlink)
+  - [Write to stdout](https://bun.com/guides/write-file/stdout)
+  - [Write a file to stdout](https://bun.com/guides/write-file/cat)
+  - [Write a Blob to a file](https://bun.com/guides/write-file/blob)
+  - [Write a string to a file](https://bun.com/guides/write-file/basic)
+  - [Append content to a file](https://bun.com/guides/write-file/append)
+  - [Write a file incrementally](https://bun.com/guides/write-file/filesink)
+  - [Write a Response to a file](https://bun.com/guides/write-file/response)
+  - [Copy a file to another location](https://bun.com/guides/write-file/file-cp)
+  - [Write a ReadableStream to a file](https://bun.com/guides/write-file/stream)
 
 ## Contributing
 
-Refer to the [Project > Contributing](https://bun.sh/docs/project/contributing) guide to start contributing to Bun.
+Refer to the [Project > Contributing](https://bun.com/docs/project/contributing) guide to start contributing to Bun.
 
 ## License
 
-Refer to the [Project > License](https://bun.sh/docs/project/licensing) page for information about Bun's licensing.
+Refer to the [Project > License](https://bun.com/docs/project/licensing) page for information about Bun's licensing.