print better errors on bytecode generation error

### What does this PR do?

Fixes #22425
Fixes #22431

### How did you verify your code works?

bun-types integration test

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

@@ -6,7 +6,7 @@ on:
 
 jobs:
   auto-label:
-    if: github.event.pull_request.user.login == 'robobun'
+    if: github.event.pull_request.user.login == 'robobun' || contains(github.event.pull_request.body, '🤖 Generated with')
     runs-on: ubuntu-latest
     permissions:
       contents: read
@@ -21,4 +21,4 @@ jobs:
               repo: context.repo.repo,
               issue_number: context.issue.number,
               labels: ['claude']
-            });
+            });

.github/workflows/format.yml

@@ -8,10 +8,8 @@ on:
   workflow_dispatch:
   pull_request:
   merge_group:
-  push:
-    branches: ["main"]
 env:
-  BUN_VERSION: "1.2.11"
+  BUN_VERSION: "1.2.20"
   LLVM_VERSION: "19.1.7"
   LLVM_VERSION_MAJOR: "19"
 
@@ -37,13 +35,14 @@ jobs:
       - name: Setup Dependencies
         run: |
           bun install
+          bun scripts/glob-sources.mjs
       - name: Format Code
         run: |
           # 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"
           (
@@ -56,13 +55,13 @@ jobs:
             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-d1a4e0b0ddc75f37c6a090b97eef0cbb6335556e/bootstrap-x86_64-linux-musl.zip
+            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..."
@@ -72,38 +71,39 @@ jobs:
             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/glob-sources.yml

@@ -1,41 +0,0 @@
-name: Glob Sources
-
-permissions:
-  contents: write
-
-on:
-  workflow_call:
-  workflow_dispatch:
-  pull_request:
-
-env:
-  BUN_VERSION: "1.2.11"
-
-jobs:
-  glob-sources:
-    name: Glob Sources
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - 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: ./.github/actions/setup-bun
-        with:
-          bun-version: ${{ env.BUN_VERSION }}
-      - name: Setup Dependencies
-        run: |
-          bun install
-      - name: Glob sources
-        run: bun scripts/glob-sources.mjs
-      - name: Commit
-        uses: stefanzweifel/git-auto-commit-action@v5
-        with:
-          commit_message: "`bun scripts/glob-sources.mjs`"
-

.github/workflows/labeled.yml

@@ -5,6 +5,8 @@ env:
 on:
   issues:
     types: [labeled]
+  pull_request_target:
+    types: [labeled, opened, reopened, synchronize, unlabeled]
 
 jobs:
   # on-bug:
@@ -43,9 +45,46 @@ jobs:
   #         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.label.name == 'crash' || github.event.label.name == 'needs repro'
+    if: github.event_name == 'issues' && (github.event.label.name == 'crash' || github.event.label.name == 'needs repro')
     permissions:
       issues: write
     steps:

.gitignore

@@ -186,4 +186,7 @@ scratch*.{js,ts,tsx,cjs,mjs}
 
 *.bun-build
 
-scripts/lldb-inline
+scripts/lldb-inline
+
+# We regenerate these in all the build scripts
+cmake/sources/*.txt

CLAUDE.md

@@ -43,16 +43,11 @@ Tests use Bun's Jest-compatible test runner with proper test fixtures:
 
 ```typescript
 import { test, expect } from "bun:test";
-import {
-  bunEnv,
-  bunExe,
-  normalizeBunSnapshot,
-  tempDirWithFiles,
-} from "harness";
+import { bunEnv, bunExe, normalizeBunSnapshot, tempDir } from "harness";
 
 test("my feature", async () => {
   // Create temp directory with test files
-  const dir = tempDirWithFiles("test-prefix", {
+  using dir = tempDir("test-prefix", {
     "index.js": `console.log("hello");`,
   });
 
@@ -60,7 +55,7 @@ test("my feature", async () => {
   await using proc = Bun.spawn({
     cmd: [bunExe(), "index.js"],
     env: bunEnv,
-    cwd: dir,
+    cwd: String(dir),
     stderr: "pipe",
   });
 

CONTRIBUTING.md

@@ -223,8 +223,8 @@ $ git clone https://github.com/oven-sh/WebKit vendor/WebKit
 $ git -C vendor/WebKit checkout <commit_hash>
 
 # Make a debug build of JSC. This will output build artifacts in ./vendor/WebKit/WebKitBuild/Debug
-# Optionally, you can use `make jsc` for a release build
-$ make jsc-debug && rm vendor/WebKit/WebKitBuild/Debug/JavaScriptCore/DerivedSources/inspector/InspectorProtocolObjects.h
+# Optionally, you can use `bun run jsc:build` for a release build
+$ bun run jsc:build:debug && rm vendor/WebKit/WebKitBuild/Debug/JavaScriptCore/DerivedSources/inspector/InspectorProtocolObjects.h
 
 # After an initial run of `make jsc-debug`, you can rebuild JSC with:
 $ cmake --build vendor/WebKit/WebKitBuild/Debug --target jsc && rm vendor/WebKit/WebKitBuild/Debug/JavaScriptCore/DerivedSources/inspector/InspectorProtocolObjects.h

LATEST

@@ -1 +1 @@
-1.2.20
+1.2.21

bench/postMessage/postMessage-object.mjs

@@ -0,0 +1,116 @@
+// Benchmark for object fast path optimization in postMessage with Workers
+
+import { bench, run } from "mitata";
+import { Worker } from "node:worker_threads";
+
+const extraProperties = {
+  a: "a!",
+  b: "b!",
+  "second": "c!",
+  bool: true,
+  nully: null,
+  undef: undefined,
+  int: 0,
+  double: 1.234,
+  falsy: false,
+};
+
+const objects = {
+  small: { property: "Hello world", ...extraProperties },
+  medium: {
+    property: Buffer.alloc("Hello World!!!".length * 1024, "Hello World!!!").toString(),
+    ...extraProperties,
+  },
+  large: {
+    property: Buffer.alloc("Hello World!!!".length * 1024 * 256, "Hello World!!!").toString(),
+    ...extraProperties,
+  },
+};
+
+let worker;
+let receivedCount = new Int32Array(new SharedArrayBuffer(4));
+let sentCount = 0;
+
+function createWorker() {
+  const workerCode = `
+    import { parentPort, workerData } from "node:worker_threads";
+
+    let int = workerData;
+
+    parentPort?.on("message", data => {
+      switch (data.property.length) {
+        case ${objects.small.property.length}:
+        case ${objects.medium.property.length}:
+        case ${objects.large.property.length}: {
+          if (
+            data.a === "a!" && 
+            data.b === "b!" && 
+            data.second === "c!" && 
+            data.bool === true && 
+            data.nully === null && 
+            data.undef === undefined && 
+            data.int === 0 && 
+            data.double === 1.234 && 
+            data.falsy === false) {
+            Atomics.add(int, 0, 1);
+            break;    
+          }
+        }
+        default: {
+          throw new Error("Invalid data object: " + JSON.stringify(data));
+        }
+      }
+      
+    });
+  `;
+
+  worker = new Worker(workerCode, { eval: true, workerData: receivedCount });
+
+  worker.on("message", confirmationId => {});
+
+  worker.on("error", error => {
+    console.error("Worker error:", error);
+  });
+}
+
+// Initialize worker before running benchmarks
+createWorker();
+
+function fmt(int) {
+  if (int < 1000) {
+    return `${int} chars`;
+  }
+
+  if (int < 100000) {
+    return `${(int / 1024) | 0} KB`;
+  }
+
+  return `${(int / 1024 / 1024) | 0} MB`;
+}
+
+// Benchmark postMessage with pure strings (uses fast path)
+bench("postMessage({ prop: " + fmt(objects.small.property.length) + " string, ...9 more props })", async () => {
+  sentCount++;
+  worker.postMessage(objects.small);
+});
+
+bench("postMessage({ prop: " + fmt(objects.medium.property.length) + " string,    ...9 more props })", async () => {
+  sentCount++;
+  worker.postMessage(objects.medium);
+});
+
+bench("postMessage({ prop: " + fmt(objects.large.property.length) + " string,     ...9 more props })", async () => {
+  sentCount++;
+  worker.postMessage(objects.large);
+});
+
+await run();
+
+await new Promise(resolve => setTimeout(resolve, 5000));
+
+if (receivedCount[0] !== sentCount) {
+  throw new Error("Expected " + receivedCount[0] + " to equal " + sentCount);
+}
+
+// Cleanup worker
+worker?.terminate();

bench/postgres/mysql.mjs

@@ -0,0 +1,58 @@
+const isBun = typeof globalThis?.Bun?.sql !== "undefined";
+let conn;
+let sql;
+import * as mariadb from "mariadb";
+import * as mysql2 from "mysql2/promise";
+let useMYSQL2 = false;
+if (process.argv.includes("--mysql2")) {
+  useMYSQL2 = true;
+}
+if (isBun) {
+  sql = new Bun.SQL({
+    adapter: "mysql",
+    database: "test",
+    username: "root",
+  });
+} else {
+  const pool = (useMYSQL2 ? mysql2 : mariadb).createPool({
+    // Add your MariaDB connection details here
+    user: "root",
+    database: "test",
+  });
+  conn = await pool.getConnection();
+}
+
+if (isBun) {
+  // Initialize the benchmark table (equivalent to initFct)
+  await sql`DROP TABLE IF EXISTS test100`;
+  await sql`CREATE TABLE test100 (i1 int,i2 int,i3 int,i4 int,i5 int,i6 int,i7 int,i8 int,i9 int,i10 int,i11 int,i12 int,i13 int,i14 int,i15 int,i16 int,i17 int,i18 int,i19 int,i20 int,i21 int,i22 int,i23 int,i24 int,i25 int,i26 int,i27 int,i28 int,i29 int,i30 int,i31 int,i32 int,i33 int,i34 int,i35 int,i36 int,i37 int,i38 int,i39 int,i40 int,i41 int,i42 int,i43 int,i44 int,i45 int,i46 int,i47 int,i48 int,i49 int,i50 int,i51 int,i52 int,i53 int,i54 int,i55 int,i56 int,i57 int,i58 int,i59 int,i60 int,i61 int,i62 int,i63 int,i64 int,i65 int,i66 int,i67 int,i68 int,i69 int,i70 int,i71 int,i72 int,i73 int,i74 int,i75 int,i76 int,i77 int,i78 int,i79 int,i80 int,i81 int,i82 int,i83 int,i84 int,i85 int,i86 int,i87 int,i88 int,i89 int,i90 int,i91 int,i92 int,i93 int,i94 int,i95 int,i96 int,i97 int,i98 int,i99 int,i100 int)`;
+  await sql`INSERT INTO test100 value (1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100)`;
+} else {
+  // Initialize the benchmark table (equivalent to initFct)
+  await conn.query("DROP TABLE IF EXISTS test100");
+  await conn.query(
+    "CREATE TABLE test100 (i1 int,i2 int,i3 int,i4 int,i5 int,i6 int,i7 int,i8 int,i9 int,i10 int,i11 int,i12 int,i13 int,i14 int,i15 int,i16 int,i17 int,i18 int,i19 int,i20 int,i21 int,i22 int,i23 int,i24 int,i25 int,i26 int,i27 int,i28 int,i29 int,i30 int,i31 int,i32 int,i33 int,i34 int,i35 int,i36 int,i37 int,i38 int,i39 int,i40 int,i41 int,i42 int,i43 int,i44 int,i45 int,i46 int,i47 int,i48 int,i49 int,i50 int,i51 int,i52 int,i53 int,i54 int,i55 int,i56 int,i57 int,i58 int,i59 int,i60 int,i61 int,i62 int,i63 int,i64 int,i65 int,i66 int,i67 int,i68 int,i69 int,i70 int,i71 int,i72 int,i73 int,i74 int,i75 int,i76 int,i77 int,i78 int,i79 int,i80 int,i81 int,i82 int,i83 int,i84 int,i85 int,i86 int,i87 int,i88 int,i89 int,i90 int,i91 int,i92 int,i93 int,i94 int,i95 int,i96 int,i97 int,i98 int,i99 int,i100 int)",
+  );
+  await conn.query(
+    "INSERT INTO test100 value (1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100)",
+  );
+}
+// Run the benchmark (equivalent to benchFct)
+const type = isBun ? "Bun.SQL" : useMYSQL2 ? "mysql2" : "mariadb";
+console.time(type);
+let promises = [];
+
+for (let i = 0; i < 100_000; i++) {
+  if (isBun) {
+    promises.push(sql`select * FROM test100`);
+  } else {
+    promises.push(conn.query("select * FROM test100"));
+  }
+}
+await Promise.all(promises);
+console.timeEnd(type);
+
+// Clean up connection
+if (!isBun && conn.release) {
+  conn.release();
+}

bench/postgres/package.json

@@ -9,6 +9,8 @@
     "typescript": "^5.0.0"
   },
   "dependencies": {
+    "mariadb": "^3.4.5",
+    "mysql2": "^3.14.3",
     "postgres": "^3.4.7"
   }
 }

bench/snippets/crypto-2190.mjs

@@ -12,6 +12,9 @@ const scenarios = [
   { alg: "sha1", digest: "base64" },
   { alg: "sha256", digest: "hex" },
   { alg: "sha256", digest: "base64" },
+  { alg: "blake2b512", digest: "hex" },
+  { alg: "sha512-224", digest: "hex" },
+  { alg: "sha512-256", digest: "hex" },
 ];
 
 for (const { alg, digest } of scenarios) {
@@ -23,6 +26,10 @@ for (const { alg, digest } of scenarios) {
     bench(`${alg}-${digest} (Bun.CryptoHasher)`, () => {
       new Bun.CryptoHasher(alg).update(data).digest(digest);
     });
+
+    bench(`${alg}-${digest} (Bun.CryptoHasher.hash)`, () => {
+      return Bun.CryptoHasher.hash(alg, data, digest);
+    });
   }
 }
 

bench/yaml/yaml-stringify.mjs

@@ -0,0 +1,407 @@
+import { bench, group, run } from "../runner.mjs";
+import jsYaml from "js-yaml";
+import yaml from "yaml";
+
+// Small object
+const smallObject = {
+  name: "John Doe",
+  age: 30,
+  email: "john@example.com",
+  active: true,
+};
+
+// Medium object with nested structures
+const mediumObject = {
+  company: "Acme Corp",
+  employees: [
+    {
+      name: "John Doe",
+      age: 30,
+      position: "Developer",
+      skills: ["JavaScript", "TypeScript", "Node.js"],
+    },
+    {
+      name: "Jane Smith",
+      age: 28,
+      position: "Designer",
+      skills: ["Figma", "Photoshop", "Illustrator"],
+    },
+    {
+      name: "Bob Johnson",
+      age: 35,
+      position: "Manager",
+      skills: ["Leadership", "Communication", "Planning"],
+    },
+  ],
+  settings: {
+    database: {
+      host: "localhost",
+      port: 5432,
+      name: "mydb",
+    },
+    cache: {
+      enabled: true,
+      ttl: 3600,
+    },
+  },
+};
+
+// Large object with complex structures
+const largeObject = {
+  apiVersion: "apps/v1",
+  kind: "Deployment",
+  metadata: {
+    name: "nginx-deployment",
+    labels: {
+      app: "nginx",
+    },
+  },
+  spec: {
+    replicas: 3,
+    selector: {
+      matchLabels: {
+        app: "nginx",
+      },
+    },
+    template: {
+      metadata: {
+        labels: {
+          app: "nginx",
+        },
+      },
+      spec: {
+        containers: [
+          {
+            name: "nginx",
+            image: "nginx:1.14.2",
+            ports: [
+              {
+                containerPort: 80,
+              },
+            ],
+            env: [
+              {
+                name: "ENV_VAR_1",
+                value: "value1",
+              },
+              {
+                name: "ENV_VAR_2",
+                value: "value2",
+              },
+            ],
+            volumeMounts: [
+              {
+                name: "config",
+                mountPath: "/etc/nginx",
+              },
+            ],
+            resources: {
+              limits: {
+                cpu: "1",
+                memory: "1Gi",
+              },
+              requests: {
+                cpu: "0.5",
+                memory: "512Mi",
+              },
+            },
+          },
+        ],
+        volumes: [
+          {
+            name: "config",
+            configMap: {
+              name: "nginx-config",
+              items: [
+                {
+                  key: "nginx.conf",
+                  path: "nginx.conf",
+                },
+                {
+                  key: "mime.types",
+                  path: "mime.types",
+                },
+              ],
+            },
+          },
+        ],
+        nodeSelector: {
+          disktype: "ssd",
+        },
+        tolerations: [
+          {
+            key: "key1",
+            operator: "Equal",
+            value: "value1",
+            effect: "NoSchedule",
+          },
+          {
+            key: "key2",
+            operator: "Exists",
+            effect: "NoExecute",
+          },
+        ],
+        affinity: {
+          nodeAffinity: {
+            requiredDuringSchedulingIgnoredDuringExecution: {
+              nodeSelectorTerms: [
+                {
+                  matchExpressions: [
+                    {
+                      key: "kubernetes.io/e2e-az-name",
+                      operator: "In",
+                      values: ["e2e-az1", "e2e-az2"],
+                    },
+                  ],
+                },
+              ],
+            },
+          },
+          podAntiAffinity: {
+            preferredDuringSchedulingIgnoredDuringExecution: [
+              {
+                weight: 100,
+                podAffinityTerm: {
+                  labelSelector: {
+                    matchExpressions: [
+                      {
+                        key: "app",
+                        operator: "In",
+                        values: ["web-store"],
+                      },
+                    ],
+                  },
+                  topologyKey: "kubernetes.io/hostname",
+                },
+              },
+            ],
+          },
+        },
+      },
+    },
+  },
+};
+
+// Object with anchors and references (after resolution)
+const objectWithAnchors = {
+  defaults: {
+    adapter: "postgresql",
+    host: "localhost",
+    port: 5432,
+  },
+  development: {
+    adapter: "postgresql",
+    host: "localhost",
+    port: 5432,
+    database: "dev_db",
+  },
+  test: {
+    adapter: "postgresql",
+    host: "localhost",
+    port: 5432,
+    database: "test_db",
+  },
+  production: {
+    adapter: "postgresql",
+    host: "prod.example.com",
+    port: 5432,
+    database: "prod_db",
+  },
+};
+
+// Array of items
+const arrayObject = [
+  {
+    id: 1,
+    name: "Item 1",
+    price: 10.99,
+    tags: ["electronics", "gadgets"],
+  },
+  {
+    id: 2,
+    name: "Item 2",
+    price: 25.5,
+    tags: ["books", "education"],
+  },
+  {
+    id: 3,
+    name: "Item 3",
+    price: 5.0,
+    tags: ["food", "snacks"],
+  },
+  {
+    id: 4,
+    name: "Item 4",
+    price: 100.0,
+    tags: ["electronics", "computers"],
+  },
+  {
+    id: 5,
+    name: "Item 5",
+    price: 15.75,
+    tags: ["clothing", "accessories"],
+  },
+];
+
+// Multiline strings
+const multilineObject = {
+  description:
+    "This is a multiline string\nthat preserves line breaks\nand indentation.\n\nIt can contain multiple paragraphs\nand special characters: !@#$%^&*()\n",
+  folded: "This is a folded string where line breaks are converted to spaces unless there are\nempty lines like above.",
+  plain: "This is a plain string",
+  quoted: 'This is a quoted string with "escapes"',
+  literal: "This is a literal string with 'quotes'",
+};
+
+// Numbers and special values
+const numbersObject = {
+  integer: 42,
+  negative: -17,
+  float: 3.14159,
+  scientific: 0.000123,
+  infinity: Infinity,
+  negativeInfinity: -Infinity,
+  notANumber: NaN,
+  octal: 493, // 0o755
+  hex: 255, // 0xFF
+  binary: 10, // 0b1010
+};
+
+// Dates and timestamps
+const datesObject = {
+  date: new Date("2024-01-15"),
+  datetime: new Date("2024-01-15T10:30:00Z"),
+  timestamp: new Date("2024-01-15T15:30:00.123456789Z"), // Adjusted for UTC-5
+  canonical: new Date("2024-01-15T10:30:00.123456789Z"),
+};
+
+// Stringify benchmarks
+group("stringify small object", () => {
+  if (typeof Bun !== "undefined" && Bun.YAML) {
+    bench("Bun.YAML.stringify", () => {
+      return Bun.YAML.stringify(smallObject);
+    });
+  }
+
+  bench("js-yaml.dump", () => {
+    return jsYaml.dump(smallObject);
+  });
+
+  bench("yaml.stringify", () => {
+    return yaml.stringify(smallObject);
+  });
+});
+
+group("stringify medium object", () => {
+  if (typeof Bun !== "undefined" && Bun.YAML) {
+    bench("Bun.YAML.stringify", () => {
+      return Bun.YAML.stringify(mediumObject);
+    });
+  }
+
+  bench("js-yaml.dump", () => {
+    return jsYaml.dump(mediumObject);
+  });
+
+  bench("yaml.stringify", () => {
+    return yaml.stringify(mediumObject);
+  });
+});
+
+group("stringify large object", () => {
+  if (typeof Bun !== "undefined" && Bun.YAML) {
+    bench("Bun.YAML.stringify", () => {
+      return Bun.YAML.stringify(largeObject);
+    });
+  }
+
+  bench("js-yaml.dump", () => {
+    return jsYaml.dump(largeObject);
+  });
+
+  bench("yaml.stringify", () => {
+    return yaml.stringify(largeObject);
+  });
+});
+
+group("stringify object with anchors", () => {
+  if (typeof Bun !== "undefined" && Bun.YAML) {
+    bench("Bun.YAML.stringify", () => {
+      return Bun.YAML.stringify(objectWithAnchors);
+    });
+  }
+
+  bench("js-yaml.dump", () => {
+    return jsYaml.dump(objectWithAnchors);
+  });
+
+  bench("yaml.stringify", () => {
+    return yaml.stringify(objectWithAnchors);
+  });
+});
+
+group("stringify array", () => {
+  if (typeof Bun !== "undefined" && Bun.YAML) {
+    bench("Bun.YAML.stringify", () => {
+      return Bun.YAML.stringify(arrayObject);
+    });
+  }
+
+  bench("js-yaml.dump", () => {
+    return jsYaml.dump(arrayObject);
+  });
+
+  bench("yaml.stringify", () => {
+    return yaml.stringify(arrayObject);
+  });
+});
+
+group("stringify object with multiline strings", () => {
+  if (typeof Bun !== "undefined" && Bun.YAML) {
+    bench("Bun.YAML.stringify", () => {
+      return Bun.YAML.stringify(multilineObject);
+    });
+  }
+
+  bench("js-yaml.dump", () => {
+    return jsYaml.dump(multilineObject);
+  });
+
+  bench("yaml.stringify", () => {
+    return yaml.stringify(multilineObject);
+  });
+});
+
+group("stringify object with numbers", () => {
+  if (typeof Bun !== "undefined" && Bun.YAML) {
+    bench("Bun.YAML.stringify", () => {
+      return Bun.YAML.stringify(numbersObject);
+    });
+  }
+
+  bench("js-yaml.dump", () => {
+    return jsYaml.dump(numbersObject);
+  });
+
+  bench("yaml.stringify", () => {
+    return yaml.stringify(numbersObject);
+  });
+});
+
+group("stringify object with dates", () => {
+  if (typeof Bun !== "undefined" && Bun.YAML) {
+    bench("Bun.YAML.stringify", () => {
+      return Bun.YAML.stringify(datesObject);
+    });
+  }
+
+  bench("js-yaml.dump", () => {
+    return jsYaml.dump(datesObject);
+  });
+
+  bench("yaml.stringify", () => {
+    return yaml.stringify(datesObject);
+  });
+});
+
+await run();

bun.lock

@@ -40,8 +40,8 @@
     },
   },
   "overrides": {
-    "bun-types": "workspace:packages/bun-types",
     "@types/bun": "workspace:packages/@types/bun",
+    "bun-types": "workspace:packages/bun-types",
   },
   "packages": {
     "@esbuild/aix-ppc64": ["@esbuild/aix-ppc64@0.21.5", "", { "os": "aix", "cpu": "ppc64" }, "sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ=="],

cmake/sources/BakeRuntimeSources.txt

@@ -1,22 +0,0 @@
-src/bake/bake.d.ts
-src/bake/bake.private.d.ts
-src/bake/bun-framework-react/index.ts
-src/bake/client/css-reloader.ts
-src/bake/client/data-view.ts
-src/bake/client/error-serialization.ts
-src/bake/client/inspect.ts
-src/bake/client/JavaScriptSyntaxHighlighter.css
-src/bake/client/JavaScriptSyntaxHighlighter.ts
-src/bake/client/overlay.css
-src/bake/client/overlay.ts
-src/bake/client/stack-trace.ts
-src/bake/client/websocket.ts
-src/bake/debug.ts
-src/bake/DevServer.bind.ts
-src/bake/enums.ts
-src/bake/hmr-module.ts
-src/bake/hmr-runtime-client.ts
-src/bake/hmr-runtime-error.ts
-src/bake/hmr-runtime-server.ts
-src/bake/server/stack-trace-stub.ts
-src/bake/shared.ts

cmake/sources/BindgenSources.txt

@@ -1,7 +0,0 @@
-src/bake.bind.ts
-src/bake/DevServer.bind.ts
-src/bun.js/api/BunObject.bind.ts
-src/bun.js/bindgen_test.bind.ts
-src/bun.js/bindings/NodeModuleModule.bind.ts
-src/bun.js/node/node_os.bind.ts
-src/fmt.bind.ts

cmake/sources/BunErrorSources.txt

@@ -1,12 +0,0 @@
-packages/bun-error/bun-error.css
-packages/bun-error/img/close.png
-packages/bun-error/img/error.png
-packages/bun-error/img/powered-by.png
-packages/bun-error/img/powered-by.webp
-packages/bun-error/index.tsx
-packages/bun-error/markdown.ts
-packages/bun-error/package.json
-packages/bun-error/runtime-error.ts
-packages/bun-error/sourcemap.ts
-packages/bun-error/stack-trace-parser.ts
-packages/bun-error/tsconfig.json

cmake/sources/CSources.txt

@@ -1,15 +0,0 @@
-packages/bun-usockets/src/bsd.c
-packages/bun-usockets/src/context.c
-packages/bun-usockets/src/crypto/openssl.c
-packages/bun-usockets/src/eventing/epoll_kqueue.c
-packages/bun-usockets/src/eventing/libuv.c
-packages/bun-usockets/src/loop.c
-packages/bun-usockets/src/quic.c
-packages/bun-usockets/src/socket.c
-packages/bun-usockets/src/udp.c
-src/asan-config.c
-src/bun.js/bindings/node/http/llhttp/api.c
-src/bun.js/bindings/node/http/llhttp/http.c
-src/bun.js/bindings/node/http/llhttp/llhttp.c
-src/bun.js/bindings/uv-posix-polyfills.c
-src/bun.js/bindings/uv-posix-stubs.c

cmake/sources/CxxSources.txt

@@ -198,6 +198,7 @@ src/bun.js/bindings/ServerRouteList.cpp
 src/bun.js/bindings/spawn.cpp
 src/bun.js/bindings/SQLClient.cpp
 src/bun.js/bindings/sqlite/JSSQLStatement.cpp
+src/bun.js/bindings/StringBuilderBinding.cpp
 src/bun.js/bindings/stripANSI.cpp
 src/bun.js/bindings/Strong.cpp
 src/bun.js/bindings/TextCodec.cpp

cmake/sources/JavaScriptCodegenSources.txt

@@ -1,21 +0,0 @@
-src/codegen/bake-codegen.ts
-src/codegen/bindgen-lib-internal.ts
-src/codegen/bindgen-lib.ts
-src/codegen/bindgen.ts
-src/codegen/buildTypeFlag.ts
-src/codegen/builtin-parser.ts
-src/codegen/bundle-functions.ts
-src/codegen/bundle-modules.ts
-src/codegen/class-definitions.ts
-src/codegen/client-js.ts
-src/codegen/cppbind.ts
-src/codegen/create-hash-table.ts
-src/codegen/generate-classes.ts
-src/codegen/generate-compact-string-table.ts
-src/codegen/generate-js2native.ts
-src/codegen/generate-jssink.ts
-src/codegen/generate-node-errors.ts
-src/codegen/helpers.ts
-src/codegen/internal-module-registry-scanner.ts
-src/codegen/replacements.ts
-src/codegen/shared-types.ts

cmake/sources/JavaScriptSources.txt

@@ -1,171 +0,0 @@
-src/js/builtins.d.ts
-src/js/builtins/Bake.ts
-src/js/builtins/BundlerPlugin.ts
-src/js/builtins/ByteLengthQueuingStrategy.ts
-src/js/builtins/CommonJS.ts
-src/js/builtins/ConsoleObject.ts
-src/js/builtins/CountQueuingStrategy.ts
-src/js/builtins/Glob.ts
-src/js/builtins/ImportMetaObject.ts
-src/js/builtins/Ipc.ts
-src/js/builtins/JSBufferConstructor.ts
-src/js/builtins/JSBufferPrototype.ts
-src/js/builtins/NodeModuleObject.ts
-src/js/builtins/Peek.ts
-src/js/builtins/ProcessObjectInternals.ts
-src/js/builtins/ReadableByteStreamController.ts
-src/js/builtins/ReadableByteStreamInternals.ts
-src/js/builtins/ReadableStream.ts
-src/js/builtins/ReadableStreamBYOBReader.ts
-src/js/builtins/ReadableStreamBYOBRequest.ts
-src/js/builtins/ReadableStreamDefaultController.ts
-src/js/builtins/ReadableStreamDefaultReader.ts
-src/js/builtins/ReadableStreamInternals.ts
-src/js/builtins/shell.ts
-src/js/builtins/StreamInternals.ts
-src/js/builtins/TextDecoderStream.ts
-src/js/builtins/TextEncoderStream.ts
-src/js/builtins/TransformStream.ts
-src/js/builtins/TransformStreamDefaultController.ts
-src/js/builtins/TransformStreamInternals.ts
-src/js/builtins/UtilInspect.ts
-src/js/builtins/WasmStreaming.ts
-src/js/builtins/WritableStreamDefaultController.ts
-src/js/builtins/WritableStreamDefaultWriter.ts
-src/js/builtins/WritableStreamInternals.ts
-src/js/bun/ffi.ts
-src/js/bun/sql.ts
-src/js/bun/sqlite.ts
-src/js/internal-for-testing.ts
-src/js/internal/abort_listener.ts
-src/js/internal/assert/assertion_error.ts
-src/js/internal/assert/calltracker.ts
-src/js/internal/assert/myers_diff.ts
-src/js/internal/assert/utils.ts
-src/js/internal/buffer.ts
-src/js/internal/cluster/child.ts
-src/js/internal/cluster/isPrimary.ts
-src/js/internal/cluster/primary.ts
-src/js/internal/cluster/RoundRobinHandle.ts
-src/js/internal/cluster/Worker.ts
-src/js/internal/crypto/x509.ts
-src/js/internal/debugger.ts
-src/js/internal/errors.ts
-src/js/internal/fifo.ts
-src/js/internal/fixed_queue.ts
-src/js/internal/freelist.ts
-src/js/internal/fs/cp-sync.ts
-src/js/internal/fs/cp.ts
-src/js/internal/fs/glob.ts
-src/js/internal/fs/streams.ts
-src/js/internal/html.ts
-src/js/internal/http.ts
-src/js/internal/http/FakeSocket.ts
-src/js/internal/linkedlist.ts
-src/js/internal/primordials.js
-src/js/internal/promisify.ts
-src/js/internal/shared.ts
-src/js/internal/sql/errors.ts
-src/js/internal/sql/mysql.ts
-src/js/internal/sql/postgres.ts
-src/js/internal/sql/query.ts
-src/js/internal/sql/shared.ts
-src/js/internal/sql/sqlite.ts
-src/js/internal/stream.promises.ts
-src/js/internal/stream.ts
-src/js/internal/streams/add-abort-signal.ts
-src/js/internal/streams/compose.ts
-src/js/internal/streams/destroy.ts
-src/js/internal/streams/duplex.ts
-src/js/internal/streams/duplexify.ts
-src/js/internal/streams/duplexpair.ts
-src/js/internal/streams/end-of-stream.ts
-src/js/internal/streams/from.ts
-src/js/internal/streams/lazy_transform.ts
-src/js/internal/streams/legacy.ts
-src/js/internal/streams/native-readable.ts
-src/js/internal/streams/operators.ts
-src/js/internal/streams/passthrough.ts
-src/js/internal/streams/pipeline.ts
-src/js/internal/streams/readable.ts
-src/js/internal/streams/state.ts
-src/js/internal/streams/transform.ts
-src/js/internal/streams/utils.ts
-src/js/internal/streams/writable.ts
-src/js/internal/timers.ts
-src/js/internal/tls.ts
-src/js/internal/tty.ts
-src/js/internal/url.ts
-src/js/internal/util/colors.ts
-src/js/internal/util/inspect.d.ts
-src/js/internal/util/inspect.js
-src/js/internal/util/mime.ts
-src/js/internal/validators.ts
-src/js/internal/webstreams_adapters.ts
-src/js/node/_http_agent.ts
-src/js/node/_http_client.ts
-src/js/node/_http_common.ts
-src/js/node/_http_incoming.ts
-src/js/node/_http_outgoing.ts
-src/js/node/_http_server.ts
-src/js/node/_stream_duplex.ts
-src/js/node/_stream_passthrough.ts
-src/js/node/_stream_readable.ts
-src/js/node/_stream_transform.ts
-src/js/node/_stream_wrap.ts
-src/js/node/_stream_writable.ts
-src/js/node/_tls_common.ts
-src/js/node/assert.strict.ts
-src/js/node/assert.ts
-src/js/node/async_hooks.ts
-src/js/node/child_process.ts
-src/js/node/cluster.ts
-src/js/node/console.ts
-src/js/node/crypto.ts
-src/js/node/dgram.ts
-src/js/node/diagnostics_channel.ts
-src/js/node/dns.promises.ts
-src/js/node/dns.ts
-src/js/node/domain.ts
-src/js/node/events.ts
-src/js/node/fs.promises.ts
-src/js/node/fs.ts
-src/js/node/http.ts
-src/js/node/http2.ts
-src/js/node/https.ts
-src/js/node/inspector.ts
-src/js/node/net.ts
-src/js/node/os.ts
-src/js/node/path.posix.ts
-src/js/node/path.ts
-src/js/node/path.win32.ts
-src/js/node/perf_hooks.ts
-src/js/node/punycode.ts
-src/js/node/querystring.ts
-src/js/node/readline.promises.ts
-src/js/node/readline.ts
-src/js/node/repl.ts
-src/js/node/stream.consumers.ts
-src/js/node/stream.promises.ts
-src/js/node/stream.ts
-src/js/node/stream.web.ts
-src/js/node/test.ts
-src/js/node/timers.promises.ts
-src/js/node/timers.ts
-src/js/node/tls.ts
-src/js/node/trace_events.ts
-src/js/node/tty.ts
-src/js/node/url.ts
-src/js/node/util.ts
-src/js/node/v8.ts
-src/js/node/vm.ts
-src/js/node/wasi.ts
-src/js/node/worker_threads.ts
-src/js/node/zlib.ts
-src/js/private.d.ts
-src/js/thirdparty/isomorphic-fetch.ts
-src/js/thirdparty/node-fetch.ts
-src/js/thirdparty/undici.js
-src/js/thirdparty/vercel_fetch.js
-src/js/thirdparty/ws.js
-src/js/wasi-runner.js

cmake/sources/NodeFallbacksSources.txt

@@ -1,24 +0,0 @@
-src/node-fallbacks/assert.js
-src/node-fallbacks/buffer.js
-src/node-fallbacks/console.js
-src/node-fallbacks/constants.js
-src/node-fallbacks/crypto.js
-src/node-fallbacks/domain.js
-src/node-fallbacks/events.js
-src/node-fallbacks/http.js
-src/node-fallbacks/https.js
-src/node-fallbacks/net.js
-src/node-fallbacks/os.js
-src/node-fallbacks/path.js
-src/node-fallbacks/process.js
-src/node-fallbacks/punycode.js
-src/node-fallbacks/querystring.js
-src/node-fallbacks/stream.js
-src/node-fallbacks/string_decoder.js
-src/node-fallbacks/sys.js
-src/node-fallbacks/timers.js
-src/node-fallbacks/timers.promises.js
-src/node-fallbacks/tty.js
-src/node-fallbacks/url.js
-src/node-fallbacks/util.js
-src/node-fallbacks/zlib.js

cmake/sources/ZigGeneratedClassesSources.txt

@@ -1,25 +0,0 @@
-src/bun.js/api/BunObject.classes.ts
-src/bun.js/api/crypto.classes.ts
-src/bun.js/api/ffi.classes.ts
-src/bun.js/api/filesystem_router.classes.ts
-src/bun.js/api/Glob.classes.ts
-src/bun.js/api/h2.classes.ts
-src/bun.js/api/html_rewriter.classes.ts
-src/bun.js/api/JSBundler.classes.ts
-src/bun.js/api/ResumableSink.classes.ts
-src/bun.js/api/S3Client.classes.ts
-src/bun.js/api/S3Stat.classes.ts
-src/bun.js/api/server.classes.ts
-src/bun.js/api/Shell.classes.ts
-src/bun.js/api/ShellArgs.classes.ts
-src/bun.js/api/sockets.classes.ts
-src/bun.js/api/sourcemap.classes.ts
-src/bun.js/api/sql.classes.ts
-src/bun.js/api/streams.classes.ts
-src/bun.js/api/valkey.classes.ts
-src/bun.js/api/zlib.classes.ts
-src/bun.js/node/node.classes.ts
-src/bun.js/resolve_message.classes.ts
-src/bun.js/test/jest.classes.ts
-src/bun.js/webcore/encoding.classes.ts
-src/bun.js/webcore/response.classes.ts

cmake/tools/SetupWebKit.cmake

@@ -2,7 +2,7 @@ option(WEBKIT_VERSION "The version of WebKit to use")
 option(WEBKIT_LOCAL "If a local version of WebKit should be used instead of downloading")
 
 if(NOT WEBKIT_VERSION)
-  set(WEBKIT_VERSION 9dba2893ab70f873d8bb6950ee1bccb6b20c10b9)
+  set(WEBKIT_VERSION f474428677de1fafaf13bb3b9a050fe3504dda25)
 endif()
 
 string(SUBSTRING ${WEBKIT_VERSION} 0 16 WEBKIT_VERSION_PREFIX)

cmake/tools/SetupZig.cmake

@@ -20,7 +20,7 @@ else()
   unsupported(CMAKE_SYSTEM_NAME)
 endif()
 
-set(ZIG_COMMIT "edc6229b1fafb1701a25fb4e17114cc756991546")
+set(ZIG_COMMIT "e0b7c318f318196c5f81fdf3423816a7b5bb3112")
 optionx(ZIG_TARGET STRING "The zig target to use" DEFAULT ${DEFAULT_ZIG_TARGET})
 
 if(CMAKE_BUILD_TYPE STREQUAL "Release")

docs/api/sql.md

@@ -1,4 +1,4 @@
-Bun provides native bindings for working with SQL databases through a unified Promise-based API that supports both PostgreSQL and SQLite. The interface is designed to be simple and performant, using tagged template literals for queries and offering features like connection pooling, transactions, and prepared statements.
+Bun provides native bindings for working with SQL databases through a unified Promise-based API that supports PostgreSQL, MySQL, and SQLite. The interface is designed to be simple and performant, using tagged template literals for queries and offering features like connection pooling, transactions, and prepared statements.
 
 ```ts
 import { sql, SQL } from "bun";
@@ -10,9 +10,16 @@ const users = await sql`
   LIMIT ${10}
 `;
 
-// With a a SQLite db
+// With MySQL
+const mysql = new SQL("mysql://user:pass@localhost:3306/mydb");
+const mysqlResults = await mysql`
+  SELECT * FROM users 
+  WHERE active = ${true}
+`;
+
+// With SQLite
 const sqlite = new SQL("sqlite://myapp.db");
-const results = await sqlite`
+const sqliteResults = await sqlite`
   SELECT * FROM users 
   WHERE active = ${1}
 `;
@@ -52,7 +59,7 @@ Bun.SQL provides a unified API for multiple database systems:
 
 PostgreSQL is used when:
 
-- The connection string doesn't match SQLite patterns (it's the fallback adapter)
+- The connection string doesn't match SQLite or MySQL patterns (it's the fallback adapter)
 - The connection string explicitly uses `postgres://` or `postgresql://` protocols
 - No connection string is provided and environment variables point to PostgreSQL
 
@@ -66,9 +73,82 @@ const pg = new SQL("postgres://user:pass@localhost:5432/mydb");
 await pg`SELECT ...`;
 ```
 
+### MySQL
+
+MySQL support is built into Bun.SQL, providing the same tagged template literal interface with full compatibility for MySQL 5.7+ and MySQL 8.0+:
+
+```ts
+import { SQL } from "bun";
+
+// MySQL connection
+const mysql = new SQL("mysql://user:password@localhost:3306/database");
+const mysql2 = new SQL("mysql2://user:password@localhost:3306/database"); // mysql2 protocol also works
+
+// Using options object
+const mysql3 = new SQL({
+  adapter: "mysql",
+  hostname: "localhost",
+  port: 3306,
+  database: "myapp",
+  username: "dbuser",
+  password: "secretpass",
+});
+
+// Works with parameters - automatically uses prepared statements
+const users = await mysql`SELECT * FROM users WHERE id = ${userId}`;
+
+// Transactions work the same as PostgreSQL
+await mysql.begin(async tx => {
+  await tx`INSERT INTO users (name) VALUES (${"Alice"})`;
+  await tx`UPDATE accounts SET balance = balance - 100 WHERE user_id = ${userId}`;
+});
+
+// Bulk inserts
+const newUsers = [
+  { name: "Alice", email: "alice@example.com" },
+  { name: "Bob", email: "bob@example.com" },
+];
+await mysql`INSERT INTO users ${mysql(newUsers)}`;
+```
+
+{% details summary="MySQL Connection String Formats" %}
+
+MySQL accepts various URL formats for connection strings:
+
+```ts
+// Standard mysql:// protocol
+new SQL("mysql://user:pass@localhost:3306/database");
+new SQL("mysql://user:pass@localhost/database"); // Default port 3306
+
+// mysql2:// protocol (compatibility with mysql2 npm package)
+new SQL("mysql2://user:pass@localhost:3306/database");
+
+// With query parameters
+new SQL("mysql://user:pass@localhost/db?ssl=true");
+
+// Unix socket connection
+new SQL("mysql://user:pass@/database?socket=/var/run/mysqld/mysqld.sock");
+```
+
+{% /details %}
+
+{% details summary="MySQL-Specific Features" %}
+
+MySQL databases support:
+
+- **Prepared statements**: Automatically created for parameterized queries with statement caching
+- **Binary protocol**: For better performance with prepared statements and accurate type handling
+- **Multiple result sets**: Support for stored procedures returning multiple result sets
+- **Authentication plugins**: Support for mysql_native_password, caching_sha2_password (MySQL 8.0 default), and sha256_password
+- **SSL/TLS connections**: Configurable SSL modes similar to PostgreSQL
+- **Connection attributes**: Client information sent to server for monitoring
+- **Query pipelining**: Execute multiple prepared statements without waiting for responses
+
+{% /details %}
+
 ### SQLite
 
-SQLite support is now built into Bun.SQL, providing the same tagged template literal interface as PostgreSQL:
+SQLite support is built into Bun.SQL, providing the same tagged template literal interface:
 
 ```ts
 import { SQL } from "bun";
@@ -90,8 +170,7 @@ const db2 = new SQL({
 const db3 = new SQL("myapp.db", { adapter: "sqlite" });
 ```
 
-<details>
-<summary>SQLite Connection String Formats</summary>
+{% details summary="SQLite Connection String Formats" %}
 
 SQLite accepts various URL formats for connection strings:
 
@@ -122,10 +201,9 @@ new SQL("sqlite://data.db?mode=rwc"); // Read-write-create mode (default)
 
 **Note:** Simple filenames without a protocol (like `"myapp.db"`) require explicitly specifying `{ adapter: "sqlite" }` to avoid ambiguity with PostgreSQL.
 
-</details>
+{% /details %}
 
-<details>
-<summary>SQLite-Specific Options</summary>
+{% details summary="SQLite-Specific Options" %}
 
 SQLite databases support additional configuration options:
 
@@ -151,7 +229,7 @@ Query parameters in the URL are parsed to set these options:
 - `?mode=rw` → `readonly: false, create: false`
 - `?mode=rwc` → `readonly: false, create: true` (default)
 
-</details>
+{% /details %}
 
 ### Inserting data
 
@@ -364,7 +442,24 @@ await query;
 
 ### Automatic Database Detection
 
-When using `Bun.sql()` without arguments or `new SQL()` with a connection string, the adapter is automatically detected based on the URL format. SQLite becomes the default adapter in these cases:
+When using `Bun.sql()` without arguments or `new SQL()` with a connection string, the adapter is automatically detected based on the URL format:
+
+#### MySQL Auto-Detection
+
+MySQL is automatically selected when the connection string matches these patterns:
+
+- `mysql://...` - MySQL protocol URLs
+- `mysql2://...` - MySQL2 protocol URLs (compatibility alias)
+
+```ts
+// These all use MySQL automatically (no adapter needed)
+const sql1 = new SQL("mysql://user:pass@localhost/mydb");
+const sql2 = new SQL("mysql2://user:pass@localhost:3306/mydb");
+
+// Works with DATABASE_URL environment variable
+DATABASE_URL="mysql://user:pass@localhost/mydb" bun run app.js
+DATABASE_URL="mysql2://user:pass@localhost:3306/mydb" bun run app.js
+```
 
 #### SQLite Auto-Detection
 
@@ -390,17 +485,42 @@ DATABASE_URL="file://./data/app.db" bun run app.js
 
 #### PostgreSQL Auto-Detection
 
-PostgreSQL is the default for all other connection strings:
+PostgreSQL is the default for connection strings that don't match MySQL or SQLite patterns:
 
 ```bash
 # PostgreSQL is detected for these patterns
 DATABASE_URL="postgres://user:pass@localhost:5432/mydb" bun run app.js
 DATABASE_URL="postgresql://user:pass@localhost:5432/mydb" bun run app.js
 
-# Or any URL that doesn't match SQLite patterns
+# Or any URL that doesn't match MySQL or SQLite patterns
 DATABASE_URL="localhost:5432/mydb" bun run app.js
 ```
 
+### MySQL Environment Variables
+
+MySQL connections can be configured via environment variables:
+
+```bash
+# Primary connection URL (checked first)
+MYSQL_URL="mysql://user:pass@localhost:3306/mydb"
+
+# Alternative: DATABASE_URL with MySQL protocol
+DATABASE_URL="mysql://user:pass@localhost:3306/mydb"
+DATABASE_URL="mysql2://user:pass@localhost:3306/mydb"
+```
+
+If no connection URL is provided, MySQL checks these individual parameters:
+
+| Environment Variable     | Default Value | Description                      |
+| ------------------------ | ------------- | -------------------------------- |
+| `MYSQL_HOST`             | `localhost`   | Database host                    |
+| `MYSQL_PORT`             | `3306`        | Database port                    |
+| `MYSQL_USER`             | `root`        | Database user                    |
+| `MYSQL_PASSWORD`         | (empty)       | Database password                |
+| `MYSQL_DATABASE`         | `mysql`       | Database name                    |
+| `MYSQL_URL`              | (empty)       | Primary connection URL for MySQL |
+| `TLS_MYSQL_DATABASE_URL` | (empty)       | SSL/TLS-enabled connection URL   |
+
 ### PostgreSQL Environment Variables
 
 The following environment variables can be used to define the PostgreSQL connection:
@@ -458,6 +578,54 @@ The `--sql-preconnect` flag will automatically establish a PostgreSQL connection
 
 You can configure your database connection manually by passing options to the SQL constructor. Options vary depending on the database adapter:
 
+### MySQL Options
+
+```ts
+import { SQL } from "bun";
+
+const db = new SQL({
+  // Required for MySQL when using options object
+  adapter: "mysql",
+
+  // Connection details
+  hostname: "localhost",
+  port: 3306,
+  database: "myapp",
+  username: "dbuser",
+  password: "secretpass",
+
+  // Unix socket connection (alternative to hostname/port)
+  // socket: "/var/run/mysqld/mysqld.sock",
+
+  // Connection pool settings
+  max: 20, // Maximum connections in pool (default: 10)
+  idleTimeout: 30, // Close idle connections after 30s
+  maxLifetime: 0, // Connection lifetime in seconds (0 = forever)
+  connectionTimeout: 30, // Timeout when establishing new connections
+
+  // SSL/TLS options
+  ssl: "prefer", // or "disable", "require", "verify-ca", "verify-full"
+  // tls: {
+  //   rejectUnauthorized: true,
+  //   ca: "path/to/ca.pem",
+  //   key: "path/to/key.pem",
+  //   cert: "path/to/cert.pem",
+  // },
+
+  // Callbacks
+  onconnect: client => {
+    console.log("Connected to MySQL");
+  },
+  onclose: (client, err) => {
+    if (err) {
+      console.error("MySQL connection error:", err);
+    } else {
+      console.log("MySQL connection closed");
+    }
+  },
+});
+```
+
 ### PostgreSQL Options
 
 ```ts
@@ -532,15 +700,14 @@ const db = new SQL({
 });
 ```
 
-<details>
-<summary>SQLite Connection Notes</summary>
+{% details summary="SQLite Connection Notes" %}
 
 - **Connection Pooling**: SQLite doesn't use connection pooling as it's a file-based database. Each `SQL` instance represents a single connection.
 - **Transactions**: SQLite supports nested transactions through savepoints, similar to PostgreSQL.
 - **Concurrent Access**: SQLite handles concurrent access through file locking. Use WAL mode for better concurrency.
 - **Memory Databases**: Using `:memory:` creates a temporary database that exists only for the connection lifetime.
 
-</details>
+{% /details %}
 
 ## Dynamic passwords
 
@@ -838,6 +1005,8 @@ try {
 }
 ```
 
+{% details summary="PostgreSQL-Specific Error Codes" %}
+
 ### PostgreSQL Connection Errors
 
 | Connection Errors                 | Description                                          |
@@ -903,12 +1072,13 @@ try {
 | `ERR_POSTGRES_UNSAFE_TRANSACTION`        | Unsafe transaction operation detected |
 | `ERR_POSTGRES_INVALID_TRANSACTION_STATE` | Invalid transaction state             |
 
+{% /details %}
+
 ### SQLite-Specific Errors
 
 SQLite errors provide error codes and numbers that correspond to SQLite's standard error codes:
 
-<details>
-<summary>Common SQLite Error Codes</summary>
+{% details summary="Common SQLite Error Codes" %}
 
 | Error Code          | errno | Description                                          |
 | ------------------- | ----- | ---------------------------------------------------- |
@@ -945,7 +1115,7 @@ try {
 }
 ```
 
-</details>
+{% /details %}
 
 ## Numbers and BigInt
 
@@ -979,11 +1149,106 @@ console.log(typeof x, x); // "bigint" 9223372036854777n
 There's still some things we haven't finished yet.
 
 - Connection preloading via `--db-preconnect` Bun CLI flag
-- MySQL support: [we're working on it](https://github.com/oven-sh/bun/pull/15274)
 - Column name transforms (e.g. `snake_case` to `camelCase`). This is mostly blocked on a unicode-aware implementation of changing the case in C++ using WebKit's `WTF::String`.
 - Column type transforms
 
-### Postgres-specific features
+## Database-Specific Features
+
+#### Authentication Methods
+
+MySQL supports multiple authentication plugins that are automatically negotiated:
+
+- **`mysql_native_password`** - Traditional MySQL authentication, widely compatible
+- **`caching_sha2_password`** - Default in MySQL 8.0+, more secure with RSA key exchange
+- **`sha256_password`** - SHA-256 based authentication
+
+The client automatically handles authentication plugin switching when requested by the server, including secure password exchange over non-SSL connections.
+
+#### Prepared Statements & Performance
+
+MySQL uses server-side prepared statements for all parameterized queries:
+
+```ts
+// This automatically creates a prepared statement on the server
+const user = await mysql`SELECT * FROM users WHERE id = ${userId}`;
+
+// Prepared statements are cached and reused for identical queries
+for (const id of userIds) {
+  // Same prepared statement is reused
+  await mysql`SELECT * FROM users WHERE id = ${id}`;
+}
+
+// Query pipelining - multiple statements sent without waiting
+const [users, orders, products] = await Promise.all([
+  mysql`SELECT * FROM users WHERE active = ${true}`,
+  mysql`SELECT * FROM orders WHERE status = ${"pending"}`,
+  mysql`SELECT * FROM products WHERE in_stock = ${true}`,
+]);
+```
+
+#### Multiple Result Sets
+
+MySQL can return multiple result sets from multi-statement queries:
+
+```ts
+const mysql = new SQL("mysql://user:pass@localhost/mydb");
+
+// Multi-statement queries with simple() method
+const multiResults = await mysql`
+  SELECT * FROM users WHERE id = 1;
+  SELECT * FROM orders WHERE user_id = 1;
+`.simple();
+```
+
+#### Character Sets & Collations
+
+Bun.SQL automatically uses `utf8mb4` character set for MySQL connections, ensuring full Unicode support including emojis. This is the recommended character set for modern MySQL applications.
+
+#### Connection Attributes
+
+Bun automatically sends client information to MySQL for better monitoring:
+
+```ts
+// These attributes are sent automatically:
+// _client_name: "Bun"
+// _client_version: <bun version>
+// You can see these in MySQL's performance_schema.session_connect_attrs
+```
+
+#### Type Handling
+
+MySQL types are automatically converted to JavaScript types:
+
+| MySQL Type                              | JavaScript Type          | Notes                                                                                                |
+| --------------------------------------- | ------------------------ | ---------------------------------------------------------------------------------------------------- |
+| INT, TINYINT, MEDIUMINT                 | number                   | Within safe integer range                                                                            |
+| BIGINT                                  | string, number or BigInt | If the value fits in i32/u32 size will be number otherwise string or BigInt Based on `bigint` option |
+| DECIMAL, NUMERIC                        | string                   | To preserve precision                                                                                |
+| FLOAT, DOUBLE                           | number                   |                                                                                                      |
+| DATE                                    | Date                     | JavaScript Date object                                                                               |
+| DATETIME, TIMESTAMP                     | Date                     | With timezone handling                                                                               |
+| TIME                                    | number                   | Total of microseconds                                                                                |
+| YEAR                                    | number                   |                                                                                                      |
+| CHAR, VARCHAR, VARSTRING, STRING        | string                   |                                                                                                      |
+| TINY TEXT, MEDIUM TEXT, TEXT, LONG TEXT | string                   |                                                                                                      |
+| TINY BLOB, MEDIUM BLOB, BLOG, LONG BLOB | string                   | BLOB Types are alias for TEXT types                                                                  |
+| JSON                                    | object/array             | Automatically parsed                                                                                 |
+| BIT(1)                                  | boolean                  | BIT(1) in MySQL                                                                                      |
+| GEOMETRY                                | string                   | Geometry data                                                                                        |
+
+#### Differences from PostgreSQL
+
+While the API is unified, there are some behavioral differences:
+
+1. **Parameter placeholders**: MySQL uses `?` internally but Bun converts `$1, $2` style automatically
+2. **RETURNING clause**: MySQL doesn't support RETURNING; use `result.lastInsertRowid` or a separate SELECT
+3. **Array types**: MySQL doesn't have native array types like PostgreSQL
+
+### MySQL-Specific Features
+
+We haven't implemented `LOAD DATA INFILE` support yet
+
+### PostgreSQL-Specific Features
 
 We haven't implemented these yet:
 
@@ -998,13 +1263,89 @@ We also haven't implemented some of the more uncommon features like:
 - Point & PostGIS types
 - All the multi-dimensional integer array types (only a couple of the types are supported)
 
+## Common Patterns & Best Practices
+
+### Working with MySQL Result Sets
+
+```ts
+// Getting insert ID after INSERT
+const result = await mysql`INSERT INTO users (name) VALUES (${"Alice"})`;
+console.log(result.lastInsertRowid); // MySQL's LAST_INSERT_ID()
+
+// Handling affected rows
+const updated =
+  await mysql`UPDATE users SET active = ${false} WHERE age < ${18}`;
+console.log(updated.affectedRows); // Number of rows updated
+
+// Using MySQL-specific functions
+const now = await mysql`SELECT NOW() as current_time`;
+const uuid = await mysql`SELECT UUID() as id`;
+```
+
+### MySQL Error Handling
+
+```ts
+try {
+  await mysql`INSERT INTO users (email) VALUES (${"duplicate@email.com"})`;
+} catch (error) {
+  if (error.code === "ER_DUP_ENTRY") {
+    console.log("Duplicate entry detected");
+  } else if (error.code === "ER_ACCESS_DENIED_ERROR") {
+    console.log("Access denied");
+  } else if (error.code === "ER_BAD_DB_ERROR") {
+    console.log("Database does not exist");
+  }
+  // MySQL error codes are compatible with mysql/mysql2 packages
+}
+```
+
+### Performance Tips for MySQL
+
+1. **Use connection pooling**: Set appropriate `max` pool size based on your workload
+2. **Enable prepared statements**: They're enabled by default and improve performance
+3. **Use transactions for bulk operations**: Group related queries in transactions
+4. **Index properly**: MySQL relies heavily on indexes for query performance
+5. **Use `utf8mb4` charset**: It's set by default and handles all Unicode characters
+
 ## Frequently Asked Questions
 
 > Why is this `Bun.sql` and not `Bun.postgres`?
 
-The plan is to add more database drivers in the future.
+The plan was to add more database drivers in the future. Now with MySQL support added, this unified API supports PostgreSQL, MySQL, and SQLite.
 
-> Why not just use an existing library?
+> How do I know which database adapter is being used?
+
+The adapter is automatically detected from the connection string:
+
+- URLs starting with `mysql://` or `mysql2://` use MySQL
+- URLs matching SQLite patterns (`:memory:`, `sqlite://`, `file://`) use SQLite
+- Everything else defaults to PostgreSQL
+
+> Are MySQL stored procedures supported?
+
+Yes, stored procedures are fully supported including OUT parameters and multiple result sets:
+
+```ts
+// Call stored procedure
+const results = await mysql`CALL GetUserStats(${userId}, @total_orders)`;
+
+// Get OUT parameter
+const outParam = await mysql`SELECT @total_orders as total`;
+```
+
+> Can I use MySQL-specific SQL syntax?
+
+Yes, you can use any MySQL-specific syntax:
+
+```ts
+// MySQL-specific syntax works fine
+await mysql`SET @user_id = ${userId}`;
+await mysql`SHOW TABLES`;
+await mysql`DESCRIBE users`;
+await mysql`EXPLAIN SELECT * FROM users WHERE id = ${id}`;
+```
+
+## Why not just use an existing library?
 
 npm packages like postgres.js, pg, and node-postgres can be used in Bun too. They're great options.
 

docs/api/workers.md

@@ -122,6 +122,59 @@ Messages are automatically enqueued until the worker is ready, so there is no ne
 
 To send messages, use [`worker.postMessage`](https://developer.mozilla.org/en-US/docs/Web/API/Worker/postMessage) and [`self.postMessage`](https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage). This leverages the [HTML Structured Clone Algorithm](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm).
 
+### Performance optimizations
+
+Bun includes optimized fast paths for `postMessage` to dramatically improve performance for common data types:
+
+**String fast path** - When posting pure string values, Bun bypasses the structured clone algorithm entirely, achieving significant performance gains with no serialization overhead.
+
+**Simple object fast path** - For plain objects containing only primitive values (strings, numbers, booleans, null, undefined), Bun uses an optimized serialization path that stores properties directly without full structured cloning.
+
+The simple object fast path activates when the object:
+
+- Is a plain object with no prototype chain modifications
+- Contains only enumerable, configurable data properties
+- Has no indexed properties or getter/setter methods
+- All property values are primitives or strings
+
+With these fast paths, Bun's `postMessage` performs **2-241x faster** because the message length no longer has a meaningful impact on performance.
+
+**Bun (with fast paths):**
+
+```
+postMessage({ prop: 11 chars string, ...9 more props }) - 648ns
+postMessage({ prop: 14 KB string, ...9 more props })    - 719ns
+postMessage({ prop: 3 MB string, ...9 more props })     - 1.26µs
+```
+
+**Node.js v24.6.0 (for comparison):**
+
+```
+postMessage({ prop: 11 chars string, ...9 more props }) - 1.19µs
+postMessage({ prop: 14 KB string, ...9 more props })    - 2.69µs
+postMessage({ prop: 3 MB string, ...9 more props })     - 304µs
+```
+
+```js
+// String fast path - optimized
+postMessage("Hello, worker!");
+
+// Simple object fast path - optimized
+postMessage({
+  message: "Hello",
+  count: 42,
+  enabled: true,
+  data: null,
+});
+
+// Complex objects still work but use standard structured clone
+postMessage({
+  nested: { deep: { object: true } },
+  date: new Date(),
+  buffer: new ArrayBuffer(8),
+});
+```
+
 ```js
 // On the worker thread, `postMessage` is automatically "routed" to the parent thread.
 postMessage({ hello: "world" });

docs/api/yaml.md

@@ -436,9 +436,8 @@ bun build app.ts --outdir=dist
 This means:
 
 - Zero runtime YAML parsing overhead in production
-- Smaller bundle sizes (no YAML parser needed)
-- Type safety with TypeScript
-- Tree-shaking support for unused configuration
+- Smaller bundle sizes
+- Tree-shaking support for unused configuration (named imports)
 
 ### Dynamic Imports
 
@@ -458,73 +457,3 @@ async function loadUserSettings(userId: string) {
   }
 }
 ```
-
-## Use Cases
-
-### Testing and Fixtures
-
-YAML works well for test fixtures and seed data:
-
-```yaml#fixtures.yaml
-users:
-  - id: 1
-    name: Alice
-    email: alice@example.com
-    role: admin
-  - id: 2
-    name: Bob
-    email: bob@example.com
-    role: user
-
-products:
-  - sku: PROD-001
-    name: Widget
-    price: 19.99
-    stock: 100
-```
-
-```ts
-import fixtures from "./fixtures.yaml";
-import { db } from "./database";
-
-async function seed() {
-  await db.user.createMany({ data: fixtures.users });
-  await db.product.createMany({ data: fixtures.products });
-}
-```
-
-### API Definitions
-
-YAML is commonly used for API specifications like OpenAPI:
-
-```yaml#api.yaml
-openapi: 3.0.0
-info:
-  title: My API
-  version: 1.0.0
-
-paths:
-  /users:
-    get:
-      summary: List users
-      responses:
-        200:
-          description: Success
-```
-
-```ts#api.ts
-import apiSpec from "./api.yaml";
-import { generateRoutes } from "./router";
-
-const routes = generateRoutes(apiSpec);
-```
-
-## Performance
-
-Bun's YAML parser is implemented in Zig for optimal performance:
-
-- **Fast parsing**: Native implementation provides excellent parse speed
-- **Build-time optimization**: When importing YAML files, parsing happens at build time, resulting in zero runtime overhead
-- **Memory efficient**: Streaming parser design minimizes memory usage
-- **Hot reload support**: changes to YAML files trigger instant reloads without server restarts when used with `bun --hot` or Bun's [frontend dev server](/docs/bundler/fullstack)
-- **Error recovery**: Detailed error messages with line and column information

docs/bundler/index.md

@@ -1,4 +1,4 @@
-Bun's fast native bundler is now in beta. It can be used via the `bun build` CLI command or the `Bun.build()` JavaScript API.
+Bun's fast native bundler can be used via the `bun build` CLI command or the `Bun.build()` JavaScript API.
 
 {% codetabs group="a" %}
 
@@ -1259,6 +1259,33 @@ $ bun build ./index.tsx --outdir ./out --drop=console --drop=debugger --drop=any
 
 {% /codetabs %}
 
+### `throw`
+
+Controls error handling behavior when the build fails. When set to `true` (default), the returned promise rejects with an `AggregateError`. When set to `false`, the promise resolves with a `BuildOutput` object where `success` is `false`.
+
+```ts#JavaScript
+// Default behavior: throws on error
+try {
+  await Bun.build({
+    entrypoints: ['./index.tsx'],
+    throw: true, // default
+  });
+} catch (error) {
+  // Handle AggregateError
+  console.error("Build failed:", error);
+}
+
+// Alternative: handle errors via success property
+const result = await Bun.build({
+  entrypoints: ['./index.tsx'],
+  throw: false,
+});
+
+if (!result.success) {
+  console.error("Build failed with errors:", result.logs);
+}
+```
+
 ## Outputs
 
 The `Bun.build` function returns a `Promise<BuildOutput>`, defined as:
@@ -1569,8 +1596,7 @@ interface BuildConfig {
    * When set to `true`, the returned promise rejects with an AggregateError when a build failure happens.
    * When set to `false`, the `success` property of the returned object will be `false` when a build failure happens.
    *
-   * This defaults to `false` in Bun 1.1 and will change to `true` in Bun 1.2
-   * as most usage of `Bun.build` forgets to check for errors.
+   * This defaults to `true`.
    */
   throw?: boolean;
 }

docs/bundler/loaders.md

@@ -1,6 +1,6 @@
 The Bun bundler implements a set of default loaders out of the box. As a rule of thumb, the bundler and the runtime both support the same set of file types out of the box.
 
-`.js` `.cjs` `.mjs` `.mts` `.cts` `.ts` `.tsx` `.jsx` `.toml` `.json` `.txt` `.wasm` `.node` `.html`
+`.js` `.cjs` `.mjs` `.mts` `.cts` `.ts` `.tsx` `.jsx` `.toml` `.json` `.yaml` `.yml` `.txt` `.wasm` `.node` `.html`
 
 Bun uses the file extension to determine which built-in _loader_ should be used to parse the file. Every loader has a name, such as `js`, `tsx`, or `json`. These names are used when building [plugins](https://bun.com/docs/bundler/plugins) that extend Bun with custom loaders.
 
@@ -121,6 +121,55 @@ export default {
 
 {% /codetabs %}
 
+### `yaml`
+
+**YAML loader**. Default for `.yaml` and `.yml`.
+
+YAML files can be directly imported. Bun will parse them with its fast native YAML parser.
+
+```ts
+import config from "./config.yaml";
+config.database.host; // => "localhost"
+
+// via import attribute:
+// import myCustomYAML from './my.config' with {type: "yaml"};
+```
+
+During bundling, the parsed YAML is inlined into the bundle as a JavaScript object.
+
+```ts
+var config = {
+  database: {
+    host: "localhost",
+    port: 5432,
+  },
+  // ...other fields
+};
+config.database.host;
+```
+
+If a `.yaml` or `.yml` file is passed as an entrypoint, it will be converted to a `.js` module that `export default`s the parsed object.
+
+{% codetabs %}
+
+```yaml#Input
+name: John Doe
+age: 35
+email: johndoe@example.com
+```
+
+```js#Output
+export default {
+  name: "John Doe",
+  age: 35,
+  email: "johndoe@example.com"
+}
+```
+
+{% /codetabs %}
+
+For more details on YAML support including the runtime API `Bun.YAML.parse()`, see the [YAML API documentation](/docs/api/yaml).
+
 ### `text`
 
 **Text loader**. Default for `.txt`.

docs/bundler/plugins.md

@@ -9,6 +9,7 @@ Plugins can register callbacks to be run at various points in the lifecycle of a
 - [`onStart()`](#onstart): Run once the bundler has started a bundle
 - [`onResolve()`](#onresolve): Run before a module is resolved
 - [`onLoad()`](#onload): Run before a module is loaded.
+- [`onEnd()`](#onend): Run after the bundle has completed
 - [`onBeforeParse()`](#onbeforeparse): Run zero-copy native addons in the parser thread before a file is parsed.
 
 ### Reference
@@ -18,6 +19,7 @@ A rough overview of the types (please refer to Bun's `bun.d.ts` for the full typ
 ```ts
 type PluginBuilder = {
   onStart(callback: () => void): void;
+  onEnd(callback: (result: BuildOutput) => void | Promise<void>): void;
   onResolve: (
     args: { filter: RegExp; namespace?: string },
     callback: (args: { path: string; importer: string }) => {
@@ -285,6 +287,53 @@ plugin({
 
 Note that the `.defer()` function currently has the limitation that it can only be called once per `onLoad` callback.
 
+### `onEnd`
+
+```ts
+onEnd(callback: (result: BuildOutput) => void | Promise<void>): void;
+```
+
+Registers a callback to be run when the bundler completes a bundle (whether successful or not).
+
+The callback receives the `BuildOutput` object containing:
+
+- `success`: boolean indicating if the build succeeded
+- `outputs`: array of generated build artifacts
+- `logs`: array of build messages (warnings, errors, etc.)
+
+This is useful for post-processing, cleanup, notifications, or custom error handling.
+
+```ts
+await Bun.build({
+  entrypoints: ["./index.ts"],
+  outdir: "./out",
+  plugins: [
+    {
+      name: "onEnd example",
+      setup(build) {
+        build.onEnd(result => {
+          if (result.success) {
+            console.log(
+              `✅ Build succeeded with ${result.outputs.length} outputs`,
+            );
+          } else {
+            console.error(`❌ Build failed with ${result.logs.length} errors`);
+          }
+        });
+      },
+    },
+  ],
+});
+```
+
+The `onEnd` callbacks are called:
+
+- **Before** the build promise resolves or rejects
+- **After** all bundling is complete
+- **In the order** they were registered
+
+Multiple plugins can register `onEnd` callbacks, and they will all be called sequentially. If an `onEnd` callback returns a promise, the build will wait for it to resolve before continuing.
+
 ## Native plugins
 
 One of the reasons why Bun's bundler is so fast is that it is written in native code and leverages multi-threading to load and parse modules in parallel.

docs/bundler/vs-esbuild.md

@@ -245,8 +245,8 @@ In Bun's CLI, simple boolean flags like `--minify` do not accept an argument. Ot
 ---
 
 - `--jsx-side-effects`
-- n/a
-- JSX is always assumed to be side-effect-free
+- `--jsx-side-effects`
+- Controls whether JSX expressions are marked as `/* @__PURE__ */` for dead code elimination. Default is `false` (JSX marked as pure).
 
 ---
 
@@ -617,7 +617,7 @@ In Bun's CLI, simple boolean flags like `--minify` do not accept an argument. Ot
 
 - `jsxSideEffects`
 - `jsxSideEffects`
-- Not supported in JS API, configure in `tsconfig.json`
+- Controls whether JSX expressions are marked as pure for dead code elimination
 
 ---
 

docs/cli/bun-install.md

@@ -230,16 +230,15 @@ $ bun install --backend copyfile
 
 **`symlink`** is typically only used for `file:` dependencies (and eventually `link:`) internally. To prevent infinite loops, it skips symlinking the `node_modules` folder.
 
-If you install with `--backend=symlink`, Node.js won't resolve node_modules of dependencies unless each dependency has its own node_modules folder or you pass `--preserve-symlinks` to `node`. See [Node.js documentation on `--preserve-symlinks`](https://nodejs.org/api/cli.html#--preserve-symlinks).
+If you install with `--backend=symlink`, Node.js won't resolve node_modules of dependencies unless each dependency has its own node_modules folder or you pass `--preserve-symlinks` to `node` or `bun`. See [Node.js documentation on `--preserve-symlinks`](https://nodejs.org/api/cli.html#--preserve-symlinks).
 
 ```bash
 $ rm -rf node_modules
 $ bun install --backend symlink
+$ bun --preserve-symlinks ./my-file.js
 $ node --preserve-symlinks ./my-file.js # https://nodejs.org/api/cli.html#--preserve-symlinks
 ```
 
-Bun's runtime does not currently expose an equivalent of `--preserve-symlinks`, though the code for it does exist.
-
 ## npm registry metadata
 
 bun uses a binary format for caching NPM registry responses. This loads much faster than JSON and tends to be smaller on disk.

docs/cli/install.md

@@ -8,6 +8,14 @@ The `bun` CLI contains a Node.js-compatible package manager designed to be a dra
 
 {% /callout %}
 
+{% callout %}
+
+**💾 Disk efficient** — Bun install stores all packages in a global cache (`~/.bun/install/cache/`) and creates hardlinks (Linux) or copy-on-write clones (macOS) to `node_modules`. This means duplicate packages across projects point to the same underlying data, taking up virtually no extra disk space.
+
+For more details, see [Package manager > Global cache](https://bun.com/docs/install/cache).
+
+{% /callout %}
+
 {% details summary="For Linux users" %}
 The recommended minimum Linux Kernel version is 5.6. If you're on Linux kernel 5.1 - 5.5, `bun install` will work, but HTTP requests will be slow due to a lack of support for io_uring's `connect()` operation.
 
@@ -207,6 +215,12 @@ Isolated installs create a central package store in `node_modules/.bun/` with sy
 
 For complete documentation on isolated installs, refer to [Package manager > Isolated installs](https://bun.com/docs/install/isolated).
 
+## Disk efficiency
+
+Bun uses a global cache at `~/.bun/install/cache/` to minimize disk usage. Packages are stored once and linked to `node_modules` using hardlinks (Linux/Windows) or copy-on-write (macOS), so duplicate packages across projects don't consume additional disk space.
+
+For complete documentation refer to [Package manager > Global cache](https://bun.com/docs/install/cache).
+
 ## Configuration
 
 The default behavior of `bun install` can be configured in `bunfig.toml`. The default values are shown below.

docs/guides/deployment/index.json

@@ -0,0 +1,4 @@
+{
+  "name": "Deployment",
+  "description": "A collection of guides for deploying Bun to providers"
+}

docs/guides/deployment/railway.md

@@ -0,0 +1,157 @@
+---
+name: Deploy a Bun application on Railway
+description: Deploy Bun applications to Railway with this step-by-step guide covering CLI and dashboard methods, optional PostgreSQL setup, and automatic SSL configuration.
+---
+
+Railway is an infrastructure platform where you can provision infrastructure, develop with that infrastructure locally, and then deploy to the cloud. It enables instant deployments from GitHub with zero configuration, automatic SSL, and built-in database provisioning.
+
+This guide walks through deploying a Bun application with a PostgreSQL database (optional), which is exactly what the template below provides.
+
+You can either follow this guide step-by-step or simply deploy the pre-configured template with one click:
+
+{% raw %}
+
+<a href="https://railway.com/deploy/bun-react-postgres?referralCode=Bun&utm_medium=integration&utm_source=template&utm_campaign=bun" target="_blank">
+  <img src="https://railway.com/button.svg" alt="Deploy on Railway" />
+</a>
+
+{% /raw %}
+
+---
+
+**Prerequisites**:
+
+- A Bun application ready for deployment
+- A [Railway account](https://railway.app/)
+- Railway CLI (for CLI deployment method)
+- A GitHub account (for Dashboard deployment method)
+
+---
+
+## Method 1: Deploy via CLI
+
+---
+
+#### Step 1
+
+Ensure sure you have the Railway CLI installed.
+
+```bash
+bun install -g @railway/cli
+```
+
+---
+
+#### Step 2
+
+Log into your Railway account.
+
+```bash
+railway login
+```
+
+---
+
+#### Step 3
+
+After successfully authenticating, initialize a new project.
+
+```bash
+# Initialize project
+bun-react-postgres$ railway init
+```
+
+---
+
+#### Step 4
+
+After initializing the project, add a new database and service.
+
+> **Note:** Step 4 is only necessary if your application uses a database. If you don't need PostgreSQL, skip to Step 5.
+
+```bash
+# Add PostgreSQL database. Make sure to add this first!
+bun-react-postgres$ railway add --database postgres
+
+# Add your application service.
+bun-react-postgres$ railway add --service bun-react-db --variables DATABASE_URL=\${{Postgres.DATABASE_URL}}
+```
+
+---
+
+#### Step 5
+
+After the services have been created and connected, deploy the application to Railway. By default, services are only accessible within Railway's private network. To make your app publicly accessible, you need to generate a public domain.
+
+```bash
+# Deploy your application
+bun-nextjs-starter$ railway up
+
+# Generate public domain
+bun-nextjs-starter$ railway domain
+```
+
+---
+
+## Method 2: Deploy via Dashboard
+
+---
+
+#### Step 1
+
+Create a new project
+
+1. Go to [Railway Dashboard](http://railway.com/dashboard?utm_medium=integration&utm_source=docs&utm_campaign=bun)
+2. Click **"+ New"** → **"GitHub repo"**
+3. Choose your repository
+
+---
+
+#### Step 2
+
+Add a PostgreSQL database, and connect this database to the service
+
+> **Note:** Step 2 is only necessary if your application uses a database. If you don't need PostgreSQL, skip to Step 3.
+
+1. Click **"+ New"** → **"Database"** → **"Add PostgreSQL"**
+2. After the database has been created, select your service (not the database)
+3. Go to **"Variables"** tab
+4. Click **"+ New Variable"** → **"Add Reference"**
+5. Select `DATABASE_URL` from postgres
+
+---
+
+#### Step 3
+
+Generate a public domain
+
+1. Select your service
+2. Go to **"Settings"** tab
+3. Under **"Networking"**, click **"Generate Domain"**
+
+---
+
+Your app is now live! Railway auto-deploys on every GitHub push.
+
+---
+
+## Configuration (Optional)
+
+---
+
+By default, Railway uses [Nixpacks](https://docs.railway.com/guides/build-configuration#nixpacks-options) to automatically detect and build your Bun application with zero configuration.
+
+However, using the [Railpack](https://docs.railway.com/guides/build-configuration#railpack) application builder provides better Bun support, and will always support the latest version of Bun. The pre-configured templates use Railpack by default.
+
+To enable Railpack in a custom project, add the following to your `railway.json`:
+
+```json
+{
+  "$schema": "https://railway.com/railway.schema.json",
+  "build": {
+    "builder": "RAILPACK"
+  }
+}
+```
+
+For more build configuration settings, check out the [Railway documentation](https://docs.railway.com/guides/build-configuration).

docs/guides/runtime/import-yaml.md

@@ -0,0 +1,76 @@
+---
+name: Import a YAML file
+---
+
+Bun natively supports `.yaml` and `.yml` imports.
+
+```yaml#config.yaml
+database:
+  host: localhost
+  port: 5432
+  name: myapp
+
+server:
+  port: 3000
+  timeout: 30
+
+features:
+  auth: true
+  rateLimit: true
+```
+
+---
+
+Import the file like any other source file.
+
+```ts
+import config from "./config.yaml";
+
+config.database.host; // => "localhost"
+config.server.port; // => 3000
+config.features.auth; // => true
+```
+
+---
+
+You can also use named imports to destructure top-level properties:
+
+```ts
+import { database, server, features } from "./config.yaml";
+
+console.log(database.name); // => "myapp"
+console.log(server.timeout); // => 30
+console.log(features.rateLimit); // => true
+```
+
+---
+
+Bun also supports [Import Attributes](https://github.com/tc39/proposal-import-attributes) syntax:
+
+```ts
+import config from "./config.yaml" with { type: "yaml" };
+
+config.database.port; // => 5432
+```
+
+---
+
+For parsing YAML strings at runtime, use `Bun.YAML.parse()`:
+
+```ts
+const yamlString = `
+name: John Doe
+age: 30
+hobbies:
+  - reading
+  - coding
+`;
+
+const data = Bun.YAML.parse(yamlString);
+console.log(data.name); // => "John Doe"
+console.log(data.hobbies); // => ["reading", "coding"]
+```
+
+---
+
+See [Docs > API > YAML](https://bun.com/docs/api/yaml) for complete documentation on YAML support in Bun.

docs/guides/runtime/set-env.md

@@ -17,7 +17,7 @@ Bun reads the following files automatically (listed in order of increasing prece
 
 - `.env`
 - `.env.production`, `.env.development`, `.env.test` (depending on value of `NODE_ENV`)
-- `.env.local`
+- `.env.local` (not loaded when `NODE_ENV=test`)
 
 ```txt#.env
 FOO=hello

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

@@ -35,7 +35,7 @@ Add this directive to _just one file_ in your project, such as:
 - Any single `.ts` file that TypeScript includes in your compilation
 
 ```ts
-/// <reference types="bun/test-globals" />
+/// <reference types="bun-types/test-globals" />
 ```
 
 ---

docs/install/cache.md

@@ -48,12 +48,12 @@ This behavior is configurable with the `--backend` flag, which is respected by a
 - **`copyfile`**: The fallback used when any of the above fail. It is the slowest option. On macOS, it uses `fcopyfile()`; on Linux it uses `copy_file_range()`.
 - **`symlink`**: Currently used only `file:` (and eventually `link:`) dependencies. To prevent infinite loops, it skips symlinking the `node_modules` folder.
 
-If you install with `--backend=symlink`, Node.js won't resolve node_modules of dependencies unless each dependency has its own `node_modules` folder or you pass `--preserve-symlinks` to `node`. See [Node.js documentation on `--preserve-symlinks`](https://nodejs.org/api/cli.html#--preserve-symlinks).
+If you install with `--backend=symlink`, Node.js won't resolve node_modules of dependencies unless each dependency has its own `node_modules` folder or you pass `--preserve-symlinks` to `node` or `bun`. See [Node.js documentation on `--preserve-symlinks`](https://nodejs.org/api/cli.html#--preserve-symlinks).
 
 ```bash
 $ bun install --backend symlink
 $ node --preserve-symlinks ./foo.js
+$ bun --preserve-symlinks ./foo.js
 ```
 
-Bun's runtime does not currently expose an equivalent of `--preserve-symlinks`.
 {% /details %}

docs/install/security-scanner-api.md

@@ -76,6 +76,6 @@ For a complete example with tests and CI setup, see the official template:
 
 ## Related
 
-- [Configuration (bunfig.toml)](/docs/runtime/bunfig#installsecurityscanner)
+- [Configuration (bunfig.toml)](/docs/runtime/bunfig#install-security-scanner)
 - [Package Manager](/docs/install)
 - [Security Scanner Template](https://github.com/oven-sh/security-scanner-template)

docs/nav.ts

@@ -219,6 +219,9 @@ export default {
     page("install/npmrc", ".npmrc support", {
       description: "Bun supports loading some configuration options from .npmrc",
     }),
+    page("install/security-scanner-api", "Security Scanner API", {
+      description: "Scan your project for vulnerabilities with Bun's security scanner API.",
+    }),
     // page("install/utilities", "Utilities", {
     //   description: "Use `bun pm` to introspect your global module cache or project dependency tree.",
     // }),

docs/runtime/bun-apis.md

@@ -195,7 +195,7 @@ Click the link in the right column to jump to the associated documentation.
 ---
 
 - Parsing & Formatting
-- [`Bun.semver`](https://bun.com/docs/api/semver), `Bun.TOML.parse`, [`Bun.color`](https://bun.com/docs/api/color)
+- [`Bun.semver`](https://bun.com/docs/api/semver), `Bun.TOML.parse`, [`Bun.YAML.parse`](https://bun.com/docs/api/yaml), [`Bun.color`](https://bun.com/docs/api/color)
 
 ---
 

docs/runtime/bunfig.md

@@ -94,6 +94,7 @@ Bun supports the following loaders:
 - `file`
 - `json`
 - `toml`
+- `yaml`
 - `wasm`
 - `napi`
 - `base64`

docs/runtime/env.md

@@ -8,6 +8,10 @@ Bun reads the following files automatically (listed in order of increasing prece
 - `.env.production`, `.env.development`, `.env.test` (depending on value of `NODE_ENV`)
 - `.env.local`
 
+{% callout %}
+**Note:** When `NODE_ENV=test`, `.env.local` is **not** loaded. This ensures consistent test environments across different executions by preventing local overrides during testing. This behavior matches popular frameworks like [Next.js](https://nextjs.org/docs/pages/guides/environment-variables#test-environment-variables) and [Create React App](https://create-react-app.dev/docs/adding-custom-environment-variables/#what-other-env-files-can-be-used).
+{% /callout %}
+
 ```txt#.env
 FOO=hello
 BAR=world

docs/runtime/index.md

@@ -92,15 +92,18 @@ every file before execution. Its transpiler  can directly run TypeScript and JSX
 
 ## JSX
 
-## JSON and TOML
+## JSON, TOML, and YAML
 
-Source files can import a `*.json` or `*.toml` file to load its contents as a plain old JavaScript object.
+Source files can import `*.json`, `*.toml`, or `*.yaml` files to load their contents as plain JavaScript objects.
 
 ```ts
 import pkg from "./package.json";
 import bunfig from "./bunfig.toml";
+import config from "./config.yaml";
 ```
 
+See the [YAML API documentation](/docs/api/yaml) for more details on YAML support.
+
 ## WASI
 
 {% callout %}

docs/runtime/jsx.md

@@ -246,6 +246,65 @@ The module from which the component factory function (`createElement`, `jsx`, `j
 
 {% /table %}
 
+### `jsxSideEffects`
+
+By default, Bun marks JSX expressions as `/* @__PURE__ */` so they can be removed during bundling if they are unused (known as "dead code elimination" or "tree shaking"). Set `jsxSideEffects` to `true` to prevent this behavior.
+
+{% table %}
+
+- Compiler options
+- Transpiled output
+
+---
+
+- ```jsonc
+  {
+    "jsx": "react",
+    // jsxSideEffects is false by default
+  }
+  ```
+
+- ```tsx
+  // JSX expressions are marked as pure
+  /* @__PURE__ */ React.createElement("div", null, "Hello");
+  ```
+
+---
+
+- ```jsonc
+  {
+    "jsx": "react",
+    "jsxSideEffects": true,
+  }
+  ```
+
+- ```tsx
+  // JSX expressions are not marked as pure
+  React.createElement("div", null, "Hello");
+  ```
+
+---
+
+- ```jsonc
+  {
+    "jsx": "react-jsx",
+    "jsxSideEffects": true,
+  }
+  ```
+
+- ```tsx
+  // Automatic runtime also respects jsxSideEffects
+  jsx("div", { children: "Hello" });
+  ```
+
+{% /table %}
+
+This option is also available as a CLI flag:
+
+```bash
+$ bun build --jsx-side-effects
+```
+
 ### JSX pragma
 
 All of these values can be set on a per-file basis using _pragmas_. A pragma is a special comment that sets a compiler option in a particular file.

docs/runtime/loaders.md

@@ -52,15 +52,18 @@ Hello world!
 
 {% /codetabs %}
 
-## JSON and TOML
+## JSON, TOML, and YAML
 
-JSON and TOML files can be directly imported from a source file. The contents will be loaded and returned as a JavaScript object.
+JSON, TOML, and YAML files can be directly imported from a source file. The contents will be loaded and returned as a JavaScript object.
 
 ```ts
 import pkg from "./package.json";
 import data from "./data.toml";
+import config from "./config.yaml";
 ```
 
+For more details on YAML support, see the [YAML API documentation](/docs/api/yaml).
+
 ## WASI
 
 {% callout %}

docs/test/runtime-behavior.md

@@ -12,6 +12,8 @@ test("NODE_ENV is set to test", () => {
 });
 ```
 
+When `NODE_ENV` is set to `"test"`, Bun will not load `.env.local` files. This ensures consistent test environments across different executions by preventing local overrides during testing. Instead, use `.env.test` for test-specific environment variables, which should be committed to your repository for consistency across all developers and CI environments.
+
 #### `$TZ` environment variable
 
 By default, all `bun test` runs use UTC (`Etc/UTC`) as the time zone unless overridden by the `TZ` environment variable. This ensures consistent date and time behavior across different development environments.

package.json

@@ -1,7 +1,7 @@
 {
   "private": true,
   "name": "bun",
-  "version": "1.2.21",
+  "version": "1.2.22",
   "workspaces": [
     "./packages/bun-types",
     "./packages/@types/bun"
@@ -32,7 +32,7 @@
     "watch-windows": "bun run zig build check-windows --watch -fincremental --prominent-compile-errors --global-cache-dir build/debug/zig-check-cache --zig-lib-dir vendor/zig/lib",
     "bd:v": "(bun run --silent build:debug &> /tmp/bun.debug.build.log || (cat /tmp/bun.debug.build.log && rm -rf /tmp/bun.debug.build.log && exit 1)) && rm -f /tmp/bun.debug.build.log && ./build/debug/bun-debug",
     "bd": "BUN_DEBUG_QUIET_LOGS=1 bun --silent bd:v",
-    "build:debug": "export COMSPEC=\"C:\\Windows\\System32\\cmd.exe\" && bun scripts/glob-sources.mjs > /dev/null && bun ./scripts/build.mjs -GNinja -DCMAKE_BUILD_TYPE=Debug -B build/debug --log-level=NOTICE",
+    "build:debug": "export COMSPEC=\"C:\\Windows\\System32\\cmd.exe\" && bun ./scripts/build.mjs -GNinja -DCMAKE_BUILD_TYPE=Debug -B build/debug --log-level=NOTICE",
     "build:debug:asan": "bun ./scripts/build.mjs -GNinja -DCMAKE_BUILD_TYPE=Debug -DENABLE_ASAN=ON -B build/debug-asan --log-level=NOTICE",
     "build:release": "bun ./scripts/build.mjs -GNinja -DCMAKE_BUILD_TYPE=Release -B build/release",
     "build:ci": "bun ./scripts/build.mjs -GNinja -DCMAKE_BUILD_TYPE=Release -DCMAKE_VERBOSE_MAKEFILE=ON -DCI=true -B build/release-ci --verbose --fresh",

packages/bun-types/bun.d.ts

@@ -619,6 +619,65 @@ declare module "bun" {
     export function parse(input: string): object;
   }
 
+  /**
+   * YAML related APIs
+   */
+  namespace YAML {
+    /**
+     * Parse a YAML string into a JavaScript value
+     *
+     * @category Utilities
+     *
+     * @param input The YAML string to parse
+     * @returns A JavaScript value
+     *
+     * @example
+     * ```ts
+     * import { YAML } from "bun";
+     *
+     * console.log(YAML.parse("123")) // 123
+     * console.log(YAML.parse("123")) // null
+     * console.log(YAML.parse("false")) // false
+     * console.log(YAML.parse("abc")) // "abc"
+     * console.log(YAML.parse("- abc")) // [ "abc" ]
+     * console.log(YAML.parse("abc: def")) // { "abc": "def" }
+     * ```
+     */
+    export function parse(input: string): unknown;
+
+    /**
+     * Convert a JavaScript value into a YAML string. Strings are double quoted if they contain keywords, non-printable or
+     * escaped characters, or if a YAML parser would parse them as numbers. Anchors and aliases are inferred from objects, allowing cycles.
+     *
+     * @category Utilities
+     *
+     * @param input The JavaScript value to stringify.
+     * @param replacer Currently not supported.
+     * @param space A number for how many spaces each level of indentation gets, or a string used as indentation. The number is clamped between 0 and 10, and the first 10 characters of the string are used.
+     * @returns A string containing the YAML document.
+     *
+     * @example
+     * ```ts
+     * import { YAML } from "bun";
+     *
+     * const input = {
+     *   abc: "def"
+     * };
+     * console.log(YAML.stringify(input));
+     * // # output
+     * // abc: def
+     *
+     * const cycle = {};
+     * cycle.obj = cycle;
+     * console.log(YAML.stringify(cycle));
+     * // # output
+     * // &root
+     * // obj:
+     * //   *root
+     */
+    export function stringify(input: unknown, replacer?: undefined | null, space?: string | number): string;
+  }
+
   /**
    * Synchronously resolve a `moduleId` as though it were imported from `parent`
    *
@@ -1628,7 +1687,7 @@ declare module "bun" {
     kind: ImportKind;
   }
 
-  namespace _BunBuildInterface {
+  namespace Build {
     type Architecture = "x64" | "arm64";
     type Libc = "glibc" | "musl";
     type SIMD = "baseline" | "modern";
@@ -1641,15 +1700,21 @@ declare module "bun" {
       | `bun-windows-x64-${SIMD}`
       | `bun-linux-x64-${SIMD}-${Libc}`;
   }
+
   /**
    * @see [Bun.build API docs](https://bun.com/docs/bundler#api)
    */
   interface BuildConfigBase {
-    entrypoints: string[]; // list of file path
+    /**
+     * List of entrypoints, usually file paths
+     */
+    entrypoints: string[];
+
     /**
      * @default "browser"
      */
     target?: Target; // default: "browser"
+
     /**
      * Output module format. Top-level await is only supported for `"esm"`.
      *
@@ -1813,9 +1878,10 @@ declare module "bun" {
     drop?: string[];
 
     /**
-     * When set to `true`, the returned promise rejects with an AggregateError when a build failure happens.
-     * When set to `false`, the `success` property of the returned object will be `false` when a build failure happens.
-     * This defaults to `true`.
+     * - When set to `true`, the returned promise rejects with an AggregateError when a build failure happens.
+     * - When set to `false`, returns a {@link BuildOutput} with `{success: false}`
+     *
+     * @default true
      */
     throw?: boolean;
 
@@ -1836,7 +1902,7 @@ declare module "bun" {
   }
 
   interface CompileBuildOptions {
-    target?: _BunBuildInterface.Target;
+    target?: Bun.Build.Target;
     execArgv?: string[];
     executablePath?: string;
     outfile?: string;
@@ -1878,13 +1944,29 @@ declare module "bun" {
      * });
      * ```
      */
-    compile: boolean | _BunBuildInterface.Target | CompileBuildOptions;
+    compile: boolean | Bun.Build.Target | CompileBuildOptions;
+
+    /**
+     * Splitting is not currently supported with `.compile`
+     */
+    splitting?: never;
+  }
+
+  interface NormalBuildConfig extends BuildConfigBase {
+    /**
+     * Enable code splitting
+     *
+     * This does not currently work with {@link CompileBuildConfig.compile `compile`}
+     *
+     * @default true
+     */
+    splitting?: boolean;
   }
 
   /**
    * @see [Bun.build API docs](https://bun.com/docs/bundler#api)
    */
-  type BuildConfig = BuildConfigBase | CompileBuildConfig;
+  type BuildConfig = CompileBuildConfig | NormalBuildConfig;
 
   /**
    * Hash and verify passwords using argon2 or bcrypt
@@ -3764,6 +3846,11 @@ declare module "bun" {
    * @category HTTP & Networking
    */
   interface Server extends Disposable {
+    /*
+     * Closes all connections connected to this server which are not sending a request or waiting for a response. Does not close the listen socket.
+     */
+    closeIdleConnections(): void;
+
     /**
      * Stop listening to prevent new connections from being accepted.
      *
@@ -5484,6 +5571,12 @@ declare module "bun" {
   type OnLoadResult = OnLoadResultSourceCode | OnLoadResultObject | undefined | void;
   type OnLoadCallback = (args: OnLoadArgs) => OnLoadResult | Promise<OnLoadResult>;
   type OnStartCallback = () => void | Promise<void>;
+  type OnEndCallback = (result: BuildOutput) => void | Promise<void>;
+  type OnBeforeParseCallback = {
+    napiModule: unknown;
+    symbol: string;
+    external?: unknown | undefined;
+  };
 
   interface OnResolveArgs {
     /**
@@ -5561,14 +5654,26 @@ declare module "bun" {
      * @returns `this` for method chaining
      */
     onStart(callback: OnStartCallback): this;
-    onBeforeParse(
-      constraints: PluginConstraints,
-      callback: {
-        napiModule: unknown;
-        symbol: string;
-        external?: unknown | undefined;
-      },
-    ): this;
+    /**
+     * Register a callback which will be invoked when bundling ends. This is
+     * called after all modules have been bundled and the build is complete.
+     *
+     * @example
+     * ```ts
+     * const plugin: Bun.BunPlugin = {
+     *   name: "my-plugin",
+     *   setup(builder) {
+     *     builder.onEnd((result) => {
+     *       console.log("bundle just finished!!", result);
+     *     });
+     *   },
+     * };
+     * ```
+     *
+     * @returns `this` for method chaining
+     */
+    onEnd(callback: OnEndCallback): this;
+    onBeforeParse(constraints: PluginConstraints, callback: OnBeforeParseCallback): this;
     /**
      * Register a callback to load imports with a specific import specifier
      * @param constraints The constraints to apply the plugin to

packages/bun-types/experimental.d.ts

@@ -191,7 +191,9 @@ declare module "bun" {
      * };
      * ```
      */
-    export type SSGPage<Params extends SSGParamsLike = SSGParamsLike> = React.ComponentType<SSGPageProps<Params>>;
+    export type SSGPage<Params extends SSGParamsLike = SSGParamsLike> = import("react").ComponentType<
+      SSGPageProps<Params>
+    >;
 
     /**
      * getStaticPaths is Bun's implementation of SSG (Static Site Generation) path determination.

packages/bun-types/ffi.d.ts

@@ -219,44 +219,39 @@ declare module "bun:ffi" {
 
     /**
      * int64 is a 64-bit signed integer
-     *
-     * This is not implemented yet!
      */
     int64_t = 7,
     /**
      * i64 is a 64-bit signed integer
-     *
-     * This is not implemented yet!
      */
     i64 = 7,
 
     /**
      * 64-bit unsigned integer
-     *
-     * This is not implemented yet!
      */
     uint64_t = 8,
     /**
      * 64-bit unsigned integer
-     *
-     * This is not implemented yet!
      */
     u64 = 8,
 
     /**
-     * Doubles are not supported yet!
+     * IEEE-754 double precision float
      */
     double = 9,
+
     /**
-     * Doubles are not supported yet!
+     * Alias of {@link FFIType.double}
      */
     f64 = 9,
+
     /**
-     * Floats are not supported yet!
+     * IEEE-754 single precision float
      */
     float = 10,
+
     /**
-     * Floats are not supported yet!
+     * Alias of {@link FFIType.float}
      */
     f32 = 10,
 

packages/bun-types/globals.d.ts

@@ -1564,6 +1564,12 @@ declare var AbortController: Bun.__internal.UseLibDomIfAvailable<
   }
 >;
 
+interface AbortSignal extends EventTarget {
+  readonly aborted: boolean;
+  onabort: ((this: AbortSignal, ev: Event) => any) | null;
+  readonly reason: any;
+  throwIfAborted(): void;
+}
 declare var AbortSignal: Bun.__internal.UseLibDomIfAvailable<
   "AbortSignal",
   {
@@ -1948,3 +1954,21 @@ declare namespace fetch {
   ): void;
 }
 //#endregion
+
+interface RegExpConstructor {
+  /**
+   * Escapes any potential regex syntax characters in a string, and returns a
+   * new string that can be safely used as a literal pattern for the RegExp()
+   * constructor.
+   *
+   * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/escape)
+   *
+   * @example
+   * ```ts
+   * const re = new RegExp(RegExp.escape("foo.bar"));
+   * re.test("foo.bar"); // true
+   * re.test("foo!bar"); // false
+   * ```
+   */
+  escape(string: string): string;
+}

packages/bun-types/overrides.d.ts

@@ -174,6 +174,96 @@ declare global {
         UV_ENODATA: number;
         UV_EUNATCH: number;
       };
+      binding(m: "http_parser"): {
+        methods: [
+          "DELETE",
+          "GET",
+          "HEAD",
+          "POST",
+          "PUT",
+          "CONNECT",
+          "OPTIONS",
+          "TRACE",
+          "COPY",
+          "LOCK",
+          "MKCOL",
+          "MOVE",
+          "PROPFIND",
+          "PROPPATCH",
+          "SEARCH",
+          "UNLOCK",
+          "BIND",
+          "REBIND",
+          "UNBIND",
+          "ACL",
+          "REPORT",
+          "MKACTIVITY",
+          "CHECKOUT",
+          "MERGE",
+          "M - SEARCH",
+          "NOTIFY",
+          "SUBSCRIBE",
+          "UNSUBSCRIBE",
+          "PATCH",
+          "PURGE",
+          "MKCALENDAR",
+          "LINK",
+          "UNLINK",
+          "SOURCE",
+          "QUERY",
+        ];
+        allMethods: [
+          "DELETE",
+          "GET",
+          "HEAD",
+          "POST",
+          "PUT",
+          "CONNECT",
+          "OPTIONS",
+          "TRACE",
+          "COPY",
+          "LOCK",
+          "MKCOL",
+          "MOVE",
+          "PROPFIND",
+          "PROPPATCH",
+          "SEARCH",
+          "UNLOCK",
+          "BIND",
+          "REBIND",
+          "UNBIND",
+          "ACL",
+          "REPORT",
+          "MKACTIVITY",
+          "CHECKOUT",
+          "MERGE",
+          "M - SEARCH",
+          "NOTIFY",
+          "SUBSCRIBE",
+          "UNSUBSCRIBE",
+          "PATCH",
+          "PURGE",
+          "MKCALENDAR",
+          "LINK",
+          "UNLINK",
+          "SOURCE",
+          "PRI",
+          "DESCRIBE",
+          "ANNOUNCE",
+          "SETUP",
+          "PLAY",
+          "PAUSE",
+          "TEARDOWN",
+          "GET_PARAMETER",
+          "SET_PARAMETER",
+          "REDIRECT",
+          "RECORD",
+          "FLUSH",
+          "QUERY",
+        ];
+        HTTPParser: unknown;
+        ConnectionsList: unknown;
+      };
       binding(m: string): object;
     }
 

packages/bun-types/shell.d.ts

@@ -211,7 +211,7 @@ declare module "bun" {
      * try {
      *   const result = await $`exit 1`;
      * } catch (error) {
-     *   if (error instanceof ShellError) {
+     *   if (error instanceof $.ShellError) {
      *     console.log(error.exitCode); // 1
      *   }
      * }

packages/bun-types/test-globals.d.ts

@@ -3,7 +3,7 @@
 // This file gets loaded by developers including the following triple slash directive:
 //
 // ```ts
-// /// <reference types="bun/test-globals" />
+// /// <reference types="bun-types/test-globals" />
 // ```
 
 declare var test: typeof import("bun:test").test;
@@ -19,3 +19,6 @@ declare var setDefaultTimeout: typeof import("bun:test").setDefaultTimeout;
 declare var mock: typeof import("bun:test").mock;
 declare var spyOn: typeof import("bun:test").spyOn;
 declare var jest: typeof import("bun:test").jest;
+declare var xit: typeof import("bun:test").xit;
+declare var xtest: typeof import("bun:test").xtest;
+declare var xdescribe: typeof import("bun:test").xdescribe;

packages/bun-types/test.d.ts

@@ -152,11 +152,41 @@ declare module "bun:test" {
     type SpiedSetter<T> = JestMock.SpiedSetter<T>;
   }
 
+  /**
+   * Create a spy on an object property or method
+   */
   export function spyOn<T extends object, K extends keyof T>(
     obj: T,
     methodOrPropertyValue: K,
   ): Mock<Extract<T[K], (...args: any[]) => any>>;
 
+  /**
+   * Vitest-compatible mocking utilities
+   * Provides Vitest-style mocking API for easier migration from Vitest to Bun
+   */
+  export const vi: {
+    /**
+     * Create a mock function
+     */
+    fn: typeof jest.fn;
+    /**
+     * Create a spy on an object property or method
+     */
+    spyOn: typeof spyOn;
+    /**
+     * Mock a module
+     */
+    module: typeof mock.module;
+    /**
+     * Restore all mocks to their original implementation
+     */
+    restoreAllMocks: typeof jest.restoreAllMocks;
+    /**
+     * Clear all mock state (calls, results, etc.) without restoring original implementation
+     */
+    clearAllMocks: typeof jest.clearAllMocks;
+  };
+
   interface FunctionLike {
     readonly name: string;
   }
@@ -262,6 +292,15 @@ declare module "bun:test" {
    * @param fn the function that defines the tests
    */
   export const describe: Describe;
+  /**
+   * Skips a group of related tests.
+   *
+   * This is equivalent to calling `describe.skip()`.
+   *
+   * @param label the label for the tests
+   * @param fn the function that defines the tests
+   */
+  export const xdescribe: Describe;
   /**
    * Runs a function, once, before all the tests.
    *
@@ -515,7 +554,17 @@ declare module "bun:test" {
    * @param fn the test function
    */
   export const test: Test;
-  export { test as it };
+  export { test as it, xtest as xit };
+
+  /**
+   * Skips a test.
+   *
+   * This is equivalent to calling `test.skip()`.
+   *
+   * @param label the label for the test
+   * @param fn the test function
+   */
+  export const xtest: Test;
 
   /**
    * Asserts that a value matches some criteria.

packages/bun-usockets/src/context.c

@@ -153,7 +153,7 @@ void us_internal_socket_context_unlink_connecting_socket(int ssl, struct us_sock
 }
 
 /* We always add in the top, so we don't modify any s.next */
-void us_internal_socket_context_link_listen_socket(struct us_socket_context_t *context, struct us_listen_socket_t *ls) {
+void us_internal_socket_context_link_listen_socket(int ssl, struct us_socket_context_t *context, struct us_listen_socket_t *ls) {
     struct us_socket_t* s = &ls->s;
     s->context = context;
     s->next = (struct us_socket_t *) context->head_listen_sockets;
@@ -162,7 +162,7 @@ void us_internal_socket_context_link_listen_socket(struct us_socket_context_t *c
         context->head_listen_sockets->s.prev = s;
     }
     context->head_listen_sockets = ls;
-    us_socket_context_ref(0, context);
+    us_socket_context_ref(ssl, context);
 }
 
 void us_internal_socket_context_link_connecting_socket(int ssl, struct us_socket_context_t *context, struct us_connecting_socket_t *c) {
@@ -179,7 +179,7 @@ void us_internal_socket_context_link_connecting_socket(int ssl, struct us_socket
 
 
 /* We always add in the top, so we don't modify any s.next */
-void us_internal_socket_context_link_socket(struct us_socket_context_t *context, struct us_socket_t *s) {
+void us_internal_socket_context_link_socket(int ssl, struct us_socket_context_t *context, struct us_socket_t *s) {
     s->context = context;
     s->next = context->head_sockets;
     s->prev = 0;
@@ -187,7 +187,7 @@ void us_internal_socket_context_link_socket(struct us_socket_context_t *context,
         context->head_sockets->prev = s;
     }
     context->head_sockets = s;
-    us_socket_context_ref(0, context);
+    us_socket_context_ref(ssl, context);
     us_internal_enable_sweep_timer(context->loop);
 }
 
@@ -388,7 +388,7 @@ struct us_listen_socket_t *us_socket_context_listen(int ssl, struct us_socket_co
     s->flags.is_ipc = 0;
     s->next = 0;
     s->flags.allow_half_open = (options & LIBUS_SOCKET_ALLOW_HALF_OPEN);
-    us_internal_socket_context_link_listen_socket(context, ls);
+    us_internal_socket_context_link_listen_socket(ssl, context, ls);
 
     ls->socket_ext_size = socket_ext_size;
 
@@ -423,7 +423,7 @@ struct us_listen_socket_t *us_socket_context_listen_unix(int ssl, struct us_sock
     s->flags.is_paused = 0;
     s->flags.is_ipc = 0;
     s->next = 0;
-    us_internal_socket_context_link_listen_socket(context, ls);
+    us_internal_socket_context_link_listen_socket(ssl, context, ls);
 
     ls->socket_ext_size = socket_ext_size;
 
@@ -456,7 +456,7 @@ struct us_socket_t* us_socket_context_connect_resolved_dns(struct us_socket_cont
     socket->connect_state = NULL;
     socket->connect_next = NULL;
 
-    us_internal_socket_context_link_socket(context, socket);
+    us_internal_socket_context_link_socket(0, context, socket);
 
     return socket;
 }
@@ -584,7 +584,7 @@ int start_connections(struct us_connecting_socket_t *c, int count) {
         flags->is_paused = 0;
         flags->is_ipc = 0;
         /* Link it into context so that timeout fires properly */
-        us_internal_socket_context_link_socket(context, s);
+        us_internal_socket_context_link_socket(0, context, s);
 
         // TODO check this, specifically how it interacts with the SSL code
         // does this work when we create multiple sockets at once? will we need multiple SSL contexts?
@@ -762,7 +762,7 @@ struct us_socket_t *us_socket_context_connect_unix(int ssl, struct us_socket_con
     connect_socket->flags.is_ipc = 0;
     connect_socket->connect_state = NULL;
     connect_socket->connect_next = NULL;
-    us_internal_socket_context_link_socket(context, connect_socket);
+    us_internal_socket_context_link_socket(ssl, context, connect_socket);
 
     return connect_socket;
 }
@@ -804,12 +804,9 @@ struct us_socket_t *us_socket_context_adopt_socket(int ssl, struct us_socket_con
     }
 
     struct us_connecting_socket_t *c = s->connect_state;
-    
     struct us_socket_t *new_s = s;
-    
     if (ext_size != -1) {
         struct us_poll_t *pool_ref = &s->p;
-       
         new_s = (struct us_socket_t *) us_poll_resize(pool_ref, loop, sizeof(struct us_socket_t) + ext_size);
         if (c) {
             c->connecting_head = new_s;
@@ -831,7 +828,7 @@ struct us_socket_t *us_socket_context_adopt_socket(int ssl, struct us_socket_con
         /* We manually ref/unref context to handle context life cycle with low-priority queue */
         us_socket_context_ref(ssl, context);
     } else {
-        us_internal_socket_context_link_socket(context, new_s);
+        us_internal_socket_context_link_socket(ssl, context, new_s);
     }
     /* We can safely unref the old context here with can potentially be freed */
     us_socket_context_unref(ssl, old_context);

packages/bun-usockets/src/internal/internal.h

@@ -150,16 +150,12 @@ void us_internal_init_loop_ssl_data(us_loop_r loop);
 void us_internal_free_loop_ssl_data(us_loop_r loop);
 
 /* Socket context related */
-void us_internal_socket_context_link_socket(us_socket_context_r context,
-                                            us_socket_r s);
-void us_internal_socket_context_unlink_socket(int ssl,
-    us_socket_context_r context, us_socket_r s);
+void us_internal_socket_context_link_socket(int ssl, us_socket_context_r context, us_socket_r s);
+void us_internal_socket_context_unlink_socket(int ssl, us_socket_context_r context, us_socket_r s);
 
 void us_internal_socket_after_resolve(struct us_connecting_socket_t *s);
 void us_internal_socket_after_open(us_socket_r s, int error);
-struct us_internal_ssl_socket_t *
-us_internal_ssl_socket_close(us_internal_ssl_socket_r s, int code,
-                             void *reason);
+struct us_internal_ssl_socket_t *us_internal_ssl_socket_close(us_internal_ssl_socket_r s, int code, void *reason);
 
 int us_internal_handle_dns_results(us_loop_r loop);
 
@@ -271,7 +267,7 @@ struct us_listen_socket_t {
 };
 
 /* Listen sockets are keps in their own list */
-void us_internal_socket_context_link_listen_socket(
+void us_internal_socket_context_link_listen_socket(int ssl,
     us_socket_context_r context, struct us_listen_socket_t *s);
 void us_internal_socket_context_unlink_listen_socket(int ssl,
     us_socket_context_r context, struct us_listen_socket_t *s);
@@ -288,8 +284,7 @@ struct us_socket_context_t {
   struct us_socket_t *iterator;
   struct us_socket_context_t *prev, *next;
 
-  struct us_socket_t *(*on_open)(struct us_socket_t *, int is_client, char *ip,
-                                 int ip_length);
+  struct us_socket_t *(*on_open)(struct us_socket_t *, int is_client, char *ip, int ip_length);
   struct us_socket_t *(*on_data)(struct us_socket_t *, char *data, int length);
   struct us_socket_t *(*on_fd)(struct us_socket_t *, int fd);
   struct us_socket_t *(*on_writable)(struct us_socket_t *);
@@ -301,7 +296,6 @@ struct us_socket_context_t {
   struct us_connecting_socket_t *(*on_connect_error)(struct us_connecting_socket_t *, int code);
   struct us_socket_t *(*on_socket_connect_error)(struct us_socket_t *, int code);
   int (*is_low_prio)(struct us_socket_t *);
-
 };
 
 /* Internal SSL interface */

packages/bun-usockets/src/loop.c

@@ -40,7 +40,6 @@ void us_internal_enable_sweep_timer(struct us_loop_t *loop) {
         us_timer_set(loop->data.sweep_timer, (void (*)(struct us_timer_t *)) sweep_timer_cb, LIBUS_TIMEOUT_GRANULARITY * 1000, LIBUS_TIMEOUT_GRANULARITY * 1000);
         Bun__internal_ensureDateHeaderTimerIsEnabled(loop);
     }
-    
 }
 
 void us_internal_disable_sweep_timer(struct us_loop_t *loop) {
@@ -183,7 +182,7 @@ void us_internal_handle_low_priority_sockets(struct us_loop_t *loop) {
         if (s->next) s->next->prev = 0;
         s->next = 0;
 
-        us_internal_socket_context_link_socket(s->context, s);
+        us_internal_socket_context_link_socket(0, s->context, s);
         us_poll_change(&s->p, us_socket_context(0, s)->loop, us_poll_events(&s->p) | LIBUS_SOCKET_READABLE);
 
         s->flags.low_prio_state = 2;
@@ -340,7 +339,7 @@ void us_internal_dispatch_ready_poll(struct us_poll_t *p, int error, int eof, in
                         /* We always use nodelay */
                         bsd_socket_nodelay(client_fd, 1);
 
-                        us_internal_socket_context_link_socket(listen_socket->s.context, s);
+                        us_internal_socket_context_link_socket(0, listen_socket->s.context, s);
 
                         listen_socket->s.context->on_open(s, 0, bsd_addr_get_ip(&addr), bsd_addr_get_ip_length(&addr));
 
@@ -364,7 +363,7 @@ void us_internal_dispatch_ready_poll(struct us_poll_t *p, int error, int eof, in
                 /* Note: if we failed a write as a socket of one loop then adopted
                  * to another loop, this will be wrong. Absurd case though */
                 loop->data.last_write_failed = 0;
-                
+
                 s = s->context->on_writable(s);
 
                 if (!s || us_socket_is_closed(0, s)) {

packages/bun-usockets/src/socket.c

@@ -329,7 +329,7 @@ struct us_socket_t *us_socket_from_fd(struct us_socket_context_t *ctx, int socke
     bsd_socket_nodelay(fd, 1);
     apple_no_sigpipe(fd);
     bsd_set_nonblocking(fd);
-    us_internal_socket_context_link_socket(ctx, s);
+    us_internal_socket_context_link_socket(0, ctx, s);
 
     return s;
 #endif

packages/bun-uws/src/App.h

@@ -298,6 +298,22 @@ public:
         return std::move(*this);
     }
 
+    /** Closes all connections connected to this server which are not sending a request or waiting for a response. Does not close the listen socket. */
+    TemplatedApp &&closeIdle() {
+        auto context = (struct us_socket_context_t *)this->httpContext;
+        struct us_socket_t *s = context->head_sockets;
+        while (s) {
+            HttpResponseData<SSL> *httpResponseData = HttpResponse<SSL>::getHttpResponseDataS(s);
+            httpResponseData->shouldCloseOnceIdle = true;
+            struct us_socket_t *next = s->next;
+            if (httpResponseData->isIdle) {
+                us_socket_close(SSL, s, LIBUS_SOCKET_CLOSE_CODE_CLEAN_SHUTDOWN, 0);
+            }
+            s = next;
+        }
+        return std::move(*this);
+    }
+
     template <typename UserData>
     TemplatedApp &&ws(std::string_view pattern, WebSocketBehavior<UserData> &&behavior) {
         /* Don't compile if alignment rules cannot be satisfied */

packages/bun-uws/src/AsyncSocket.h

@@ -386,6 +386,9 @@ public:
                     /* We do not need to care for buffering here, write does that */
                     return {0, true};
                 }
+                if (length == 0) {
+                    return {written, failed};
+                }
             }
 
             /* We should only return with new writes, not things written to cork already */

packages/bun-uws/src/HttpContext.h

@@ -137,10 +137,6 @@ private:
         return (HttpContextData<SSL> *) us_socket_context_ext(SSL, getSocketContext());
     }
 
-    static HttpContextData<SSL> *getSocketContextDataS(us_socket_t *s) {
-        return (HttpContextData<SSL> *) us_socket_context_ext(SSL, getSocketContext(s));
-    }
-
     /* Init the HttpContext by registering libusockets event handlers */
     HttpContext<SSL> *init() {
 
@@ -247,6 +243,7 @@ private:
 
             /* Mark that we are inside the parser now */
             httpContextData->flags.isParsingHttp = true;
+            httpResponseData->isIdle = false;
             // clients need to know the cursor after http parse, not servers!
             // how far did we read then? we need to know to continue with websocket parsing data? or?
 
@@ -398,6 +395,7 @@ private:
                 /* Timeout on uncork failure */
                 auto [written, failed] = ((AsyncSocket<SSL> *) returnedData)->uncork();
                 if (written > 0 || failed) {
+                    httpResponseData->isIdle = true;
                     /* All Http sockets timeout by this, and this behavior match the one in HttpResponse::cork */
                     ((HttpResponse<SSL> *) s)->resetTimeout();
                 }
@@ -642,6 +640,10 @@ public:
         }, priority);
     }
 
+    static HttpContextData<SSL> *getSocketContextDataS(us_socket_t *s) {
+        return (HttpContextData<SSL> *) us_socket_context_ext(SSL, getSocketContext(s));
+    }
+
     /* Listen to port using this HttpContext */
     us_listen_socket_t *listen(const char *host, int port, int options) {
         int error = 0;

packages/bun-uws/src/HttpContextData.h

@@ -63,7 +63,6 @@ private:
     OnSocketClosedCallback onSocketClosed = nullptr;
     OnClientErrorCallback onClientError = nullptr;
 
-    HttpFlags flags;
     uint64_t maxHeaderSize = 0; // 0 means no limit
 
     // TODO: SNI
@@ -73,10 +72,8 @@ private:
         filterHandlers.clear();
     }
 
-    public:
-    bool isAuthorized() const {
-        return flags.isAuthorized;
-    }
+public:
+    HttpFlags flags;
 };
 
 }

packages/bun-uws/src/HttpResponse.h

@@ -50,6 +50,11 @@ public:
     HttpResponseData<SSL> *getHttpResponseData() {
         return (HttpResponseData<SSL> *) Super::getAsyncSocketData();
     }
+
+    static HttpResponseData<SSL> *getHttpResponseDataS(us_socket_t *s) {
+        return (HttpResponseData<SSL> *) us_socket_ext(SSL, s);
+    }
+
     void setTimeout(uint8_t seconds) {
         auto* data = getHttpResponseData();
         data->idleTimeout = seconds;
@@ -132,7 +137,7 @@ public:
 
             /* Terminating 0 chunk */
             Super::write("0\r\n\r\n", 5);
-            httpResponseData->markDone();
+            httpResponseData->markDone(this);
 
             /* We need to check if we should close this socket here now */
             if (!Super::isCorked()) {
@@ -198,7 +203,7 @@ public:
 
             /* Remove onAborted function if we reach the end */
             if (httpResponseData->offset == totalSize) {
-                httpResponseData->markDone();
+                httpResponseData->markDone(this);
 
                 /* We need to check if we should close this socket here now */
                 if (!Super::isCorked()) {

packages/bun-uws/src/HttpResponseData.h

@@ -22,11 +22,15 @@
 #include "HttpParser.h"
 #include "AsyncSocketData.h"
 #include "ProxyParser.h"
+#include "HttpContext.h"
 
 #include "MoveOnlyFunction.h"
 
 namespace uWS {
 
+template <bool SSL>
+struct HttpContext;
+
 template <bool SSL>
 struct HttpResponseData : AsyncSocketData<SSL>, HttpParser {
     template <bool> friend struct HttpResponse;
@@ -38,7 +42,7 @@ struct HttpResponseData : AsyncSocketData<SSL>, HttpParser {
     using OnDataCallback = void (*)(uWS::HttpResponse<SSL>* response, const char* chunk, size_t chunk_length, bool, void*);
 
     /* When we are done with a response we mark it like so */
-    void markDone() {
+    void markDone(uWS::HttpResponse<SSL> *uwsRes) {
         onAborted = nullptr;
         /* Also remove onWritable so that we do not emit when draining behind the scenes. */
         onWritable = nullptr;
@@ -50,6 +54,9 @@ struct HttpResponseData : AsyncSocketData<SSL>, HttpParser {
 
         /* We are done with this request */
         this->state &= ~HttpResponseData<SSL>::HTTP_RESPONSE_PENDING;
+
+        HttpResponseData<SSL> *httpResponseData = uwsRes->getHttpResponseData();
+        httpResponseData->isIdle = true;
     }
 
     /* Caller of onWritable. It is possible onWritable calls markDone so we need to borrow it. */
@@ -101,6 +108,8 @@ struct HttpResponseData : AsyncSocketData<SSL>, HttpParser {
     uint8_t state = 0;
     uint8_t idleTimeout = 10; // default HTTP_TIMEOUT 10 seconds
     bool fromAncientRequest = false;
+    bool isIdle = true;
+    bool shouldCloseOnceIdle = false;
 
 
 #ifdef UWS_WITH_PROXY

scripts/build.mjs

@@ -1,5 +1,3 @@
-#!/usr/bin/env node
-
 import { spawn as nodeSpawn } from "node:child_process";
 import { chmodSync, cpSync, existsSync, mkdirSync, readFileSync } from "node:fs";
 import { basename, join, relative, resolve } from "node:path";
@@ -14,6 +12,10 @@ import {
   startGroup,
 } from "./utils.mjs";
 
+if (globalThis.Bun) {
+  await import("./glob-sources.mjs");
+}
+
 // https://cmake.org/cmake/help/latest/manual/cmake.1.html#generate-a-project-buildsystem
 const generateFlags = [
   ["-S", "string", "path to source directory"],

scripts/buildkite-slow-tests.js

@@ -0,0 +1,107 @@
+#!/usr/bin/env bun
+
+import { readFileSync } from "fs";
+
+function parseLogFile(filename) {
+  const testDetails = new Map(); // Track individual attempts and total for each test
+  let currentTest = null;
+  let startTime = null;
+
+  // Pattern to match test group start: --- [90m[N/TOTAL][0m test/path
+  // Note: there are escape sequences before _bk
+  const startPattern = /_bk;t=(\d+).*?--- .*?\[90m\[(\d+)\/(\d+)\].*?\[0m (.+)/;
+
+  const content = readFileSync(filename, "utf-8");
+  const lines = content.split("\n");
+
+  for (const line of lines) {
+    const match = line.match(startPattern);
+    if (match) {
+      // If we have a previous test, calculate its duration
+      if (currentTest && startTime) {
+        const endTime = parseInt(match[1]);
+        const duration = endTime - startTime;
+
+        // Extract attempt info - match the actual ANSI pattern
+        const attemptMatch = currentTest.match(/\s+\x1b\[90m\[attempt #(\d+)\]\x1b\[0m$/);
+        const cleanName = currentTest.replace(/\s+\x1b\[90m\[attempt #\d+\]\x1b\[0m$/, "").trim();
+        const attemptNum = attemptMatch ? parseInt(attemptMatch[1]) : 1;
+
+        if (!testDetails.has(cleanName)) {
+          testDetails.set(cleanName, { total: 0, attempts: [] });
+        }
+
+        const testInfo = testDetails.get(cleanName);
+        testInfo.total += duration;
+        testInfo.attempts.push({ attempt: attemptNum, duration });
+      }
+
+      // Start new test
+      startTime = parseInt(match[1]);
+      currentTest = match[4].trim();
+    }
+  }
+
+  // Convert to array and sort by total duration
+  const testGroups = Array.from(testDetails.entries())
+    .map(([name, info]) => ({
+      name,
+      totalDuration: info.total,
+      attempts: info.attempts.sort((a, b) => a.attempt - b.attempt),
+    }))
+    .sort((a, b) => b.totalDuration - a.totalDuration);
+
+  return testGroups;
+}
+
+function formatAttempts(attempts) {
+  if (attempts.length <= 1) return "";
+
+  const attemptStrings = attempts.map(
+    ({ attempt, duration }) => `${(duration / 1000).toFixed(1)}s attempt #${attempt}`,
+  );
+  return ` [${attemptStrings.join(", ")}]`;
+}
+
+if (process.argv.length !== 3) {
+  console.log("Usage: bun parse_test_logs.js <log_file>");
+  process.exit(1);
+}
+
+const filename = process.argv[2];
+const testGroups = parseLogFile(filename);
+
+const totalTime = testGroups.reduce((sum, group) => sum + group.totalDuration, 0) / 1000;
+const avgTime = testGroups.length > 0 ? totalTime / testGroups.length : 0;
+
+console.log(
+  `## Slowest Tests Analysis - ${testGroups.length} tests (${totalTime.toFixed(1)}s total, ${avgTime.toFixed(2)}s avg)`,
+);
+console.log("");
+
+// Top 10 summary
+console.log("**Top 10 slowest tests:**");
+for (let i = 0; i < Math.min(10, testGroups.length); i++) {
+  const { name, totalDuration, attempts } = testGroups[i];
+  const durationSec = totalDuration / 1000;
+  const testName = name.replace("test/", "").replace(".test.ts", "").replace(".test.js", "");
+  const attemptInfo = formatAttempts(attempts);
+  console.log(`- **${durationSec.toFixed(1)}s** ${testName}${attemptInfo}`);
+}
+
+console.log("");
+
+// Filter tests > 1 second
+const slowTests = testGroups.filter(test => test.totalDuration > 1000);
+
+console.log("```");
+console.log(`All tests > 1s (${slowTests.length} tests):`);
+
+for (let i = 0; i < slowTests.length; i++) {
+  const { name, totalDuration, attempts } = slowTests[i];
+  const durationSec = totalDuration / 1000;
+  const attemptInfo = formatAttempts(attempts);
+  console.log(`${(i + 1).toString().padStart(3)}. ${durationSec.toFixed(2).padStart(7)}s  ${name}${attemptInfo}`);
+}
+
+console.log("```");

src/HTMLScanner.zig

@@ -41,7 +41,7 @@ fn createImportRecord(this: *HTMLScanner, input_path: []const u8, kind: ImportKi
     const record = ImportRecord{
         .path = fs.Path.init(try this.allocator.dupeZ(u8, path_to_use)),
         .kind = kind,
-        .range = logger.Range.None,
+        .range = .none,
     };
 
     try this.import_records.push(this.allocator, record);
@@ -56,9 +56,9 @@ pub fn onWriteHTML(_: *HTMLScanner, bytes: []const u8) void {
 pub fn onHTMLParseError(this: *HTMLScanner, message: []const u8) void {
     this.log.addError(
         this.source,
-        logger.Loc.Empty,
+        .none,
         message,
-    ) catch bun.outOfMemory();
+    ) catch |err| bun.handleOom(err);
 }
 
 pub fn onTag(this: *HTMLScanner, _: *lol.Element, path: []const u8, url_attribute: []const u8, kind: ImportKind) void {
@@ -222,7 +222,7 @@ pub fn HTMLProcessor(
             var builder = lol.HTMLRewriter.Builder.init();
             defer builder.deinit();
 
-            var selectors: std.BoundedArray(*lol.HTMLSelector, tag_handlers.len + if (visit_document_tags) 3 else 0) = .{};
+            var selectors: bun.BoundedArray(*lol.HTMLSelector, tag_handlers.len + if (visit_document_tags) 3 else 0) = .{};
             defer for (selectors.slice()) |selector| {
                 selector.deinit();
             };

src/StandaloneModuleGraph.zig

@@ -44,11 +44,20 @@ pub const StandaloneModuleGraph = struct {
         };
     }
 
-    pub fn isBunStandaloneFilePath(str: []const u8) bool {
+    pub fn isBunStandaloneFilePathCanonicalized(str: []const u8) bool {
         return bun.strings.hasPrefixComptime(str, base_path) or
             (Environment.isWindows and bun.strings.hasPrefixComptime(str, base_public_path));
     }
 
+    pub fn isBunStandaloneFilePath(str: []const u8) bool {
+        if (Environment.isWindows) {
+            // On Windows, remove NT path prefixes before checking
+            const canonicalized = strings.withoutNTPrefix(u8, str);
+            return isBunStandaloneFilePathCanonicalized(canonicalized);
+        }
+        return isBunStandaloneFilePathCanonicalized(str);
+    }
+
     pub fn entryPoint(this: *const StandaloneModuleGraph) *File {
         return &this.files.values()[this.entry_point_id];
     }
@@ -248,7 +257,7 @@ pub const StandaloneModuleGraph = struct {
                     };
 
                     const source_files = serialized.sourceFileNames();
-                    const slices = bun.default_allocator.alloc(?[]u8, source_files.len * 2) catch bun.outOfMemory();
+                    const slices = bun.handleOom(bun.default_allocator.alloc(?[]u8, source_files.len * 2));
 
                     const file_names: [][]const u8 = @ptrCast(slices[0..source_files.len]);
                     const decompressed_contents_slice = slices[source_files.len..][0..source_files.len];
@@ -598,7 +607,7 @@ pub const StandaloneModuleGraph = struct {
                                         std.fs.path.sep_str,
                                         zname,
                                         &.{0},
-                                    }) catch bun.outOfMemory();
+                                    }) catch |e| bun.handleOom(e);
                                     zname = zname_z[0..zname_z.len -| 1 :0];
                                     continue;
                                 }
@@ -683,7 +692,7 @@ pub const StandaloneModuleGraph = struct {
                 var file = bun.sys.File{ .handle = cloned_executable_fd };
                 const writer = file.writer();
                 const BufferedWriter = std.io.BufferedWriter(512 * 1024, @TypeOf(writer));
-                var buffered_writer = bun.default_allocator.create(BufferedWriter) catch bun.outOfMemory();
+                var buffered_writer = bun.handleOom(bun.default_allocator.create(BufferedWriter));
                 buffered_writer.* = .{
                     .unbuffered_writer = writer,
                 };
@@ -929,7 +938,7 @@ pub const StandaloneModuleGraph = struct {
         var free_self_exe = false;
         const self_exe = if (self_exe_path) |path| brk: {
             free_self_exe = true;
-            break :brk allocator.dupeZ(u8, path) catch bun.outOfMemory();
+            break :brk bun.handleOom(allocator.dupeZ(u8, path));
         } else if (target.isDefault())
             bun.selfExePath() catch |err| {
                 return CompileResult.fail(std.fmt.allocPrint(allocator, "failed to get self executable path: {s}", .{@errorName(err)}) catch "failed to get self executable path");
@@ -958,7 +967,7 @@ pub const StandaloneModuleGraph = struct {
             }
 
             free_self_exe = true;
-            break :blk allocator.dupeZ(u8, dest_z) catch bun.outOfMemory();
+            break :blk bun.handleOom(allocator.dupeZ(u8, dest_z));
         };
 
         defer if (free_self_exe) {
@@ -980,27 +989,54 @@ pub const StandaloneModuleGraph = struct {
         }
 
         if (Environment.isWindows) {
-            var outfile_buf: bun.OSPathBuffer = undefined;
-            const outfile_slice = brk: {
-                const outfile_w = bun.strings.toWPathNormalized(&outfile_buf, std.fs.path.basenameWindows(outfile));
-                bun.assert(outfile_w.ptr == &outfile_buf);
-                const outfile_buf_u16 = bun.reinterpretSlice(u16, &outfile_buf);
-                outfile_buf_u16[outfile_w.len] = 0;
-                break :brk outfile_buf_u16[0..outfile_w.len :0];
+            // Get the current path of the temp file
+            var temp_buf: bun.PathBuffer = undefined;
+            const temp_path = bun.getFdPath(fd, &temp_buf) catch |err| {
+                return CompileResult.fail(std.fmt.allocPrint(allocator, "Failed to get temp file path: {s}", .{@errorName(err)}) catch "Failed to get temp file path");
             };
 
-            bun.windows.moveOpenedFileAtLoose(fd, .fromStdDir(root_dir), outfile_slice, true).unwrap() catch |err| {
-                _ = bun.windows.deleteOpenedFile(fd);
-                if (err == error.EISDIR) {
-                    return CompileResult.fail(std.fmt.allocPrint(allocator, "{s} is a directory. Please choose a different --outfile or delete the directory", .{outfile}) catch "outfile is a directory");
-                } else {
-                    return CompileResult.fail(std.fmt.allocPrint(allocator, "failed to move executable to result path: {s}", .{@errorName(err)}) catch "failed to move executable");
-                }
+            // Build the absolute destination path
+            // On Windows, we need an absolute path for MoveFileExW
+            // Get the current working directory and join with outfile
+            var cwd_buf: bun.PathBuffer = undefined;
+            const cwd_path = bun.getcwd(&cwd_buf) catch |err| {
+                return CompileResult.fail(std.fmt.allocPrint(allocator, "Failed to get current directory: {s}", .{@errorName(err)}) catch "Failed to get current directory");
             };
+            const dest_path = if (std.fs.path.isAbsolute(outfile))
+                outfile
+            else
+                bun.path.joinAbsString(cwd_path, &[_][]const u8{outfile}, .auto);
 
+            // Convert paths to Windows UTF-16
+            var temp_buf_w: bun.OSPathBuffer = undefined;
+            var dest_buf_w: bun.OSPathBuffer = undefined;
+            const temp_w = bun.strings.toWPathNormalized(&temp_buf_w, temp_path);
+            const dest_w = bun.strings.toWPathNormalized(&dest_buf_w, dest_path);
+
+            // Ensure null termination
+            const temp_buf_u16 = bun.reinterpretSlice(u16, &temp_buf_w);
+            const dest_buf_u16 = bun.reinterpretSlice(u16, &dest_buf_w);
+            temp_buf_u16[temp_w.len] = 0;
+            dest_buf_u16[dest_w.len] = 0;
+
+            // Close the file handle before moving (Windows requires this)
             fd.close();
             fd = bun.invalid_fd;
 
+            // Move the file using MoveFileExW
+            if (bun.windows.kernel32.MoveFileExW(temp_buf_u16[0..temp_w.len :0].ptr, dest_buf_u16[0..dest_w.len :0].ptr, bun.windows.MOVEFILE_COPY_ALLOWED | bun.windows.MOVEFILE_REPLACE_EXISTING | bun.windows.MOVEFILE_WRITE_THROUGH) == bun.windows.FALSE) {
+                const err = bun.windows.Win32Error.get();
+                if (err.toSystemErrno()) |sys_err| {
+                    if (sys_err == .EISDIR) {
+                        return CompileResult.fail(std.fmt.allocPrint(allocator, "{s} is a directory. Please choose a different --outfile or delete the directory", .{outfile}) catch "outfile is a directory");
+                    } else {
+                        return CompileResult.fail(std.fmt.allocPrint(allocator, "failed to move executable to {s}: {s}", .{ dest_path, @tagName(sys_err) }) catch "failed to move executable");
+                    }
+                } else {
+                    return CompileResult.fail(std.fmt.allocPrint(allocator, "failed to move executable to {s}", .{dest_path}) catch "failed to move executable");
+                }
+            }
+
             // Set Windows icon and/or metadata using unified function
             if (windows_options.icon != null or
                 windows_options.title != null or
@@ -1009,25 +1045,9 @@ pub const StandaloneModuleGraph = struct {
                 windows_options.description != null or
                 windows_options.copyright != null)
             {
-                // Need to get the full path to the executable
-                var full_path_buf: bun.OSPathBuffer = undefined;
-                const full_path = brk: {
-                    // Get the directory path
-                    var dir_buf: bun.PathBuffer = undefined;
-                    const dir_path = bun.getFdPath(bun.FD.fromStdDir(root_dir), &dir_buf) catch |err| {
-                        return CompileResult.fail(std.fmt.allocPrint(allocator, "Failed to get directory path: {s}", .{@errorName(err)}) catch "Failed to get directory path");
-                    };
-
-                    // Join with the outfile name
-                    const full_path_str = bun.path.joinAbsString(dir_path, &[_][]const u8{outfile}, .auto);
-                    const full_path_w = bun.strings.toWPathNormalized(&full_path_buf, full_path_str);
-                    const buf_u16 = bun.reinterpretSlice(u16, &full_path_buf);
-                    buf_u16[full_path_w.len] = 0;
-                    break :brk buf_u16[0..full_path_w.len :0];
-                };
-
+                // The file has been moved to dest_path
                 bun.windows.rescle.setWindowsMetadata(
-                    full_path.ptr,
+                    dest_buf_u16[0..dest_w.len :0].ptr,
                     windows_options.icon,
                     windows_options.title,
                     windows_options.publisher,
@@ -1358,7 +1378,7 @@ pub const StandaloneModuleGraph = struct {
                 const compressed_file = compressed_codes[@intCast(index)].slice(this.map.bytes);
                 const size = bun.zstd.getDecompressedSize(compressed_file);
 
-                const bytes = bun.default_allocator.alloc(u8, size) catch bun.outOfMemory();
+                const bytes = bun.handleOom(bun.default_allocator.alloc(u8, size));
                 const result = bun.zstd.decompress(bytes, compressed_file);
 
                 if (result == .err) {

src/Watcher.zig

@@ -322,7 +322,7 @@ fn appendFileAssumeCapacity(
     const watchlist_id = this.watchlist.len;
 
     const file_path_: string = if (comptime clone_file_path)
-        bun.asByteSlice(this.allocator.dupeZ(u8, file_path) catch bun.outOfMemory())
+        bun.asByteSlice(bun.handleOom(this.allocator.dupeZ(u8, file_path)))
     else
         file_path;
 
@@ -409,7 +409,7 @@ fn appendDirectoryAssumeCapacity(
     };
 
     const file_path_: string = if (comptime clone_file_path)
-        bun.asByteSlice(this.allocator.dupeZ(u8, file_path) catch bun.outOfMemory())
+        bun.asByteSlice(bun.handleOom(this.allocator.dupeZ(u8, file_path)))
     else
         file_path;
 
@@ -529,7 +529,7 @@ pub fn appendFileMaybeLock(
             }
         }
     }
-    this.watchlist.ensureUnusedCapacity(this.allocator, 1 + @as(usize, @intCast(@intFromBool(parent_watch_item == null)))) catch bun.outOfMemory();
+    bun.handleOom(this.watchlist.ensureUnusedCapacity(this.allocator, 1 + @as(usize, @intCast(@intFromBool(parent_watch_item == null)))));
 
     if (autowatch_parent_dir) {
         parent_watch_item = parent_watch_item orelse switch (this.appendDirectoryAssumeCapacity(dir_fd, parent_dir, parent_dir_hash, clone_file_path)) {
@@ -595,7 +595,7 @@ pub fn addDirectory(
         return .{ .result = @truncate(idx) };
     }
 
-    this.watchlist.ensureUnusedCapacity(this.allocator, 1) catch bun.outOfMemory();
+    bun.handleOom(this.watchlist.ensureUnusedCapacity(this.allocator, 1));
 
     return this.appendDirectoryAssumeCapacity(fd, file_path, hash, clone_file_path);
 }

src/allocators.zig

@@ -3,11 +3,16 @@ pub const z_allocator = basic.z_allocator;
 pub const freeWithoutSize = basic.freeWithoutSize;
 pub const mimalloc = @import("./allocators/mimalloc.zig");
 pub const MimallocArena = @import("./allocators/MimallocArena.zig");
-pub const AllocationScope = @import("./allocators/AllocationScope.zig");
+
+pub const allocation_scope = @import("./allocators/allocation_scope.zig");
+pub const AllocationScope = allocation_scope.AllocationScope;
+pub const AllocationScopeIn = allocation_scope.AllocationScopeIn;
+
 pub const NullableAllocator = @import("./allocators/NullableAllocator.zig");
 pub const MaxHeapAllocator = @import("./allocators/MaxHeapAllocator.zig");
 pub const MemoryReportingAllocator = @import("./allocators/MemoryReportingAllocator.zig");
 pub const LinuxMemFdAllocator = @import("./allocators/LinuxMemFdAllocator.zig");
+pub const MaybeOwned = @import("./allocators/maybe_owned.zig").MaybeOwned;
 
 pub fn isSliceInBufferT(comptime T: type, slice: []const T, buffer: []const T) bool {
     return (@intFromPtr(buffer.ptr) <= @intFromPtr(slice.ptr) and
@@ -228,7 +233,7 @@ pub fn BSSList(comptime ValueType: type, comptime _count: anytype) type {
 
         const Self = @This();
 
-        allocator: Allocator,
+        allocator: std.mem.Allocator,
         mutex: Mutex = .{},
         head: *OverflowBlock,
         tail: OverflowBlock,
@@ -244,7 +249,7 @@ pub fn BSSList(comptime ValueType: type, comptime _count: anytype) type {
 
         pub fn init(allocator: std.mem.Allocator) *Self {
             if (!loaded) {
-                instance = bun.default_allocator.create(Self) catch bun.outOfMemory();
+                instance = bun.handleOom(bun.default_allocator.create(Self));
                 // Avoid struct initialization syntax.
                 // This makes Bun start about 1ms faster.
                 // https://github.com/ziglang/zig/issues/24313
@@ -316,7 +321,7 @@ pub fn BSSStringList(comptime _count: usize, comptime _item_length: usize) type
         backing_buf: [count * item_length]u8,
         backing_buf_used: u64,
         overflow_list: Overflow,
-        allocator: Allocator,
+        allocator: std.mem.Allocator,
         slice_buf: [count][]const u8,
         slice_buf_used: u16,
         mutex: Mutex = .{},
@@ -330,7 +335,7 @@ pub fn BSSStringList(comptime _count: usize, comptime _item_length: usize) type
 
         pub fn init(allocator: std.mem.Allocator) *Self {
             if (!loaded) {
-                instance = bun.default_allocator.create(Self) catch bun.outOfMemory();
+                instance = bun.handleOom(bun.default_allocator.create(Self));
                 // Avoid struct initialization syntax.
                 // This makes Bun start about 1ms faster.
                 // https://github.com/ziglang/zig/issues/24313
@@ -499,7 +504,7 @@ pub fn BSSMap(comptime ValueType: type, comptime count: anytype, comptime store_
 
         index: IndexMap,
         overflow_list: Overflow,
-        allocator: Allocator,
+        allocator: std.mem.Allocator,
         mutex: Mutex = .{},
         backing_buf: [count]ValueType,
         backing_buf_used: u16,
@@ -513,7 +518,7 @@ pub fn BSSMap(comptime ValueType: type, comptime count: anytype, comptime store_
                 // Avoid struct initialization syntax.
                 // This makes Bun start about 1ms faster.
                 // https://github.com/ziglang/zig/issues/24313
-                instance = bun.default_allocator.create(Self) catch bun.outOfMemory();
+                instance = bun.handleOom(bun.default_allocator.create(Self));
                 instance.index = IndexMap{};
                 instance.allocator = allocator;
                 instance.overflow_list.zero();
@@ -666,7 +671,7 @@ pub fn BSSMap(comptime ValueType: type, comptime count: anytype, comptime store_
 
         pub fn init(allocator: std.mem.Allocator) *Self {
             if (!instance_loaded) {
-                instance = bun.default_allocator.create(Self) catch bun.outOfMemory();
+                instance = bun.handleOom(bun.default_allocator.create(Self));
                 // Avoid struct initialization syntax.
                 // This makes Bun start about 1ms faster.
                 // https://github.com/ziglang/zig/issues/24313
@@ -770,36 +775,119 @@ pub fn BSSMap(comptime ValueType: type, comptime count: anytype, comptime store_
     };
 }
 
-pub fn isDefault(allocator: Allocator) bool {
+/// Checks whether `allocator` is the default allocator.
+pub fn isDefault(allocator: std.mem.Allocator) bool {
     return allocator.vtable == c_allocator.vtable;
 }
 
-/// Allocate memory for a value of type `T` using the provided allocator, and initialize the memory
-/// with `value`.
-///
-/// If `allocator` is `bun.default_allocator`, this will internally use `bun.tryNew` to benefit from
-/// the added assertions.
-pub fn create(comptime T: type, allocator: Allocator, value: T) OOM!*T {
-    if ((comptime Environment.allow_assert) and isDefault(allocator)) {
-        return bun.tryNew(T, value);
-    }
-    const ptr = try allocator.create(T);
-    ptr.* = value;
-    return ptr;
+// The following functions operate on generic allocators. A generic allocator is a type that
+// satisfies the `GenericAllocator` interface:
+//
+// ```
+// const GenericAllocator = struct {
+//     // Required.
+//     pub fn allocator(self: Self) std.mem.Allocator;
+//
+//     // Optional, to allow default-initialization. `.{}` will also be tried.
+//     pub fn init() Self;
+//
+//     // Optional, if this allocator owns auxiliary resources that need to be deinitialized.
+//     pub fn deinit(self: *Self) void;
+//
+//     // Optional. Defining a borrowed type makes it clear who owns the allocator and prevents
+//     // `deinit` from being called twice.
+//     pub const Borrowed: type;
+//     pub fn borrow(self: Self) Borrowed;
+// };
+// ```
+//
+// Generic allocators must support being moved. They cannot contain self-references, and they cannot
+// serve allocations from a buffer that exists within the allocator itself (have your allocator type
+// contain a pointer to the buffer instead).
+//
+// As an exception, `std.mem.Allocator` is also treated as a generic allocator, and receives
+// special handling in the following functions to achieve this.
+
+/// Gets the `std.mem.Allocator` for a given generic allocator.
+pub fn asStd(allocator: anytype) std.mem.Allocator {
+    return if (comptime @TypeOf(allocator) == std.mem.Allocator)
+        allocator
+    else
+        allocator.allocator();
 }
 
-/// Free memory previously allocated by `create`.
+/// A borrowed version of an allocator.
 ///
-/// The memory must have been allocated by the `create` function in this namespace, not
-/// directly by `allocator.create`.
-pub fn destroy(allocator: Allocator, ptr: anytype) void {
-    if ((comptime Environment.allow_assert) and isDefault(allocator)) {
-        bun.destroy(ptr);
-    } else {
-        allocator.destroy(ptr);
-    }
+/// Some allocators have a `deinit` method that would be invalid to call multiple times (e.g.,
+/// `AllocationScope` and `MimallocArena`).
+///
+/// If multiple structs or functions need access to the same allocator, we want to avoid simply
+/// passing the allocator by value, as this could easily lead to `deinit` being called multiple
+/// times if we forget who really owns the allocator.
+///
+/// Passing a pointer is not always a good approach, as this results in a performance penalty for
+/// zero-sized allocators, and adds another level of indirection in all cases.
+///
+/// This function allows allocators that have a concept of being "owned" to define a "borrowed"
+/// version of the allocator. If no such type is defined, it is assumed the allocator does not
+/// own any data, and `Borrowed(Allocator)` is simply the same as `Allocator`.
+pub fn Borrowed(comptime Allocator: type) type {
+    return if (comptime @hasDecl(Allocator, "Borrowed"))
+        Allocator.Borrowed
+    else
+        Allocator;
 }
 
+/// Borrows an allocator.
+///
+/// See `Borrowed` for the rationale.
+pub fn borrow(allocator: anytype) Borrowed(@TypeOf(allocator)) {
+    return if (comptime @hasDecl(@TypeOf(allocator), "Borrowed"))
+        allocator.borrow()
+    else
+        allocator;
+}
+
+/// A type that behaves like `?Allocator`. This function will either return `?Allocator` itself,
+/// or an optimized type that behaves like `?Allocator`.
+///
+/// Use `initNullable` and `unpackNullable` to work with the returned type.
+pub fn Nullable(comptime Allocator: type) type {
+    return if (comptime Allocator == std.mem.Allocator)
+        NullableAllocator
+    else if (comptime @hasDecl(Allocator, "Nullable"))
+        Allocator.Nullable
+    else
+        ?Allocator;
+}
+
+/// Creates a `Nullable(Allocator)` from an optional `Allocator`.
+pub fn initNullable(comptime Allocator: type, allocator: ?Allocator) Nullable(Allocator) {
+    return if (comptime Allocator == std.mem.Allocator or @hasDecl(Allocator, "Nullable"))
+        .init(allocator)
+    else
+        allocator;
+}
+
+/// Turns a `Nullable(Allocator)` back into an optional `Allocator`.
+pub fn unpackNullable(comptime Allocator: type, allocator: Nullable(Allocator)) ?Allocator {
+    return if (comptime Allocator == std.mem.Allocator or @hasDecl(Allocator, "Nullable"))
+        .get()
+    else
+        allocator;
+}
+
+/// The default allocator. This is a zero-sized type whose `allocator` method returns
+/// `bun.default_allocator`.
+///
+/// This type is a `GenericAllocator`; see `src/allocators.zig`.
+pub const Default = struct {
+    pub fn allocator(self: Default) std.mem.Allocator {
+        _ = self;
+        return c_allocator;
+    }
+};
+
 const basic = if (bun.use_mimalloc)
     @import("./allocators/basic.zig")
 else
@@ -807,7 +895,6 @@ else
 
 const Environment = @import("./env.zig");
 const std = @import("std");
-const Allocator = std.mem.Allocator;
 
 const bun = @import("bun");
 const OOM = bun.OOM;

src/allocators/AllocationScope.zig

@@ -1,288 +0,0 @@
-//! AllocationScope wraps another allocator, providing leak and invalid free assertions.
-//! It also allows measuring how much memory a scope has allocated.
-//!
-//! AllocationScope is conceptually a pointer, so it can be moved without invalidating allocations.
-//! Therefore, it isn't necessary to pass an AllocationScope by pointer.
-
-const Self = @This();
-
-pub const enabled = bun.Environment.enableAllocScopes;
-
-internal_state: if (enabled) *State else Allocator,
-
-const State = struct {
-    parent: Allocator,
-    mutex: bun.Mutex,
-    total_memory_allocated: usize,
-    allocations: std.AutoHashMapUnmanaged([*]const u8, Allocation),
-    frees: std.AutoArrayHashMapUnmanaged([*]const u8, Free),
-    /// Once `frees` fills up, entries are overwritten from start to end.
-    free_overwrite_index: std.math.IntFittingRange(0, max_free_tracking + 1),
-};
-
-pub const max_free_tracking = 2048 - 1;
-
-pub const Allocation = struct {
-    allocated_at: StoredTrace,
-    len: usize,
-    extra: Extra,
-};
-
-pub const Free = struct {
-    allocated_at: StoredTrace,
-    freed_at: StoredTrace,
-};
-
-pub const Extra = union(enum) {
-    none,
-    ref_count: *RefCountDebugData(false),
-    ref_count_threadsafe: *RefCountDebugData(true),
-
-    const RefCountDebugData = @import("../ptr/ref_count.zig").DebugData;
-};
-
-pub fn init(parent_alloc: Allocator) Self {
-    const state = if (comptime enabled)
-        bun.new(State, .{
-            .parent = parent_alloc,
-            .total_memory_allocated = 0,
-            .allocations = .empty,
-            .frees = .empty,
-            .free_overwrite_index = 0,
-            .mutex = .{},
-        })
-    else
-        parent_alloc;
-    return .{ .internal_state = state };
-}
-
-pub fn deinit(scope: Self) void {
-    if (comptime !enabled) return;
-
-    const state = scope.internal_state;
-    state.mutex.lock();
-    defer bun.destroy(state);
-    defer state.allocations.deinit(state.parent);
-    const count = state.allocations.count();
-    if (count == 0) return;
-    Output.errGeneric("Allocation scope leaked {d} allocations ({})", .{
-        count,
-        bun.fmt.size(state.total_memory_allocated, .{}),
-    });
-    var it = state.allocations.iterator();
-    var n: usize = 0;
-    while (it.next()) |entry| {
-        Output.prettyErrorln("- {any}, len {d}, at:", .{ entry.key_ptr.*, entry.value_ptr.len });
-        bun.crash_handler.dumpStackTrace(entry.value_ptr.allocated_at.trace(), trace_limits);
-
-        switch (entry.value_ptr.extra) {
-            .none => {},
-            inline else => |t| t.onAllocationLeak(@constCast(entry.key_ptr.*[0..entry.value_ptr.len])),
-        }
-
-        n += 1;
-        if (n >= 8) {
-            Output.prettyErrorln("(only showing first 10 leaks)", .{});
-            break;
-        }
-    }
-    Output.panic("Allocation scope leaked {}", .{bun.fmt.size(state.total_memory_allocated, .{})});
-}
-
-pub fn allocator(scope: Self) Allocator {
-    const state = scope.internal_state;
-    return if (comptime enabled) .{ .ptr = state, .vtable = &vtable } else state;
-}
-
-pub fn parent(scope: Self) Allocator {
-    const state = scope.internal_state;
-    return if (comptime enabled) state.parent else state;
-}
-
-pub fn total(self: Self) usize {
-    if (comptime !enabled) @compileError("AllocationScope must be enabled");
-    return self.internal_state.total_memory_allocated;
-}
-
-pub fn numAllocations(self: Self) usize {
-    if (comptime !enabled) @compileError("AllocationScope must be enabled");
-    return self.internal_state.allocations.count();
-}
-
-const vtable: Allocator.VTable = .{
-    .alloc = alloc,
-    .resize = &std.mem.Allocator.noResize,
-    .remap = &std.mem.Allocator.noRemap,
-    .free = free,
-};
-
-// Smaller traces since AllocationScope prints so many
-pub const trace_limits: bun.crash_handler.WriteStackTraceLimits = .{
-    .frame_count = 6,
-    .stop_at_jsc_llint = true,
-    .skip_stdlib = true,
-};
-pub const free_trace_limits: bun.crash_handler.WriteStackTraceLimits = .{
-    .frame_count = 3,
-    .stop_at_jsc_llint = true,
-    .skip_stdlib = true,
-};
-
-fn alloc(ctx: *anyopaque, len: usize, alignment: std.mem.Alignment, ret_addr: usize) ?[*]u8 {
-    const state: *State = @ptrCast(@alignCast(ctx));
-
-    state.mutex.lock();
-    defer state.mutex.unlock();
-    state.allocations.ensureUnusedCapacity(state.parent, 1) catch
-        return null;
-    const result = state.parent.vtable.alloc(state.parent.ptr, len, alignment, ret_addr) orelse
-        return null;
-    trackAllocationAssumeCapacity(state, result[0..len], ret_addr, .none);
-    return result;
-}
-
-fn trackAllocationAssumeCapacity(state: *State, buf: []const u8, ret_addr: usize, extra: Extra) void {
-    const trace = StoredTrace.capture(ret_addr);
-    state.allocations.putAssumeCapacityNoClobber(buf.ptr, .{
-        .allocated_at = trace,
-        .len = buf.len,
-        .extra = extra,
-    });
-    state.total_memory_allocated += buf.len;
-}
-
-fn free(ctx: *anyopaque, buf: []u8, alignment: std.mem.Alignment, ret_addr: usize) void {
-    const state: *State = @ptrCast(@alignCast(ctx));
-    state.mutex.lock();
-    defer state.mutex.unlock();
-    const invalid = trackFreeAssumeLocked(state, buf, ret_addr);
-
-    state.parent.vtable.free(state.parent.ptr, buf, alignment, ret_addr);
-
-    // If asan did not catch the free, panic now.
-    if (invalid) @panic("Invalid free");
-}
-
-fn trackFreeAssumeLocked(state: *State, buf: []const u8, ret_addr: usize) bool {
-    if (state.allocations.fetchRemove(buf.ptr)) |entry| {
-        state.total_memory_allocated -= entry.value.len;
-
-        free_entry: {
-            state.frees.put(state.parent, buf.ptr, .{
-                .allocated_at = entry.value.allocated_at,
-                .freed_at = StoredTrace.capture(ret_addr),
-            }) catch break :free_entry;
-            // Store a limited amount of free entries
-            if (state.frees.count() >= max_free_tracking) {
-                const i = state.free_overwrite_index;
-                state.free_overwrite_index = @mod(state.free_overwrite_index + 1, max_free_tracking);
-                state.frees.swapRemoveAt(i);
-            }
-        }
-        return false;
-    } else {
-        bun.Output.errGeneric("Invalid free, pointer {any}, len {d}", .{ buf.ptr, buf.len });
-
-        if (state.frees.get(buf.ptr)) |free_entry_const| {
-            var free_entry = free_entry_const;
-            bun.Output.printErrorln("Pointer allocated here:", .{});
-            bun.crash_handler.dumpStackTrace(free_entry.allocated_at.trace(), trace_limits);
-            bun.Output.printErrorln("Pointer first freed here:", .{});
-            bun.crash_handler.dumpStackTrace(free_entry.freed_at.trace(), free_trace_limits);
-        }
-
-        // do not panic because address sanitizer will catch this case better.
-        // the log message is in case there is a situation where address
-        // sanitizer does not catch the invalid free.
-
-        return true;
-    }
-}
-
-pub fn assertOwned(scope: Self, ptr: anytype) void {
-    if (comptime !enabled) return;
-    const cast_ptr: [*]const u8 = @ptrCast(switch (@typeInfo(@TypeOf(ptr)).pointer.size) {
-        .c, .one, .many => ptr,
-        .slice => if (ptr.len > 0) ptr.ptr else return,
-    });
-    const state = scope.internal_state;
-    state.mutex.lock();
-    defer state.mutex.unlock();
-    _ = state.allocations.getPtr(cast_ptr) orelse
-        @panic("this pointer was not owned by the allocation scope");
-}
-
-pub fn assertUnowned(scope: Self, ptr: anytype) void {
-    if (comptime !enabled) return;
-    const cast_ptr: [*]const u8 = @ptrCast(switch (@typeInfo(@TypeOf(ptr)).pointer.size) {
-        .c, .one, .many => ptr,
-        .slice => if (ptr.len > 0) ptr.ptr else return,
-    });
-    const state = scope.internal_state;
-    state.mutex.lock();
-    defer state.mutex.unlock();
-    if (state.allocations.getPtr(cast_ptr)) |owned| {
-        Output.warn("Owned pointer allocated here:");
-        bun.crash_handler.dumpStackTrace(owned.allocated_at.trace(), trace_limits, trace_limits);
-    }
-    @panic("this pointer was owned by the allocation scope when it was not supposed to be");
-}
-
-/// Track an arbitrary pointer. Extra data can be stored in the allocation,
-/// which will be printed when a leak is detected.
-pub fn trackExternalAllocation(scope: Self, ptr: []const u8, ret_addr: ?usize, extra: Extra) void {
-    if (comptime !enabled) return;
-    const state = scope.internal_state;
-    state.mutex.lock();
-    defer state.mutex.unlock();
-    state.allocations.ensureUnusedCapacity(state.parent, 1) catch bun.outOfMemory();
-    trackAllocationAssumeCapacity(state, ptr, ptr.len, ret_addr orelse @returnAddress(), extra);
-}
-
-/// Call when the pointer from `trackExternalAllocation` is freed.
-/// Returns true if the free was invalid.
-pub fn trackExternalFree(scope: Self, slice: anytype, ret_addr: ?usize) bool {
-    if (comptime !enabled) return false;
-    const ptr: []const u8 = switch (@typeInfo(@TypeOf(slice))) {
-        .pointer => |p| switch (p.size) {
-            .slice => brk: {
-                if (p.child != u8) @compileError("This function only supports []u8 or [:sentinel]u8 types, you passed in: " ++ @typeName(@TypeOf(slice)));
-                if (p.sentinel_ptr == null) break :brk slice;
-                // Ensure we include the sentinel value
-                break :brk slice[0 .. slice.len + 1];
-            },
-            else => @compileError("This function only supports []u8 or [:sentinel]u8 types, you passed in: " ++ @typeName(@TypeOf(slice))),
-        },
-        else => @compileError("This function only supports []u8 or [:sentinel]u8 types, you passed in: " ++ @typeName(@TypeOf(slice))),
-    };
-    // Empty slice usually means invalid pointer
-    if (ptr.len == 0) return false;
-    const state = scope.internal_state;
-    state.mutex.lock();
-    defer state.mutex.unlock();
-    return trackFreeAssumeLocked(state, ptr, ret_addr orelse @returnAddress());
-}
-
-pub fn setPointerExtra(scope: Self, ptr: *anyopaque, extra: Extra) void {
-    if (comptime !enabled) return;
-    const state = scope.internal_state;
-    state.mutex.lock();
-    defer state.mutex.unlock();
-    const allocation = state.allocations.getPtr(ptr) orelse
-        @panic("Pointer not owned by allocation scope");
-    allocation.extra = extra;
-}
-
-pub inline fn downcast(a: Allocator) ?Self {
-    return if (enabled and a.vtable == &vtable)
-        .{ .internal_state = @ptrCast(@alignCast(a.ptr)) }
-    else
-        null;
-}
-
-const std = @import("std");
-const Allocator = std.mem.Allocator;
-
-const bun = @import("bun");
-const Output = bun.Output;
-const StoredTrace = bun.crash_handler.StoredTrace;

src/allocators/MimallocArena.zig

@@ -1,29 +1,95 @@
+//! This type is a `GenericAllocator`; see `src/allocators.zig`.
+
 const Self = @This();
 
-heap: HeapPtr,
+#heap: if (safety_checks) Owned(*DebugHeap) else *mimalloc.Heap,
 
-const HeapPtr = if (safety_checks) *DebugHeap else *mimalloc.Heap;
+/// Uses the default thread-local heap. This type is zero-sized.
+///
+/// This type is a `GenericAllocator`; see `src/allocators.zig`.
+pub const Default = struct {
+    pub fn allocator(self: Default) std.mem.Allocator {
+        _ = self;
+        return Borrowed.getDefault().allocator();
+    }
+};
+
+/// Borrowed version of `MimallocArena`, returned by `MimallocArena.borrow`.
+/// Using this type makes it clear who actually owns the `MimallocArena`, and prevents
+/// `deinit` from being called twice.
+///
+/// This type is a `GenericAllocator`; see `src/allocators.zig`.
+pub const Borrowed = struct {
+    #heap: BorrowedHeap,
+
+    pub fn allocator(self: Borrowed) std.mem.Allocator {
+        return .{ .ptr = self.#heap, .vtable = &c_allocator_vtable };
+    }
+
+    pub fn getDefault() Borrowed {
+        return .{ .#heap = getThreadHeap() };
+    }
+
+    pub fn gc(self: Borrowed) void {
+        mimalloc.mi_heap_collect(self.getMimallocHeap(), false);
+    }
+
+    pub fn helpCatchMemoryIssues(self: Borrowed) void {
+        if (comptime bun.FeatureFlags.help_catch_memory_issues) {
+            self.gc();
+            bun.mimalloc.mi_collect(false);
+        }
+    }
+
+    pub fn ownsPtr(self: Borrowed, ptr: *const anyopaque) bool {
+        return mimalloc.mi_heap_check_owned(self.getMimallocHeap(), ptr);
+    }
+
+    fn fromOpaque(ptr: *anyopaque) Borrowed {
+        return .{ .#heap = @ptrCast(@alignCast(ptr)) };
+    }
+
+    fn getMimallocHeap(self: Borrowed) *mimalloc.Heap {
+        return if (comptime safety_checks) self.#heap.inner else self.#heap;
+    }
+
+    fn assertThreadLock(self: Borrowed) void {
+        if (comptime safety_checks) self.#heap.thread_lock.assertLocked();
+    }
+
+    fn alignedAlloc(self: Borrowed, len: usize, alignment: Alignment) ?[*]u8 {
+        log("Malloc: {d}\n", .{len});
+
+        const heap = self.getMimallocHeap();
+        const ptr: ?*anyopaque = if (mimalloc.mustUseAlignedAlloc(alignment))
+            mimalloc.mi_heap_malloc_aligned(heap, len, alignment.toByteUnits())
+        else
+            mimalloc.mi_heap_malloc(heap, len);
+
+        if (comptime bun.Environment.isDebug) {
+            const usable = mimalloc.mi_malloc_usable_size(ptr);
+            if (usable < len) {
+                std.debug.panic("mimalloc: allocated size is too small: {d} < {d}", .{ usable, len });
+            }
+        }
+
+        return if (ptr) |p|
+            @as([*]u8, @ptrCast(p))
+        else
+            null;
+    }
+};
+
+const BorrowedHeap = if (safety_checks) *DebugHeap else *mimalloc.Heap;
 
 const DebugHeap = struct {
     inner: *mimalloc.Heap,
     thread_lock: bun.safety.ThreadLock,
 };
 
-fn getMimallocHeap(self: Self) *mimalloc.Heap {
-    return if (comptime safety_checks) self.heap.inner else self.heap;
-}
-
-fn fromOpaque(ptr: *anyopaque) Self {
-    return .{ .heap = bun.cast(HeapPtr, ptr) };
-}
-
-fn assertThreadLock(self: Self) void {
-    if (comptime safety_checks) self.heap.thread_lock.assertLocked();
-}
-
 threadlocal var thread_heap: if (safety_checks) ?DebugHeap else void = if (safety_checks) null;
 
-fn getThreadHeap() HeapPtr {
+fn getThreadHeap() BorrowedHeap {
     if (comptime !safety_checks) return mimalloc.mi_heap_get_default();
     if (thread_heap == null) {
         thread_heap = .{
@@ -36,23 +102,27 @@ fn getThreadHeap() HeapPtr {
 
 const log = bun.Output.scoped(.mimalloc, .hidden);
 
+pub fn allocator(self: Self) std.mem.Allocator {
+    return self.borrow().allocator();
+}
+
+pub fn borrow(self: Self) Borrowed {
+    return .{ .#heap = if (comptime safety_checks) self.#heap.get() else self.#heap };
+}
+
 /// Internally, mimalloc calls mi_heap_get_default()
 /// to get the default heap.
 /// It uses pthread_getspecific to do that.
 /// We can save those extra calls if we just do it once in here
-pub fn getThreadLocalDefault() Allocator {
-    return Allocator{ .ptr = getThreadHeap(), .vtable = &c_allocator_vtable };
+pub fn getThreadLocalDefault() std.mem.Allocator {
+    return Borrowed.getDefault().allocator();
 }
 
-pub fn backingAllocator(_: Self) Allocator {
+pub fn backingAllocator(_: Self) std.mem.Allocator {
     return getThreadLocalDefault();
 }
 
-pub fn allocator(self: Self) Allocator {
-    return Allocator{ .ptr = self.heap, .vtable = &c_allocator_vtable };
-}
-
-pub fn dumpThreadStats(_: *Self) void {
+pub fn dumpThreadStats(_: Self) void {
     const dump_fn = struct {
         pub fn dump(textZ: [*:0]const u8, _: ?*anyopaque) callconv(.C) void {
             const text = bun.span(textZ);
@@ -63,7 +133,7 @@ pub fn dumpThreadStats(_: *Self) void {
     bun.Output.flush();
 }
 
-pub fn dumpStats(_: *Self) void {
+pub fn dumpStats(_: Self) void {
     const dump_fn = struct {
         pub fn dump(textZ: [*:0]const u8, _: ?*anyopaque) callconv(.C) void {
             const text = bun.span(textZ);
@@ -75,9 +145,9 @@ pub fn dumpStats(_: *Self) void {
 }
 
 pub fn deinit(self: *Self) void {
-    const mimalloc_heap = self.getMimallocHeap();
+    const mimalloc_heap = self.borrow().getMimallocHeap();
     if (comptime safety_checks) {
-        bun.destroy(self.heap);
+        self.#heap.deinit();
     }
     mimalloc.mi_heap_destroy(mimalloc_heap);
     self.* = undefined;
@@ -85,70 +155,43 @@ pub fn deinit(self: *Self) void {
 
 pub fn init() Self {
     const mimalloc_heap = mimalloc.mi_heap_new() orelse bun.outOfMemory();
-    const heap = if (comptime safety_checks)
-        bun.new(DebugHeap, .{
-            .inner = mimalloc_heap,
-            .thread_lock = .initLocked(),
-        })
-    else
-        mimalloc_heap;
-    return .{ .heap = heap };
+    if (comptime !safety_checks) return .{ .#heap = mimalloc_heap };
+    const heap: Owned(*DebugHeap) = .new(.{
+        .inner = mimalloc_heap,
+        .thread_lock = .initLocked(),
+    });
+    return .{ .#heap = heap };
 }
 
 pub fn gc(self: Self) void {
-    mimalloc.mi_heap_collect(self.getMimallocHeap(), false);
+    self.borrow().gc();
 }
 
-pub inline fn helpCatchMemoryIssues(self: Self) void {
-    if (comptime bun.FeatureFlags.help_catch_memory_issues) {
-        self.gc();
-        bun.mimalloc.mi_collect(false);
-    }
+pub fn helpCatchMemoryIssues(self: Self) void {
+    self.borrow().helpCatchMemoryIssues();
 }
 
 pub fn ownsPtr(self: Self, ptr: *const anyopaque) bool {
-    return mimalloc.mi_heap_check_owned(self.getMimallocHeap(), ptr);
-}
-
-fn alignedAlloc(self: Self, len: usize, alignment: Alignment) ?[*]u8 {
-    log("Malloc: {d}\n", .{len});
-
-    const heap = self.getMimallocHeap();
-    const ptr: ?*anyopaque = if (mimalloc.mustUseAlignedAlloc(alignment))
-        mimalloc.mi_heap_malloc_aligned(heap, len, alignment.toByteUnits())
-    else
-        mimalloc.mi_heap_malloc(heap, len);
-
-    if (comptime bun.Environment.isDebug) {
-        const usable = mimalloc.mi_malloc_usable_size(ptr);
-        if (usable < len) {
-            std.debug.panic("mimalloc: allocated size is too small: {d} < {d}", .{ usable, len });
-        }
-    }
-
-    return if (ptr) |p|
-        @as([*]u8, @ptrCast(p))
-    else
-        null;
+    return self.borrow().ownsPtr(ptr);
 }
 
 fn alignedAllocSize(ptr: [*]u8) usize {
     return mimalloc.mi_malloc_usable_size(ptr);
 }
 
-fn alloc(ptr: *anyopaque, len: usize, alignment: Alignment, _: usize) ?[*]u8 {
-    const self = fromOpaque(ptr);
+fn vtable_alloc(ptr: *anyopaque, len: usize, alignment: Alignment, _: usize) ?[*]u8 {
+    const self: Borrowed = .fromOpaque(ptr);
     self.assertThreadLock();
-    return alignedAlloc(self, len, alignment);
+    return self.alignedAlloc(len, alignment);
 }
 
-fn resize(ptr: *anyopaque, buf: []u8, _: Alignment, new_len: usize, _: usize) bool {
-    const self = fromOpaque(ptr);
+fn vtable_resize(ptr: *anyopaque, buf: []u8, _: Alignment, new_len: usize, _: usize) bool {
+    const self: Borrowed = .fromOpaque(ptr);
     self.assertThreadLock();
     return mimalloc.mi_expand(buf.ptr, new_len) != null;
 }
 
-fn free(
+fn vtable_free(
     _: *anyopaque,
     buf: []u8,
     alignment: Alignment,
@@ -187,8 +230,8 @@ fn free(
 /// `ret_addr` is optionally provided as the first return address of the
 /// allocation call stack. If the value is `0` it means no return address
 /// has been provided.
-fn remap(ptr: *anyopaque, buf: []u8, alignment: Alignment, new_len: usize, _: usize) ?[*]u8 {
-    const self = fromOpaque(ptr);
+fn vtable_remap(ptr: *anyopaque, buf: []u8, alignment: Alignment, new_len: usize, _: usize) ?[*]u8 {
+    const self: Borrowed = .fromOpaque(ptr);
     self.assertThreadLock();
     const heap = self.getMimallocHeap();
     const aligned_size = alignment.toByteUnits();
@@ -196,23 +239,22 @@ fn remap(ptr: *anyopaque, buf: []u8, alignment: Alignment, new_len: usize, _: us
     return @ptrCast(value);
 }
 
-pub fn isInstance(allocator_: Allocator) bool {
-    return allocator_.vtable == &c_allocator_vtable;
+pub fn isInstance(alloc: std.mem.Allocator) bool {
+    return alloc.vtable == &c_allocator_vtable;
 }
 
-const c_allocator_vtable = Allocator.VTable{
-    .alloc = &Self.alloc,
-    .resize = &Self.resize,
-    .remap = &Self.remap,
-    .free = &Self.free,
+const c_allocator_vtable = std.mem.Allocator.VTable{
+    .alloc = vtable_alloc,
+    .resize = vtable_resize,
+    .remap = vtable_remap,
+    .free = vtable_free,
 };
 
 const std = @import("std");
+const Alignment = std.mem.Alignment;
 
 const bun = @import("bun");
 const assert = bun.assert;
 const mimalloc = bun.mimalloc;
+const Owned = bun.ptr.Owned;
 const safety_checks = bun.Environment.ci_assert;
-
-const Alignment = std.mem.Alignment;
-const Allocator = std.mem.Allocator;

src/allocators/NullableAllocator.zig

@@ -4,8 +4,7 @@ const NullableAllocator = @This();
 
 ptr: *anyopaque = undefined,
 // Utilize the null pointer optimization on the vtable instead of
-// the regular ptr because some allocator implementations might tag their
-// `ptr` property.
+// the regular `ptr` because `ptr` may be undefined.
 vtable: ?*const std.mem.Allocator.VTable = null,
 
 pub inline fn init(allocator: ?std.mem.Allocator) NullableAllocator {

src/allocators/allocation_scope.zig

@@ -0,0 +1,555 @@
+//! AllocationScope wraps another allocator, providing leak and invalid free assertions.
+//! It also allows measuring how much memory a scope has allocated.
+
+const allocation_scope = @This();
+
+/// An allocation scope with a dynamically typed parent allocator. Prefer using a concrete type,
+/// like `AllocationScopeIn(bun.DefaultAllocator)`.
+pub const AllocationScope = AllocationScopeIn(std.mem.Allocator);
+
+pub const Allocation = struct {
+    allocated_at: StoredTrace,
+    len: usize,
+    extra: Extra,
+};
+
+pub const Free = struct {
+    allocated_at: StoredTrace,
+    freed_at: StoredTrace,
+};
+
+pub const Extra = struct {
+    ptr: *anyopaque,
+    vtable: ?*const VTable,
+
+    pub const none: Extra = .{ .ptr = undefined, .vtable = null };
+
+    pub const VTable = struct {
+        onAllocationLeak: *const fn (*anyopaque, data: []u8) void,
+    };
+};
+
+pub const Stats = struct {
+    total_memory_allocated: usize,
+    num_allocations: usize,
+};
+
+pub const FreeError = error{
+    /// Tried to free memory that wasn't allocated by this `AllocationScope`, or was already freed.
+    NotAllocated,
+};
+
+pub const enabled = bun.Environment.enableAllocScopes;
+pub const max_free_tracking = 2048 - 1;
+
+const History = struct {
+    const Self = @This();
+
+    total_memory_allocated: usize = 0,
+    /// Allocated by `State.parent`.
+    allocations: std.AutoHashMapUnmanaged([*]const u8, Allocation) = .empty,
+    /// Allocated by `State.parent`.
+    frees: std.AutoArrayHashMapUnmanaged([*]const u8, Free) = .empty,
+    /// Once `frees` fills up, entries are overwritten from start to end.
+    free_overwrite_index: std.math.IntFittingRange(0, max_free_tracking + 1) = 0,
+
+    /// `allocator` should be `State.parent`.
+    fn deinit(self: *Self, allocator: std.mem.Allocator) void {
+        self.allocations.deinit(allocator);
+        self.frees.deinit(allocator);
+        self.* = undefined;
+    }
+};
+
+const LockedState = struct {
+    const Self = @This();
+
+    /// Should be the same as `State.parent`.
+    parent: std.mem.Allocator,
+    history: *History,
+
+    fn alloc(self: Self, len: usize, alignment: std.mem.Alignment, ret_addr: usize) bun.OOM![*]u8 {
+        const result = self.parent.rawAlloc(len, alignment, ret_addr) orelse
+            return error.OutOfMemory;
+        errdefer self.parent.rawFree(result[0..len], alignment, ret_addr);
+        try self.trackAllocation(result[0..len], ret_addr, .none);
+        return result;
+    }
+
+    fn free(self: Self, buf: []u8, alignment: std.mem.Alignment, ret_addr: usize) void {
+        const success = if (self.trackFree(buf, ret_addr))
+            true
+        else |err| switch (err) {
+            error.NotAllocated => false,
+        };
+        if (success or bun.Environment.enable_asan) {
+            self.parent.rawFree(buf, alignment, ret_addr);
+        }
+        if (!success) {
+            // If asan did not catch the free, panic now.
+            std.debug.panic("Invalid free: {*}", .{buf});
+        }
+    }
+
+    fn assertOwned(self: Self, ptr: anytype) void {
+        const cast_ptr: [*]const u8 = @ptrCast(switch (@typeInfo(@TypeOf(ptr)).pointer.size) {
+            .c, .one, .many => ptr,
+            .slice => if (ptr.len > 0) ptr.ptr else return,
+        });
+        if (!self.history.allocations.contains(cast_ptr)) {
+            @panic("this pointer was not owned by the allocation scope");
+        }
+    }
+
+    fn assertUnowned(self: Self, ptr: anytype) void {
+        const cast_ptr: [*]const u8 = @ptrCast(switch (@typeInfo(@TypeOf(ptr)).pointer.size) {
+            .c, .one, .many => ptr,
+            .slice => if (ptr.len > 0) ptr.ptr else return,
+        });
+        if (self.history.allocations.getPtr(cast_ptr)) |owned| {
+            Output.warn("Owned pointer allocated here:");
+            bun.crash_handler.dumpStackTrace(
+                owned.allocated_at.trace(),
+                trace_limits,
+                trace_limits,
+            );
+            @panic("this pointer was owned by the allocation scope when it was not supposed to be");
+        }
+    }
+
+    fn trackAllocation(self: Self, buf: []const u8, ret_addr: usize, extra: Extra) bun.OOM!void {
+        const trace = StoredTrace.capture(ret_addr);
+        try self.history.allocations.putNoClobber(self.parent, buf.ptr, .{
+            .allocated_at = trace,
+            .len = buf.len,
+            .extra = extra,
+        });
+        self.history.total_memory_allocated += buf.len;
+    }
+
+    fn trackFree(self: Self, buf: []const u8, ret_addr: usize) FreeError!void {
+        const entry = self.history.allocations.fetchRemove(buf.ptr) orelse {
+            Output.errGeneric("Invalid free, pointer {any}, len {d}", .{ buf.ptr, buf.len });
+
+            if (self.history.frees.getPtr(buf.ptr)) |free_entry| {
+                Output.printErrorln("Pointer allocated here:", .{});
+                bun.crash_handler.dumpStackTrace(free_entry.allocated_at.trace(), trace_limits);
+                Output.printErrorln("Pointer first freed here:", .{});
+                bun.crash_handler.dumpStackTrace(free_entry.freed_at.trace(), free_trace_limits);
+            }
+
+            // do not panic because address sanitizer will catch this case better.
+            // the log message is in case there is a situation where address
+            // sanitizer does not catch the invalid free.
+            return error.NotAllocated;
+        };
+
+        self.history.total_memory_allocated -= entry.value.len;
+
+        // Store a limited amount of free entries
+        if (self.history.frees.count() >= max_free_tracking) {
+            const i = self.history.free_overwrite_index;
+            self.history.free_overwrite_index =
+                @mod(self.history.free_overwrite_index + 1, max_free_tracking);
+            self.history.frees.swapRemoveAt(i);
+        }
+
+        self.history.frees.put(self.parent, buf.ptr, .{
+            .allocated_at = entry.value.allocated_at,
+            .freed_at = StoredTrace.capture(ret_addr),
+        }) catch |err| bun.handleOom(err);
+    }
+};
+
+const State = struct {
+    const Self = @This();
+
+    /// This field should not be modified. Therefore, it doesn't need to be protected by the mutex.
+    parent: std.mem.Allocator,
+    history: bun.threading.Guarded(History),
+
+    fn init(parent_alloc: std.mem.Allocator) Self {
+        return .{
+            .parent = parent_alloc,
+            .history = .init(.{}),
+        };
+    }
+
+    fn lock(self: *Self) LockedState {
+        return .{
+            .parent = self.parent,
+            .history = self.history.lock(),
+        };
+    }
+
+    fn unlock(self: *Self) void {
+        self.history.unlock();
+    }
+
+    fn deinit(self: *Self) void {
+        defer self.* = undefined;
+        var history = self.history.intoUnprotected();
+        defer history.deinit();
+
+        const count = history.allocations.count();
+        if (count == 0) return;
+        Output.errGeneric("Allocation scope leaked {d} allocations ({})", .{
+            count,
+            bun.fmt.size(history.total_memory_allocated, .{}),
+        });
+
+        var it = history.allocations.iterator();
+        var n: usize = 0;
+        while (it.next()) |entry| : (n += 1) {
+            if (n >= 10) {
+                Output.prettyErrorln("(only showing first 10 leaks)", .{});
+                break;
+            }
+            Output.prettyErrorln(
+                "- {any}, len {d}, at:",
+                .{ entry.key_ptr.*, entry.value_ptr.len },
+            );
+            bun.crash_handler.dumpStackTrace(
+                entry.value_ptr.allocated_at.trace(),
+                trace_limits,
+            );
+            const extra = entry.value_ptr.extra;
+            if (extra.vtable) |extra_vtable| {
+                extra_vtable.onAllocationLeak(
+                    extra.ptr,
+                    @constCast(entry.key_ptr.*[0..entry.value_ptr.len]),
+                );
+            }
+        }
+
+        Output.panic(
+            "Allocation scope leaked {}",
+            .{bun.fmt.size(history.total_memory_allocated, .{})},
+        );
+    }
+
+    fn trackExternalAllocation(self: *Self, ptr: []const u8, ret_addr: ?usize, extra: Extra) void {
+        const locked = self.lock();
+        defer self.unlock();
+        locked.trackAllocation(ptr, ret_addr orelse @returnAddress(), extra) catch |err|
+            bun.handleOom(err);
+    }
+
+    fn trackExternalFree(self: *Self, slice: anytype, ret_addr: ?usize) FreeError!void {
+        const invalidType = struct {
+            fn invalidType() noreturn {
+                @compileError(std.fmt.comptimePrint(
+                    "This function only supports []u8 or [:sentinel]u8 types, you passed in: {s}",
+                    .{@typeName(@TypeOf(slice))},
+                ));
+            }
+        }.invalidType;
+
+        const ptr: []const u8 = switch (@typeInfo(@TypeOf(slice))) {
+            .pointer => |p| switch (p.size) {
+                .slice => brk: {
+                    if (p.child != u8) invalidType();
+                    if (p.sentinel_ptr == null) break :brk slice;
+                    // Ensure we include the sentinel value
+                    break :brk slice[0 .. slice.len + 1];
+                },
+                else => invalidType(),
+            },
+            else => invalidType(),
+        };
+        // Empty slice usually means invalid pointer
+        if (ptr.len == 0) return;
+        const locked = self.lock();
+        defer self.unlock();
+        return locked.trackFree(ptr, ret_addr orelse @returnAddress());
+    }
+
+    fn setPointerExtra(self: *Self, ptr: *anyopaque, extra: Extra) void {
+        const locked = self.lock();
+        defer self.unlock();
+        const allocation = locked.history.allocations.getPtr(@ptrCast(ptr)) orelse
+            @panic("Pointer not owned by allocation scope");
+        allocation.extra = extra;
+    }
+};
+
+/// An allocation scope that uses a specific kind of parent allocator.
+///
+/// This type is a `GenericAllocator`; see `src/allocators.zig`.
+pub fn AllocationScopeIn(comptime Allocator: type) type {
+    const BorrowedAllocator = bun.allocators.Borrowed(Allocator);
+
+    // Borrowed version of `AllocationScope`. Access this type as `AllocationScope.Borrowed`.
+    const BorrowedScope = struct {
+        const Self = @This();
+
+        #parent: BorrowedAllocator,
+        #state: if (enabled) *State else void,
+
+        pub fn allocator(self: Self) std.mem.Allocator {
+            return if (comptime enabled)
+                .{ .ptr = self.#state, .vtable = &vtable }
+            else
+                bun.allocators.asStd(self.#parent);
+        }
+
+        pub fn parent(self: Self) BorrowedAllocator {
+            return self.#parent;
+        }
+
+        /// Deinitializes a borrowed allocation scope. This does not deinitialize the
+        /// `AllocationScope` itself; only the owner of the `AllocationScope` should do that.
+        ///
+        /// This method doesn't need to be called unless `bun.allocators.Borrowed(Allocator)` has
+        /// a `deinit` method.
+        pub fn deinit(self: *Self) void {
+            bun.memory.deinit(&self.#parent);
+            self.* = undefined;
+        }
+
+        pub fn stats(self: Self) Stats {
+            if (comptime !enabled) @compileError("AllocationScope must be enabled");
+            const state = self.#state.lock();
+            defer self.#state.unlock();
+            return .{
+                .total_memory_allocated = state.history.total_memory_allocated,
+                .num_allocations = state.history.allocations.count(),
+            };
+        }
+
+        pub fn assertOwned(self: Self, ptr: anytype) void {
+            if (comptime !enabled) return;
+            const state = self.#state.lock();
+            defer self.#state.unlock();
+            state.assertOwned(ptr);
+        }
+
+        pub fn assertUnowned(self: Self, ptr: anytype) void {
+            if (comptime !enabled) return;
+            const state = self.#state.lock();
+            defer self.#state.unlock();
+            state.assertUnowned(ptr);
+        }
+
+        pub fn trackExternalAllocation(
+            self: Self,
+            ptr: []const u8,
+            ret_addr: ?usize,
+            extra: Extra,
+        ) void {
+            if (comptime enabled) self.#state.trackExternalAllocation(ptr, ret_addr, extra);
+        }
+
+        pub fn trackExternalFree(self: Self, slice: anytype, ret_addr: ?usize) FreeError!void {
+            return if (comptime enabled) self.#state.trackExternalFree(slice, ret_addr);
+        }
+
+        pub fn setPointerExtra(self: Self, ptr: *anyopaque, extra: Extra) void {
+            if (comptime enabled) self.#state.setPointerExtra(ptr, extra);
+        }
+
+        fn downcastImpl(
+            std_alloc: std.mem.Allocator,
+            parent_alloc: if (Allocator == std.mem.Allocator)
+                ?BorrowedAllocator
+            else
+                BorrowedAllocator,
+        ) Self {
+            const state = if (comptime enabled) blk: {
+                bun.assertf(
+                    std_alloc.vtable == &vtable,
+                    "allocator is not an allocation scope (has vtable {*})",
+                    .{std_alloc.vtable},
+                );
+                const state: *State = @ptrCast(@alignCast(std_alloc.ptr));
+                break :blk state;
+            };
+
+            const current_std_parent = if (comptime enabled)
+                state.parent
+            else
+                std_alloc;
+
+            const new_parent = if (comptime Allocator == std.mem.Allocator)
+                parent_alloc orelse current_std_parent
+            else
+                parent_alloc;
+
+            const new_std_parent = bun.allocators.asStd(new_parent);
+            bun.safety.alloc.assertEqFmt(
+                current_std_parent,
+                new_std_parent,
+                "tried to downcast allocation scope with wrong parent allocator",
+                .{},
+            );
+            return .{ .#parent = new_parent, .#state = state };
+        }
+
+        /// Converts an `std.mem.Allocator` into a borrowed allocation scope, with a given parent
+        /// allocator.
+        ///
+        /// Requirements:
+        ///
+        /// * `std_alloc` must have come from `AllocationScopeIn(Allocator).allocator` (or the
+        ///   equivalent method on a `Borrowed` instance).
+        ///
+        /// * `parent_alloc` must be equivalent to the (borrowed) parent allocator of the original
+        ///   allocation scope (that is, the return value of `AllocationScopeIn(Allocator).parent`).
+        ///   In particular, `bun.allocators.asStd` must return the same value for each allocator.
+        pub fn downcastIn(std_alloc: std.mem.Allocator, parent_alloc: BorrowedAllocator) Self {
+            return downcastImpl(std_alloc, parent_alloc);
+        }
+
+        /// Converts an `std.mem.Allocator` into a borrowed allocation scope.
+        ///
+        /// Requirements:
+        ///
+        /// * `std_alloc` must have come from `AllocationScopeIn(Allocator).allocator` (or the
+        ///   equivalent method on a `Borrowed` instance).
+        ///
+        /// * One of the following must be true:
+        ///
+        ///   1. `Allocator` is `std.mem.Allocator`.
+        ///
+        ///   2. The parent allocator of the original allocation scope is equivalent to a
+        ///      default-initialized borrowed `Allocator`, as returned by
+        ///      `bun.memory.initDefault(bun.allocators.Borrowed(Allocator))`. This is the case
+        ///      for `bun.DefaultAllocator`.
+        pub fn downcast(std_alloc: std.mem.Allocator) Self {
+            return downcastImpl(std_alloc, if (comptime Allocator == std.mem.Allocator)
+                null
+            else
+                bun.memory.initDefault(BorrowedAllocator));
+        }
+    };
+
+    return struct {
+        const Self = @This();
+
+        #parent: Allocator,
+        #state: if (Self.enabled) Owned(*State) else void,
+
+        pub const enabled = allocation_scope.enabled;
+
+        /// Borrowed version of `AllocationScope`, returned by `AllocationScope.borrow`.
+        /// Using this type makes it clear who actually owns the `AllocationScope`, and prevents
+        /// `deinit` from being called twice.
+        ///
+        /// This type is a `GenericAllocator`; see `src/allocators.zig`.
+        pub const Borrowed = BorrowedScope;
+
+        pub fn init(parent_alloc: Allocator) Self {
+            return .{
+                .#parent = parent_alloc,
+                .#state = if (comptime Self.enabled) .new(.init(
+                    bun.allocators.asStd(parent_alloc),
+                )),
+            };
+        }
+
+        pub fn initDefault() Self {
+            return .init(bun.memory.initDefault(Allocator));
+        }
+
+        /// Borrows this `AllocationScope`. Use this method instead of copying `self`, as that makes
+        /// it hard to know who owns the `AllocationScope`, and could lead to `deinit` being called
+        /// twice.
+        pub fn borrow(self: Self) Borrowed {
+            return .{
+                .#parent = self.parent(),
+                .#state = if (comptime Self.enabled) self.#state.get(),
+            };
+        }
+
+        pub fn allocator(self: Self) std.mem.Allocator {
+            return self.borrow().allocator();
+        }
+
+        pub fn deinit(self: *Self) void {
+            bun.memory.deinit(&self.#parent);
+            if (comptime Self.enabled) self.#state.deinit();
+            self.* = undefined;
+        }
+
+        pub fn parent(self: Self) BorrowedAllocator {
+            return bun.allocators.borrow(self.#parent);
+        }
+
+        pub fn stats(self: Self) Stats {
+            return self.borrow().stats();
+        }
+
+        pub fn assertOwned(self: Self, ptr: anytype) void {
+            self.borrow().assertOwned(ptr);
+        }
+
+        pub fn assertUnowned(self: Self, ptr: anytype) void {
+            self.borrow().assertUnowned(ptr);
+        }
+
+        /// Track an arbitrary pointer. Extra data can be stored in the allocation, which will be
+        /// printed when a leak is detected.
+        pub fn trackExternalAllocation(
+            self: Self,
+            ptr: []const u8,
+            ret_addr: ?usize,
+            extra: Extra,
+        ) void {
+            self.borrow().trackExternalAllocation(ptr, ret_addr, extra);
+        }
+
+        /// Call when the pointer from `trackExternalAllocation` is freed.
+        pub fn trackExternalFree(self: Self, slice: anytype, ret_addr: ?usize) FreeError!void {
+            return self.borrow().trackExternalFree(slice, ret_addr);
+        }
+
+        pub fn setPointerExtra(self: Self, ptr: *anyopaque, extra: Extra) void {
+            return self.borrow().setPointerExtra(ptr, extra);
+        }
+    };
+}
+
+const vtable: std.mem.Allocator.VTable = .{
+    .alloc = vtable_alloc,
+    .resize = std.mem.Allocator.noResize,
+    .remap = std.mem.Allocator.noRemap,
+    .free = vtable_free,
+};
+
+// Smaller traces since AllocationScope prints so many
+pub const trace_limits: bun.crash_handler.WriteStackTraceLimits = .{
+    .frame_count = 6,
+    .stop_at_jsc_llint = true,
+    .skip_stdlib = true,
+};
+
+pub const free_trace_limits: bun.crash_handler.WriteStackTraceLimits = .{
+    .frame_count = 3,
+    .stop_at_jsc_llint = true,
+    .skip_stdlib = true,
+};
+
+fn vtable_alloc(ctx: *anyopaque, len: usize, alignment: std.mem.Alignment, ret_addr: usize) ?[*]u8 {
+    const raw_state: *State = @ptrCast(@alignCast(ctx));
+    const state = raw_state.lock();
+    defer raw_state.unlock();
+    return state.alloc(len, alignment, ret_addr) catch null;
+}
+
+fn vtable_free(ctx: *anyopaque, buf: []u8, alignment: std.mem.Alignment, ret_addr: usize) void {
+    const raw_state: *State = @ptrCast(@alignCast(ctx));
+    const state = raw_state.lock();
+    defer raw_state.unlock();
+    state.free(buf, alignment, ret_addr);
+}
+
+pub inline fn isInstance(allocator: std.mem.Allocator) bool {
+    return (comptime enabled) and allocator.vtable == &vtable;
+}
+
+const std = @import("std");
+
+const bun = @import("bun");
+const Output = bun.Output;
+const Owned = bun.ptr.Owned;
+const StoredTrace = bun.crash_handler.StoredTrace;

src/allocators/maybe_owned.zig

@@ -0,0 +1,112 @@
+/// This type can be used with `bun.ptr.Owned` to model "maybe owned" pointers:
+///
+/// ```
+/// // Either owned by the default allocator, or borrowed
+/// const MaybeOwnedFoo = bun.ptr.Owned(*Foo, bun.allocators.MaybeOwned(bun.DefaultAllocator));
+///
+/// var owned_foo: MaybeOwnedFoo = .new(makeFoo());
+/// var borrowed_foo: MaybeOwnedFoo = .fromRawIn(some_foo_ptr, .initBorrowed());
+///
+/// owned_foo.deinit(); // calls `Foo.deinit` and frees the memory
+/// borrowed_foo.deinit(); // no-op
+/// ```
+///
+/// This type is a `GenericAllocator`; see `src/allocators.zig`.
+pub fn MaybeOwned(comptime Allocator: type) type {
+    return struct {
+        const Self = @This();
+
+        _parent: bun.allocators.Nullable(Allocator),
+
+        /// Same as `.initBorrowed()`. This allocator cannot be used to allocate memory; a panic
+        /// will occur.
+        pub const borrowed = .initBorrowed();
+
+        /// Creates a `MaybeOwned` allocator that owns memory.
+        ///
+        /// Allocations are forwarded to a default-initialized `Allocator`.
+        pub fn init() Self {
+            return .initOwned(bun.memory.initDefault(Allocator));
+        }
+
+        /// Creates a `MaybeOwned` allocator that owns memory, and forwards to a specific
+        /// allocator.
+        ///
+        /// Allocations are forwarded to `parent_alloc`.
+        pub fn initOwned(parent_alloc: Allocator) Self {
+            return .initRaw(parent_alloc);
+        }
+
+        /// Creates a `MaybeOwned` allocator that does not own any memory. This allocator cannot
+        /// be used to allocate new memory (a panic will occur), and its implementation of `free`
+        /// is a no-op.
+        pub fn initBorrowed() Self {
+            return .initRaw(null);
+        }
+
+        pub fn deinit(self: *Self) void {
+            var maybe_parent = self.intoParent();
+            if (maybe_parent) |*parent_alloc| {
+                bun.memory.deinit(parent_alloc);
+            }
+        }
+
+        pub fn isOwned(self: Self) bool {
+            return self.rawParent() != null;
+        }
+
+        pub fn allocator(self: Self) std.mem.Allocator {
+            const maybe_parent = self.rawParent();
+            return if (maybe_parent) |parent_alloc|
+                bun.allocators.asStd(parent_alloc)
+            else
+                .{ .ptr = undefined, .vtable = &null_vtable };
+        }
+
+        const BorrowedParent = bun.allocators.Borrowed(Allocator);
+
+        pub fn parent(self: Self) ?BorrowedParent {
+            const maybe_parent = self.rawParent();
+            return if (maybe_parent) |parent_alloc|
+                bun.allocators.borrow(parent_alloc)
+            else
+                null;
+        }
+
+        pub fn intoParent(self: *Self) ?Allocator {
+            defer self.* = undefined;
+            return self.rawParent();
+        }
+
+        /// Used by smart pointer types and allocator wrappers. See `bun.allocators.borrow`.
+        pub const Borrowed = MaybeOwned(BorrowedParent);
+
+        pub fn borrow(self: Self) Borrowed {
+            return .{ ._parent = bun.allocators.initNullable(BorrowedParent, self.parent()) };
+        }
+
+        fn initRaw(parent_alloc: ?Allocator) Self {
+            return .{ ._parent = bun.allocators.initNullable(Allocator, parent_alloc) };
+        }
+
+        fn rawParent(self: Self) ?Allocator {
+            return bun.allocators.unpackNullable(Allocator, self._parent);
+        }
+    };
+}
+
+fn nullAlloc(ptr: *anyopaque, len: usize, alignment: Alignment, ret_addr: usize) ?[*]u8 {
+    _ = .{ ptr, len, alignment, ret_addr };
+    std.debug.panic("cannot allocate with a borrowed `MaybeOwned` allocator", .{});
+}
+
+const null_vtable: std.mem.Allocator.VTable = .{
+    .alloc = nullAlloc,
+    .resize = std.mem.Allocator.noResize,
+    .remap = std.mem.Allocator.noRemap,
+    .free = std.mem.Allocator.noFree,
+};
+
+const bun = @import("bun");
+const std = @import("std");
+const Alignment = std.mem.Alignment;

src/api/schema.zig

@@ -799,6 +799,9 @@ pub const api = struct {
         /// import_source
         import_source: []const u8,
 
+        /// side_effects
+        side_effects: bool = false,
+
         pub fn decode(reader: anytype) anyerror!Jsx {
             var this = std.mem.zeroes(Jsx);
 
@@ -807,6 +810,7 @@ pub const api = struct {
             this.fragment = try reader.readValue([]const u8);
             this.development = try reader.readValue(bool);
             this.import_source = try reader.readValue([]const u8);
+            this.side_effects = try reader.readValue(bool);
             return this;
         }
 
@@ -816,6 +820,7 @@ pub const api = struct {
             try writer.writeValue(@TypeOf(this.fragment), this.fragment);
             try writer.writeInt(@as(u8, @intFromBool(this.development)));
             try writer.writeValue(@TypeOf(this.import_source), this.import_source);
+            try writer.writeInt(@as(u8, @intFromBool(this.side_effects)));
         }
     };
 
@@ -2820,7 +2825,7 @@ pub const api = struct {
         token: []const u8,
 
         pub fn dupe(this: NpmRegistry, allocator: std.mem.Allocator) NpmRegistry {
-            const buf = allocator.alloc(u8, this.url.len + this.username.len + this.password.len + this.token.len) catch bun.outOfMemory();
+            const buf = bun.handleOom(allocator.alloc(u8, this.url.len + this.username.len + this.password.len + this.token.len));
 
             var out: NpmRegistry = .{
                 .url = "",

src/ast.zig

@@ -61,7 +61,7 @@ pub const AssignTarget = enum(u2) {
 };
 
 pub const LocRef = struct {
-    loc: logger.Loc = logger.Loc.Empty,
+    loc: logger.Loc = .none,
 
     // TODO: remove this optional and make Ref a function getter
     // That will make this struct 128 bits instead of 192 bits and we can remove some heap allocations
@@ -121,7 +121,7 @@ pub const ClauseItem = struct {
     /// For exports: `export { foo as bar }` - "bar" is the alias
     /// For re-exports: `export { foo as bar } from 'path'` - "bar" is the alias
     alias: string,
-    alias_loc: logger.Loc = logger.Loc.Empty,
+    alias_loc: logger.Loc = .none,
     /// Reference to the actual symbol being imported/exported.
     /// For imports: `import { foo as bar }` - ref to the symbol representing "foo" from the source module
     /// For exports: `export { foo as bar }` - ref to the local symbol "foo"

src/ast/Ast.zig

@@ -22,9 +22,9 @@ exports_kind: ExportsKind = ExportsKind.none,
 
 // This is a list of ES6 features. They are ranges instead of booleans so
 // that they can be used in log messages. Check to see if "Len > 0".
-import_keyword: logger.Range = logger.Range.None, // Does not include TypeScript-specific syntax or "import()"
-export_keyword: logger.Range = logger.Range.None, // Does not include TypeScript-specific syntax
-top_level_await_keyword: logger.Range = logger.Range.None,
+import_keyword: logger.Range = .none, // Does not include TypeScript-specific syntax or "import()"
+export_keyword: logger.Range = .none, // Does not include TypeScript-specific syntax
+top_level_await_keyword: logger.Range = .none,
 
 /// These are stored at the AST level instead of on individual AST nodes so
 /// they can be manipulated efficiently without a full AST traversal

src/ast/BundledAst.zig

@@ -111,7 +111,7 @@ pub fn toAST(this: *const BundledAst) Ast {
         .uses_exports_ref = this.flags.uses_exports_ref,
         .uses_module_ref = this.flags.uses_module_ref,
         // .uses_require_ref = ast.uses_require_ref,
-        .export_keyword = .{ .len = if (this.flags.uses_export_keyword) 1 else 0, .loc = .{} },
+        .export_keyword = .{ .len = if (this.flags.uses_export_keyword) 1 else 0, .loc = .none },
         .force_cjs_to_esm = this.flags.force_cjs_to_esm,
         .has_lazy_export = this.flags.has_lazy_export,
         .commonjs_module_exports_assigned_deoptimized = this.flags.commonjs_module_exports_assigned_deoptimized,
@@ -193,7 +193,7 @@ pub fn addUrlForCss(
             const encode_len = bun.base64.encodeLen(contents);
             const data_url_prefix_len = "data:".len + mime_type.len + ";base64,".len;
             const total_buffer_len = data_url_prefix_len + encode_len;
-            var encoded = allocator.alloc(u8, total_buffer_len) catch bun.outOfMemory();
+            var encoded = bun.handleOom(allocator.alloc(u8, total_buffer_len));
             _ = std.fmt.bufPrint(encoded[0..data_url_prefix_len], "data:{s};base64,", .{mime_type}) catch unreachable;
             const len = bun.base64.encode(encoded[data_url_prefix_len..], contents);
             break :url_for_css encoded[0 .. data_url_prefix_len + len];

src/ast/ConvertESMExportsForHmr.zig

@@ -439,19 +439,19 @@ pub fn finalize(ctx: *ConvertESMExportsForHmr, p: anytype, all_parts: []js_ast.P
     if (ctx.export_props.items.len > 0) {
         const obj = Expr.init(E.Object, .{
             .properties = G.Property.List.fromList(ctx.export_props),
-        }, logger.Loc.Empty);
+        }, .none);
 
         // `hmr.exports = ...`
         try ctx.stmts.append(p.allocator, Stmt.alloc(S.SExpr, .{
             .value = Expr.assign(
                 Expr.init(E.Dot, .{
-                    .target = Expr.initIdentifier(p.hmr_api_ref, logger.Loc.Empty),
+                    .target = Expr.initIdentifier(p.hmr_api_ref, .none),
                     .name = "exports",
-                    .name_loc = logger.Loc.Empty,
-                }, logger.Loc.Empty),
+                    .name_loc = .none,
+                }, .none),
                 obj,
             ),
-        }, logger.Loc.Empty));
+        }, .none));
 
         // mark a dependency on module_ref so it is renamed
         try ctx.last_part.symbol_uses.put(p.allocator, p.module_ref, .{ .count_estimate = 1 });
@@ -462,13 +462,13 @@ pub fn finalize(ctx: *ConvertESMExportsForHmr, p: anytype, all_parts: []js_ast.P
         try ctx.stmts.append(p.allocator, Stmt.alloc(S.SExpr, .{
             .value = Expr.init(E.Call, .{
                 .target = Expr.init(E.Dot, .{
-                    .target = Expr.initIdentifier(p.hmr_api_ref, .Empty),
+                    .target = Expr.initIdentifier(p.hmr_api_ref, .none),
                     .name = "reactRefreshAccept",
-                    .name_loc = .Empty,
-                }, .Empty),
+                    .name_loc = .none,
+                }, .none),
                 .args = .init(&.{}),
-            }, .Empty),
-        }, .Empty));
+            }, .none),
+        }, .none));
     }
 
     // Merge all part metadata into the first part.

src/ast/E.zig

@@ -15,7 +15,7 @@ pub const Array = struct {
     is_single_line: bool = false,
     is_parenthesized: bool = false,
     was_originally_macro: bool = false,
-    close_bracket_loc: logger.Loc = logger.Loc.Empty,
+    close_bracket_loc: logger.Loc = .none,
 
     pub fn push(this: *Array, allocator: std.mem.Allocator, item: Expr) !void {
         try this.items.push(allocator, item);
@@ -161,7 +161,7 @@ pub const Call = struct {
     args: ExprNodeList = ExprNodeList{},
     optional_chain: ?OptionalChain = null,
     is_direct_eval: bool = false,
-    close_paren_loc: logger.Loc = logger.Loc.Empty,
+    close_paren_loc: logger.Loc = .none,
 
     // True if there is a comment containing "@__PURE__" or "#__PURE__" preceding
     // this call expression. This is an annotation used for tree shaking, and
@@ -233,7 +233,7 @@ pub const Arrow = struct {
     pub const noop_return_undefined: Arrow = .{
         .args = &.{},
         .body = .{
-            .loc = .Empty,
+            .loc = .none,
             .stmts = &.{},
         },
     };
@@ -365,7 +365,7 @@ pub const JSXElement = struct {
 
     flags: Flags.JSXElement.Bitset = Flags.JSXElement.Bitset{},
 
-    close_tag_loc: logger.Loc = logger.Loc.Empty,
+    close_tag_loc: logger.Loc = .none,
 
     pub const SpecialProp = enum {
         __self, // old react transform used this as a prop
@@ -434,7 +434,7 @@ pub const Number = struct {
 
         if (Environment.isNative) {
             var buf: [124]u8 = undefined;
-            return allocator.dupe(u8, bun.fmt.FormatDouble.dtoa(&buf, value)) catch bun.outOfMemory();
+            return bun.handleOom(allocator.dupe(u8, bun.fmt.FormatDouble.dtoa(&buf, value)));
         } else {
             // do not attempt to implement the spec here, it would be error prone.
         }
@@ -493,7 +493,7 @@ pub const Object = struct {
     is_parenthesized: bool = false,
     was_originally_macro: bool = false,
 
-    close_brace_loc: logger.Loc = logger.Loc.Empty,
+    close_brace_loc: logger.Loc = .none,
 
     // used in TOML parser to merge properties
     pub const Rope = struct {
@@ -544,7 +544,7 @@ pub const Object = struct {
     }
 
     pub fn putString(self: *Object, allocator: std.mem.Allocator, key: string, value: string) !void {
-        return try put(self, allocator, key, Expr.init(E.String, E.String.init(value), logger.Loc.Empty));
+        return try put(self, allocator, key, Expr.init(E.String, E.String.init(value), .none));
     }
 
     pub const SetError = error{ OutOfMemory, Clobber };
@@ -909,7 +909,7 @@ pub const String = struct {
         return if (bun.strings.isAllASCII(utf8))
             init(utf8)
         else
-            init(bun.strings.toUTF16AllocForReal(allocator, utf8, false, false) catch bun.outOfMemory());
+            init(bun.handleOom(bun.strings.toUTF16AllocForReal(allocator, utf8, false, false)));
     }
 
     pub fn slice8(this: *const String) []const u8 {
@@ -924,11 +924,11 @@ pub const String = struct {
 
     pub fn resolveRopeIfNeeded(this: *String, allocator: std.mem.Allocator) void {
         if (this.next == null or !this.isUTF8()) return;
-        var bytes = std.ArrayList(u8).initCapacity(allocator, this.rope_len) catch bun.outOfMemory();
+        var bytes = bun.handleOom(std.ArrayList(u8).initCapacity(allocator, this.rope_len));
         bytes.appendSliceAssumeCapacity(this.data);
         var str = this.next;
         while (str) |part| {
-            bytes.appendSlice(part.data) catch bun.outOfMemory();
+            bun.handleOom(bytes.appendSlice(part.data));
             str = part.next;
         }
         this.data = bytes.items;
@@ -937,7 +937,7 @@ pub const String = struct {
 
     pub fn slice(this: *String, allocator: std.mem.Allocator) []const u8 {
         this.resolveRopeIfNeeded(allocator);
-        return this.string(allocator) catch bun.outOfMemory();
+        return bun.handleOom(this.string(allocator));
     }
 
     pub var empty = String{};
@@ -1246,7 +1246,7 @@ pub const Template = struct {
             if (part.value.data == .e_string and part.tail.cooked.isUTF8() and part.value.data.e_string.isUTF8()) {
                 if (parts.items.len == 0) {
                     if (part.value.data.e_string.len() > 0) {
-                        head.data.e_string.push(Expr.init(E.String, part.value.data.e_string.*, logger.Loc.Empty).data.e_string);
+                        head.data.e_string.push(Expr.init(E.String, part.value.data.e_string.*, .none).data.e_string);
                     }
 
                     if (part.tail.cooked.len() > 0) {
@@ -1260,7 +1260,7 @@ pub const Template = struct {
 
                     if (prev_part.tail.cooked.isUTF8()) {
                         if (part.value.data.e_string.len() > 0) {
-                            prev_part.tail.cooked.push(Expr.init(E.String, part.value.data.e_string.*, logger.Loc.Empty).data.e_string);
+                            prev_part.tail.cooked.push(Expr.init(E.String, part.value.data.e_string.*, .none).data.e_string);
                         }
 
                         if (part.tail.cooked.len() > 0) {
@@ -1361,7 +1361,7 @@ pub const RequireString = struct {
 pub const RequireResolveString = struct {
     import_record_index: u32,
 
-    // close_paren_loc: logger.Loc = logger.Loc.Empty,
+    // close_paren_loc: logger.Loc = .none,
 };
 
 pub const InlinedEnum = struct {

src/ast/Expr.zig

@@ -1,7 +1,7 @@
 loc: logger.Loc,
 data: Data,
 
-pub const empty = Expr{ .data = .{ .e_missing = E.Missing{} }, .loc = logger.Loc.Empty };
+pub const empty = Expr{ .data = .{ .e_missing = E.Missing{} }, .loc = .none };
 
 pub fn isAnonymousNamed(expr: Expr) bool {
     return switch (expr.data) {
@@ -275,7 +275,7 @@ pub fn set(expr: *Expr, allocator: std.mem.Allocator, name: string, value: Expr)
 
     var new_props = expr.data.e_object.properties.listManaged(allocator);
     try new_props.append(.{
-        .key = Expr.init(E.String, .{ .data = name }, logger.Loc.Empty),
+        .key = Expr.init(E.String, .{ .data = name }, .none),
         .value = value,
     });
 
@@ -293,15 +293,15 @@ pub fn setString(expr: *Expr, allocator: std.mem.Allocator, name: string, value:
         const key = prop.key orelse continue;
         if (std.meta.activeTag(key.data) != .e_string) continue;
         if (key.data.e_string.eql(string, name)) {
-            prop.value = Expr.init(E.String, .{ .data = value }, logger.Loc.Empty);
+            prop.value = Expr.init(E.String, .{ .data = value }, .none);
             return;
         }
     }
 
     var new_props = expr.data.e_object.properties.listManaged(allocator);
     try new_props.append(.{
-        .key = Expr.init(E.String, .{ .data = name }, logger.Loc.Empty),
-        .value = Expr.init(E.String, .{ .data = value }, logger.Loc.Empty),
+        .key = Expr.init(E.String, .{ .data = name }, .none),
+        .value = Expr.init(E.String, .{ .data = value }, .none),
     });
 
     expr.data.e_object.properties = BabyList(G.Property).fromList(new_props);
@@ -474,7 +474,7 @@ pub inline fn isString(expr: *const Expr) bool {
 
 pub inline fn asString(expr: *const Expr, allocator: std.mem.Allocator) ?string {
     switch (expr.data) {
-        .e_string => |str| return str.string(allocator) catch bun.outOfMemory(),
+        .e_string => |str| return bun.handleOom(str.string(allocator)),
         else => return null,
     }
 }
@@ -3088,7 +3088,7 @@ pub const Data = union(Tag) {
 
             // brk: {
             //     // var node = try allocator.create(Macro.JSNode);
-            //     // node.* = Macro.JSNode.initExpr(Expr{ .data = this, .loc = logger.Loc.Empty });
+            //     // node.* = Macro.JSNode.initExpr(Expr{ .data = this, .loc = .none });
             //     // break :brk jsc.JSValue.c(Macro.JSNode.Class.make(globalObject, node));
             // },
 

src/ast/G.zig

@@ -24,12 +24,12 @@ pub const ExportStarAlias = struct {
 };
 
 pub const Class = struct {
-    class_keyword: logger.Range = logger.Range.None,
+    class_keyword: logger.Range = .none,
     ts_decorators: ExprNodeList = ExprNodeList{},
     class_name: ?LocRef = null,
     extends: ?ExprNodeIndex = null,
-    body_loc: logger.Loc = logger.Loc.Empty,
-    close_brace_loc: logger.Loc = logger.Loc.Empty,
+    body_loc: logger.Loc = .none,
+    close_brace_loc: logger.Loc = .none,
     properties: []Property = &([_]Property{}),
     has_decorators: bool = false,
 
@@ -157,11 +157,11 @@ pub const FnBody = struct {
 
 pub const Fn = struct {
     name: ?LocRef = null,
-    open_parens_loc: logger.Loc = logger.Loc.Empty,
+    open_parens_loc: logger.Loc = .none,
     args: []Arg = &.{},
     // This was originally nullable, but doing so I believe caused a miscompilation
     // Specifically, the body was always null.
-    body: FnBody = .{ .loc = logger.Loc.Empty, .stmts = &.{} },
+    body: FnBody = .{ .loc = .none, .stmts = &.{} },
     arguments_ref: ?Ref = null,
 
     flags: Flags.Function.Set = Flags.Function.None,

src/ast/ImportScanner.zig

@@ -217,7 +217,7 @@ pub fn scan(
                             result.* = alias;
                         }
                         strings.sortDesc(sorted);
-                        p.named_imports.ensureUnusedCapacity(p.allocator, sorted.len) catch bun.outOfMemory();
+                        bun.handleOom(p.named_imports.ensureUnusedCapacity(p.allocator, sorted.len));
 
                         // Create named imports for these property accesses. This will
                         // cause missing imports to generate useful warnings.
@@ -236,7 +236,7 @@ pub fn scan(
                                     .namespace_ref = namespace_ref,
                                     .import_record_index = st.import_record_index,
                                 },
-                            ) catch bun.outOfMemory();
+                            ) catch |err| bun.handleOom(err);
 
                             const name: LocRef = item;
                             const name_ref = name.ref.?;
@@ -262,7 +262,7 @@ pub fn scan(
                     p.named_imports.ensureUnusedCapacity(
                         p.allocator,
                         st.items.len + @as(usize, @intFromBool(st.default_name != null)) + @as(usize, @intFromBool(st.star_name_loc != null)),
-                    ) catch bun.outOfMemory();
+                    ) catch |err| bun.handleOom(err);
 
                     if (st.star_name_loc) |loc| {
                         record.contains_import_star = true;

src/ast/NewStore.zig

@@ -78,7 +78,7 @@ pub fn NewStore(comptime types: []const type, comptime count: usize) type {
         pub fn init() *Store {
             log("init", .{});
             // Avoid initializing the entire struct.
-            const prealloc = backing_allocator.create(PreAlloc) catch bun.outOfMemory();
+            const prealloc = bun.handleOom(backing_allocator.create(PreAlloc));
             prealloc.zero();
 
             return &prealloc.metadata;

src/ast/P.zig

@@ -150,15 +150,15 @@ pub fn NewParser_(
         latest_return_had_semicolon: bool = false,
         has_import_meta: bool = false,
         has_es_module_syntax: bool = false,
-        top_level_await_keyword: logger.Range = logger.Range.None,
+        top_level_await_keyword: logger.Range = .none,
         fn_or_arrow_data_parse: FnOrArrowDataParse = FnOrArrowDataParse{},
         fn_or_arrow_data_visit: FnOrArrowDataVisit = FnOrArrowDataVisit{},
         fn_only_data_visit: FnOnlyDataVisit = FnOnlyDataVisit{},
         allocated_names: List(string) = .{},
         // allocated_names: ListManaged(string) = ListManaged(string).init(bun.default_allocator),
         // allocated_names_pool: ?*AllocatedNamesPool.Node = null,
-        latest_arrow_arg_loc: logger.Loc = logger.Loc.Empty,
-        forbid_suffix_after_as_loc: logger.Loc = logger.Loc.Empty,
+        latest_arrow_arg_loc: logger.Loc = .none,
+        forbid_suffix_after_as_loc: logger.Loc = .none,
         current_scope: *js_ast.Scope = undefined,
         scopes_for_current_part: List(*js_ast.Scope) = .{},
         symbols: ListManaged(js_ast.Symbol) = undefined,
@@ -284,9 +284,9 @@ pub fn NewParser_(
         import_symbol_property_uses: SymbolPropertyUseMap = .{},
 
         // These are for handling ES6 imports and exports
-        esm_import_keyword: logger.Range = logger.Range.None,
-        esm_export_keyword: logger.Range = logger.Range.None,
-        enclosing_class_keyword: logger.Range = logger.Range.None,
+        esm_import_keyword: logger.Range = .none,
+        esm_export_keyword: logger.Range = .none,
+        enclosing_class_keyword: logger.Range = .none,
         import_items_for_namespace: std.AutoHashMapUnmanaged(Ref, ImportItemForNamespaceMap) = .{},
         is_import_item: RefMap = .{},
         named_imports: NamedImportsType,
@@ -327,7 +327,7 @@ pub fn NewParser_(
         delete_target: Expr.Data,
         loop_body: Stmt.Data,
         module_scope: *js_ast.Scope = undefined,
-        module_scope_directive_loc: logger.Loc = .{},
+        module_scope_directive_loc: logger.Loc = .none,
         is_control_flow_dead: bool = false,
 
         /// We must be careful to avoid revisiting nodes that have scopes.
@@ -429,7 +429,7 @@ pub fn NewParser_(
         //     AssignmentExpression
         //     Expression , AssignmentExpression
         //
-        after_arrow_body_loc: logger.Loc = logger.Loc.Empty,
+        after_arrow_body_loc: logger.Loc = .none,
         import_transposer: ImportTransposer,
         require_transposer: RequireTransposer,
         require_resolve_transposer: RequireResolveTransposer,
@@ -565,7 +565,7 @@ pub fn NewParser_(
 
         pub fn transposeRequire(noalias p: *P, arg: Expr, state: *const TransposeState) Expr {
             if (!p.options.features.allow_runtime) {
-                const args = p.allocator.alloc(Expr, 1) catch bun.outOfMemory();
+                const args = bun.handleOom(p.allocator.alloc(Expr, 1));
                 args[0] = arg;
                 return p.newExpr(
                     E.Call{
@@ -607,8 +607,8 @@ pub fn NewParser_(
 
                         // Note that this symbol may be completely removed later.
                         var path_name = fs.PathName.init(path.text);
-                        const name = path_name.nonUniqueNameString(p.allocator) catch bun.outOfMemory();
-                        const namespace_ref = p.newSymbol(.other, name) catch bun.outOfMemory();
+                        const name = bun.handleOom(path_name.nonUniqueNameString(p.allocator));
+                        const namespace_ref = bun.handleOom(p.newSymbol(.other, name));
 
                         p.imports_to_convert_from_require.append(p.allocator, .{
                             .namespace = .{
@@ -616,8 +616,8 @@ pub fn NewParser_(
                                 .loc = arg.loc,
                             },
                             .import_record_id = import_record_index,
-                        }) catch bun.outOfMemory();
-                        p.import_items_for_namespace.put(p.allocator, namespace_ref, ImportItemForNamespaceMap.init(p.allocator)) catch bun.outOfMemory();
+                        }) catch |err| bun.handleOom(err);
+                        bun.handleOom(p.import_items_for_namespace.put(p.allocator, namespace_ref, ImportItemForNamespaceMap.init(p.allocator)));
                         p.recordUsage(namespace_ref);
 
                         if (!state.is_require_immediately_assigned_to_decl) {
@@ -1231,7 +1231,7 @@ pub fn NewParser_(
             comptime is_internal: bool,
         ) anyerror!void {
             const allocator = p.allocator;
-            const import_record_i = p.addImportRecordByRange(.stmt, logger.Range.None, import_path);
+            const import_record_i = p.addImportRecordByRange(.stmt, .none, import_path);
             var import_record: *ImportRecord = &p.import_records.items[import_record_i];
             if (comptime is_internal)
                 import_record.path.namespace = "runtime";
@@ -1257,8 +1257,8 @@ pub fn NewParser_(
                 clause_item.* = js_ast.ClauseItem{
                     .alias = alias_name,
                     .original_name = alias_name,
-                    .alias_loc = logger.Loc{},
-                    .name = LocRef{ .ref = ref, .loc = logger.Loc{} },
+                    .alias_loc = .none,
+                    .name = LocRef{ .ref = ref, .loc = .none },
                 };
                 declared_symbols.appendAssumeCapacity(.{ .ref = ref, .is_top_level = true });
 
@@ -1277,7 +1277,7 @@ pub fn NewParser_(
                 try p.is_import_item.put(allocator, ref, {});
                 try p.named_imports.put(allocator, ref, js_ast.NamedImport{
                     .alias = alias_name,
-                    .alias_loc = logger.Loc{},
+                    .alias_loc = .none,
                     .namespace_ref = namespace_ref,
                     .import_record_index = import_record_i,
                 });
@@ -1290,7 +1290,7 @@ pub fn NewParser_(
                     .import_record_index = import_record_i,
                     .is_single_line = true,
                 },
-                logger.Loc{},
+                .none,
             );
             if (additional_stmt) |add| {
                 stmts[1] = add;
@@ -1343,7 +1343,7 @@ pub fn NewParser_(
             // already a CommonJS module, and it will actually be more efficient
             // at runtime this way.
             const allocator = p.allocator;
-            const import_record_index = p.addImportRecordByRange(.stmt, logger.Range.None, import_path);
+            const import_record_index = p.addImportRecordByRange(.stmt, .none, import_path);
 
             const Item = if (hot_module_reloading) B.Object.Property else js_ast.ClauseItem;
 
@@ -1365,20 +1365,20 @@ pub fn NewParser_(
             for (clauses) |entry| {
                 if (entry.enabled) {
                     items.appendAssumeCapacity(if (hot_module_reloading) .{
-                        .key = p.newExpr(E.String{ .data = entry.name }, logger.Loc.Empty),
-                        .value = p.b(B.Identifier{ .ref = entry.ref }, logger.Loc.Empty),
+                        .key = p.newExpr(E.String{ .data = entry.name }, .none),
+                        .value = p.b(B.Identifier{ .ref = entry.ref }, .none),
                     } else .{
                         .alias = entry.name,
                         .original_name = entry.name,
-                        .alias_loc = logger.Loc{},
-                        .name = LocRef{ .ref = entry.ref, .loc = logger.Loc{} },
+                        .alias_loc = .none,
+                        .name = LocRef{ .ref = entry.ref, .loc = .none },
                     });
                     declared_symbols.appendAssumeCapacity(.{ .ref = entry.ref, .is_top_level = true });
                     try p.module_scope.generated.push(allocator, entry.ref);
                     try p.is_import_item.put(allocator, entry.ref, {});
                     try p.named_imports.put(allocator, entry.ref, .{
                         .alias = entry.name,
-                        .alias_loc = logger.Loc.Empty,
+                        .alias_loc = .none,
                         .namespace_ref = namespace_ref,
                         .import_record_index = import_record_index,
                     });
@@ -1391,10 +1391,10 @@ pub fn NewParser_(
                     .decls = try Decl.List.fromSlice(p.allocator, &.{.{
                         .binding = p.b(B.Object{
                             .properties = items.items,
-                        }, logger.Loc.Empty),
+                        }, .none),
                         .value = p.newExpr(E.RequireString{
                             .import_record_index = import_record_index,
-                        }, logger.Loc.Empty),
+                        }, .none),
                     }}),
                 }
             else
@@ -1403,7 +1403,7 @@ pub fn NewParser_(
                     .items = items.items,
                     .import_record_index = import_record_index,
                     .is_single_line = false,
-                }, logger.Loc.Empty);
+                }, .none);
 
             try parts.append(.{
                 .stmts = stmts,
@@ -1994,6 +1994,9 @@ pub fn NewParser_(
                 p.jest.afterEach = try p.declareCommonJSSymbol(.unbound, "afterEach");
                 p.jest.beforeAll = try p.declareCommonJSSymbol(.unbound, "beforeAll");
                 p.jest.afterAll = try p.declareCommonJSSymbol(.unbound, "afterAll");
+                p.jest.xit = try p.declareCommonJSSymbol(.unbound, "xit");
+                p.jest.xtest = try p.declareCommonJSSymbol(.unbound, "xtest");
+                p.jest.xdescribe = try p.declareCommonJSSymbol(.unbound, "xdescribe");
             }
 
             if (p.options.features.react_fast_refresh) {
@@ -2019,7 +2022,7 @@ pub fn NewParser_(
         fn ensureRequireSymbol(p: *P) void {
             if (p.runtime_imports.__require != null) return;
             const static_symbol = generatedSymbolName("__require");
-            p.runtime_imports.__require = declareSymbolMaybeGenerated(p, .other, logger.Loc.Empty, static_symbol, true) catch bun.outOfMemory();
+            p.runtime_imports.__require = bun.handleOom(declareSymbolMaybeGenerated(p, .other, .none, static_symbol, true));
             p.runtime_imports.put("__require", p.runtime_imports.__require.?);
         }
 
@@ -2228,12 +2231,12 @@ pub fn NewParser_(
 
             // Sanity-check that the scopes generated by the first and second passes match
             if (bun.Environment.allow_assert and
-                order.loc.start != loc.start or order.scope.kind != kind)
+                order.loc != loc or order.scope.kind != kind)
             {
                 p.log.level = .verbose;
 
-                p.log.addDebugFmt(p.source, loc, p.allocator, "Expected this scope (.{s})", .{@tagName(kind)}) catch bun.outOfMemory();
-                p.log.addDebugFmt(p.source, order.loc, p.allocator, "Found this scope (.{s})", .{@tagName(order.scope.kind)}) catch bun.outOfMemory();
+                bun.handleOom(p.log.addDebugFmt(p.source, loc, p.allocator, "Expected this scope (.{s})", .{@tagName(kind)}));
+                bun.handleOom(p.log.addDebugFmt(p.source, order.loc, p.allocator, "Found this scope (.{s})", .{@tagName(order.scope.kind)}));
 
                 p.panic("Scope mismatch while visiting", .{});
             }
@@ -2278,11 +2281,11 @@ pub fn NewParser_(
                     }
 
                     if (p.scopes_in_order.items[last_i]) |prev_scope| {
-                        if (prev_scope.loc.start >= loc.start) {
+                        if (prev_scope.loc.get() >= loc.get()) {
                             p.log.level = .verbose;
-                            p.log.addDebugFmt(p.source, prev_scope.loc, p.allocator, "Previous Scope", .{}) catch bun.outOfMemory();
-                            p.log.addDebugFmt(p.source, loc, p.allocator, "Next Scope", .{}) catch bun.outOfMemory();
-                            p.panic("Scope location {d} must be greater than {d}", .{ loc.start, prev_scope.loc.start });
+                            bun.handleOom(p.log.addDebugFmt(p.source, prev_scope.loc, p.allocator, "Previous Scope", .{}));
+                            bun.handleOom(p.log.addDebugFmt(p.source, loc, p.allocator, "Next Scope", .{}));
+                            p.panic("Scope location {d} must be greater than {d}", .{ loc.get(), prev_scope.loc.get() });
                         }
                     }
                 }
@@ -2474,7 +2477,7 @@ pub fn NewParser_(
             }
 
             if (errors.invalid_expr_after_question) |r| {
-                p.log.addRangeErrorFmt(p.source, r, p.allocator, "Unexpected {s}", .{p.source.contents[r.loc.i()..r.endI()]}) catch unreachable;
+                p.log.addRangeErrorFmt(p.source, r, p.allocator, "Unexpected {s}", .{p.source.contents[r.loc.getUsize()..r.endI()]}) catch unreachable;
             }
 
             // if (errors.array_spread_feature) |err| {
@@ -2956,7 +2959,7 @@ pub fn NewParser_(
                 scope: js_ast.TSNamespaceScope,
             };
 
-            var pair = p.allocator.create(Pair) catch bun.outOfMemory();
+            var pair = bun.handleOom(p.allocator.create(Pair));
             pair.map = .{};
             pair.scope = .{
                 .exported_members = &pair.map,
@@ -2988,7 +2991,7 @@ pub fn NewParser_(
             const scope = p.current_scope;
             if (p.isStrictMode()) {
                 var why: string = "";
-                var where: logger.Range = logger.Range.None;
+                var where: logger.Range = .none;
                 switch (scope.strict_mode) {
                     .implicit_strict_mode_import => {
                         where = p.esm_import_keyword;
@@ -3056,7 +3059,7 @@ pub fn NewParser_(
             const ref = try p.newSymbol(kind, name);
 
             if (member == null) {
-                try p.module_scope.members.put(p.allocator, name, Scope.Member{ .ref = ref, .loc = logger.Loc.Empty });
+                try p.module_scope.members.put(p.allocator, name, Scope.Member{ .ref = ref, .loc = .none });
                 return ref;
             }
 
@@ -3071,10 +3074,10 @@ pub fn NewParser_(
         fn declareGeneratedSymbol(p: *P, kind: Symbol.Kind, comptime name: string) !Ref {
             // The bundler runs the renamer, so it is ok to not append a hash
             if (p.options.bundle) {
-                return try declareSymbolMaybeGenerated(p, kind, logger.Loc.Empty, name, true);
+                return try declareSymbolMaybeGenerated(p, kind, .none, name, true);
             }
 
-            return try declareSymbolMaybeGenerated(p, kind, logger.Loc.Empty, generatedSymbolName(name), true);
+            return try declareSymbolMaybeGenerated(p, kind, .none, generatedSymbolName(name), true);
         }
 
         pub fn declareSymbol(p: *P, kind: Symbol.Kind, loc: logger.Loc, name: string) !Ref {
@@ -3321,14 +3324,14 @@ pub fn NewParser_(
             // panic during visit pass leaves the lexer at the end, which
             // would make this location absolutely useless.
             const location = loc orelse p.lexer.loc();
-            if (location.start < p.lexer.source.contents.len and !location.isEmpty()) {
+            if (location.get() < p.lexer.source.contents.len and location != .none) {
                 p.log.addRangeErrorFmt(
                     p.source,
                     .{ .loc = location },
                     p.allocator,
                     "panic here",
                     .{},
-                ) catch bun.outOfMemory();
+                ) catch |err| bun.handleOom(err);
             }
 
             p.log.level = .verbose;
@@ -3688,14 +3691,14 @@ pub fn NewParser_(
                 bun.assert(p.options.features.allow_runtime);
 
                 p.ensureRequireSymbol();
-                p.recordUsage(p.runtimeIdentifierRef(logger.Loc.Empty, "__require"));
+                p.recordUsage(p.runtimeIdentifierRef(.none, "__require"));
             }
         }
 
         pub fn ignoreUsageOfRuntimeRequire(p: *P) void {
             if (p.options.features.auto_polyfill_require) {
                 bun.assert(p.runtime_imports.__require != null);
-                p.ignoreUsage(p.runtimeIdentifierRef(logger.Loc.Empty, "__require"));
+                p.ignoreUsage(p.runtimeIdentifierRef(.none, "__require"));
                 p.symbols.items[p.require_ref.innerIndex()].use_count_estimate -|= 1;
             }
         }
@@ -4529,9 +4532,9 @@ pub fn NewParser_(
             if ((symbol.kind == .ts_namespace or symbol.kind == .ts_enum) and
                 !p.emitted_namespace_vars.contains(name_ref))
             {
-                p.emitted_namespace_vars.putNoClobber(allocator, name_ref, {}) catch bun.outOfMemory();
+                bun.handleOom(p.emitted_namespace_vars.putNoClobber(allocator, name_ref, {}));
 
-                var decls = allocator.alloc(G.Decl, 1) catch bun.outOfMemory();
+                var decls = bun.handleOom(allocator.alloc(G.Decl, 1));
                 decls[0] = G.Decl{ .binding = p.b(B.Identifier{ .ref = name_ref }, name_loc) };
 
                 if (p.enclosing_namespace_arg_ref == null) {
@@ -4542,7 +4545,7 @@ pub fn NewParser_(
                             .decls = G.Decl.List.init(decls),
                             .is_export = is_export,
                         }, stmt_loc),
-                    ) catch bun.outOfMemory();
+                    ) catch |err| bun.handleOom(err);
                 } else {
                     // Nested namespace: "let"
                     stmts.append(
@@ -4550,7 +4553,7 @@ pub fn NewParser_(
                             .kind = .k_let,
                             .decls = G.Decl.List.init(decls),
                         }, stmt_loc),
-                    ) catch bun.outOfMemory();
+                    ) catch |err| bun.handleOom(err);
                 }
             }
 
@@ -4589,10 +4592,10 @@ pub fn NewParser_(
                 }, name_loc);
             };
 
-            var func_args = allocator.alloc(G.Arg, 1) catch bun.outOfMemory();
+            var func_args = bun.handleOom(allocator.alloc(G.Arg, 1));
             func_args[0] = .{ .binding = p.b(B.Identifier{ .ref = arg_ref }, name_loc) };
 
-            var args_list = allocator.alloc(ExprNodeIndex, 1) catch bun.outOfMemory();
+            var args_list = bun.handleOom(allocator.alloc(ExprNodeIndex, 1));
             args_list[0] = arg_expr;
 
             // TODO: if unsupported features includes arrow functions
@@ -4737,7 +4740,7 @@ pub fn NewParser_(
                                         {
                                             // design:type
                                             var args = p.allocator.alloc(Expr, 2) catch unreachable;
-                                            args[0] = p.newExpr(E.String{ .data = "design:type" }, logger.Loc.Empty);
+                                            args[0] = p.newExpr(E.String{ .data = "design:type" }, .none);
                                             args[1] = p.serializeMetadata(prop.ts_metadata) catch unreachable;
                                             array.append(p.callRuntime(loc, "__legacyMetadataTS", args)) catch unreachable;
                                         }
@@ -4746,7 +4749,7 @@ pub fn NewParser_(
                                             if (prop.value) |prop_value| {
                                                 {
                                                     var args = p.allocator.alloc(Expr, 2) catch unreachable;
-                                                    args[0] = p.newExpr(E.String{ .data = "design:paramtypes" }, logger.Loc.Empty);
+                                                    args[0] = p.newExpr(E.String{ .data = "design:paramtypes" }, .none);
 
                                                     const method_args = prop_value.data.e_function.func.args;
                                                     const args_array = p.allocator.alloc(Expr, method_args.len) catch unreachable;
@@ -4754,13 +4757,13 @@ pub fn NewParser_(
                                                         entry.* = p.serializeMetadata(method_arg.ts_metadata) catch unreachable;
                                                     }
 
-                                                    args[1] = p.newExpr(E.Array{ .items = ExprNodeList.init(args_array) }, logger.Loc.Empty);
+                                                    args[1] = p.newExpr(E.Array{ .items = ExprNodeList.init(args_array) }, .none);
 
                                                     array.append(p.callRuntime(loc, "__legacyMetadataTS", args)) catch unreachable;
                                                 }
                                                 {
                                                     var args = p.allocator.alloc(Expr, 2) catch unreachable;
-                                                    args[0] = p.newExpr(E.String{ .data = "design:returntype" }, logger.Loc.Empty);
+                                                    args[0] = p.newExpr(E.String{ .data = "design:returntype" }, .none);
                                                     args[1] = p.serializeMetadata(prop_value.data.e_function.func.return_ts_metadata) catch unreachable;
                                                     array.append(p.callRuntime(loc, "__legacyMetadataTS", args)) catch unreachable;
                                                 }
@@ -4772,14 +4775,14 @@ pub fn NewParser_(
                                         if (prop.value) |prop_value| {
                                             {
                                                 var args = p.allocator.alloc(Expr, 2) catch unreachable;
-                                                args[0] = p.newExpr(E.String{ .data = "design:type" }, logger.Loc.Empty);
+                                                args[0] = p.newExpr(E.String{ .data = "design:type" }, .none);
                                                 args[1] = p.serializeMetadata(prop_value.data.e_function.func.return_ts_metadata) catch unreachable;
                                                 array.append(p.callRuntime(loc, "__legacyMetadataTS", args)) catch unreachable;
                                             }
                                             {
                                                 var args = p.allocator.alloc(Expr, 2) catch unreachable;
-                                                args[0] = p.newExpr(E.String{ .data = "design:paramtypes" }, logger.Loc.Empty);
-                                                args[1] = p.newExpr(E.Array{ .items = ExprNodeList.init(&[_]Expr{}) }, logger.Loc.Empty);
+                                                args[0] = p.newExpr(E.String{ .data = "design:paramtypes" }, .none);
+                                                args[1] = p.newExpr(E.Array{ .items = ExprNodeList.init(&[_]Expr{}) }, .none);
                                                 array.append(p.callRuntime(loc, "__legacyMetadataTS", args)) catch unreachable;
                                             }
                                         }
@@ -4792,20 +4795,20 @@ pub fn NewParser_(
                                             const method_args = prop_value.data.e_function.func.args;
                                             {
                                                 var args = p.allocator.alloc(Expr, 2) catch unreachable;
-                                                args[0] = p.newExpr(E.String{ .data = "design:paramtypes" }, logger.Loc.Empty);
+                                                args[0] = p.newExpr(E.String{ .data = "design:paramtypes" }, .none);
 
                                                 const args_array = p.allocator.alloc(Expr, method_args.len) catch unreachable;
                                                 for (args_array, method_args) |*entry, method_arg| {
                                                     entry.* = p.serializeMetadata(method_arg.ts_metadata) catch unreachable;
                                                 }
 
-                                                args[1] = p.newExpr(E.Array{ .items = ExprNodeList.init(args_array) }, logger.Loc.Empty);
+                                                args[1] = p.newExpr(E.Array{ .items = ExprNodeList.init(args_array) }, .none);
 
                                                 array.append(p.callRuntime(loc, "__legacyMetadataTS", args)) catch unreachable;
                                             }
                                             if (method_args.len >= 1) {
                                                 var args = p.allocator.alloc(Expr, 2) catch unreachable;
-                                                args[0] = p.newExpr(E.String{ .data = "design:type" }, logger.Loc.Empty);
+                                                args[0] = p.newExpr(E.String{ .data = "design:type" }, .none);
                                                 args[1] = p.serializeMetadata(method_args[0].ts_metadata) catch unreachable;
                                                 array.append(p.callRuntime(loc, "__legacyMetadataTS", args)) catch unreachable;
                                             }
@@ -4894,7 +4897,7 @@ pub fn NewParser_(
                                 .key = p.newExpr(E.String{ .data = "constructor" }, stmt.loc),
                                 .value = p.newExpr(E.Function{ .func = G.Fn{
                                     .name = null,
-                                    .open_parens_loc = logger.Loc.Empty,
+                                    .open_parens_loc = .none,
                                     .args = &[_]Arg{},
                                     .body = .{ .loc = stmt.loc, .stmts = constructor_stmts.items },
                                     .flags = Flags.Function.init(.{}),
@@ -4936,7 +4939,7 @@ pub fn NewParser_(
                             if (constructor_function != null) {
                                 // design:paramtypes
                                 var args = p.allocator.alloc(Expr, 2) catch unreachable;
-                                args[0] = p.newExpr(E.String{ .data = "design:paramtypes" }, logger.Loc.Empty);
+                                args[0] = p.newExpr(E.String{ .data = "design:paramtypes" }, .none);
 
                                 const constructor_args = constructor_function.?.func.args;
                                 if (constructor_args.len > 0) {
@@ -4946,9 +4949,9 @@ pub fn NewParser_(
                                         param_array[i] = p.serializeMetadata(constructor_arg.ts_metadata) catch unreachable;
                                     }
 
-                                    args[1] = p.newExpr(E.Array{ .items = ExprNodeList.init(param_array) }, logger.Loc.Empty);
+                                    args[1] = p.newExpr(E.Array{ .items = ExprNodeList.init(param_array) }, .none);
                                 } else {
-                                    args[1] = p.newExpr(E.Array{ .items = ExprNodeList.init(&[_]Expr{}) }, logger.Loc.Empty);
+                                    args[1] = p.newExpr(E.Array{ .items = ExprNodeList.init(&[_]Expr{}) }, .none);
                                 }
 
                                 array.append(p.callRuntime(stmt.loc, "__legacyMetadataTS", args)) catch unreachable;
@@ -4985,9 +4988,9 @@ pub fn NewParser_(
                 .m_object,
                 => p.newExpr(
                     E.Identifier{
-                        .ref = (p.findSymbol(logger.Loc.Empty, "Object") catch unreachable).ref,
+                        .ref = (p.findSymbol(.none, "Object") catch unreachable).ref,
                     },
-                    logger.Loc.Empty,
+                    .none,
                 ),
 
                 .m_never,
@@ -4996,63 +4999,63 @@ pub fn NewParser_(
                 .m_void,
                 => p.newExpr(
                     E.Undefined{},
-                    logger.Loc.Empty,
+                    .none,
                 ),
 
                 .m_string => p.newExpr(
                     E.Identifier{
-                        .ref = (p.findSymbol(logger.Loc.Empty, "String") catch unreachable).ref,
+                        .ref = (p.findSymbol(.none, "String") catch unreachable).ref,
                     },
-                    logger.Loc.Empty,
+                    .none,
                 ),
                 .m_number => p.newExpr(
                     E.Identifier{
-                        .ref = (p.findSymbol(logger.Loc.Empty, "Number") catch unreachable).ref,
+                        .ref = (p.findSymbol(.none, "Number") catch unreachable).ref,
                     },
-                    logger.Loc.Empty,
+                    .none,
                 ),
                 .m_function => p.newExpr(
                     E.Identifier{
-                        .ref = (p.findSymbol(logger.Loc.Empty, "Function") catch unreachable).ref,
+                        .ref = (p.findSymbol(.none, "Function") catch unreachable).ref,
                     },
-                    logger.Loc.Empty,
+                    .none,
                 ),
                 .m_boolean => p.newExpr(
                     E.Identifier{
-                        .ref = (p.findSymbol(logger.Loc.Empty, "Boolean") catch unreachable).ref,
+                        .ref = (p.findSymbol(.none, "Boolean") catch unreachable).ref,
                     },
-                    logger.Loc.Empty,
+                    .none,
                 ),
                 .m_array => p.newExpr(
                     E.Identifier{
-                        .ref = (p.findSymbol(logger.Loc.Empty, "Array") catch unreachable).ref,
+                        .ref = (p.findSymbol(.none, "Array") catch unreachable).ref,
                     },
-                    logger.Loc.Empty,
+                    .none,
                 ),
 
                 .m_bigint => p.maybeDefinedHelper(
                     p.newExpr(
                         E.Identifier{
-                            .ref = (p.findSymbol(logger.Loc.Empty, "BigInt") catch unreachable).ref,
+                            .ref = (p.findSymbol(.none, "BigInt") catch unreachable).ref,
                         },
-                        logger.Loc.Empty,
+                        .none,
                     ),
                 ),
 
                 .m_symbol => p.maybeDefinedHelper(
                     p.newExpr(
                         E.Identifier{
-                            .ref = (p.findSymbol(logger.Loc.Empty, "Symbol") catch unreachable).ref,
+                            .ref = (p.findSymbol(.none, "Symbol") catch unreachable).ref,
                         },
-                        logger.Loc.Empty,
+                        .none,
                     ),
                 ),
 
                 .m_promise => p.newExpr(
                     E.Identifier{
-                        .ref = (p.findSymbol(logger.Loc.Empty, "Promise") catch unreachable).ref,
+                        .ref = (p.findSymbol(.none, "Promise") catch unreachable).ref,
                     },
-                    logger.Loc.Empty,
+                    .none,
                 ),
 
                 .m_identifier => |ref| {
@@ -5062,13 +5065,13 @@ pub fn NewParser_(
                             E.ImportIdentifier{
                                 .ref = ref,
                             },
-                            logger.Loc.Empty,
+                            .none,
                         ));
                     }
 
                     return p.maybeDefinedHelper(p.newExpr(
                         E.Identifier{ .ref = ref },
-                        logger.Loc.Empty,
+                        .none,
                     ));
                 },
 
@@ -5080,10 +5083,10 @@ pub fn NewParser_(
                     var dots = p.newExpr(
                         E.Dot{
                             .name = p.loadNameFromRef(refs.items[refs.items.len - 1]),
-                            .name_loc = logger.Loc.Empty,
+                            .name_loc = .none,
                             .target = undefined,
                         },
-                        logger.Loc.Empty,
+                        .none,
                     );
 
                     var current_expr = &dots.data.e_dot.target;
@@ -5091,9 +5094,9 @@ pub fn NewParser_(
                     while (i > 0) {
                         current_expr.* = p.newExpr(E.Dot{
                             .name = p.loadNameFromRef(refs.items[i]),
-                            .name_loc = logger.Loc.Empty,
+                            .name_loc = .none,
                             .target = undefined,
-                        }, logger.Loc.Empty);
+                        }, .none);
                         current_expr = &current_expr.data.e_dot.target;
                         i -= 1;
                     }
@@ -5103,14 +5106,14 @@ pub fn NewParser_(
                             E.ImportIdentifier{
                                 .ref = refs.items[0],
                             },
-                            logger.Loc.Empty,
+                            .none,
                         );
                     } else {
                         current_expr.* = p.newExpr(
                             E.Identifier{
                                 .ref = refs.items[0],
                             },
-                            logger.Loc.Empty,
+                            .none,
                         );
                     }
 
@@ -5123,7 +5126,7 @@ pub fn NewParser_(
                             .right = try p.checkIfDefinedHelper(current_dot),
                             .left = undefined,
                         },
-                        logger.Loc.Empty,
+                        .none,
                     );
 
                     if (i < refs.items.len - 2) {
@@ -5138,7 +5141,7 @@ pub fn NewParser_(
                                 .right = try p.checkIfDefinedHelper(current_dot),
                                 .left = undefined,
                             },
-                            logger.Loc.Empty,
+                            .none,
                         );
 
                         current_expr = &current_expr.data.e_binary.left;
@@ -5154,14 +5157,14 @@ pub fn NewParser_(
                         E.If{
                             .yes = p.newExpr(
                                 E.Identifier{
-                                    .ref = (p.findSymbol(logger.Loc.Empty, "Object") catch unreachable).ref,
+                                    .ref = (p.findSymbol(.none, "Object") catch unreachable).ref,
                                 },
-                                logger.Loc.Empty,
+                                .none,
                             ),
                             .no = dots,
                             .test_ = maybe_defined_dots,
                         },
-                        logger.Loc.Empty,
+                        .none,
                     );
 
                     return root;
@@ -5463,15 +5466,15 @@ pub fn NewParser_(
         pub fn generateTempRefWithScope(p: *P, default_name: ?string, scope: *Scope) Ref {
             const name = (if (p.willUseRenamer()) default_name else null) orelse brk: {
                 p.temp_ref_count += 1;
-                break :brk std.fmt.allocPrint(p.allocator, "__bun_temp_ref_{x}$", .{p.temp_ref_count}) catch bun.outOfMemory();
+                break :brk bun.handleOom(std.fmt.allocPrint(p.allocator, "__bun_temp_ref_{x}$", .{p.temp_ref_count}));
             };
-            const ref = p.newSymbol(.other, name) catch bun.outOfMemory();
+            const ref = bun.handleOom(p.newSymbol(.other, name));
 
             p.temp_refs_to_declare.append(p.allocator, .{
                 .ref = ref,
-            }) catch bun.outOfMemory();
+            }) catch |err| bun.handleOom(err);
 
-            scope.generated.append(p.allocator, &.{ref}) catch bun.outOfMemory();
+            bun.handleOom(scope.generated.append(p.allocator, &.{ref}));
 
             return ref;
         }
@@ -5535,7 +5538,7 @@ pub fn NewParser_(
 
             pub fn init(p: *P) !LowerUsingDeclarationsContext {
                 return LowerUsingDeclarationsContext{
-                    .first_using_loc = logger.Loc.Empty,
+                    .first_using_loc = .none,
                     .stack_ref = p.generateTempRef("__stack"),
                     .has_await_using = false,
                 };
@@ -5547,7 +5550,7 @@ pub fn NewParser_(
                         .s_local => |local| {
                             if (!local.kind.isUsing()) continue;
 
-                            if (ctx.first_using_loc.isEmpty()) {
+                            if (ctx.first_using_loc == .none) {
                                 ctx.first_using_loc = stmt.loc;
                             }
                             if (local.kind == .k_await_using) {
@@ -5557,7 +5560,7 @@ pub fn NewParser_(
                                 if (decl.value) |*decl_value| {
                                     const value_loc = decl_value.loc;
                                     p.recordUsage(ctx.stack_ref);
-                                    const args = p.allocator.alloc(Expr, 3) catch bun.outOfMemory();
+                                    const args = bun.handleOom(p.allocator.alloc(Expr, 3));
                                     args[0] = Expr{
                                         .data = .{ .e_identifier = .{ .ref = ctx.stack_ref } },
                                         .loc = stmt.loc,
@@ -5591,14 +5594,14 @@ pub fn NewParser_(
                     switch (stmt.data) {
                         .s_directive, .s_import, .s_export_from, .s_export_star => {
                             // These can't go in a try/catch block
-                            result.append(stmt) catch bun.outOfMemory();
+                            bun.handleOom(result.append(stmt));
                             continue;
                         },
 
                         .s_class => {
                             if (stmt.data.s_class.is_export) {
                                 // can't go in try/catch; hoist out
-                                result.append(stmt) catch bun.outOfMemory();
+                                bun.handleOom(result.append(stmt));
                                 continue;
                             }
                         },
@@ -5609,14 +5612,14 @@ pub fn NewParser_(
 
                         .s_export_clause => |data| {
                             // Merge export clauses together
-                            exports.appendSlice(data.items) catch bun.outOfMemory();
+                            bun.handleOom(exports.appendSlice(data.items));
                             continue;
                         },
 
                         .s_function => {
                             if (should_hoist_fns) {
                                 // Hoist function declarations for cross-file ESM references
-                                result.append(stmt) catch bun.outOfMemory();
+                                bun.handleOom(result.append(stmt));
                                 continue;
                             }
                         },
@@ -5635,7 +5638,7 @@ pub fn NewParser_(
                                             },
                                             .alias = p.symbols.items[identifier.ref.inner_index].original_name,
                                             .alias_loc = decl.binding.loc,
-                                        }) catch bun.outOfMemory();
+                                        }) catch |err| bun.handleOom(err);
                                         local.kind = .k_var;
                                     }
                                 }
@@ -5666,12 +5669,12 @@ pub fn NewParser_(
                     caught_ref,
                     err_ref,
                     has_err_ref,
-                }) catch bun.outOfMemory();
+                }) catch |err| bun.handleOom(err);
                 p.declared_symbols.ensureUnusedCapacity(
                     p.allocator,
                     // 5 to include the _promise decl later on:
                     if (ctx.has_await_using) 5 else 4,
-                ) catch bun.outOfMemory();
+                ) catch |err| bun.handleOom(err);
                 p.declared_symbols.appendAssumeCapacity(.{ .is_top_level = is_top_level, .ref = ctx.stack_ref });
                 p.declared_symbols.appendAssumeCapacity(.{ .is_top_level = is_top_level, .ref = caught_ref });
                 p.declared_symbols.appendAssumeCapacity(.{ .is_top_level = is_top_level, .ref = err_ref });
@@ -5682,7 +5685,7 @@ pub fn NewParser_(
                     p.recordUsage(ctx.stack_ref);
                     p.recordUsage(err_ref);
                     p.recordUsage(has_err_ref);
-                    const args = p.allocator.alloc(Expr, 3) catch bun.outOfMemory();
+                    const args = bun.handleOom(p.allocator.alloc(Expr, 3));
                     args[0] = Expr{
                         .data = .{ .e_identifier = .{ .ref = ctx.stack_ref } },
                         .loc = loc,
@@ -5701,7 +5704,7 @@ pub fn NewParser_(
                 const finally_stmts = finally: {
                     if (ctx.has_await_using) {
                         const promise_ref = p.generateTempRef("_promise");
-                        scope.generated.append(p.allocator, &.{promise_ref}) catch bun.outOfMemory();
+                        bun.handleOom(scope.generated.append(p.allocator, &.{promise_ref}));
                         p.declared_symbols.appendAssumeCapacity(.{ .is_top_level = is_top_level, .ref = promise_ref });
 
                         const promise_ref_expr = p.newExpr(E.Identifier{ .ref = promise_ref }, loc);
@@ -5711,10 +5714,10 @@ pub fn NewParser_(
                         }, loc);
                         p.recordUsage(promise_ref);
 
-                        const statements = p.allocator.alloc(Stmt, 2) catch bun.outOfMemory();
+                        const statements = bun.handleOom(p.allocator.alloc(Stmt, 2));
                         statements[0] = p.s(S.Local{
                             .decls = decls: {
-                                const decls = p.allocator.alloc(Decl, 1) catch bun.outOfMemory();
+                                const decls = bun.handleOom(p.allocator.alloc(Decl, 1));
                                 decls[0] = .{
                                     .binding = p.b(B.Identifier{ .ref = promise_ref }, loc),
                                     .value = call_dispose,
@@ -5739,7 +5742,7 @@ pub fn NewParser_(
 
                         break :finally statements;
                     } else {
-                        const single = p.allocator.alloc(Stmt, 1) catch bun.outOfMemory();
+                        const single = bun.handleOom(p.allocator.alloc(Stmt, 1));
                         single[0] = p.s(S.SExpr{ .value = call_dispose }, call_dispose.loc);
                         break :finally single;
                     }
@@ -5747,10 +5750,10 @@ pub fn NewParser_(
 
                 // Wrap everything in a try/catch/finally block
                 p.recordUsage(caught_ref);
-                result.ensureUnusedCapacity(2 + @as(usize, @intFromBool(exports.items.len > 0))) catch bun.outOfMemory();
+                bun.handleOom(result.ensureUnusedCapacity(2 + @as(usize, @intFromBool(exports.items.len > 0))));
                 result.appendAssumeCapacity(p.s(S.Local{
                     .decls = decls: {
-                        const decls = p.allocator.alloc(Decl, 1) catch bun.outOfMemory();
+                        const decls = bun.handleOom(p.allocator.alloc(Decl, 1));
                         decls[0] = .{
                             .binding = p.b(B.Identifier{ .ref = ctx.stack_ref }, loc),
                             .value = p.newExpr(E.Array{}, loc),
@@ -5765,10 +5768,10 @@ pub fn NewParser_(
                     .catch_ = .{
                         .binding = p.b(B.Identifier{ .ref = caught_ref }, loc),
                         .body = catch_body: {
-                            const statements = p.allocator.alloc(Stmt, 1) catch bun.outOfMemory();
+                            const statements = bun.handleOom(p.allocator.alloc(Stmt, 1));
                             statements[0] = p.s(S.Local{
                                 .decls = decls: {
-                                    const decls = p.allocator.alloc(Decl, 2) catch bun.outOfMemory();
+                                    const decls = bun.handleOom(p.allocator.alloc(Decl, 2));
                                     decls[0] = .{
                                         .binding = p.b(B.Identifier{ .ref = err_ref }, loc),
                                         .value = p.newExpr(E.Identifier{ .ref = caught_ref }, loc),
@@ -5824,7 +5827,7 @@ pub fn NewParser_(
                 },
                 .e_array => |arr| for (arr.items.slice()) |*item| {
                     if (item.data != .e_string) {
-                        p.log.addError(p.source, item.loc, import_meta_hot_accept_err) catch bun.outOfMemory();
+                        bun.handleOom(p.log.addError(p.source, item.loc, import_meta_hot_accept_err));
                         continue;
                     }
                     item.data = p.rewriteImportMetaHotAcceptString(item.data.e_string, item.loc) orelse
@@ -5837,7 +5840,7 @@ pub fn NewParser_(
         }
 
         fn rewriteImportMetaHotAcceptString(p: *P, str: *E.String, loc: logger.Loc) ?Expr.Data {
-            str.toUTF8(p.allocator) catch bun.outOfMemory();
+            bun.handleOom(str.toUTF8(p.allocator));
             const specifier = str.data;
 
             const import_record_index = for (p.import_records.items, 0..) |import_record, i| {
@@ -5845,7 +5848,7 @@ pub fn NewParser_(
                     break i;
                 }
             } else {
-                p.log.addError(p.source, loc, import_meta_hot_accept_err) catch bun.outOfMemory();
+                bun.handleOom(p.log.addError(p.source, loc, import_meta_hot_accept_err));
                 return null;
             };
 
@@ -5870,7 +5873,7 @@ pub fn NewParser_(
             bun.assert(p.current_scope == p.module_scope);
 
             // $RefreshReg$(component, "file.ts:Original Name")
-            const loc = logger.Loc.Empty;
+            const loc = .none;
             try stmts.append(p.s(S.SExpr{ .value = p.newExpr(E.Call{
                 .target = Expr.initIdentifier(p.react_refresh.register_ref, loc),
                 .args = try ExprNodeList.fromSlice(p.allocator, &.{
@@ -5904,7 +5907,7 @@ pub fn NewParser_(
                     p.source.path.pretty
                 else
                     bun.todoPanic(@src(), "TODO: unique_key here", .{}),
-            }, logger.Loc.Empty);
+            }, .none);
 
             // registerClientReference(
             //   Comp,
@@ -5912,13 +5915,13 @@ pub fn NewParser_(
             //   "Comp"
             // );
             return p.newExpr(E.Call{
-                .target = Expr.initIdentifier(p.server_components_wrap_ref, logger.Loc.Empty),
+                .target = Expr.initIdentifier(p.server_components_wrap_ref, .none),
                 .args = js_ast.ExprNodeList.fromSlice(p.allocator, &.{
                     val,
                     module_path,
-                    p.newExpr(E.String{ .data = original_name }, logger.Loc.Empty),
-                }) catch bun.outOfMemory(),
-            }, logger.Loc.Empty);
+                    p.newExpr(E.String{ .data = original_name }, .none),
+                }) catch |err| bun.handleOom(err),
+            }, .none);
         }
 
         pub fn handleReactRefreshHookCall(p: *P, hook_call: *E.Call, original_name: []const u8) void {
@@ -5949,7 +5952,7 @@ pub fn NewParser_(
                 p.declared_symbols.append(p.allocator, .{
                     .is_top_level = true,
                     .ref = ctx_storage.*.?.signature_cb,
-                }) catch bun.outOfMemory();
+                }) catch |err| bun.handleOom(err);
 
                 break :init &(ctx_storage.*.?);
             };
@@ -5972,11 +5975,11 @@ pub fn NewParser_(
                 .e_import_identifier,
                 .e_commonjs_export_identifier,
                 => |id, tag| {
-                    const gop = ctx.user_hooks.getOrPut(p.allocator, id.ref) catch bun.outOfMemory();
+                    const gop = bun.handleOom(ctx.user_hooks.getOrPut(p.allocator, id.ref));
                     if (!gop.found_existing) {
                         gop.value_ptr.* = .{
                             .data = @unionInit(Expr.Data, @tagName(tag), id),
-                            .loc = .Empty,
+                            .loc = .none,
                         };
                     }
                 },
@@ -5995,7 +5998,7 @@ pub fn NewParser_(
                 // re-allocated entirely to fit. Only one slot of new capacity
                 // is used since we know this statement list is not going to be
                 // appended to afterwards; This function is a post-visit handler.
-                const new_stmts = p.allocator.alloc(Stmt, stmts.items.len + 1) catch bun.outOfMemory();
+                const new_stmts = bun.handleOom(p.allocator.alloc(Stmt, stmts.items.len + 1));
                 @memcpy(new_stmts[1..], stmts.items);
                 stmts.deinit();
                 stmts.* = ListManaged(Stmt).fromOwnedSlice(p.allocator, new_stmts);
@@ -6007,7 +6010,7 @@ pub fn NewParser_(
                 bun.copy(Stmt, stmts.items[1..], stmts.items[0 .. stmts.items.len - 1]);
             }
 
-            const loc = logger.Loc.Empty;
+            const loc = .none;
             const prepended_stmt = p.s(S.SExpr{ .value = p.newExpr(E.Call{
                 .target = Expr.initIdentifier(hook.signature_cb, loc),
             }, loc) }, loc);
@@ -6015,7 +6018,7 @@ pub fn NewParser_(
         }
 
         pub fn getReactRefreshHookSignalDecl(p: *P, signal_cb_ref: Ref) Stmt {
-            const loc = logger.Loc.Empty;
+            const loc = .none;
             p.react_refresh.latest_signature_ref = signal_cb_ref;
             // var s_ = $RefreshSig$();
             return p.s(S.Local{ .decls = G.Decl.List.fromSlice(p.allocator, &.{.{
@@ -6023,14 +6026,14 @@ pub fn NewParser_(
                 .value = p.newExpr(E.Call{
                     .target = Expr.initIdentifier(p.react_refresh.create_signature_ref, loc),
                 }, loc),
-            }}) catch bun.outOfMemory() }, loc);
+            }}) catch |err| bun.handleOom(err) }, loc);
         }
 
         pub fn getReactRefreshHookSignalInit(p: *P, ctx: *ReactRefresh.HookContext, function_with_hook_calls: Expr) Expr {
-            const loc = logger.Loc.Empty;
+            const loc = .none;
 
             const final = ctx.hasher.final();
-            const hash_data = p.allocator.alloc(u8, comptime bun.base64.encodeLenFromSize(@sizeOf(@TypeOf(final)))) catch bun.outOfMemory();
+            const hash_data = bun.handleOom(p.allocator.alloc(u8, comptime bun.base64.encodeLenFromSize(@sizeOf(@TypeOf(final)))));
             bun.assert(bun.base64.encode(hash_data, std.mem.asBytes(&final)) == hash_data.len);
 
             const have_custom_hooks = ctx.user_hooks.count() > 0;
@@ -6041,7 +6044,7 @@ pub fn NewParser_(
                 2 +
                     @as(usize, @intFromBool(have_force_arg)) +
                     @as(usize, @intFromBool(have_custom_hooks)),
-            ) catch bun.outOfMemory();
+            ) catch |err| bun.handleOom(err);
 
             args[0] = function_with_hook_calls;
             args[1] = p.newExpr(E.String{ .data = hash_data }, loc);
@@ -6056,7 +6059,7 @@ pub fn NewParser_(
                             p.s(S.Return{ .value = p.newExpr(E.Array{
                                 .items = ExprNodeList.init(ctx.user_hooks.values()),
                             }, loc) }, loc),
-                        }) catch bun.outOfMemory(),
+                        }) catch |err| bun.handleOom(err),
                         .loc = loc,
                     },
                     .prefer_expr = true,
@@ -6195,17 +6198,17 @@ pub fn NewParser_(
                 //   })
                 //
                 //  which is then called in `evaluateCommonJSModuleOnce`
-                var args = allocator.alloc(Arg, 5 + @as(usize, @intFromBool(p.has_import_meta))) catch bun.outOfMemory();
+                var args = bun.handleOom(allocator.alloc(Arg, 5 + @as(usize, @intFromBool(p.has_import_meta))));
                 args[0..5].* = .{
-                    Arg{ .binding = p.b(B.Identifier{ .ref = p.exports_ref }, logger.Loc.Empty) },
-                    Arg{ .binding = p.b(B.Identifier{ .ref = p.require_ref }, logger.Loc.Empty) },
-                    Arg{ .binding = p.b(B.Identifier{ .ref = p.module_ref }, logger.Loc.Empty) },
-                    Arg{ .binding = p.b(B.Identifier{ .ref = p.filename_ref }, logger.Loc.Empty) },
-                    Arg{ .binding = p.b(B.Identifier{ .ref = p.dirname_ref }, logger.Loc.Empty) },
+                    Arg{ .binding = p.b(B.Identifier{ .ref = p.exports_ref }, .none) },
+                    Arg{ .binding = p.b(B.Identifier{ .ref = p.require_ref }, .none) },
+                    Arg{ .binding = p.b(B.Identifier{ .ref = p.module_ref }, .none) },
+                    Arg{ .binding = p.b(B.Identifier{ .ref = p.filename_ref }, .none) },
+                    Arg{ .binding = p.b(B.Identifier{ .ref = p.dirname_ref }, .none) },
                 };
                 if (p.has_import_meta) {
-                    p.import_meta_ref = p.newSymbol(.other, "$Bun_import_meta") catch bun.outOfMemory();
-                    args[5] = Arg{ .binding = p.b(B.Identifier{ .ref = p.import_meta_ref }, logger.Loc.Empty) };
+                    p.import_meta_ref = bun.handleOom(p.newSymbol(.other, "$Bun_import_meta"));
+                    args[5] = Arg{ .binding = p.b(B.Identifier{ .ref = p.import_meta_ref }, .none) };
                 }
 
                 var total_stmts_count: usize = 0;
@@ -6220,7 +6223,7 @@ pub fn NewParser_(
 
                 total_stmts_count += @as(usize, @intCast(@intFromBool(preserve_strict_mode)));
 
-                const stmts_to_copy = allocator.alloc(Stmt, total_stmts_count) catch bun.outOfMemory();
+                const stmts_to_copy = bun.handleOom(allocator.alloc(Stmt, total_stmts_count));
                 {
                     var remaining_stmts = stmts_to_copy;
                     if (preserve_strict_mode) {
@@ -6245,21 +6248,21 @@ pub fn NewParser_(
                     E.Function{
                         .func = G.Fn{
                             .name = null,
-                            .open_parens_loc = logger.Loc.Empty,
+                            .open_parens_loc = .none,
                             .args = args,
-                            .body = .{ .loc = logger.Loc.Empty, .stmts = stmts_to_copy },
+                            .body = .{ .loc = .none, .stmts = stmts_to_copy },
                             .flags = Flags.Function.init(.{ .is_export = false }),
                         },
                     },
-                    logger.Loc.Empty,
+                    .none,
                 );
 
-                var top_level_stmts = p.allocator.alloc(Stmt, 1) catch bun.outOfMemory();
+                var top_level_stmts = bun.handleOom(p.allocator.alloc(Stmt, 1));
                 top_level_stmts[0] = p.s(
                     S.SExpr{
                         .value = wrapper,
                     },
-                    logger.Loc.Empty,
+                    .none,
                 );
 
                 try parts.ensureUnusedCapacity(1);
@@ -6334,8 +6337,8 @@ pub fn NewParser_(
                             p.allocator,
                             "require_{any}",
                             .{p.source.fmtIdentifier()},
-                        ) catch bun.outOfMemory(),
-                    ) catch bun.outOfMemory();
+                        ) catch |err| bun.handleOom(err),
+                    ) catch |err| bun.handleOom(err);
                 }
 
                 break :brk Ref.None;

src/ast/Parser.zig

@@ -155,14 +155,14 @@ pub const Parser = struct {
         if (self.options.jsx.parse and p.needs_jsx_import) {
             _ = p.addImportRecord(
                 .require,
-                logger.Loc{ .start = 0 },
+                .from(0),
                 p.options.jsx.importSource(),
             );
             // Ensure we have both classic and automatic
             // This is to handle cases where they use fragments in the automatic runtime
             _ = p.addImportRecord(
                 .require,
-                logger.Loc{ .start = 0 },
+                .from(0),
                 p.options.jsx.classic_import_source,
             );
         }
@@ -446,7 +446,7 @@ pub const Parser = struct {
         if (p.options.bundle) {
             // The bundler requires a part for generated module wrappers. This
             // part must be at the start as it is referred to by index.
-            before.append(js_ast.Part{}) catch bun.outOfMemory();
+            bun.handleOom(before.append(js_ast.Part{}));
         }
 
         // --inspect-brk
@@ -454,13 +454,13 @@ pub const Parser = struct {
             var debugger_stmts = try p.allocator.alloc(Stmt, 1);
             debugger_stmts[0] = Stmt{
                 .data = .{ .s_debugger = .{} },
-                .loc = logger.Loc.Empty,
+                .loc = .none,
             };
             before.append(
                 js_ast.Part{
                     .stmts = debugger_stmts,
                 },
-            ) catch bun.outOfMemory();
+            ) catch |err| bun.handleOom(err);
         }
 
         // When "using" declarations appear at the top level, we change all TDZ
@@ -660,24 +660,24 @@ pub const Parser = struct {
                 var decls = p.allocator.alloc(G.Decl, count) catch unreachable;
                 if (uses_dirname) {
                     decls[0] = .{
-                        .binding = p.b(B.Identifier{ .ref = p.dirname_ref }, logger.Loc.Empty),
+                        .binding = p.b(B.Identifier{ .ref = p.dirname_ref }, .none),
                         .value = p.newExpr(
                             E.String{
                                 .data = p.source.path.name.dir,
                             },
-                            logger.Loc.Empty,
+                            .none,
                         ),
                     };
                     declared_symbols.appendAssumeCapacity(.{ .ref = p.dirname_ref, .is_top_level = true });
                 }
                 if (uses_filename) {
                     decls[@as(usize, @intFromBool(uses_dirname))] = .{
-                        .binding = p.b(B.Identifier{ .ref = p.filename_ref }, logger.Loc.Empty),
+                        .binding = p.b(B.Identifier{ .ref = p.filename_ref }, .none),
                         .value = p.newExpr(
                             E.String{
                                 .data = p.source.path.text,
                             },
-                            logger.Loc.Empty,
+                            .none,
                         ),
                     };
                     declared_symbols.appendAssumeCapacity(.{ .ref = p.filename_ref, .is_top_level = true });
@@ -687,7 +687,7 @@ pub const Parser = struct {
                 part_stmts[0] = p.s(S.Local{
                     .kind = .k_var,
                     .decls = Decl.List.init(decls),
-                }, logger.Loc.Empty);
+                }, .none);
                 before.append(js_ast.Part{
                     .stmts = part_stmts,
                     .declared_symbols = declared_symbols,
@@ -713,7 +713,7 @@ pub const Parser = struct {
                     var import_part_stmts = remaining_stmts[0..1];
                     remaining_stmts = remaining_stmts[1..];
 
-                    p.module_scope.generated.push(p.allocator, deferred_import.namespace.ref.?) catch bun.outOfMemory();
+                    bun.handleOom(p.module_scope.generated.push(p.allocator, deferred_import.namespace.ref.?));
 
                     import_part_stmts[0] = Stmt.alloc(
                         S.Import,
@@ -1134,14 +1134,14 @@ pub const Parser = struct {
             if (uses_dirname) {
                 // var __dirname = import.meta
                 decls[0] = .{
-                    .binding = p.b(B.Identifier{ .ref = p.dirname_ref }, logger.Loc.Empty),
+                    .binding = p.b(B.Identifier{ .ref = p.dirname_ref }, .none),
                     .value = p.newExpr(
                         E.Dot{
                             .name = "dir",
-                            .name_loc = logger.Loc.Empty,
-                            .target = p.newExpr(E.ImportMeta{}, logger.Loc.Empty),
+                            .name_loc = .none,
+                            .target = p.newExpr(E.ImportMeta{}, .none),
                         },
-                        logger.Loc.Empty,
+                        .none,
                     ),
                 };
                 declared_symbols.appendAssumeCapacity(.{ .ref = p.dirname_ref, .is_top_level = true });
@@ -1149,14 +1149,14 @@ pub const Parser = struct {
             if (uses_filename) {
                 // var __filename = import.meta.path
                 decls[@as(usize, @intFromBool(uses_dirname))] = .{
-                    .binding = p.b(B.Identifier{ .ref = p.filename_ref }, logger.Loc.Empty),
+                    .binding = p.b(B.Identifier{ .ref = p.filename_ref }, .none),
                     .value = p.newExpr(
                         E.Dot{
                             .name = "path",
-                            .name_loc = logger.Loc.Empty,
-                            .target = p.newExpr(E.ImportMeta{}, logger.Loc.Empty),
+                            .name_loc = .none,
+                            .target = p.newExpr(E.ImportMeta{}, .none),
                         },
-                        logger.Loc.Empty,
+                        .none,
                     ),
                 };
                 declared_symbols.appendAssumeCapacity(.{ .ref = p.filename_ref, .is_top_level = true });
@@ -1166,7 +1166,7 @@ pub const Parser = struct {
             part_stmts[0] = p.s(S.Local{
                 .kind = .k_var,
                 .decls = Decl.List.init(decls),
-            }, logger.Loc.Empty);
+            }, .none);
             before.append(js_ast.Part{
                 .stmts = part_stmts,
                 .declared_symbols = declared_symbols,
@@ -1208,7 +1208,7 @@ pub const Parser = struct {
             if (items_count == 0)
                 break :outer;
 
-            const import_record_id = p.addImportRecord(.stmt, logger.Loc.Empty, "bun:test");
+            const import_record_id = p.addImportRecord(.stmt, .none, "bun:test");
             var import_record: *ImportRecord = &p.import_records.items[import_record_id];
             import_record.tag = .bun_test;
 
@@ -1219,9 +1219,9 @@ pub const Parser = struct {
             inline for (comptime std.meta.fieldNames(Jest)) |symbol_name| {
                 if (p.symbols.items[@field(jest, symbol_name).innerIndex()].use_count_estimate > 0) {
                     clauses[clause_i] = js_ast.ClauseItem{
-                        .name = .{ .ref = @field(jest, symbol_name), .loc = logger.Loc.Empty },
+                        .name = .{ .ref = @field(jest, symbol_name), .loc = .none },
                         .alias = symbol_name,
-                        .alias_loc = logger.Loc.Empty,
+                        .alias_loc = .none,
                         .original_name = "",
                     };
                     declared_symbols.appendAssumeCapacity(.{ .ref = @field(jest, symbol_name), .is_top_level = true });
@@ -1231,11 +1231,11 @@ pub const Parser = struct {
 
             const import_stmt = p.s(
                 S.Import{
-                    .namespace_ref = p.declareSymbol(.unbound, logger.Loc.Empty, "bun_test_import_namespace_for_internal_use_only") catch unreachable,
+                    .namespace_ref = p.declareSymbol(.unbound, .none, "bun_test_import_namespace_for_internal_use_only") catch unreachable,
                     .items = clauses,
                     .import_record_index = import_record_id,
                 },
-                logger.Loc.Empty,
+                .none,
             );
 
             var part_stmts = try p.allocator.alloc(Stmt, 1);

src/ast/S.zig

@@ -1,6 +1,6 @@
 pub const Block = struct {
     stmts: StmtNodeList,
-    close_brace_loc: logger.Loc = logger.Loc.Empty,
+    close_brace_loc: logger.Loc = .none,
 };
 
 pub const SExpr = struct {
@@ -123,7 +123,7 @@ pub const While = struct {
 pub const With = struct {
     value: ExprNodeIndex,
     body: StmtNodeIndex,
-    body_loc: logger.Loc = logger.Loc.Empty,
+    body_loc: logger.Loc = .none,
 };
 
 pub const Try = struct {

src/ast/Scope.zig

@@ -74,7 +74,7 @@ pub const Member = struct {
     loc: logger.Loc,
 
     pub fn eql(a: Member, b: Member) bool {
-        return @call(bun.callmod_inline, Ref.eql, .{ a.ref, b.ref }) and a.loc.start == b.loc.start;
+        return @call(bun.callmod_inline, Ref.eql, .{ a.ref, b.ref }) and a.loc == b.loc;
     }
 };
 

src/ast/SideEffects.zig

@@ -347,7 +347,7 @@ pub const SideEffects = enum(u1) {
         const stack_bottom = stack.items.len;
         defer stack.shrinkRetainingCapacity(stack_bottom);
 
-        stack.append(.{ .bin = expr.data.e_binary }) catch bun.outOfMemory();
+        bun.handleOom(stack.append(.{ .bin = expr.data.e_binary }));
 
         // Build stack up of expressions
         var left: Expr = expr.data.e_binary.left;
@@ -357,7 +357,7 @@ pub const SideEffects = enum(u1) {
                 .bin_strict_ne,
                 .bin_comma,
                 => {
-                    stack.append(.{ .bin = left_bin }) catch bun.outOfMemory();
+                    bun.handleOom(stack.append(.{ .bin = left_bin }));
                     left = left_bin.left;
                 },
                 else => break,

src/ast/Stmt.zig

@@ -37,7 +37,7 @@ pub fn isMissingExpr(self: Stmt) bool {
 }
 
 pub fn empty() Stmt {
-    return Stmt{ .data = .{ .s_empty = None }, .loc = logger.Loc{} };
+    return Stmt{ .data = .{ .s_empty = None }, .loc = .none };
 }
 
 pub fn toEmpty(this: Stmt) Stmt {

src/ast/foldStringAddition.zig

@@ -182,7 +182,7 @@ pub fn foldStringAddition(l: Expr, r: Expr, allocator: std.mem.Allocator, kind:
                                             allocator,
                                             E.TemplatePart,
                                             &.{ left.parts, right.parts },
-                                        ) catch bun.outOfMemory();
+                                        ) catch |err| bun.handleOom(err);
                                     return lhs;
                                 }
                             } else {

src/ast/maybe.zig

@@ -22,7 +22,7 @@ pub fn AstMaybe(
                 return .{ .ok = false };
             }
 
-            var value: Expr = Expr{ .loc = logger.Loc.Empty, .data = Expr.Data{ .e_missing = E.Missing{} } };
+            var value: Expr = Expr{ .loc = .none, .data = Expr.Data{ .e_missing = E.Missing{} } };
 
             for (decls) |decl| {
                 const binding = Binding.toExpr(
@@ -459,12 +459,12 @@ pub fn AstMaybe(
                             p.allocator,
                             id.ref,
                             .{},
-                        ) catch bun.outOfMemory();
+                        ) catch |err| bun.handleOom(err);
                         const inner_use = gop.value_ptr.getOrPutValue(
                             p.allocator,
                             name,
                             .{},
-                        ) catch bun.outOfMemory();
+                        ) catch |err| bun.handleOom(err);
                         inner_use.value_ptr.count_estimate += 1;
                     }
                 },
@@ -572,8 +572,8 @@ pub fn AstMaybe(
                                     p.allocator,
                                     "import.meta.hot.{s} does not exist",
                                     .{name},
-                                ) catch bun.outOfMemory(),
-                            ) catch bun.outOfMemory();
+                                ) catch |err| bun.handleOom(err),
+                            ) catch |err| bun.handleOom(err);
                             return .{ .data = .e_undefined, .loc = loc };
                         }
                     },
@@ -651,14 +651,14 @@ pub fn AstMaybe(
                             .op = .un_typeof,
                             .value = expr,
                         },
-                        logger.Loc.Empty,
+                        .none,
                     ),
                     .right = p.newExpr(
                         E.String{ .data = "undefined" },
-                        logger.Loc.Empty,
+                        .none,
                     ),
                 },
-                logger.Loc.Empty,
+                .none,
             );
         }
 
@@ -668,19 +668,19 @@ pub fn AstMaybe(
                     .test_ = try p.checkIfDefinedHelper(identifier_expr),
                     .yes = p.newExpr(
                         E.Identifier{
-                            .ref = (p.findSymbol(logger.Loc.Empty, "Object") catch unreachable).ref,
+                            .ref = (p.findSymbol(.none, "Object") catch unreachable).ref,
                         },
-                        logger.Loc.Empty,
+                        .none,
                     ),
                     .no = identifier_expr,
                 },
-                logger.Loc.Empty,
+                .none,
             );
         }
 
         pub fn maybeCommaSpreadError(p: *P, _comma_after_spread: ?logger.Loc) void {
             const comma_after_spread = _comma_after_spread orelse return;
-            if (comma_after_spread.start == -1) return;
+            if (comma_after_spread == .none) return;
 
             p.log.addRangeError(p.source, logger.Range{ .loc = comma_after_spread, .len = 1 }, "Unexpected \",\" after rest pattern") catch unreachable;
         }

src/ast/parse.zig

@@ -290,7 +290,7 @@ pub fn Parse(
             // Use NextInsideJSXElement() not Next() so we can parse a JSX-style string literal
             try p.lexer.nextInsideJSXElement();
             if (p.lexer.token == .t_string_literal) {
-                previous_string_with_backslash_loc.start = @max(p.lexer.loc().start, p.lexer.previous_backslash_quote_in_jsx.loc.start);
+                previous_string_with_backslash_loc.* = p.lexer.loc().max(p.lexer.previous_backslash_quote_in_jsx.loc);
                 const expr = p.newExpr(try p.lexer.toEString(), previous_string_with_backslash_loc.*);
 
                 try p.lexer.nextInsideJSXElement();
@@ -362,7 +362,7 @@ pub fn Parse(
                 }
 
                 // There may be a "=" after the type (but not after an "as" cast)
-                if (is_typescript_enabled and p.lexer.token == .t_equals and !p.forbid_suffix_after_as_loc.eql(p.lexer.loc())) {
+                if (is_typescript_enabled and p.lexer.token == .t_equals and p.forbid_suffix_after_as_loc != p.lexer.loc()) {
                     try p.lexer.next();
                     item.* = Expr.assign(item.*, try p.parseExpr(.comma));
                 }
@@ -886,7 +886,7 @@ pub fn Parse(
         }
 
         pub fn parsePropertyBinding(p: *P) anyerror!B.Property {
-            var key: js_ast.Expr = Expr{ .loc = logger.Loc.Empty, .data = Prefill.Data.EMissing };
+            var key: js_ast.Expr = Expr{ .loc = .none, .data = Prefill.Data.EMissing };
             var is_computed = false;
 
             switch (p.lexer.token) {
@@ -1213,7 +1213,7 @@ pub fn Parse(
                     switch (stmt.data) {
                         .s_return => |ret| {
                             if (ret.value == null and !p.latest_return_had_semicolon) {
-                                returnWithoutSemicolonStart = stmt.loc.start;
+                                returnWithoutSemicolonStart = stmt.loc.get();
                                 needsCheck = false;
                             }
                         },
@@ -1225,7 +1225,7 @@ pub fn Parse(
                             .s_expr => {
                                 try p.log.addWarning(
                                     p.source,
-                                    logger.Loc{ .start = returnWithoutSemicolonStart + 6 },
+                                    .from(returnWithoutSemicolonStart + 6),
                                     "The following expression is not returned because of an automatically-inserted semicolon",
                                 );
                             },