Merge branch 'main' into claude/refactor-shell-interpreter-jsref

Replace the `hasPendingActivity` callback mechanism with `jsc.JSRef` to manage
the JavaScript object lifecycle. This aligns the shell interpreter with the
pattern used in subprocess.zig.

Changes:
- Replace `this_jsvalue: JSValue` with `this_value: jsc.JSRef`
- Remove `has_pending_activity` atomic counter and incr/decr helper functions
- Replace `hasPendingActivity()` with `computeHasPendingActivity()` that checks actual state
- Add `updateHasPendingActivity()` to upgrade/downgrade JSRef based on pending activity
- Update all JSValue accesses to use `this_value.tryGet()`
- Remove `hasPendingActivity: true` from Shell.classes.ts

The JSRef automatically manages GC references by upgrading to strong when there's
pending activity and downgrading to weak when done, eliminating the need for the
hasPendingActivity callback.

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

Co-Authored-By: Claude <noreply@anthropic.com>

.buildkite/Dockerfile

@@ -26,7 +26,7 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
    wget curl git python3 python3-pip ninja-build \
    software-properties-common apt-transport-https \
    ca-certificates gnupg lsb-release unzip \
-   libxml2-dev ruby ruby-dev bison gawk perl make golang ccache \
+   libxml2-dev ruby ruby-dev bison gawk perl make golang \
    && add-apt-repository ppa:ubuntu-toolchain-r/test \
    && apt-get update \
    && apt-get install -y gcc-13 g++-13 libgcc-13-dev libstdc++-13-dev \
@@ -35,8 +35,7 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
    && wget https://apt.llvm.org/llvm.sh \
    && chmod +x llvm.sh \
    && ./llvm.sh ${LLVM_VERSION} all \
-   && rm llvm.sh \
-   && rm -rf /var/lib/apt/lists/*
+   && rm llvm.sh
 
 
 RUN --mount=type=tmpfs,target=/tmp \
@@ -49,6 +48,14 @@ RUN --mount=type=tmpfs,target=/tmp \
     wget -O /tmp/cmake.sh "$cmake_url" && \
     sh /tmp/cmake.sh --skip-license --prefix=/usr
 
+RUN --mount=type=tmpfs,target=/tmp \
+    sccache_version="0.12.0" && \
+    arch=$(uname -m) && \
+    sccache_url="https://github.com/mozilla/sccache/releases/download/v${sccache_version}/sccache-v${sccache_version}-${arch}-unknown-linux-musl.tar.gz" && \
+    wget -O /tmp/sccache.tar.gz "$sccache_url" && \
+    tar -xzf /tmp/sccache.tar.gz -C /tmp && \
+    install -m755 /tmp/sccache-v${sccache_version}-${arch}-unknown-linux-musl/sccache /usr/local/bin
+
 RUN update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-13 130 \
    --slave /usr/bin/g++ g++ /usr/bin/g++-13 \
    --slave /usr/bin/gcc-ar gcc-ar /usr/bin/gcc-ar-13 \
@@ -127,7 +134,9 @@ RUN ARCH=$(if [ "$TARGETARCH" = "arm64" ]; then echo "arm64"; else echo "amd64";
 RUN mkdir -p /var/cache/buildkite-agent /var/log/buildkite-agent /var/run/buildkite-agent /etc/buildkite-agent /var/lib/buildkite-agent/cache/bun
 
 # The following is necessary to configure buildkite to use a stable
-# checkout directory for ccache to be effective.
+# checkout directory. sccache hashes absolute paths into its cache keys,
+# so if buildkite uses a different checkout path each time (which it does
+# by default), sccache will be useless.
 RUN mkdir -p -m 755 /var/lib/buildkite-agent/hooks && \
     cat <<'EOF' > /var/lib/buildkite-agent/hooks/environment
 #!/bin/sh

.buildkite/ci.mjs

@@ -31,7 +31,7 @@ import {
 } from "../scripts/utils.mjs";
 
 /**
- * @typedef {"linux" | "darwin" | "windows"} Os
+ * @typedef {"linux" | "darwin" | "windows" | "freebsd"} Os
  * @typedef {"aarch64" | "x64"} Arch
  * @typedef {"musl"} Abi
  * @typedef {"debian" | "ubuntu" | "alpine" | "amazonlinux"} Distro
@@ -114,6 +114,7 @@ const buildPlatforms = [
   { os: "linux", arch: "x64", abi: "musl", baseline: true, distro: "alpine", release: "3.22" },
   { os: "windows", arch: "x64", release: "2019" },
   { os: "windows", arch: "x64", baseline: true, release: "2019" },
+  { os: "freebsd", arch: "x64", release: "14.3" },
 ];
 
 /**
@@ -571,7 +572,6 @@ function getTestBunStep(platform, options, testOptions = {}) {
   if (buildId) {
     args.push(`--build-id=${buildId}`);
   }
-
   if (testFiles) {
     args.push(...testFiles.map(testFile => `--include=${testFile}`));
   }
@@ -588,7 +588,7 @@ function getTestBunStep(platform, options, testOptions = {}) {
     agents: getTestAgent(platform, options),
     retry: getRetry(),
     cancel_on_build_failing: isMergeQueue(),
-    parallelism: os === "darwin" ? 2 : 20,
+    parallelism: os === "darwin" ? 2 : 10,
     timeout_in_minutes: profile === "asan" || os === "windows" ? 45 : 30,
     env: {
       ASAN_OPTIONS: "allow_user_segv_handler=1:disable_coredump=0:detect_leaks=0",
@@ -657,7 +657,7 @@ function getReleaseStep(buildPlatforms, options) {
     agents: {
       queue: "test-darwin",
     },
-    depends_on: buildPlatforms.map(platform => `${getTargetKey(platform)}-build-bun`),
+    depends_on: buildPlatforms.filter(p => p.os !== "freebsd").map(platform => `${getTargetKey(platform)}-build-bun`),
     env: {
       CANARY: revision,
     },
@@ -1108,6 +1108,9 @@ async function getPipeline(options = {}) {
       ? buildPlatforms
       : buildPlatforms.filter(({ profile }) => profile !== "asan");
 
+    // run build-image but no build-bun yet
+    relevantBuildPlatforms = relevantBuildPlatforms.filter(({ os }) => os !== "freebsd");
+
     steps.push(
       ...relevantBuildPlatforms.map(target => {
         const imageKey = getImageKey(target);

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

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

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

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

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

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

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

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

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

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

.coderabbit.yaml

@@ -3,6 +3,8 @@ language: en-US
 issue_enrichment:
   auto_enrich:
     enabled: false
+  planning:
+    enabled: false
 
 reviews:
   profile: assertive

.cursor/rules/building-bun.mdc

@@ -0,0 +1,41 @@
+---
+description:
+globs: src/**/*.cpp,src/**/*.zig
+alwaysApply: false
+---
+
+### Build Commands
+
+- **Build debug version**: `bun bd` or `bun run build:debug`
+  - Creates a debug build at `./build/debug/bun-debug`
+  - Compilation takes ~2.5 minutes
+- **Run tests with your debug build**: `bun bd test <test-file>`
+  - **CRITICAL**: Never use `bun test` directly - it won't include your changes
+- **Run any command with debug build**: `bun bd <command>`
+
+### Run a file
+
+To run a file, use:
+
+```sh
+bun bd <file> <...args>
+```
+
+**CRITICAL**: Never use `bun <file>` directly. It will not have your changes.
+
+### Logging
+
+`BUN_DEBUG_$(SCOPE)=1` enables debug logs for a specific debug log scope.
+
+Debug logs look like this:
+
+```zig
+const log = bun.Output.scoped(.${SCOPE}, .hidden);
+
+// ...later
+log("MY DEBUG LOG", .{})
+```
+
+### Code Generation
+
+Code generation happens automatically as part of the build process. There are no commands to run.

.cursor/rules/dev-server-tests.mdc

@@ -0,0 +1,139 @@
+---
+description: Writing HMR/Dev Server tests
+globs: test/bake/*
+---
+
+# Writing HMR/Dev Server tests
+
+Dev server tests validate that hot-reloading is robust, correct, and reliable. Remember to write thorough, yet concise tests.
+
+## File Structure
+
+- `test/bake/bake-harness.ts` - shared utilities and test harness
+  - primary test functions `devTest` / `prodTest` / `devAndProductionTest`
+  - class `Dev` (controls subprocess for dev server)
+  - class `Client` (controls a happy-dom subprocess for having the page open)
+  - more helpers
+- `test/bake/client-fixture.mjs` - subprocess for what `Client` controls. it loads a page and uses IPC to query parts of the page, run javascript, and much more.
+- `test/bake/dev/*.test.ts` - these call `devTest` to test dev server and hot reloading
+- `test/bake/dev-and-prod.ts` - these use `devAndProductionTest` to run the same test on dev and production mode. these tests cannot really test hot reloading for obvious reasons.
+
+## Categories
+
+bundle.test.ts - Bundle tests are tests concerning bundling bugs that only occur in DevServer.
+css.test.ts - CSS tests concern bundling bugs with CSS files
+plugins.test.ts - Plugin tests concern plugins in development mode.
+ecosystem.test.ts - These tests involve ensuring certain libraries are correct. It is preferred to test more concrete bugs than testing entire packages.
+esm.test.ts - ESM tests are about various esm features in development mode.
+html.test.ts - HTML tests are tests relating to HTML files themselves.
+react-spa.test.ts - Tests relating to React, our react-refresh transform, and basic server component transforms.
+sourcemap.test.ts - Tests verifying source-maps are correct.
+
+## `devTest` Basics
+
+A test takes in two primary inputs: `files` and `async test(dev) {`
+
+```ts
+import { devTest, emptyHtmlFile } from "../bake-harness";
+
+devTest("html file is watched", {
+  files: {
+    "index.html": emptyHtmlFile({
+      scripts: ["/script.ts"],
+      body: "<h1>Hello</h1>",
+    }),
+    "script.ts": `
+      console.log("hello");
+    `,
+  },
+  async test(dev) {
+    await dev.fetch("/").expect.toInclude("<h1>Hello</h1>");
+    await dev.fetch("/").expect.toInclude("<h1>Hello</h1>");
+    await dev.patch("index.html", {
+      find: "Hello",
+      replace: "World",
+    });
+    await dev.fetch("/").expect.toInclude("<h1>World</h1>");
+
+    // Works
+    await using c = await dev.client("/");
+    await c.expectMessage("hello");
+
+    // Editing HTML reloads
+    await c.expectReload(async () => {
+      await dev.patch("index.html", {
+        find: "World",
+        replace: "Hello",
+      });
+      await dev.fetch("/").expect.toInclude("<h1>Hello</h1>");
+    });
+    await c.expectMessage("hello");
+
+    await c.expectReload(async () => {
+      await dev.patch("index.html", {
+        find: "Hello",
+        replace: "Bar",
+      });
+      await dev.fetch("/").expect.toInclude("<h1>Bar</h1>");
+    });
+    await c.expectMessage("hello");
+
+    await c.expectReload(async () => {
+      await dev.patch("script.ts", {
+        find: "hello",
+        replace: "world",
+      });
+    });
+    await c.expectMessage("world");
+  },
+});
+```
+
+`files` holds the initial state, and the callback runs with the server running. `dev.fetch()` runs HTTP requests, while `dev.client()` opens a browser instance to the code.
+
+Functions `dev.write` and `dev.patch` and `dev.delete` mutate the filesystem. Do not use `node:fs` APIs, as the dev server ones are hooked to wait for hot-reload, and all connected clients to receive changes.
+
+When a change performs a hard-reload, that must be explicitly annotated with `expectReload`. This tells `client-fixture.mjs` that the test is meant to reload the page once; All other hard reloads automatically fail the test.
+
+Client's have `console.log` instrumented, so that any unasserted logs fail the test. This makes it more obvious when an extra reload or re-evaluation. Messages are awaited via `c.expectMessage("log")` or with multiple arguments if there are multiple logs.
+
+## Testing for bundling errors
+
+By default, a client opening a page to an error will fail the test. This makes testing errors explicit.
+
+```ts
+devTest("import then create", {
+  files: {
+    "index.html": `
+      <!DOCTYPE html>
+      <html>
+      <head></head>
+      <body>
+        <script type="module" src="/script.ts"></script>
+      </body>
+      </html>
+    `,
+    "script.ts": `
+      import data from "./data";
+      console.log(data);
+    `,
+  },
+  async test(dev) {
+    const c = await dev.client("/", {
+      errors: ['script.ts:1:18: error: Could not resolve: "./data"'],
+    });
+    await c.expectReload(async () => {
+      await dev.write("data.ts", "export default 'data';");
+    });
+    await c.expectMessage("data");
+  },
+});
+```
+
+Many functions take an options value to allow specifying it will produce errors. For example, this delete is going to cause a resolution failure.
+
+```ts
+await dev.delete("other.ts", {
+  errors: ['index.ts:1:16: error: Could not resolve: "./other"'],
+});
+```

.cursor/rules/javascriptcore-class.mdc

@@ -0,0 +1,413 @@
+---
+description: JavaScript class implemented in C++
+globs: *.cpp
+alwaysApply: false
+---
+
+# Implementing JavaScript classes in C++
+
+If there is a publicly accessible Constructor and Prototype, then there are 3 classes:
+
+- IF there are C++ class members we need a destructor, so `class Foo : public JSC::DestructibleObject`, if no C++ class fields (only JS properties) then we don't need a class at all usually. We can instead use JSC::constructEmptyObject(vm, structure) and `putDirectOffset` like in [NodeFSStatBinding.cpp](mdc:src/bun.js/bindings/NodeFSStatBinding.cpp).
+- class FooPrototype : public JSC::JSNonFinalObject
+- class FooConstructor : public JSC::InternalFunction
+
+If there is no publicly accessible Constructor, just the Prototype and the class is necessary. In some cases, we can avoid the prototype entirely (but that's rare).
+
+If there are C++ fields on the Foo class, the Foo class will need an iso subspace added to [DOMClientIsoSubspaces.h](mdc:src/bun.js/bindings/webcore/DOMClientIsoSubspaces.h) and [DOMIsoSubspaces.h](mdc:src/bun.js/bindings/webcore/DOMIsoSubspaces.h). Prototype and Constructor do not need subspaces.
+
+Usually you'll need to #include "root.h" at the top of C++ files or you'll get lint errors.
+
+Generally, defining the subspace looks like this:
+
+```c++
+
+class Foo : public JSC::DestructibleObject {
+
+// ...
+
+ template<typename MyClassT, JSC::SubspaceAccess mode>
+    static JSC::GCClient::IsoSubspace* subspaceFor(JSC::VM& vm)
+    {
+        if constexpr (mode == JSC::SubspaceAccess::Concurrently)
+            return nullptr;
+        return WebCore::subspaceForImpl<MyClassT, WebCore::UseCustomHeapCellType::No>(
+            vm,
+            [](auto& spaces) { return spaces.m_clientSubspaceFor${MyClassT}.get(); },
+            [](auto& spaces, auto&& space) { spaces.m_clientSubspaceFor${MyClassT} = std::forward<decltype(space)>(space); },
+            [](auto& spaces) { return spaces.m_subspaceFo${MyClassT}.get(); },
+            [](auto& spaces, auto&& space) { spaces.m_subspaceFor${MyClassT} = std::forward<decltype(space)>(space); });
+    }
+
+
+```
+
+It's better to put it in the .cpp file instead of the .h file, when possible.
+
+## Defining properties
+
+Define properties on the prototype. Use a const HashTableValues like this:
+
+```C++
+static JSC_DECLARE_HOST_FUNCTION(jsX509CertificateProtoFuncCheckEmail);
+static JSC_DECLARE_HOST_FUNCTION(jsX509CertificateProtoFuncCheckHost);
+static JSC_DECLARE_HOST_FUNCTION(jsX509CertificateProtoFuncCheckIP);
+static JSC_DECLARE_HOST_FUNCTION(jsX509CertificateProtoFuncCheckIssued);
+static JSC_DECLARE_HOST_FUNCTION(jsX509CertificateProtoFuncCheckPrivateKey);
+static JSC_DECLARE_HOST_FUNCTION(jsX509CertificateProtoFuncToJSON);
+static JSC_DECLARE_HOST_FUNCTION(jsX509CertificateProtoFuncToLegacyObject);
+static JSC_DECLARE_HOST_FUNCTION(jsX509CertificateProtoFuncToString);
+static JSC_DECLARE_HOST_FUNCTION(jsX509CertificateProtoFuncVerify);
+
+static JSC_DECLARE_CUSTOM_GETTER(jsX509CertificateGetter_ca);
+static JSC_DECLARE_CUSTOM_GETTER(jsX509CertificateGetter_fingerprint);
+static JSC_DECLARE_CUSTOM_GETTER(jsX509CertificateGetter_fingerprint256);
+static JSC_DECLARE_CUSTOM_GETTER(jsX509CertificateGetter_fingerprint512);
+static JSC_DECLARE_CUSTOM_GETTER(jsX509CertificateGetter_subject);
+static JSC_DECLARE_CUSTOM_GETTER(jsX509CertificateGetter_subjectAltName);
+static JSC_DECLARE_CUSTOM_GETTER(jsX509CertificateGetter_infoAccess);
+static JSC_DECLARE_CUSTOM_GETTER(jsX509CertificateGetter_keyUsage);
+static JSC_DECLARE_CUSTOM_GETTER(jsX509CertificateGetter_issuer);
+static JSC_DECLARE_CUSTOM_GETTER(jsX509CertificateGetter_issuerCertificate);
+static JSC_DECLARE_CUSTOM_GETTER(jsX509CertificateGetter_publicKey);
+static JSC_DECLARE_CUSTOM_GETTER(jsX509CertificateGetter_raw);
+static JSC_DECLARE_CUSTOM_GETTER(jsX509CertificateGetter_serialNumber);
+static JSC_DECLARE_CUSTOM_GETTER(jsX509CertificateGetter_validFrom);
+static JSC_DECLARE_CUSTOM_GETTER(jsX509CertificateGetter_validTo);
+static JSC_DECLARE_CUSTOM_GETTER(jsX509CertificateGetter_validFromDate);
+static JSC_DECLARE_CUSTOM_GETTER(jsX509CertificateGetter_validToDate);
+
+static const HashTableValue JSX509CertificatePrototypeTableValues[] = {
+    { "ca"_s, static_cast<unsigned>(PropertyAttribute::ReadOnly | PropertyAttribute::CustomAccessor), NoIntrinsic, { HashTableValue::GetterSetterType, jsX509CertificateGetter_ca, 0 } },
+    { "checkEmail"_s, static_cast<unsigned>(PropertyAttribute::Function), NoIntrinsic, { HashTableValue::NativeFunctionType, jsX509CertificateProtoFuncCheckEmail, 2 } },
+    { "checkHost"_s, static_cast<unsigned>(PropertyAttribute::Function), NoIntrinsic, { HashTableValue::NativeFunctionType, jsX509CertificateProtoFuncCheckHost, 2 } },
+    { "checkIP"_s, static_cast<unsigned>(PropertyAttribute::Function), NoIntrinsic, { HashTableValue::NativeFunctionType, jsX509CertificateProtoFuncCheckIP, 1 } },
+    { "checkIssued"_s, static_cast<unsigned>(PropertyAttribute::Function), NoIntrinsic, { HashTableValue::NativeFunctionType, jsX509CertificateProtoFuncCheckIssued, 1 } },
+    { "checkPrivateKey"_s, static_cast<unsigned>(PropertyAttribute::Function), NoIntrinsic, { HashTableValue::NativeFunctionType, jsX509CertificateProtoFuncCheckPrivateKey, 1 } },
+    { "fingerprint"_s, static_cast<unsigned>(PropertyAttribute::ReadOnly | PropertyAttribute::CustomAccessor), NoIntrinsic, { HashTableValue::GetterSetterType, jsX509CertificateGetter_fingerprint, 0 } },
+    { "fingerprint256"_s, static_cast<unsigned>(PropertyAttribute::ReadOnly | PropertyAttribute::CustomAccessor), NoIntrinsic, { HashTableValue::GetterSetterType, jsX509CertificateGetter_fingerprint256, 0 } },
+    { "fingerprint512"_s, static_cast<unsigned>(PropertyAttribute::ReadOnly | PropertyAttribute::CustomAccessor), NoIntrinsic, { HashTableValue::GetterSetterType, jsX509CertificateGetter_fingerprint512, 0 } },
+    { "infoAccess"_s, static_cast<unsigned>(PropertyAttribute::ReadOnly | PropertyAttribute::CustomAccessor), NoIntrinsic, { HashTableValue::GetterSetterType, jsX509CertificateGetter_infoAccess, 0 } },
+    { "issuer"_s, static_cast<unsigned>(PropertyAttribute::ReadOnly | PropertyAttribute::CustomAccessor), NoIntrinsic, { HashTableValue::GetterSetterType, jsX509CertificateGetter_issuer, 0 } },
+    { "issuerCertificate"_s, static_cast<unsigned>(PropertyAttribute::ReadOnly | PropertyAttribute::CustomAccessor), NoIntrinsic, { HashTableValue::GetterSetterType, jsX509CertificateGetter_issuerCertificate, 0 } },
+    { "keyUsage"_s, static_cast<unsigned>(PropertyAttribute::ReadOnly | PropertyAttribute::CustomAccessor), NoIntrinsic, { HashTableValue::GetterSetterType, jsX509CertificateGetter_keyUsage, 0 } },
+    { "publicKey"_s, static_cast<unsigned>(PropertyAttribute::ReadOnly | PropertyAttribute::CustomAccessor), NoIntrinsic, { HashTableValue::GetterSetterType, jsX509CertificateGetter_publicKey, 0 } },
+    { "raw"_s, static_cast<unsigned>(PropertyAttribute::ReadOnly | PropertyAttribute::CustomAccessor), NoIntrinsic, { HashTableValue::GetterSetterType, jsX509CertificateGetter_raw, 0 } },
+    { "serialNumber"_s, static_cast<unsigned>(PropertyAttribute::ReadOnly | PropertyAttribute::CustomAccessor), NoIntrinsic, { HashTableValue::GetterSetterType, jsX509CertificateGetter_serialNumber, 0 } },
+    { "subject"_s, static_cast<unsigned>(PropertyAttribute::ReadOnly | PropertyAttribute::CustomAccessor), NoIntrinsic, { HashTableValue::GetterSetterType, jsX509CertificateGetter_subject, 0 } },
+    { "subjectAltName"_s, static_cast<unsigned>(PropertyAttribute::ReadOnly | PropertyAttribute::CustomAccessor), NoIntrinsic, { HashTableValue::GetterSetterType, jsX509CertificateGetter_subjectAltName, 0 } },
+    { "toJSON"_s, static_cast<unsigned>(PropertyAttribute::Function), NoIntrinsic, { HashTableValue::NativeFunctionType, jsX509CertificateProtoFuncToJSON, 0 } },
+    { "toLegacyObject"_s, static_cast<unsigned>(PropertyAttribute::Function), NoIntrinsic, { HashTableValue::NativeFunctionType, jsX509CertificateProtoFuncToLegacyObject, 0 } },
+    { "toString"_s, static_cast<unsigned>(PropertyAttribute::Function), NoIntrinsic, { HashTableValue::NativeFunctionType, jsX509CertificateProtoFuncToString, 0 } },
+    { "validFrom"_s, static_cast<unsigned>(PropertyAttribute::ReadOnly | PropertyAttribute::CustomAccessor), NoIntrinsic, { HashTableValue::GetterSetterType, jsX509CertificateGetter_validFrom, 0 } },
+    { "validFromDate"_s, static_cast<unsigned>(PropertyAttribute::ReadOnly | PropertyAttribute::CustomAccessorOrValue), NoIntrinsic, { HashTableValue::GetterSetterType, jsX509CertificateGetter_validFromDate, 0 } },
+    { "validTo"_s, static_cast<unsigned>(PropertyAttribute::ReadOnly | PropertyAttribute::CustomAccessor), NoIntrinsic, { HashTableValue::GetterSetterType, jsX509CertificateGetter_validTo, 0 } },
+    { "validToDate"_s, static_cast<unsigned>(PropertyAttribute::ReadOnly | PropertyAttribute::CustomAccessorOrValue), NoIntrinsic, { HashTableValue::GetterSetterType, jsX509CertificateGetter_validToDate, 0 } },
+    { "verify"_s, static_cast<unsigned>(PropertyAttribute::Function), NoIntrinsic, { HashTableValue::NativeFunctionType, jsX509CertificateProtoFuncVerify, 1 } },
+};
+```
+
+### Creating a prototype class
+
+Follow a pattern like this:
+
+```c++
+class JSX509CertificatePrototype final : public JSC::JSNonFinalObject {
+public:
+    using Base = JSC::JSNonFinalObject;
+    static constexpr unsigned StructureFlags = Base::StructureFlags;
+
+    static JSX509CertificatePrototype* create(JSC::VM& vm, JSC::JSGlobalObject* globalObject, JSC::Structure* structure)
+    {
+        JSX509CertificatePrototype* prototype = new (NotNull, allocateCell<JSX509CertificatePrototype>(vm)) JSX509CertificatePrototype(vm, structure);
+        prototype->finishCreation(vm);
+        return prototype;
+    }
+
+    template<typename, JSC::SubspaceAccess>
+    static JSC::GCClient::IsoSubspace* subspaceFor(JSC::VM& vm)
+    {
+        return &vm.plainObjectSpace();
+    }
+
+    DECLARE_INFO;
+
+    static JSC::Structure* createStructure(JSC::VM& vm, JSC::JSGlobalObject* globalObject, JSC::JSValue prototype)
+    {
+        auto* structure = JSC::Structure::create(vm, globalObject, prototype, JSC::TypeInfo(JSC::ObjectType, StructureFlags), info());
+        structure->setMayBePrototype(true);
+        return structure;
+    }
+
+private:
+    JSX509CertificatePrototype(JSC::VM& vm, JSC::Structure* structure)
+        : Base(vm, structure)
+    {
+    }
+
+    void finishCreation(JSC::VM& vm);
+};
+
+const ClassInfo JSX509CertificatePrototype::s_info = { "X509Certificate"_s, &Base::s_info, nullptr, nullptr, CREATE_METHOD_TABLE(JSX509CertificatePrototype) };
+
+void JSX509CertificatePrototype::finishCreation(VM& vm)
+{
+    Base::finishCreation(vm);
+    reifyStaticProperties(vm, JSX509Certificate::info(), JSX509CertificatePrototypeTableValues, *this);
+    JSC_TO_STRING_TAG_WITHOUT_TRANSITION();
+}
+
+} // namespace Bun
+```
+
+### Getter definition:
+
+```C++
+
+JSC_DEFINE_CUSTOM_GETTER(jsX509CertificateGetter_ca, (JSGlobalObject * globalObject, EncodedJSValue thisValue, PropertyName))
+{
+    VM& vm = globalObject->vm();
+    auto scope = DECLARE_THROW_SCOPE(vm);
+
+    JSX509Certificate* thisObject = jsDynamicCast<JSX509Certificate*>(JSValue::decode(thisValue));
+    if (UNLIKELY(!thisObject)) {
+        Bun::throwThisTypeError(*globalObject, scope, "JSX509Certificate"_s, "ca"_s);
+        return {};
+    }
+
+    return JSValue::encode(jsBoolean(thisObject->view().isCA()));
+}
+```
+
+### Setter definition
+
+```C++
+JSC_DEFINE_CUSTOM_SETTER(jsImportMetaObjectSetter_require, (JSGlobalObject * jsGlobalObject, JSC::EncodedJSValue thisValue, JSC::EncodedJSValue encodedValue, PropertyName propertyName))
+{
+    ImportMetaObject* thisObject = jsDynamicCast<ImportMetaObject*>(JSValue::decode(thisValue));
+    if (UNLIKELY(!thisObject))
+        return false;
+
+    JSValue value = JSValue::decode(encodedValue);
+    if (!value.isCell()) {
+        // TODO:
+        return true;
+    }
+
+    thisObject->requireProperty.set(thisObject->vm(), thisObject, value.asCell());
+    return true;
+}
+```
+
+### Function definition
+
+```C++
+JSC_DEFINE_HOST_FUNCTION(jsX509CertificateProtoFuncToJSON, (JSGlobalObject * globalObject, CallFrame* callFrame))
+{
+    VM& vm = globalObject->vm();
+    auto scope = DECLARE_THROW_SCOPE(vm);
+    auto *thisObject = jsDynamicCast<MyClassT*>(callFrame->thisValue());
+     if (UNLIKELY(!thisObject)) {
+        Bun::throwThisTypeError(*globalObject, scope, "MyClass"_s, "myFunctionName"_s);
+        return {};
+    }
+
+    return JSValue::encode(functionThatReturnsJSValue(vm, globalObject, thisObject));
+}
+```
+
+### Constructor definition
+
+```C++
+
+JSC_DECLARE_HOST_FUNCTION(callStats);
+JSC_DECLARE_HOST_FUNCTION(constructStats);
+
+class JSStatsConstructor final : public JSC::InternalFunction {
+public:
+    using Base = JSC::InternalFunction;
+    static constexpr unsigned StructureFlags = Base::StructureFlags;
+
+    static JSStatsConstructor* create(JSC::VM& vm, JSC::Structure* structure, JSC::JSObject* prototype)
+    {
+        JSStatsConstructor* constructor = new (NotNull, JSC::allocateCell<JSStatsConstructor>(vm)) JSStatsConstructor(vm, structure);
+        constructor->finishCreation(vm, prototype);
+        return constructor;
+    }
+
+    DECLARE_INFO;
+
+    template<typename CellType, JSC::SubspaceAccess>
+    static JSC::GCClient::IsoSubspace* subspaceFor(JSC::VM& vm)
+    {
+        return &vm.internalFunctionSpace();
+    }
+
+    static JSC::Structure* createStructure(JSC::VM& vm, JSC::JSGlobalObject* globalObject, JSC::JSValue prototype)
+    {
+        return JSC::Structure::create(vm, globalObject, prototype, JSC::TypeInfo(JSC::InternalFunctionType, StructureFlags), info());
+    }
+
+private:
+    JSStatsConstructor(JSC::VM& vm, JSC::Structure* structure)
+        : Base(vm, structure, callStats, constructStats)
+    {
+    }
+
+    void finishCreation(JSC::VM& vm, JSC::JSObject* prototype)
+    {
+        Base::finishCreation(vm, 0, "Stats"_s);
+        putDirectWithoutTransition(vm, vm.propertyNames->prototype, prototype, JSC::PropertyAttribute::DontEnum | JSC::PropertyAttribute::DontDelete | JSC::PropertyAttribute::ReadOnly);
+    }
+};
+```
+
+### Structure caching
+
+If there's a class, prototype, and constructor:
+
+1. Add the `JSC::LazyClassStructure` to [ZigGlobalObject.h](mdc:src/bun.js/bindings/ZigGlobalObject.h)
+2. Initialize the class structure in [ZigGlobalObject.cpp](mdc:src/bun.js/bindings/ZigGlobalObject.cpp) in `void GlobalObject::finishCreation(VM& vm)`
+3. Visit the class structure in visitChildren in [ZigGlobalObject.cpp](mdc:src/bun.js/bindings/ZigGlobalObject.cpp) in `void GlobalObject::visitChildrenImpl`
+
+```c++#ZigGlobalObject.cpp
+void GlobalObject::finishCreation(VM& vm) {
+// ...
+    m_JSStatsBigIntClassStructure.initLater(
+        [](LazyClassStructure::Initializer& init) {
+            // Call the function to initialize our class structure.
+            Bun::initJSBigIntStatsClassStructure(init);
+        });
+```
+
+Then, implement the function that creates the structure:
+
+```c++
+void setupX509CertificateClassStructure(LazyClassStructure::Initializer& init)
+{
+    auto* prototypeStructure = JSX509CertificatePrototype::createStructure(init.vm, init.global, init.global->objectPrototype());
+    auto* prototype = JSX509CertificatePrototype::create(init.vm, init.global, prototypeStructure);
+
+    auto* constructorStructure = JSX509CertificateConstructor::createStructure(init.vm, init.global, init.global->functionPrototype());
+
+    auto* constructor = JSX509CertificateConstructor::create(init.vm, init.global, constructorStructure, prototype);
+
+    auto* structure = JSX509Certificate::createStructure(init.vm, init.global, prototype);
+    init.setPrototype(prototype);
+    init.setStructure(structure);
+    init.setConstructor(constructor);
+}
+```
+
+If there's only a class, use `JSC::LazyProperty<JSGlobalObject, Structure>` instead of `JSC::LazyClassStructure`:
+
+1. Add the `JSC::LazyProperty<JSGlobalObject, Structure>` to @ZigGlobalObject.h
+2. Initialize the class structure in @ZigGlobalObject.cpp in `void GlobalObject::finishCreation(VM& vm)`
+3. Visit the lazy property in visitChildren in @ZigGlobalObject.cpp in `void GlobalObject::visitChildrenImpl`
+   void GlobalObject::finishCreation(VM& vm) {
+   // ...
+   this.m_myLazyProperty.initLater([](const JSC::LazyProperty<JSC::JSGlobalObject, JSC::Structure>::Initializer& init) {
+   init.set(Bun::initMyStructure(init.vm, reinterpret_cast<Zig::GlobalObject\*>(init.owner)));
+   });
+
+```
+
+Then, implement the function that creates the structure:
+```c++
+Structure* setupX509CertificateStructure(JSC::VM &vm, Zig::GlobalObject* globalObject)
+{
+    // If there is a prototype:
+    auto* prototypeStructure = JSX509CertificatePrototype::createStructure(init.vm, init.global, init.global->objectPrototype());
+    auto* prototype = JSX509CertificatePrototype::create(init.vm, init.global, prototypeStructure);
+
+    // If there is no prototype or it only has
+
+    auto* structure = JSX509Certificate::createStructure(init.vm, init.global, prototype);
+    init.setPrototype(prototype);
+    init.setStructure(structure);
+    init.setConstructor(constructor);
+}
+```
+
+Then, use the structure by calling `globalObject.m_myStructureName.get(globalObject)`
+
+```C++
+JSC_DEFINE_HOST_FUNCTION(x509CertificateConstructorConstruct, (JSGlobalObject * globalObject, CallFrame* callFrame))
+{
+    VM& vm = globalObject->vm();
+    auto scope = DECLARE_THROW_SCOPE(vm);
+
+    if (!callFrame->argumentCount()) {
+        Bun::throwError(globalObject, scope, ErrorCode::ERR_MISSING_ARGS, "X509Certificate constructor requires at least one argument"_s);
+        return {};
+    }
+
+    JSValue arg = callFrame->uncheckedArgument(0);
+    if (!arg.isCell()) {
+        Bun::throwError(globalObject, scope, ErrorCode::ERR_INVALID_ARG_TYPE, "X509Certificate constructor argument must be a Buffer, TypedArray, or string"_s);
+        return {};
+    }
+
+    auto* zigGlobalObject = defaultGlobalObject(globalObject);
+    Structure* structure = zigGlobalObject->m_JSX509CertificateClassStructure.get(zigGlobalObject);
+    JSValue newTarget = callFrame->newTarget();
+    if (UNLIKELY(zigGlobalObject->m_JSX509CertificateClassStructure.constructor(zigGlobalObject) != newTarget)) {
+        auto scope = DECLARE_THROW_SCOPE(vm);
+        if (!newTarget) {
+            throwTypeError(globalObject, scope, "Class constructor X509Certificate cannot be invoked without 'new'"_s);
+            return {};
+        }
+
+        auto* functionGlobalObject = defaultGlobalObject(getFunctionRealm(globalObject, newTarget.getObject()));
+        RETURN_IF_EXCEPTION(scope, {});
+        structure = InternalFunction::createSubclassStructure(globalObject, newTarget.getObject(), functionGlobalObject->NodeVMScriptStructure());
+        RETURN_IF_EXCEPTION(scope, {});
+    }
+
+    return JSValue::encode(createX509Certificate(vm, globalObject, structure, arg));
+}
+```
+
+### Expose to Zig
+
+To expose the constructor to zig:
+
+```c++
+extern "C" JSC::EncodedJSValue Bun__JSBigIntStatsObjectConstructor(Zig::GlobalObject* globalobject)
+{
+    return JSValue::encode(globalobject->m_JSStatsBigIntClassStructure.constructor(globalobject));
+}
+```
+
+Zig:
+
+```zig
+extern "c" fn Bun__JSBigIntStatsObjectConstructor(*JSC.JSGlobalObject) JSC.JSValue;
+pub const getBigIntStatsConstructor =  Bun__JSBigIntStatsObjectConstructor;
+```
+
+To create an object (instance) of a JS class defined in C++ from Zig, follow the \_\_toJS convention like this:
+
+```c++
+// X509* is whatever we need to create the object
+extern "C" EncodedJSValue Bun__X509__toJS(Zig::GlobalObject* globalObject, X509* cert)
+{
+    // ... implementation details
+    auto* structure = globalObject->m_JSX509CertificateClassStructure.get(globalObject);
+    return JSValue::encode(JSX509Certificate::create(globalObject->vm(), structure, globalObject, WTFMove(cert)));
+}
+```
+
+And from Zig:
+
+```zig
+const X509 = opaque {
+    // ... class
+
+    extern fn Bun__X509__toJS(*JSC.JSGlobalObject, *X509) JSC.JSValue;
+
+    pub fn toJS(this: *X509, globalObject: *JSC.JSGlobalObject) JSC.JSValue {
+        return Bun__X509__toJS(globalObject, this);
+    }
+};
+```

.cursor/rules/registering-bun-modules.mdc

@@ -0,0 +1,203 @@
+# Registering Functions, Objects, and Modules in Bun
+
+This guide documents the process of adding new functionality to the Bun global object and runtime.
+
+## Overview
+
+Bun's architecture exposes functionality to JavaScript through a set of carefully registered functions, objects, and modules. Most core functionality is implemented in Zig, with JavaScript bindings that make these features accessible to users.
+
+There are several key ways to expose functionality in Bun:
+
+1. **Global Functions**: Direct methods on the `Bun` object (e.g., `Bun.serve()`)
+2. **Getter Properties**: Lazily initialized properties on the `Bun` object (e.g., `Bun.sqlite`)
+3. **Constructor Classes**: Classes available through the `Bun` object (e.g., `Bun.ValkeyClient`)
+4. **Global Modules**: Modules that can be imported directly (e.g., `import {X} from "bun:*"`)
+
+## The Registration Process
+
+Adding new functionality to Bun involves several coordinated steps across multiple files:
+
+### 1. Implement the Core Functionality in Zig
+
+First, implement your feature in Zig, typically in its own directory in `src/`. Examples:
+
+- `src/valkey/` for Redis/Valkey client
+- `src/semver/` for SemVer functionality
+- `src/smtp/` for SMTP client
+
+### 2. Create JavaScript Bindings
+
+Create bindings that expose your Zig functionality to JavaScript:
+
+- Create a class definition file (e.g., `js_bindings.classes.ts`) to define the JavaScript interface
+- Implement `JSYourFeature` struct in a file like `js_your_feature.zig`
+
+Example from a class definition file:
+
+```typescript
+// Example from a .classes.ts file
+import { define } from "../../codegen/class-definitions";
+
+export default [
+  define({
+    name: "YourFeature",
+    construct: true,
+    finalize: true,
+    hasPendingActivity: true,
+    memoryCost: true,
+    klass: {},
+    JSType: "0b11101110",
+    proto: {
+      yourMethod: {
+        fn: "yourZigMethod",
+        length: 1,
+      },
+      property: {
+        getter: "getProperty",
+      },
+    },
+    values: ["cachedValues"],
+  }),
+];
+```
+
+### 3. Register with BunObject in `src/bun.js/bindings/BunObject+exports.h`
+
+Add an entry to the `FOR_EACH_GETTER` macro:
+
+```c
+// In BunObject+exports.h
+#define FOR_EACH_GETTER(macro) \
+    macro(CSRF) \
+    macro(CryptoHasher) \
+    ... \
+    macro(YourFeature) \
+```
+
+### 4. Create a Getter Function in `src/bun.js/api/BunObject.zig`
+
+Implement a getter function in `BunObject.zig` that returns your feature:
+
+```zig
+// In BunObject.zig
+pub const YourFeature = toJSGetter(Bun.getYourFeatureConstructor);
+
+// In the exportAll() function:
+@export(&BunObject.YourFeature, .{ .name = getterName("YourFeature") });
+```
+
+### 5. Implement the Getter Function in a Relevant Zig File
+
+Implement the function that creates your object:
+
+```zig
+// In your main module file (e.g., src/your_feature/your_feature.zig)
+pub fn getYourFeatureConstructor(globalThis: *JSC.JSGlobalObject, _: *JSC.JSObject) JSC.JSValue {
+    return JSC.API.YourFeature.getConstructor(globalThis);
+}
+```
+
+### 6. Add to Build System
+
+Ensure your files are included in the build system by adding them to the appropriate targets.
+
+## Example: Adding a New Module
+
+Here's a comprehensive example of adding a hypothetical SMTP module:
+
+1. Create implementation files in `src/smtp/`:
+
+   - `index.zig`: Main entry point that exports everything
+   - `SmtpClient.zig`: Core SMTP client implementation
+   - `js_smtp.zig`: JavaScript bindings
+   - `js_bindings.classes.ts`: Class definition
+
+2. Define your JS class in `js_bindings.classes.ts`:
+
+```typescript
+import { define } from "../../codegen/class-definitions";
+
+export default [
+  define({
+    name: "EmailClient",
+    construct: true,
+    finalize: true,
+    hasPendingActivity: true,
+    configurable: false,
+    memoryCost: true,
+    klass: {},
+    JSType: "0b11101110",
+    proto: {
+      send: {
+        fn: "send",
+        length: 1,
+      },
+      verify: {
+        fn: "verify",
+        length: 0,
+      },
+      close: {
+        fn: "close",
+        length: 0,
+      },
+    },
+    values: ["connectionPromise"],
+  }),
+];
+```
+
+3. Add getter to `BunObject+exports.h`:
+
+```c
+#define FOR_EACH_GETTER(macro) \
+    macro(CSRF) \
+    ... \
+    macro(SMTP) \
+```
+
+4. Add getter function to `BunObject.zig`:
+
+```zig
+pub const SMTP = toJSGetter(Bun.getSmtpConstructor);
+
+// In exportAll:
+@export(&BunObject.SMTP, .{ .name = getterName("SMTP") });
+```
+
+5. Implement getter in your module:
+
+```zig
+pub fn getSmtpConstructor(globalThis: *JSC.JSGlobalObject, _: *JSC.JSObject) JSC.JSValue {
+    return JSC.API.JSEmailClient.getConstructor(globalThis);
+}
+```
+
+## Best Practices
+
+1. **Follow Naming Conventions**: Align your naming with existing patterns
+2. **Reference Existing Modules**: Study similar modules like Valkey or S3Client for guidance
+3. **Memory Management**: Be careful with memory management and reference counting
+4. **Error Handling**: Use `bun.JSError!JSValue` for proper error propagation
+5. **Documentation**: Add JSDoc comments to your JavaScript bindings
+6. **Testing**: Add tests for your new functionality
+
+## Common Gotchas
+
+- Be sure to handle reference counting properly with `ref()`/`deref()`
+- Always implement proper cleanup in `deinit()` and `finalize()`
+- For network operations, manage socket lifetimes correctly
+- Use `JSC.Codegen` correctly to generate necessary binding code
+
+## Related Files
+
+- `src/bun.js/bindings/BunObject+exports.h`: Registration of getters and functions
+- `src/bun.js/api/BunObject.zig`: Implementation of getters and object creation
+- `src/bun.js/api/BunObject.classes.ts`: Class definitions
+- `.cursor/rules/zig-javascriptcore-classes.mdc`: More details on class bindings
+
+## Additional Resources
+
+For more detailed information on specific topics:
+
+- See `zig-javascriptcore-classes.mdc` for details on creating JS class bindings
+- Review existing modules like `valkey`, `sqlite`, or `s3` for real-world examples

.cursor/rules/writing-tests.mdc

@@ -0,0 +1,91 @@
+---
+description: Writing tests for Bun
+globs: 
+---
+# Writing tests for Bun
+
+## Where tests are found
+
+You'll find all of Bun's tests in the `test/` directory.
+
+* `test/`
+  * `cli/` - CLI command tests, like `bun install` or `bun init`
+  * `js/` - JavaScript & TypeScript tests
+    * `bun/` - `Bun` APIs tests, separated by category, for example: `glob/` for `Bun.Glob` tests
+    * `node/` - Node.js module tests, separated by module, for example: `assert/` for `node:assert` tests
+      * `test/` - Vendored Node.js tests, taken from the Node.js repository (does not conform to Bun's test style)
+    * `web/` - Web API tests, separated by category, for example: `fetch/` for `Request` and `Response` tests
+    * `third_party/` - npm package tests, to validate that basic usage works in Bun
+  * `napi/` - N-API tests
+  * `v8/` - V8 C++ API tests
+  * `bundler/` - Bundler, transpiler, CSS, and `bun build` tests
+  * `regression/issue/[number]` - Regression tests, always make one when fixing a particular issue
+
+## How tests are written
+
+Bun's tests are written as JavaScript and TypeScript files with the Jest-style APIs, like `test`, `describe`, and `expect`. They are tested using Bun's own test runner, `bun test`. 
+
+```js
+import { describe, test, expect } from "bun:test";
+import assert, { AssertionError } from "assert";
+
+describe("assert(expr)", () => {
+  test.each([true, 1, "foo"])(`assert(%p) does not throw`, expr => {
+    expect(() => assert(expr)).not.toThrow();
+  });
+
+  test.each([false, 0, "", null, undefined])(`assert(%p) throws`, expr => {
+    expect(() => assert(expr)).toThrow(AssertionError);
+  });
+});
+```
+
+## Testing conventions
+
+* See `test/harness.ts` for common test utilities and helpers
+* Be rigorous and test for edge-cases and unexpected inputs
+* Use data-driven tests, e.g. `test.each`, to reduce boilerplate when possible
+* When you need to test Bun as a CLI, use the following pattern:
+
+```js
+import { test, expect } from "bun:test";
+import { spawn } from "bun";
+import { bunExe, bunEnv } from "harness";
+
+test("bun --version", async () => {
+  const { exited, stdout: stdoutStream, stderr: stderrStream } = spawn({
+    cmd: [bunExe(), "--version"],
+    env: bunEnv,
+    stdout: "pipe",
+    stderr: "pipe",
+  });
+  const [ exitCode, stdout, stderr ] = await Promise.all([
+    exited,
+    new Response(stdoutStream).text(),
+    new Response(stderrStream).text(),
+  ]);
+  expect({ exitCode, stdout, stderr }).toMatchObject({
+    exitCode: 0,
+    stdout: expect.stringContaining(Bun.version),
+    stderr: "",
+  });
+});
+```
+
+## Before writing a test
+
+* If you are fixing a bug, write the test first and make sure it fails (as expected) with the canary version of Bun
+* If you are fixing a Node.js compatibility bug, create a throw-away snippet of code and test that it works as you expect in Node.js, then that it fails (as expected) with the canary version of Bun
+* When the expected behaviour is ambigious, defer to matching what happens in Node.js
+* Always attempt to find related tests in an existing test file before creating a new test file
+
+
+
+
+
+
+
+
+
+
+

.cursor/rules/zig-javascriptcore-classes.mdc

@@ -0,0 +1,509 @@
+---
+description: How Zig works with JavaScriptCore bindings generator
+globs:
+alwaysApply: false
+---
+
+# Bun's JavaScriptCore Class Bindings Generator
+
+This document explains how Bun's class bindings generator works to bridge Zig and JavaScript code through JavaScriptCore (JSC).
+
+## Architecture Overview
+
+Bun's binding system creates a seamless bridge between JavaScript and Zig, allowing Zig implementations to be exposed as JavaScript classes. The system has several key components:
+
+1. **Zig Implementation** (.zig files)
+2. **JavaScript Interface Definition** (.classes.ts files)
+3. **Generated Code** (C++/Zig files that connect everything)
+
+## Class Definition Files
+
+### JavaScript Interface (.classes.ts)
+
+The `.classes.ts` files define the JavaScript API using a declarative approach:
+
+```typescript
+// Example: encoding.classes.ts
+define({
+  name: "TextDecoder",
+  constructor: true,
+  JSType: "object",
+  finalize: true,
+  proto: {
+    decode: {
+      // Function definition
+      args: 1,
+    },
+    encoding: {
+      // Getter with caching
+      getter: true,
+      cache: true,
+    },
+    fatal: {
+      // Read-only property
+      getter: true,
+    },
+    ignoreBOM: {
+      // Read-only property
+      getter: true,
+    },
+  },
+});
+```
+
+Each class definition specifies:
+
+- The class name
+- Whether it has a constructor
+- JavaScript type (object, function, etc.)
+- Properties and methods in the `proto` field
+- Caching strategy for properties
+- Finalization requirements
+
+### Zig Implementation (.zig)
+
+The Zig files implement the native functionality:
+
+```zig
+// Example: TextDecoder.zig
+pub const TextDecoder = struct {
+    // Expose generated bindings as `js` namespace with trait conversion methods
+    pub const js = JSC.Codegen.JSTextDecoder;
+    pub const toJS = js.toJS;
+    pub const fromJS = js.fromJS;
+    pub const fromJSDirect = js.fromJSDirect;
+
+    // Internal state
+    encoding: []const u8,
+    fatal: bool,
+    ignoreBOM: bool,
+
+    // Constructor implementation - note use of globalObject
+    pub fn constructor(
+        globalObject: *JSGlobalObject,
+        callFrame: *JSC.CallFrame,
+    ) bun.JSError!*TextDecoder {
+        // Implementation
+
+        return bun.new(TextDecoder, .{
+            // Fields
+        });
+    }
+
+    // Prototype methods - note return type includes JSError
+    pub fn decode(
+        this: *TextDecoder,
+        globalObject: *JSGlobalObject,
+        callFrame: *JSC.CallFrame,
+    ) bun.JSError!JSC.JSValue {
+        // Implementation
+    }
+
+    // Getters
+    pub fn getEncoding(this: *TextDecoder, globalObject: *JSGlobalObject) JSC.JSValue {
+        return JSC.JSValue.createStringFromUTF8(globalObject, this.encoding);
+    }
+
+    pub fn getFatal(this: *TextDecoder, globalObject: *JSGlobalObject) JSC.JSValue {
+        return JSC.JSValue.jsBoolean(this.fatal);
+    }
+
+    // Cleanup - note standard pattern of using deinit/deref
+    fn deinit(this: *TextDecoder) void {
+        // Release any retained resources
+        // Free the pointer at the end.
+        bun.destroy(this);
+    }
+
+    // Finalize - called by JS garbage collector. This should call deinit, or deref if reference counted.
+    pub fn finalize(this: *TextDecoder) void {
+        this.deinit();
+    }
+};
+```
+
+Key components in the Zig file:
+
+- The struct containing native state
+- `pub const js = JSC.Codegen.JS<ClassName>` to include generated code
+- Constructor and methods using `bun.JSError!JSValue` return type for proper error handling
+- Consistent use of `globalObject` parameter name instead of `ctx`
+- Methods matching the JavaScript interface
+- Getters/setters for properties
+- Proper resource cleanup pattern with `deinit()` and `finalize()`
+- Update `src/bun.js/bindings/generated_classes_list.zig` to include the new class
+
+## Code Generation System
+
+The binding generator produces C++ code that connects JavaScript and Zig:
+
+1. **JSC Class Structure**: Creates C++ classes for the JS object, prototype, and constructor
+2. **Memory Management**: Handles GC integration through JSC's WriteBarrier
+3. **Method Binding**: Connects JS function calls to Zig implementations
+4. **Type Conversion**: Converts between JS values and Zig types
+5. **Property Caching**: Implements the caching system for properties
+
+The generated C++ code includes:
+
+- A JSC wrapper class (`JSTextDecoder`)
+- A prototype class (`JSTextDecoderPrototype`)
+- A constructor function (`JSTextDecoderConstructor`)
+- Function bindings (`TextDecoderPrototype__decodeCallback`)
+- Property getters/setters (`TextDecoderPrototype__encodingGetterWrap`)
+
+## CallFrame Access
+
+The `CallFrame` object provides access to JavaScript execution context:
+
+```zig
+pub fn decode(
+    this: *TextDecoder,
+    globalObject: *JSGlobalObject,
+    callFrame: *JSC.CallFrame
+) bun.JSError!JSC.JSValue {
+    // Get arguments
+    const input = callFrame.argument(0);
+    const options = callFrame.argument(1);
+
+    // Get this value
+    const thisValue = callFrame.thisValue();
+
+    // Implementation with error handling
+    if (input.isUndefinedOrNull()) {
+        return globalObject.throw("Input cannot be null or undefined", .{});
+    }
+
+    // Return value or throw error
+    return JSC.JSValue.jsString(globalObject, "result");
+}
+```
+
+CallFrame methods include:
+
+- `argument(i)`: Get the i-th argument
+- `argumentCount()`: Get the number of arguments
+- `thisValue()`: Get the `this` value
+- `callee()`: Get the function being called
+
+## Property Caching and GC-Owned Values
+
+The `cache: true` option in property definitions enables JSC's WriteBarrier to efficiently store values:
+
+```typescript
+encoding: {
+  getter: true,
+  cache: true, // Enable caching
+}
+```
+
+### C++ Implementation
+
+In the generated C++ code, caching uses JSC's WriteBarrier:
+
+```cpp
+JSC_DEFINE_CUSTOM_GETTER(TextDecoderPrototype__encodingGetterWrap, (...)) {
+    auto& vm = JSC::getVM(lexicalGlobalObject);
+    Zig::GlobalObject *globalObject = reinterpret_cast<Zig::GlobalObject*>(lexicalGlobalObject);
+    auto throwScope = DECLARE_THROW_SCOPE(vm);
+    JSTextDecoder* thisObject = jsCast<JSTextDecoder*>(JSValue::decode(encodedThisValue));
+    JSC::EnsureStillAliveScope thisArg = JSC::EnsureStillAliveScope(thisObject);
+
+    // Check for cached value and return if present
+    if (JSValue cachedValue = thisObject->m_encoding.get())
+        return JSValue::encode(cachedValue);
+
+    // Get value from Zig implementation
+    JSC::JSValue result = JSC::JSValue::decode(
+        TextDecoderPrototype__getEncoding(thisObject->wrapped(), globalObject)
+    );
+    RETURN_IF_EXCEPTION(throwScope, {});
+
+    // Store in cache for future access
+    thisObject->m_encoding.set(vm, thisObject, result);
+    RELEASE_AND_RETURN(throwScope, JSValue::encode(result));
+}
+```
+
+### Zig Accessor Functions
+
+For each cached property, the generator creates Zig accessor functions that allow Zig code to work with these GC-owned values:
+
+```zig
+// External function declarations
+extern fn TextDecoderPrototype__encodingSetCachedValue(JSC.JSValue, *JSC.JSGlobalObject, JSC.JSValue) callconv(JSC.conv) void;
+extern fn TextDecoderPrototype__encodingGetCachedValue(JSC.JSValue) callconv(JSC.conv) JSC.JSValue;
+
+/// `TextDecoder.encoding` setter
+/// This value will be visited by the garbage collector.
+pub fn encodingSetCached(thisValue: JSC.JSValue, globalObject: *JSC.JSGlobalObject, value: JSC.JSValue) void {
+    JSC.markBinding(@src());
+    TextDecoderPrototype__encodingSetCachedValue(thisValue, globalObject, value);
+}
+
+/// `TextDecoder.encoding` getter
+/// This value will be visited by the garbage collector.
+pub fn encodingGetCached(thisValue: JSC.JSValue) ?JSC.JSValue {
+    JSC.markBinding(@src());
+    const result = TextDecoderPrototype__encodingGetCachedValue(thisValue);
+    if (result == .zero)
+        return null;
+
+    return result;
+}
+```
+
+### Benefits of GC-Owned Values
+
+This system provides several key benefits:
+
+1. **Automatic Memory Management**: The JavaScriptCore GC tracks and manages these values
+2. **Proper Garbage Collection**: The WriteBarrier ensures values are properly visited during GC
+3. **Consistent Access**: Zig code can easily get/set these cached JS values
+4. **Performance**: Cached values avoid repeated computation or serialization
+
+### Use Cases
+
+GC-owned cached values are particularly useful for:
+
+1. **Computed Properties**: Store expensive computation results
+2. **Lazily Created Objects**: Create objects only when needed, then cache them
+3. **References to Other Objects**: Store references to other JS objects that need GC tracking
+4. **Memoization**: Cache results based on input parameters
+
+The WriteBarrier mechanism ensures that any JS values stored in this way are properly tracked by the garbage collector.
+
+## Memory Management and Finalization
+
+The binding system handles memory management across the JavaScript/Zig boundary:
+
+1. **Object Creation**: JavaScript `new TextDecoder()` creates both a JS wrapper and a Zig struct
+2. **Reference Tracking**: JSC's GC tracks all JS references to the object
+3. **Finalization**: When the JS object is collected, the finalizer releases Zig resources
+
+Bun uses a consistent pattern for resource cleanup:
+
+```zig
+// Resource cleanup method - separate from finalization
+pub fn deinit(this: *TextDecoder) void {
+    // Release resources like strings
+    this._encoding.deref(); // String deref pattern
+
+    // Free any buffers
+    if (this.buffer) |buffer| {
+        bun.default_allocator.free(buffer);
+    }
+}
+
+// Called by the GC when object is collected
+pub fn finalize(this: *TextDecoder) void {
+    JSC.markBinding(@src()); // For debugging
+    this.deinit(); // Clean up resources
+    bun.default_allocator.destroy(this); // Free the object itself
+}
+```
+
+Some objects that hold references to other JS objects use `.deref()` instead:
+
+```zig
+pub fn finalize(this: *SocketAddress) void {
+    JSC.markBinding(@src());
+    this._presentation.deref(); // Release references
+    this.destroy();
+}
+```
+
+## Error Handling with JSError
+
+Bun uses `bun.JSError!JSValue` return type for proper error handling:
+
+```zig
+pub fn decode(
+    this: *TextDecoder,
+    globalObject: *JSGlobalObject,
+    callFrame: *JSC.CallFrame
+) bun.JSError!JSC.JSValue {
+    // Throwing an error
+    if (callFrame.argumentCount() < 1) {
+        return globalObject.throw("Missing required argument", .{});
+    }
+
+    // Or returning a success value
+    return JSC.JSValue.jsString(globalObject, "Success!");
+}
+```
+
+This pattern allows Zig functions to:
+
+1. Return JavaScript values on success
+2. Throw JavaScript exceptions on error
+3. Propagate errors automatically through the call stack
+
+## Type Safety and Error Handling
+
+The binding system includes robust error handling:
+
+```cpp
+// Example of type checking in generated code
+JSTextDecoder* thisObject = jsDynamicCast<JSTextDecoder*>(callFrame->thisValue());
+if (UNLIKELY(!thisObject)) {
+    scope.throwException(lexicalGlobalObject,
+        Bun::createInvalidThisError(lexicalGlobalObject, callFrame->thisValue(), "TextDecoder"_s));
+    return {};
+}
+```
+
+## Prototypal Inheritance
+
+The binding system creates proper JavaScript prototype chains:
+
+1. **Constructor**: JSTextDecoderConstructor with standard .prototype property
+2. **Prototype**: JSTextDecoderPrototype with methods and properties
+3. **Instances**: Each JSTextDecoder instance with **proto** pointing to prototype
+
+This ensures JavaScript inheritance works as expected:
+
+```cpp
+// From generated code
+void JSTextDecoderConstructor::finishCreation(VM& vm, JSC::JSGlobalObject* globalObject, JSTextDecoderPrototype* prototype)
+{
+    Base::finishCreation(vm, 0, "TextDecoder"_s, PropertyAdditionMode::WithoutStructureTransition);
+
+    // Set up the prototype chain
+    putDirectWithoutTransition(vm, vm.propertyNames->prototype, prototype, PropertyAttribute::DontEnum | PropertyAttribute::DontDelete | PropertyAttribute::ReadOnly);
+    ASSERT(inherits(info()));
+}
+```
+
+## Performance Considerations
+
+The binding system is optimized for performance:
+
+1. **Direct Pointer Access**: JavaScript objects maintain a direct pointer to Zig objects
+2. **Property Caching**: WriteBarrier caching avoids repeated native calls for stable properties
+3. **Memory Management**: JSC garbage collection integrated with Zig memory management
+4. **Type Conversion**: Fast paths for common JavaScript/Zig type conversions
+
+## Creating a New Class Binding
+
+To create a new class binding in Bun:
+
+1. **Define the class interface** in a `.classes.ts` file:
+
+   ```typescript
+   define({
+     name: "MyClass",
+     constructor: true,
+     finalize: true,
+     proto: {
+       myMethod: {
+         args: 1,
+       },
+       myProperty: {
+         getter: true,
+         cache: true,
+       },
+     },
+   });
+   ```
+
+2. **Implement the native functionality** in a `.zig` file:
+
+   ```zig
+   pub const MyClass = struct {
+       // Generated bindings
+       pub const js = JSC.Codegen.JSMyClass;
+       pub const toJS = js.toJS;
+       pub const fromJS = js.fromJS;
+       pub const fromJSDirect = js.fromJSDirect;
+
+       // State
+       value: []const u8,
+
+       pub const new = bun.TrivialNew(@This());
+
+       // Constructor
+       pub fn constructor(
+           globalObject: *JSGlobalObject,
+           callFrame: *JSC.CallFrame,
+       ) bun.JSError!*MyClass {
+           const arg = callFrame.argument(0);
+           // Implementation
+       }
+
+       // Method
+       pub fn myMethod(
+           this: *MyClass,
+           globalObject: *JSGlobalObject,
+           callFrame: *JSC.CallFrame,
+       ) bun.JSError!JSC.JSValue {
+           // Implementation
+       }
+
+       // Getter
+       pub fn getMyProperty(this: *MyClass, globalObject: *JSGlobalObject) JSC.JSValue {
+           return JSC.JSValue.jsString(globalObject, this.value);
+       }
+
+       // Resource cleanup
+       pub fn deinit(this: *MyClass) void {
+           // Clean up resources
+       }
+
+       pub fn finalize(this: *MyClass) void {
+           this.deinit();
+           bun.destroy(this);
+       }
+   };
+   ```
+
+3. **The binding generator** creates all necessary C++ and Zig glue code to connect JavaScript and Zig, including:
+   - C++ class definitions
+   - Method and property bindings
+   - Memory management utilities
+   - GC integration code
+
+## Generated Code Structure
+
+The binding generator produces several components:
+
+### 1. C++ Classes
+
+For each Zig class, the system generates:
+
+- **JS<Class>**: Main wrapper that holds a pointer to the Zig object (`JSTextDecoder`)
+- **JS<Class>Prototype**: Contains methods and properties (`JSTextDecoderPrototype`)
+- **JS<Class>Constructor**: Implementation of the JavaScript constructor (`JSTextDecoderConstructor`)
+
+### 2. C++ Methods and Properties
+
+- **Method Callbacks**: `TextDecoderPrototype__decodeCallback`
+- **Property Getters/Setters**: `TextDecoderPrototype__encodingGetterWrap`
+- **Initialization Functions**: `finishCreation` methods for setting up the class
+
+### 3. Zig Bindings
+
+- **External Function Declarations**:
+
+  ```zig
+  extern fn TextDecoderPrototype__decode(*TextDecoder, *JSC.JSGlobalObject, *JSC.CallFrame) callconv(JSC.conv) JSC.EncodedJSValue;
+  ```
+
+- **Cached Value Accessors**:
+
+  ```zig
+  pub fn encodingGetCached(thisValue: JSC.JSValue) ?JSC.JSValue { ... }
+  pub fn encodingSetCached(thisValue: JSC.JSValue, globalObject: *JSC.JSGlobalObject, value: JSC.JSValue) void { ... }
+  ```
+
+- **Constructor Helpers**:
+  ```zig
+  pub fn create(globalObject: *JSC.JSGlobalObject) bun.JSError!JSC.JSValue { ... }
+  ```
+
+### 4. GC Integration
+
+- **Memory Cost Calculation**: `estimatedSize` method
+- **Child Visitor Methods**: `visitChildrenImpl` and `visitAdditionalChildren`
+- **Heap Analysis**: `analyzeHeap` for debugging memory issues
+
+This architecture makes it possible to implement high-performance native functionality in Zig while exposing a clean, idiomatic JavaScript API to users.

.github/workflows/codex-test-sync.yml

@@ -0,0 +1,58 @@
+name: Codex Test Sync
+
+on:
+  pull_request:
+    types: [labeled, opened]
+
+env:
+  BUN_VERSION: "1.2.15"
+
+jobs:
+  sync-node-tests:
+    runs-on: ubuntu-latest
+    if: |
+      (github.event.action == 'labeled' && github.event.label.name == 'codex') ||
+      (github.event.action == 'opened' && contains(github.event.pull_request.labels.*.name, 'codex')) ||
+      contains(github.head_ref, 'codex')
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          fetch-depth: 0
+
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: ${{ env.BUN_VERSION }}
+
+      - name: Get changed files
+        id: changed-files
+        uses: tj-actions/changed-files@v44
+        with:
+          files: |
+            test/js/node/test/parallel/**/*.{js,mjs,ts}
+            test/js/node/test/sequential/**/*.{js,mjs,ts}
+
+      - name: Sync tests
+        if: steps.changed-files.outputs.any_changed == 'true'
+        shell: bash
+        run: |
+          echo "Changed test files:"
+          echo "${{ steps.changed-files.outputs.all_changed_files }}"
+
+          # Process each changed test file
+          for file in ${{ steps.changed-files.outputs.all_changed_files }}; do
+            # Extract test name from file path
+            test_name=$(basename "$file" | sed 's/\.[^.]*$//')
+            echo "Syncing test: $test_name"
+            bun node:test:cp "$test_name"
+          done
+
+      - name: Commit changes
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "Sync Node.js tests with upstream"

.gitignore

@@ -9,7 +9,6 @@
 .ninja_deps
 .ninja_log
 .npm
-.npmrc
 .npm.gz
 .parcel-cache
 .swcrc

CMakeLists.txt

@@ -47,7 +47,15 @@ include(SetupEsbuild)
 include(SetupZig)
 include(SetupRust)
 
-include(SetupCcache)
+find_program(SCCACHE_PROGRAM sccache)
+if(SCCACHE_PROGRAM AND NOT DEFINED ENV{NO_SCCACHE})
+  include(SetupSccache)
+else()
+  find_program(CCACHE_PROGRAM ccache)
+  if(CCACHE_PROGRAM)
+    include(SetupCcache)
+  endif()
+endif()
 
 # Generate dependency versions header
 include(GenerateDependencyVersions)

CONTRIBUTING.md

@@ -23,7 +23,7 @@ Using your system's package manager, install Bun's dependencies:
 {% codetabs group="os" %}
 
 ```bash#macOS (Homebrew)
-$ brew install automake ccache cmake coreutils gnu-sed go icu4c libiconv libtool ninja pkg-config rust ruby
+$ brew install automake cmake coreutils gnu-sed go icu4c libiconv libtool ninja pkg-config rust ruby sccache
 ```
 
 ```bash#Ubuntu/Debian
@@ -65,28 +65,43 @@ $ brew install bun
 
 {% /codetabs %}
 
-### Optional: Install `ccache`
+### Optional: Install `sccache`
 
-ccache is used to cache compilation artifacts, significantly speeding up builds:
+sccache is used to cache compilation artifacts, significantly speeding up builds. It must be installed with S3 support:
 
 ```bash
 # For macOS
-$ brew install ccache
+$ brew install sccache
 
-# For Ubuntu/Debian
-$ sudo apt install ccache
-
-# For Arch
-$ sudo pacman -S ccache
-
-# For Fedora
-$ sudo dnf install ccache
-
-# For openSUSE
-$ sudo zypper install ccache
+# For Linux. Note that the version in your package manager may not have S3 support.
+$ cargo install sccache --features=s3
 ```
 
-Our build scripts will automatically detect and use `ccache` if available. You can check cache statistics with `ccache --show-stats`.
+This will install `sccache` with S3 support. Our build scripts will automatically detect and use `sccache` with our shared S3 cache. **Note**: Not all versions of `sccache` are compiled with S3 support, hence we recommend installing it via `cargo`.
+
+#### Registering AWS Credentials for `sccache` (Core Developers Only)
+
+Core developers have write access to the shared S3 cache. To enable write access, you must log in with AWS credentials. The easiest way to do this is to use the [`aws` CLI](https://aws.amazon.com/cli/) and invoke [`aws configure` to provide your AWS security info](https://docs.aws.amazon.com/cli/latest/reference/configure/).
+
+The `cmake` scripts should automatically detect your AWS credentials from the environment or the `~/.aws/credentials` file.
+
+<details>
+    <summary>Logging in to the `aws` CLI</summary>
+
+    1. Install the AWS CLI by following [the official guide](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
+    2. Log in to your AWS account console. A team member should provide you with your credentials.
+    3. Click your name in the top right > Security credentials.
+    4. Scroll to "Access keys" and create a new access key.
+    5. Run `aws configure` in your terminal and provide the access key ID and secret access key when prompted.
+</details>
+
+<details>
+    <summary>Common Issues You May Encounter</summary>
+
+    - To confirm that the cache is being used, you can use the `sccache --show-stats` command right after a build. This will expose very useful statistics, including cache hits/misses.
+    - If you have multiple AWS profiles configured, ensure that the correct profile is set in the `AWS_PROFILE` environment variable.
+    - `sccache` follows a server-client model. If you run into weird issues where `sccache` refuses to use S3, even though you have AWS credentials configured, try killing any running `sccache` servers with `sccache --stop-server` and then re-running the build.
+</details>
 
 ## Install LLVM
 

LATEST

@@ -1 +1 @@
-1.3.5
+1.3.4

bench/bun.lock

@@ -23,7 +23,6 @@
         "react-dom": "^18.3.1",
         "string-width": "7.1.0",
         "strip-ansi": "^7.1.0",
-        "tar": "^7.4.3",
         "tinycolor2": "^1.6.0",
         "zx": "^7.2.3",
       },
@@ -109,8 +108,6 @@
 
     "@fastify/proxy-addr": ["@fastify/proxy-addr@5.0.0", "", { "dependencies": { "@fastify/forwarded": "^3.0.0", "ipaddr.js": "^2.1.0" } }, "sha512-37qVVA1qZ5sgH7KpHkkC4z9SK6StIsIcOmpjvMPXNb3vx2GQxhZocogVYbr2PbbeLCQxYIPDok307xEvRZOzGA=="],
 
-    "@isaacs/fs-minipass": ["@isaacs/fs-minipass@4.0.1", "", { "dependencies": { "minipass": "^7.0.4" } }, "sha512-wgm9Ehl2jpeqP3zw/7mo3kRHFp5MEDhqAdwy1fTGkHAwnkGOVsgpvQhL8B5n1qlb01jV3n/bI0ZfZp5lWA1k4w=="],
-
     "@jridgewell/gen-mapping": ["@jridgewell/gen-mapping@0.1.1", "", { "dependencies": { "@jridgewell/set-array": "^1.0.0", "@jridgewell/sourcemap-codec": "^1.4.10" } }, "sha512-sQXCasFk+U8lWYEe66WxRDOE9PjVz4vSM51fTu3Hw+ClTpUSQb718772vH3pyS5pShp6lvQM7SxgIDXXXmOX7w=="],
 
     "@jridgewell/resolve-uri": ["@jridgewell/resolve-uri@3.1.0", "", {}, "sha512-F2msla3tad+Mfht5cJq7LSXcdudKTWCVYUgw6pLFOOHSTtZlj6SWNYAp+AhuqLmWdBO2X5hPrLcu8cVP8fy28w=="],
@@ -185,8 +182,6 @@
 
     "chalk": ["chalk@5.3.0", "", {}, "sha512-dLitG79d+GV1Nb/VYcCDFivJeK1hiukt9QjRNVOsUtTy1rR1YJsmpGGTZ3qJos+uw7WmWF4wUwBd9jxjocFC2w=="],
 
-    "chownr": ["chownr@3.0.0", "", {}, "sha512-+IxzY9BZOQd/XuYPRmrvEVjF/nqj5kgT4kEq7VofrDoM1MxoRjEWkrCC3EtLi59TVawxTAn+orJwFQcrqEN1+g=="],
-
     "color": ["color@4.2.3", "", { "dependencies": { "color-convert": "^2.0.1", "color-string": "^1.9.0" } }, "sha512-1rXeuUUiGGrykh+CeBdu5Ie7OJwinCgQY0bc7GCRxy5xVHy+moaqkpL/jqQq0MtQOeYcrqEz4abc5f0KtU7W4A=="],
 
     "color-convert": ["color-convert@2.0.1", "", { "dependencies": { "color-name": "~1.1.4" } }, "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ=="],
@@ -367,10 +362,6 @@
 
     "minimist": ["minimist@1.2.8", "", {}, "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA=="],
 
-    "minipass": ["minipass@7.1.2", "", {}, "sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw=="],
-
-    "minizlib": ["minizlib@3.1.0", "", { "dependencies": { "minipass": "^7.1.2" } }, "sha512-KZxYo1BUkWD2TVFLr0MQoM8vUUigWD3LlD83a/75BqC+4qE0Hb1Vo5v1FgcfaNXvfXzr+5EhQ6ing/CaBijTlw=="],
-
     "mitata": ["mitata@1.0.25", "", {}, "sha512-0v5qZtVW5vwj9FDvYfraR31BMDcRLkhSFWPTLaxx/Z3/EvScfVtAAWtMI2ArIbBcwh7P86dXh0lQWKiXQPlwYA=="],
 
     "ms": ["ms@2.1.2", "", {}, "sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w=="],
@@ -467,8 +458,6 @@
 
     "supports-color": ["supports-color@5.5.0", "", { "dependencies": { "has-flag": "^3.0.0" } }, "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow=="],
 
-    "tar": ["tar@7.5.2", "", { "dependencies": { "@isaacs/fs-minipass": "^4.0.0", "chownr": "^3.0.0", "minipass": "^7.1.2", "minizlib": "^3.1.0", "yallist": "^5.0.0" } }, "sha512-7NyxrTE4Anh8km8iEy7o0QYPs+0JKBTj5ZaqHg6B39erLg0qYXN3BijtShwbsNSvQ+LN75+KV+C4QR/f6Gwnpg=="],
-
     "thread-stream": ["thread-stream@3.1.0", "", { "dependencies": { "real-require": "^0.2.0" } }, "sha512-OqyPZ9u96VohAyMfJykzmivOrY2wfMSf3C5TtFJVgN+Hm6aj+voFhlK+kZEIv2FBh1X6Xp3DlnCOfEQ3B2J86A=="],
 
     "through": ["through@2.3.8", "", {}, "sha512-w89qg7PI8wAdvX60bMDP+bFoD5Dvhm9oLheFp5O4a2QF0cSBGsBX4qZmadPMvVqlLJBBci+WqGGOAPvcDeNSVg=="],
@@ -493,7 +482,7 @@
 
     "which": ["which@3.0.1", "", { "dependencies": { "isexe": "^2.0.0" }, "bin": { "node-which": "bin/which.js" } }, "sha512-XA1b62dzQzLfaEOSQFTCOd5KFf/1VSzZo7/7TUjnya6u0vGGKzU96UQBZTAThCb2j4/xjBAyii1OhRLJEivHvg=="],
 
-    "yallist": ["yallist@5.0.0", "", {}, "sha512-YgvUTfwqyc7UXVMrB+SImsVYSmTS8X/tSrtdNZMImM+n7+QTriRXyXim0mBrTXNeqzVF0KWGgHPeiyViFFrNDw=="],
+    "yallist": ["yallist@3.1.1", "", {}, "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g=="],
 
     "yaml": ["yaml@2.3.4", "", {}, "sha512-8aAvwVUSHpfEqTQ4w/KMlf3HcRdt50E5ODIQJBw1fQ5RL34xabzxtUlzTXVqc4rkZsPbvrXKWnABCD7kWSmocA=="],
 
@@ -513,8 +502,6 @@
 
     "light-my-request/process-warning": ["process-warning@4.0.1", "", {}, "sha512-3c2LzQ3rY9d0hc1emcsHhfT9Jwz0cChib/QN89oME2R451w5fy3f0afAhERFZAwrbDU43wk12d0ORBpDVME50Q=="],
 
-    "lru-cache/yallist": ["yallist@3.1.1", "", {}, "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g=="],
-
     "npm-run-path/path-key": ["path-key@4.0.0", "", {}, "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ=="],
 
     "ansi-styles/color-convert/color-name": ["color-name@1.1.3", "", {}, "sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw=="],

bench/package.json

@@ -19,7 +19,6 @@
     "react-dom": "^18.3.1",
     "string-width": "7.1.0",
     "strip-ansi": "^7.1.0",
-    "tar": "^7.4.3",
     "tinycolor2": "^1.6.0",
     "zx": "^7.2.3"
   },

bench/snippets/archive.mjs

@@ -1,477 +0,0 @@
-import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { Pack, Unpack } from "tar";
-import { bench, group, run } from "../runner.mjs";
-
-// Check if Bun.Archive is available
-const hasBunArchive = typeof Bun !== "undefined" && typeof Bun.Archive !== "undefined";
-
-// Test data sizes
-const smallContent = "Hello, World!";
-const mediumContent = Buffer.alloc(10 * 1024, "x").toString(); // 10KB
-const largeContent = Buffer.alloc(100 * 1024, "x").toString(); // 100KB
-
-// Create test files for node-tar (it reads from filesystem)
-const setupDir = mkdtempSync(join(tmpdir(), "archive-bench-setup-"));
-
-function setupNodeTarFiles(prefix, files) {
-  const dir = join(setupDir, prefix);
-  mkdirSync(dir, { recursive: true });
-  for (const [name, content] of Object.entries(files)) {
-    const filePath = join(dir, name);
-    const fileDir = join(filePath, "..");
-    mkdirSync(fileDir, { recursive: true });
-    writeFileSync(filePath, content);
-  }
-  return dir;
-}
-
-// Setup directories for different test cases
-const smallFilesDir = setupNodeTarFiles("small", {
-  "file1.txt": smallContent,
-  "file2.txt": smallContent,
-  "file3.txt": smallContent,
-});
-
-const mediumFilesDir = setupNodeTarFiles("medium", {
-  "file1.txt": mediumContent,
-  "file2.txt": mediumContent,
-  "file3.txt": mediumContent,
-});
-
-const largeFilesDir = setupNodeTarFiles("large", {
-  "file1.txt": largeContent,
-  "file2.txt": largeContent,
-  "file3.txt": largeContent,
-});
-
-const manyFilesEntries = {};
-for (let i = 0; i < 100; i++) {
-  manyFilesEntries[`file${i}.txt`] = smallContent;
-}
-const manyFilesDir = setupNodeTarFiles("many", manyFilesEntries);
-
-// Pre-create archives for extraction benchmarks
-let smallTarGzBuffer, mediumTarGzBuffer, largeTarGzBuffer, manyFilesTarGzBuffer;
-let smallTarBuffer, mediumTarBuffer, largeTarBuffer, manyFilesTarBuffer;
-let smallBunArchiveGz, mediumBunArchiveGz, largeBunArchiveGz, manyFilesBunArchiveGz;
-let smallBunArchive, mediumBunArchive, largeBunArchive, manyFilesBunArchive;
-
-// Create tar buffer using node-tar (with optional gzip)
-async function createNodeTarBuffer(cwd, files, gzip = false) {
-  return new Promise(resolve => {
-    const pack = new Pack({ cwd, gzip });
-    const bufs = [];
-    pack.on("data", chunk => bufs.push(chunk));
-    pack.on("end", () => resolve(Buffer.concat(bufs)));
-    for (const file of files) {
-      pack.add(file);
-    }
-    pack.end();
-  });
-}
-
-// Extract tar buffer using node-tar
-async function extractNodeTarBuffer(buffer, cwd) {
-  return new Promise((resolve, reject) => {
-    const unpack = new Unpack({ cwd });
-    unpack.on("end", resolve);
-    unpack.on("error", reject);
-    unpack.end(buffer);
-  });
-}
-
-// Initialize gzipped archives
-smallTarGzBuffer = await createNodeTarBuffer(smallFilesDir, ["file1.txt", "file2.txt", "file3.txt"], true);
-mediumTarGzBuffer = await createNodeTarBuffer(mediumFilesDir, ["file1.txt", "file2.txt", "file3.txt"], true);
-largeTarGzBuffer = await createNodeTarBuffer(largeFilesDir, ["file1.txt", "file2.txt", "file3.txt"], true);
-manyFilesTarGzBuffer = await createNodeTarBuffer(manyFilesDir, Object.keys(manyFilesEntries), true);
-
-// Initialize uncompressed archives
-smallTarBuffer = await createNodeTarBuffer(smallFilesDir, ["file1.txt", "file2.txt", "file3.txt"], false);
-mediumTarBuffer = await createNodeTarBuffer(mediumFilesDir, ["file1.txt", "file2.txt", "file3.txt"], false);
-largeTarBuffer = await createNodeTarBuffer(largeFilesDir, ["file1.txt", "file2.txt", "file3.txt"], false);
-manyFilesTarBuffer = await createNodeTarBuffer(manyFilesDir, Object.keys(manyFilesEntries), false);
-
-const smallFiles = { "file1.txt": smallContent, "file2.txt": smallContent, "file3.txt": smallContent };
-const mediumFiles = { "file1.txt": mediumContent, "file2.txt": mediumContent, "file3.txt": mediumContent };
-const largeFiles = { "file1.txt": largeContent, "file2.txt": largeContent, "file3.txt": largeContent };
-
-if (hasBunArchive) {
-  smallBunArchiveGz = await Bun.Archive.from(smallFiles).bytes("gzip");
-  mediumBunArchiveGz = await Bun.Archive.from(mediumFiles).bytes("gzip");
-  largeBunArchiveGz = await Bun.Archive.from(largeFiles).bytes("gzip");
-  manyFilesBunArchiveGz = await Bun.Archive.from(manyFilesEntries).bytes("gzip");
-
-  smallBunArchive = await Bun.Archive.from(smallFiles).bytes();
-  mediumBunArchive = await Bun.Archive.from(mediumFiles).bytes();
-  largeBunArchive = await Bun.Archive.from(largeFiles).bytes();
-  manyFilesBunArchive = await Bun.Archive.from(manyFilesEntries).bytes();
-}
-
-// Create reusable extraction directories (overwriting is fine)
-const extractDirNodeTar = mkdtempSync(join(tmpdir(), "archive-bench-extract-node-"));
-const extractDirBun = mkdtempSync(join(tmpdir(), "archive-bench-extract-bun-"));
-const writeDirNodeTar = mkdtempSync(join(tmpdir(), "archive-bench-write-node-"));
-const writeDirBun = mkdtempSync(join(tmpdir(), "archive-bench-write-bun-"));
-
-// ============================================================================
-// Create .tar (uncompressed) benchmarks
-// ============================================================================
-
-group("create .tar (3 small files)", () => {
-  bench("node-tar", async () => {
-    await createNodeTarBuffer(smallFilesDir, ["file1.txt", "file2.txt", "file3.txt"], false);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive", async () => {
-      await Bun.Archive.from(smallFiles).bytes();
-    });
-  }
-});
-
-group("create .tar (3 x 100KB files)", () => {
-  bench("node-tar", async () => {
-    await createNodeTarBuffer(largeFilesDir, ["file1.txt", "file2.txt", "file3.txt"], false);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive", async () => {
-      await Bun.Archive.from(largeFiles).bytes();
-    });
-  }
-});
-
-group("create .tar (100 small files)", () => {
-  bench("node-tar", async () => {
-    await createNodeTarBuffer(manyFilesDir, Object.keys(manyFilesEntries), false);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive", async () => {
-      await Bun.Archive.from(manyFilesEntries).bytes();
-    });
-  }
-});
-
-// ============================================================================
-// Create .tar.gz (compressed) benchmarks
-// ============================================================================
-
-group("create .tar.gz (3 small files)", () => {
-  bench("node-tar", async () => {
-    await createNodeTarBuffer(smallFilesDir, ["file1.txt", "file2.txt", "file3.txt"], true);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive", async () => {
-      await Bun.Archive.from(smallFiles).bytes("gzip");
-    });
-  }
-});
-
-group("create .tar.gz (3 x 100KB files)", () => {
-  bench("node-tar", async () => {
-    await createNodeTarBuffer(largeFilesDir, ["file1.txt", "file2.txt", "file3.txt"], true);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive", async () => {
-      await Bun.Archive.from(largeFiles).bytes("gzip");
-    });
-  }
-});
-
-group("create .tar.gz (100 small files)", () => {
-  bench("node-tar", async () => {
-    await createNodeTarBuffer(manyFilesDir, Object.keys(manyFilesEntries), true);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive", async () => {
-      await Bun.Archive.from(manyFilesEntries).bytes("gzip");
-    });
-  }
-});
-
-// ============================================================================
-// Extract .tar (uncompressed) benchmarks
-// ============================================================================
-
-group("extract .tar (3 small files)", () => {
-  bench("node-tar", async () => {
-    await extractNodeTarBuffer(smallTarBuffer, extractDirNodeTar);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive", async () => {
-      await Bun.Archive.from(smallBunArchive).extract(extractDirBun);
-    });
-  }
-});
-
-group("extract .tar (3 x 100KB files)", () => {
-  bench("node-tar", async () => {
-    await extractNodeTarBuffer(largeTarBuffer, extractDirNodeTar);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive", async () => {
-      await Bun.Archive.from(largeBunArchive).extract(extractDirBun);
-    });
-  }
-});
-
-group("extract .tar (100 small files)", () => {
-  bench("node-tar", async () => {
-    await extractNodeTarBuffer(manyFilesTarBuffer, extractDirNodeTar);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive", async () => {
-      await Bun.Archive.from(manyFilesBunArchive).extract(extractDirBun);
-    });
-  }
-});
-
-// ============================================================================
-// Extract .tar.gz (compressed) benchmarks
-// ============================================================================
-
-group("extract .tar.gz (3 small files)", () => {
-  bench("node-tar", async () => {
-    await extractNodeTarBuffer(smallTarGzBuffer, extractDirNodeTar);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive", async () => {
-      await Bun.Archive.from(smallBunArchiveGz).extract(extractDirBun);
-    });
-  }
-});
-
-group("extract .tar.gz (3 x 100KB files)", () => {
-  bench("node-tar", async () => {
-    await extractNodeTarBuffer(largeTarGzBuffer, extractDirNodeTar);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive", async () => {
-      await Bun.Archive.from(largeBunArchiveGz).extract(extractDirBun);
-    });
-  }
-});
-
-group("extract .tar.gz (100 small files)", () => {
-  bench("node-tar", async () => {
-    await extractNodeTarBuffer(manyFilesTarGzBuffer, extractDirNodeTar);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive", async () => {
-      await Bun.Archive.from(manyFilesBunArchiveGz).extract(extractDirBun);
-    });
-  }
-});
-
-// ============================================================================
-// Write .tar to disk benchmarks
-// ============================================================================
-
-let writeCounter = 0;
-
-group("write .tar to disk (3 small files)", () => {
-  bench("node-tar + writeFileSync", async () => {
-    const buffer = await createNodeTarBuffer(smallFilesDir, ["file1.txt", "file2.txt", "file3.txt"], false);
-    writeFileSync(join(writeDirNodeTar, `archive-${writeCounter++}.tar`), buffer);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive.write", async () => {
-      await Bun.Archive.write(join(writeDirBun, `archive-${writeCounter++}.tar`), smallFiles);
-    });
-  }
-});
-
-group("write .tar to disk (3 x 100KB files)", () => {
-  bench("node-tar + writeFileSync", async () => {
-    const buffer = await createNodeTarBuffer(largeFilesDir, ["file1.txt", "file2.txt", "file3.txt"], false);
-    writeFileSync(join(writeDirNodeTar, `archive-${writeCounter++}.tar`), buffer);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive.write", async () => {
-      await Bun.Archive.write(join(writeDirBun, `archive-${writeCounter++}.tar`), largeFiles);
-    });
-  }
-});
-
-group("write .tar to disk (100 small files)", () => {
-  bench("node-tar + writeFileSync", async () => {
-    const buffer = await createNodeTarBuffer(manyFilesDir, Object.keys(manyFilesEntries), false);
-    writeFileSync(join(writeDirNodeTar, `archive-${writeCounter++}.tar`), buffer);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive.write", async () => {
-      await Bun.Archive.write(join(writeDirBun, `archive-${writeCounter++}.tar`), manyFilesEntries);
-    });
-  }
-});
-
-// ============================================================================
-// Write .tar.gz to disk benchmarks
-// ============================================================================
-
-group("write .tar.gz to disk (3 small files)", () => {
-  bench("node-tar + writeFileSync", async () => {
-    const buffer = await createNodeTarBuffer(smallFilesDir, ["file1.txt", "file2.txt", "file3.txt"], true);
-    writeFileSync(join(writeDirNodeTar, `archive-${writeCounter++}.tar.gz`), buffer);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive.write", async () => {
-      await Bun.Archive.write(join(writeDirBun, `archive-${writeCounter++}.tar.gz`), smallFiles, "gzip");
-    });
-  }
-});
-
-group("write .tar.gz to disk (3 x 100KB files)", () => {
-  bench("node-tar + writeFileSync", async () => {
-    const buffer = await createNodeTarBuffer(largeFilesDir, ["file1.txt", "file2.txt", "file3.txt"], true);
-    writeFileSync(join(writeDirNodeTar, `archive-${writeCounter++}.tar.gz`), buffer);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive.write", async () => {
-      await Bun.Archive.write(join(writeDirBun, `archive-${writeCounter++}.tar.gz`), largeFiles, "gzip");
-    });
-  }
-});
-
-group("write .tar.gz to disk (100 small files)", () => {
-  bench("node-tar + writeFileSync", async () => {
-    const buffer = await createNodeTarBuffer(manyFilesDir, Object.keys(manyFilesEntries), true);
-    writeFileSync(join(writeDirNodeTar, `archive-${writeCounter++}.tar.gz`), buffer);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive.write", async () => {
-      await Bun.Archive.write(join(writeDirBun, `archive-${writeCounter++}.tar.gz`), manyFilesEntries, "gzip");
-    });
-  }
-});
-
-// ============================================================================
-// Get files array from archive (files() method) benchmarks
-// ============================================================================
-
-// Helper to get files array from node-tar (reads all entries into memory)
-async function getFilesArrayNodeTar(buffer) {
-  return new Promise((resolve, reject) => {
-    const files = new Map();
-    let pending = 0;
-    let closed = false;
-
-    const maybeResolve = () => {
-      if (closed && pending === 0) {
-        resolve(files);
-      }
-    };
-
-    const unpack = new Unpack({
-      onReadEntry: entry => {
-        if (entry.type === "File") {
-          pending++;
-          const chunks = [];
-          entry.on("data", chunk => chunks.push(chunk));
-          entry.on("end", () => {
-            const content = Buffer.concat(chunks);
-            // Create a File-like object similar to Bun.Archive.files()
-            files.set(entry.path, new Blob([content]));
-            pending--;
-            maybeResolve();
-          });
-        }
-        entry.resume(); // Drain the entry
-      },
-    });
-    unpack.on("close", () => {
-      closed = true;
-      maybeResolve();
-    });
-    unpack.on("error", reject);
-    unpack.end(buffer);
-  });
-}
-
-group("files() - get all files as Map (3 small files)", () => {
-  bench("node-tar", async () => {
-    await getFilesArrayNodeTar(smallTarBuffer);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive.files()", async () => {
-      await Bun.Archive.from(smallBunArchive).files();
-    });
-  }
-});
-
-group("files() - get all files as Map (3 x 100KB files)", () => {
-  bench("node-tar", async () => {
-    await getFilesArrayNodeTar(largeTarBuffer);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive.files()", async () => {
-      await Bun.Archive.from(largeBunArchive).files();
-    });
-  }
-});
-
-group("files() - get all files as Map (100 small files)", () => {
-  bench("node-tar", async () => {
-    await getFilesArrayNodeTar(manyFilesTarBuffer);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive.files()", async () => {
-      await Bun.Archive.from(manyFilesBunArchive).files();
-    });
-  }
-});
-
-group("files() - get all files as Map from .tar.gz (3 small files)", () => {
-  bench("node-tar", async () => {
-    await getFilesArrayNodeTar(smallTarGzBuffer);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive.files()", async () => {
-      await Bun.Archive.from(smallBunArchiveGz).files();
-    });
-  }
-});
-
-group("files() - get all files as Map from .tar.gz (100 small files)", () => {
-  bench("node-tar", async () => {
-    await getFilesArrayNodeTar(manyFilesTarGzBuffer);
-  });
-
-  if (hasBunArchive) {
-    bench("Bun.Archive.files()", async () => {
-      await Bun.Archive.from(manyFilesBunArchiveGz).files();
-    });
-  }
-});
-
-await run();
-
-// Cleanup
-rmSync(setupDir, { recursive: true, force: true });
-rmSync(extractDirNodeTar, { recursive: true, force: true });
-rmSync(extractDirBun, { recursive: true, force: true });
-rmSync(writeDirNodeTar, { recursive: true, force: true });
-rmSync(writeDirBun, { recursive: true, force: true });

bench/snippets/array-of.js

@@ -1,335 +0,0 @@
-import { bench, run } from "../runner.mjs";
-
-let sink;
-
-// Integers
-bench("int: Array.of(1,2,3,4,5)", () => {
-  sink = Array.of(1, 2, 3, 4, 5);
-});
-
-bench("int: Array.of(100 elements)", () => {
-  sink = Array.of(
-    0,
-    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,
-  );
-});
-
-// Doubles
-bench("double: Array.of(1.1,2.2,3.3,4.4,5.5)", () => {
-  sink = Array.of(1.1, 2.2, 3.3, 4.4, 5.5);
-});
-
-bench("double: Array.of(100 elements)", () => {
-  sink = Array.of(
-    0.1,
-    1.1,
-    2.1,
-    3.1,
-    4.1,
-    5.1,
-    6.1,
-    7.1,
-    8.1,
-    9.1,
-    10.1,
-    11.1,
-    12.1,
-    13.1,
-    14.1,
-    15.1,
-    16.1,
-    17.1,
-    18.1,
-    19.1,
-    20.1,
-    21.1,
-    22.1,
-    23.1,
-    24.1,
-    25.1,
-    26.1,
-    27.1,
-    28.1,
-    29.1,
-    30.1,
-    31.1,
-    32.1,
-    33.1,
-    34.1,
-    35.1,
-    36.1,
-    37.1,
-    38.1,
-    39.1,
-    40.1,
-    41.1,
-    42.1,
-    43.1,
-    44.1,
-    45.1,
-    46.1,
-    47.1,
-    48.1,
-    49.1,
-    50.1,
-    51.1,
-    52.1,
-    53.1,
-    54.1,
-    55.1,
-    56.1,
-    57.1,
-    58.1,
-    59.1,
-    60.1,
-    61.1,
-    62.1,
-    63.1,
-    64.1,
-    65.1,
-    66.1,
-    67.1,
-    68.1,
-    69.1,
-    70.1,
-    71.1,
-    72.1,
-    73.1,
-    74.1,
-    75.1,
-    76.1,
-    77.1,
-    78.1,
-    79.1,
-    80.1,
-    81.1,
-    82.1,
-    83.1,
-    84.1,
-    85.1,
-    86.1,
-    87.1,
-    88.1,
-    89.1,
-    90.1,
-    91.1,
-    92.1,
-    93.1,
-    94.1,
-    95.1,
-    96.1,
-    97.1,
-    98.1,
-    99.1,
-  );
-});
-
-// Objects
-bench("object: Array.of(obj x5)", () => {
-  sink = Array.of({ a: 1 }, { a: 2 }, { a: 3 }, { a: 4 }, { a: 5 });
-});
-
-bench("object: Array.of(100 elements)", () => {
-  sink = Array.of(
-    { a: 0 },
-    { a: 1 },
-    { a: 2 },
-    { a: 3 },
-    { a: 4 },
-    { a: 5 },
-    { a: 6 },
-    { a: 7 },
-    { a: 8 },
-    { a: 9 },
-    { a: 10 },
-    { a: 11 },
-    { a: 12 },
-    { a: 13 },
-    { a: 14 },
-    { a: 15 },
-    { a: 16 },
-    { a: 17 },
-    { a: 18 },
-    { a: 19 },
-    { a: 20 },
-    { a: 21 },
-    { a: 22 },
-    { a: 23 },
-    { a: 24 },
-    { a: 25 },
-    { a: 26 },
-    { a: 27 },
-    { a: 28 },
-    { a: 29 },
-    { a: 30 },
-    { a: 31 },
-    { a: 32 },
-    { a: 33 },
-    { a: 34 },
-    { a: 35 },
-    { a: 36 },
-    { a: 37 },
-    { a: 38 },
-    { a: 39 },
-    { a: 40 },
-    { a: 41 },
-    { a: 42 },
-    { a: 43 },
-    { a: 44 },
-    { a: 45 },
-    { a: 46 },
-    { a: 47 },
-    { a: 48 },
-    { a: 49 },
-    { a: 50 },
-    { a: 51 },
-    { a: 52 },
-    { a: 53 },
-    { a: 54 },
-    { a: 55 },
-    { a: 56 },
-    { a: 57 },
-    { a: 58 },
-    { a: 59 },
-    { a: 60 },
-    { a: 61 },
-    { a: 62 },
-    { a: 63 },
-    { a: 64 },
-    { a: 65 },
-    { a: 66 },
-    { a: 67 },
-    { a: 68 },
-    { a: 69 },
-    { a: 70 },
-    { a: 71 },
-    { a: 72 },
-    { a: 73 },
-    { a: 74 },
-    { a: 75 },
-    { a: 76 },
-    { a: 77 },
-    { a: 78 },
-    { a: 79 },
-    { a: 80 },
-    { a: 81 },
-    { a: 82 },
-    { a: 83 },
-    { a: 84 },
-    { a: 85 },
-    { a: 86 },
-    { a: 87 },
-    { a: 88 },
-    { a: 89 },
-    { a: 90 },
-    { a: 91 },
-    { a: 92 },
-    { a: 93 },
-    { a: 94 },
-    { a: 95 },
-    { a: 96 },
-    { a: 97 },
-    { a: 98 },
-    { a: 99 },
-  );
-});
-
-await run();

bench/snippets/ipc-json-child.mjs

@@ -1,4 +0,0 @@
-// Child process for IPC benchmarks - echoes messages back to parent
-process.on("message", message => {
-  process.send(message);
-});

bench/snippets/ipc-json.mjs

@@ -1,45 +0,0 @@
-import { fork } from "node:child_process";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { bench, run } from "../runner.mjs";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const childPath = path.join(__dirname, "ipc-json-child.mjs");
-
-const smallMessage = { type: "ping", id: 1 };
-const largeString = Buffer.alloc(10 * 1024 * 1024, "A").toString();
-const largeMessage = { type: "ping", id: 1, data: largeString };
-
-async function runBenchmark(message, count) {
-  let received = 0;
-  const { promise, resolve } = Promise.withResolvers();
-
-  const child = fork(childPath, [], {
-    stdio: ["ignore", "ignore", "ignore", "ipc"],
-    serialization: "json",
-  });
-
-  child.on("message", () => {
-    received++;
-    if (received >= count) {
-      resolve();
-    }
-  });
-
-  for (let i = 0; i < count; i++) {
-    child.send(message);
-  }
-
-  await promise;
-  child.kill();
-}
-
-bench("ipc json - small messages (1000 roundtrips)", async () => {
-  await runBenchmark(smallMessage, 1000);
-});
-
-bench("ipc json - 10MB messages (10 roundtrips)", async () => {
-  await runBenchmark(largeMessage, 10);
-});
-
-await run();

bench/snippets/object-hasown.mjs

@@ -1,57 +0,0 @@
-import { bench, run } from "../runner.mjs";
-
-const obj = { a: 1, b: 2, c: 3 };
-const objDeep = { a: 1, b: 2, c: 3, d: 4, e: 5, f: 6, g: 7, h: 8 };
-const sym = Symbol("test");
-const objWithSymbol = { [sym]: 1, a: 2 };
-
-const objs = [
-  { f: 50 },
-  { f: 50, g: 70 },
-  { g: 50, f: 70 },
-  { h: 50, f: 70 },
-  { z: 50, f: 70 },
-  { k: 50, f: 70 },
-];
-
-bench("Object.hasOwn - hit", () => {
-  return Object.hasOwn(obj, "a");
-});
-
-bench("Object.hasOwn - miss", () => {
-  return Object.hasOwn(obj, "z");
-});
-
-bench("Object.hasOwn - symbol hit", () => {
-  return Object.hasOwn(objWithSymbol, sym);
-});
-
-bench("Object.hasOwn - symbol miss", () => {
-  return Object.hasOwn(objWithSymbol, Symbol("other"));
-});
-
-bench("Object.hasOwn - multiple shapes", () => {
-  let result = true;
-  for (let i = 0; i < objs.length; i++) {
-    result = Object.hasOwn(objs[i], "f") && result;
-  }
-  return result;
-});
-
-bench("Object.prototype.hasOwnProperty - hit", () => {
-  return obj.hasOwnProperty("a");
-});
-
-bench("Object.prototype.hasOwnProperty - miss", () => {
-  return obj.hasOwnProperty("z");
-});
-
-bench("in operator - hit", () => {
-  return "a" in obj;
-});
-
-bench("in operator - miss", () => {
-  return "z" in obj;
-});
-
-await run();

bench/snippets/promise-race.mjs

@@ -1,7 +0,0 @@
-import { bench, run } from "../runner.mjs";
-
-bench("Promise.race([p1, p2])", async function () {
-  return await Promise.race([Promise.resolve(1), Promise.resolve(2)]);
-});
-
-await run();

bench/snippets/response-json.mjs

@@ -112,40 +112,12 @@ const obj = {
   },
 };
 
-const smallObj = { id: 1, name: "test" };
-
-const arrayObj = {
-  items: Array.from({ length: 100 }, (_, i) => ({ id: i, value: `item-${i}` })),
-};
-
-bench("Response.json(obj)", () => {
+bench("Response.json(obj)", async () => {
   return Response.json(obj);
 });
 
-bench("new Response(JSON.stringify(obj))", () => {
-  return new Response(JSON.stringify(obj), {
-    headers: { "Content-Type": "application/json" },
-  });
-});
-
-bench("Response.json(smallObj)", () => {
-  return Response.json(smallObj);
-});
-
-bench("new Response(JSON.stringify(smallObj))", () => {
-  return new Response(JSON.stringify(smallObj), {
-    headers: { "Content-Type": "application/json" },
-  });
-});
-
-bench("Response.json(arrayObj)", () => {
-  return Response.json(arrayObj);
-});
-
-bench("new Response(JSON.stringify(arrayObj))", () => {
-  return new Response(JSON.stringify(arrayObj), {
-    headers: { "Content-Type": "application/json" },
-  });
+bench("Response.json(obj).json()", async () => {
+  return await Response.json(obj).json();
 });
 
 await run();

bench/snippets/string-includes.mjs

@@ -1,34 +0,0 @@
-import { bench, run } from "../runner.mjs";
-
-const shortStr = "The quick brown fox jumps over the lazy dog";
-const longStr = shortStr.repeat(100);
-
-bench("String.includes - short, hit (middle)", () => {
-  return shortStr.includes("jumps");
-});
-
-bench("String.includes - short, hit (start)", () => {
-  return shortStr.includes("The");
-});
-
-bench("String.includes - short, hit (end)", () => {
-  return shortStr.includes("dog");
-});
-
-bench("String.includes - short, miss", () => {
-  return shortStr.includes("cat");
-});
-
-bench("String.includes - long, hit (middle)", () => {
-  return longStr.includes("jumps");
-});
-
-bench("String.includes - long, miss", () => {
-  return longStr.includes("cat");
-});
-
-bench("String.includes - with position", () => {
-  return shortStr.includes("fox", 10);
-});
-
-await run();

cmake/targets/BuildBun.cmake

@@ -419,9 +419,12 @@ execute_process(
     --command=list-outputs
     --sources=${BUN_BINDGENV2_SOURCES_COMMA_SEPARATED}
     --codegen-path=${CODEGEN_PATH}
+  RESULT_VARIABLE bindgen_result
   OUTPUT_VARIABLE bindgen_outputs
-  COMMAND_ERROR_IS_FATAL ANY
 )
+if(${bindgen_result})
+  message(FATAL_ERROR "bindgenv2/script.ts exited with non-zero status")
+endif()
 foreach(output IN LISTS bindgen_outputs)
   if(output MATCHES "\.cpp$")
     list(APPEND BUN_BINDGENV2_CPP_OUTPUTS ${output})
@@ -869,7 +872,6 @@ target_include_directories(${bun} PRIVATE
   ${CODEGEN_PATH}
   ${VENDOR_PATH}
   ${VENDOR_PATH}/picohttpparser
-  ${VENDOR_PATH}/zlib
   ${NODEJS_HEADERS_PATH}/include
   ${NODEJS_HEADERS_PATH}/include/node
 )
@@ -1197,29 +1199,6 @@ set_target_properties(${bun} PROPERTIES LINK_DEPENDS ${BUN_SYMBOLS_PATH})
 
 include(SetupWebKit)
 
-if(BUN_LINK_ONLY)
-  register_command(
-    TARGET
-      ${bun}
-    TARGET_PHASE
-      POST_BUILD
-    COMMENT
-      "Uploading link metadata"
-    COMMAND
-      ${CMAKE_COMMAND} -E env
-        BUN_VERSION=${VERSION}
-        WEBKIT_DOWNLOAD_URL=${WEBKIT_DOWNLOAD_URL}
-        WEBKIT_VERSION=${WEBKIT_VERSION}
-        ZIG_COMMIT=${ZIG_COMMIT}
-        ${BUN_EXECUTABLE} ${CWD}/scripts/create-link-metadata.mjs ${BUILD_PATH} ${bun}
-    SOURCES
-      ${BUN_ZIG_OUTPUT}
-      ${BUN_CPP_OUTPUT}
-    ARTIFACTS
-      ${BUILD_PATH}/link-metadata.json
-  )
-endif()
-
 if(WIN32)
   if(DEBUG)
     target_link_libraries(${bun} PRIVATE

cmake/tools/SetupBuildkite.cmake

@@ -48,9 +48,6 @@ if(NOT BUILDKITE_BUILD_STATUS EQUAL 0)
 endif()
 
 file(READ ${BUILDKITE_BUILD_PATH}/build.json BUILDKITE_BUILD)
-# Escape backslashes so CMake doesn't interpret JSON escape sequences (e.g., \n in commit messages)
-string(REPLACE "\\" "\\\\" BUILDKITE_BUILD "${BUILDKITE_BUILD}")
-
 string(JSON BUILDKITE_BUILD_UUID GET ${BUILDKITE_BUILD} id)
 string(JSON BUILDKITE_JOBS GET ${BUILDKITE_BUILD} jobs)
 string(JSON BUILDKITE_JOBS_COUNT LENGTH ${BUILDKITE_JOBS})

cmake/tools/SetupCcache.cmake

@@ -5,12 +5,18 @@ if(NOT ENABLE_CCACHE OR CACHE_STRATEGY STREQUAL "none")
   return()
 endif()
 
+if (CI AND NOT APPLE)
+  setenv(CCACHE_DISABLE 1)
+  return()
+endif()
 
 find_command(
   VARIABLE
     CCACHE_PROGRAM
   COMMAND
     ccache
+  REQUIRED
+    ${CI}
 )
 
 if(NOT CCACHE_PROGRAM)

cmake/tools/SetupSccache.cmake

@@ -0,0 +1,123 @@
+# Setup sccache as the C and C++ compiler launcher to speed up builds by caching
+if(CACHE_STRATEGY STREQUAL "none")
+  return()
+endif()
+
+set(SCCACHE_SHARED_CACHE_REGION "us-west-1")
+set(SCCACHE_SHARED_CACHE_BUCKET "bun-build-sccache-store")
+
+# Function to check if the system AWS credentials have access to the sccache S3 bucket.
+function(check_aws_credentials OUT_VAR)
+  # Install dependencies first
+  execute_process(
+    COMMAND ${BUN_EXECUTABLE} install --frozen-lockfile
+    WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}/scripts/build-cache
+    RESULT_VARIABLE INSTALL_EXIT_CODE
+    OUTPUT_VARIABLE INSTALL_OUTPUT
+    ERROR_VARIABLE INSTALL_ERROR
+  )
+
+  if(NOT INSTALL_EXIT_CODE EQUAL 0)
+    message(FATAL_ERROR "Failed to install dependencies in scripts/build-cache\n"
+      "Exit code: ${INSTALL_EXIT_CODE}\n"
+      "Output: ${INSTALL_OUTPUT}\n"
+      "Error: ${INSTALL_ERROR}")
+  endif()
+
+  # Check AWS credentials
+  execute_process(
+    COMMAND
+      ${BUN_EXECUTABLE}
+      run
+      have-access.ts
+      --bucket ${SCCACHE_SHARED_CACHE_BUCKET}
+      --region ${SCCACHE_SHARED_CACHE_REGION}
+    WORKING_DIRECTORY
+      ${CMAKE_SOURCE_DIR}/scripts/build-cache
+    RESULT_VARIABLE HAVE_ACCESS_EXIT_CODE
+  )
+
+  if(HAVE_ACCESS_EXIT_CODE EQUAL 0)
+    set(HAS_CREDENTIALS TRUE)
+  else()
+    set(HAS_CREDENTIALS FALSE)
+  endif()
+
+  set(${OUT_VAR} ${HAS_CREDENTIALS} PARENT_SCOPE)
+endfunction()
+
+# Configure sccache to use the local cache only.
+function(sccache_configure_local_filesystem)
+  unsetenv(SCCACHE_BUCKET)
+  unsetenv(SCCACHE_REGION)
+  setenv(SCCACHE_DIR "${CACHE_PATH}/sccache")
+endfunction()
+
+# Configure sccache to use the distributed cache (S3 + local).
+function(sccache_configure_distributed)
+  setenv(SCCACHE_BUCKET "${SCCACHE_SHARED_CACHE_BUCKET}")
+  setenv(SCCACHE_REGION "${SCCACHE_SHARED_CACHE_REGION}")
+  setenv(SCCACHE_DIR "${CACHE_PATH}/sccache")
+endfunction()
+
+function(sccache_configure_environment_ci)
+  if(CACHE_STRATEGY STREQUAL "auto" OR CACHE_STRATEGY STREQUAL "distributed")
+    check_aws_credentials(HAS_AWS_CREDENTIALS)
+    if(HAS_AWS_CREDENTIALS)
+      sccache_configure_distributed()
+      message(NOTICE "sccache: Using distributed cache strategy.")
+    else()
+      message(FATAL_ERROR "CI CACHE_STRATEGY is set to '${CACHE_STRATEGY}', but no valid AWS "
+        "credentials were found. Note that 'auto' requires AWS credentials to access the shared "
+        "cache in CI.")
+    endif()
+  elseif(CACHE_STRATEGY STREQUAL "local")
+    # We disallow this because we want our CI runs to always used the shared cache to accelerate
+    # builds.
+    # none, distributed and auto are all okay.
+    #
+    # If local is configured, it's as good as "none", so this is probably user error.
+    message(FATAL_ERROR "CI CACHE_STRATEGY is set to 'local', which is not allowed.")
+  endif()
+endfunction()
+
+function(sccache_configure_environment_developer)
+  # Local environments can use any strategy they like. S3 is set up in such a way so as to clean
+  # itself from old entries automatically.
+  if (CACHE_STRATEGY STREQUAL "auto" OR CACHE_STRATEGY STREQUAL "local")
+    # In the local environment, we prioritize using the local cache. This is because sccache takes
+    # into consideration the whole absolute path of the files being compiled, and it's very
+    # unlikely users will have the same absolute paths on their local machines.
+    sccache_configure_local_filesystem()
+    message(NOTICE "sccache: Using local cache strategy.")
+  elseif(CACHE_STRATEGY STREQUAL "distributed")
+    check_aws_credentials(HAS_AWS_CREDENTIALS)
+    if(HAS_AWS_CREDENTIALS)
+      sccache_configure_distributed()
+      message(NOTICE "sccache: Using distributed cache strategy.")
+    else()
+      message(FATAL_ERROR "CACHE_STRATEGY is set to 'distributed', but no valid AWS credentials "
+        "were found.")
+    endif()
+  endif()
+endfunction()
+
+find_command(VARIABLE SCCACHE_PROGRAM COMMAND sccache REQUIRED ${CI})
+if(NOT SCCACHE_PROGRAM)
+  message(WARNING "sccache not found. Your builds will be slower.")
+  return()
+endif()
+
+set(SCCACHE_ARGS CMAKE_C_COMPILER_LAUNCHER CMAKE_CXX_COMPILER_LAUNCHER)
+foreach(arg ${SCCACHE_ARGS})
+  setx(${arg} ${SCCACHE_PROGRAM})
+  list(APPEND CMAKE_ARGS -D${arg}=${${arg}})
+endforeach()
+
+setenv(SCCACHE_LOG "info")
+
+if (CI)
+  sccache_configure_environment_ci()
+else()
+  sccache_configure_environment_developer()
+endif()

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 1d0216219a3c52cb85195f48f19ba7d5db747ff7)
+  set(WEBKIT_VERSION 6d0f3aac0b817cc01a846b3754b21271adedac12)
 endif()
 
 string(SUBSTRING ${WEBKIT_VERSION} 0 16 WEBKIT_VERSION_PREFIX)
@@ -28,7 +28,6 @@ if(WEBKIT_LOCAL)
     # make jsc-compile-debug jsc-copy-headers
     include_directories(
       ${WEBKIT_PATH}
-      ${WEBKIT_PATH}/JavaScriptCore/Headers
       ${WEBKIT_PATH}/JavaScriptCore/Headers/JavaScriptCore
       ${WEBKIT_PATH}/JavaScriptCore/PrivateHeaders
       ${WEBKIT_PATH}/bmalloc/Headers
@@ -91,14 +90,7 @@ if(EXISTS ${WEBKIT_PATH}/package.json)
   endif()
 endif()
 
-file(
-  DOWNLOAD ${WEBKIT_DOWNLOAD_URL} ${CACHE_PATH}/${WEBKIT_FILENAME} SHOW_PROGRESS
-  STATUS WEBKIT_DOWNLOAD_STATUS
-)
-if(NOT "${WEBKIT_DOWNLOAD_STATUS}" MATCHES "^0;")
-  message(FATAL_ERROR "Failed to download WebKit: ${WEBKIT_DOWNLOAD_STATUS}")
-endif()
-
+file(DOWNLOAD ${WEBKIT_DOWNLOAD_URL} ${CACHE_PATH}/${WEBKIT_FILENAME} SHOW_PROGRESS)
 file(ARCHIVE_EXTRACT INPUT ${CACHE_PATH}/${WEBKIT_FILENAME} DESTINATION ${CACHE_PATH} TOUCH)
 file(REMOVE ${CACHE_PATH}/${WEBKIT_FILENAME})
 file(REMOVE_RECURSE ${WEBKIT_PATH})

docs/bundler/index.mdx

@@ -220,78 +220,6 @@ An array of paths corresponding to the entrypoints of our application. One bundl
   </Tab>
 </Tabs>
 
-### files
-
-A map of file paths to their contents for in-memory bundling. This allows you to bundle virtual files that don't exist on disk, or override the contents of files that do exist. This option is only available in the JavaScript API.
-
-File contents can be provided as a `string`, `Blob`, `TypedArray`, or `ArrayBuffer`.
-
-#### Bundle entirely from memory
-
-You can bundle code without any files on disk by providing all sources via `files`:
-
-```ts title="build.ts" icon="/icons/typescript.svg"
-const result = await Bun.build({
-  entrypoints: ["/app/index.ts"],
-  files: {
-    "/app/index.ts": `
-      import { greet } from "./greet.ts";
-      console.log(greet("World"));
-    `,
-    "/app/greet.ts": `
-      export function greet(name: string) {
-        return "Hello, " + name + "!";
-      }
-    `,
-  },
-});
-
-const output = await result.outputs[0].text();
-console.log(output);
-```
-
-When all entrypoints are in the `files` map, the current working directory is used as the root.
-
-#### Override files on disk
-
-In-memory files take priority over files on disk. This lets you override specific files while keeping the rest of your codebase unchanged:
-
-```ts title="build.ts" icon="/icons/typescript.svg"
-// Assume ./src/config.ts exists on disk with development settings
-await Bun.build({
-  entrypoints: ["./src/index.ts"],
-  files: {
-    // Override config.ts with production values
-    "./src/config.ts": `
-      export const API_URL = "https://api.production.com";
-      export const DEBUG = false;
-    `,
-  },
-  outdir: "./dist",
-});
-```
-
-#### Mix disk and virtual files
-
-Real files on disk can import virtual files, and virtual files can import real files:
-
-```ts title="build.ts" icon="/icons/typescript.svg"
-// ./src/index.ts exists on disk and imports "./generated.ts"
-await Bun.build({
-  entrypoints: ["./src/index.ts"],
-  files: {
-    // Provide a virtual file that index.ts imports
-    "./src/generated.ts": `
-      export const BUILD_ID = "${crypto.randomUUID()}";
-      export const BUILD_TIME = ${Date.now()};
-    `,
-  },
-  outdir: "./dist",
-});
-```
-
-This is useful for code generation, injecting build-time constants, or testing with mock modules.
-
 ### outdir
 
 The directory where output files will be written.
@@ -1291,79 +1219,6 @@ declare module "bun:bundle" {
 
 Ensure the file is included in your `tsconfig.json` (e.g., `"include": ["src", "env.d.ts"]`). Now `feature()` only accepts those flags, and invalid strings like `feature("TYPO")` become type errors.
 
-### metafile
-
-Generate metadata about the build in a structured format. The metafile contains information about all input files, output files, their sizes, imports, and exports. This is useful for:
-
-- **Bundle analysis**: Understand what's contributing to bundle size
-- **Visualization**: Feed into tools like [esbuild's bundle analyzer](https://esbuild.github.io/analyze/) or other visualization tools
-- **Dependency tracking**: See the full import graph of your application
-- **CI integration**: Track bundle size changes over time
-
-<Tabs>
-  <Tab title="JavaScript">
-    ```ts title="build.ts" icon="/icons/typescript.svg"
-    const result = await Bun.build({
-      entrypoints: ['./src/index.ts'],
-      outdir: './dist',
-      metafile: true,
-    });
-
-    if (result.metafile) {
-      // Analyze inputs
-      for (const [path, meta] of Object.entries(result.metafile.inputs)) {
-        console.log(`${path}: ${meta.bytes} bytes`);
-      }
-
-      // Analyze outputs
-      for (const [path, meta] of Object.entries(result.metafile.outputs)) {
-        console.log(`${path}: ${meta.bytes} bytes`);
-      }
-
-      // Save for external analysis tools
-      await Bun.write('./dist/meta.json', JSON.stringify(result.metafile));
-    }
-    ```
-
-  </Tab>
-  <Tab title="CLI">
-    ```bash terminal icon="terminal"
-    bun build ./src/index.ts --outdir ./dist --metafile ./dist/meta.json
-    ```
-  </Tab>
-</Tabs>
-
-The metafile structure contains:
-
-```ts
-interface BuildMetafile {
-  inputs: {
-    [path: string]: {
-      bytes: number;
-      imports: Array<{
-        path: string;
-        kind: ImportKind;
-        original?: string; // Original specifier before resolution
-        external?: boolean;
-      }>;
-      format?: "esm" | "cjs" | "json" | "css";
-    };
-  };
-  outputs: {
-    [path: string]: {
-      bytes: number;
-      inputs: {
-        [path: string]: { bytesInOutput: number };
-      };
-      imports: Array<{ path: string; kind: ImportKind }>;
-      exports: string[];
-      entryPoint?: string;
-      cssBundle?: string; // Associated CSS file for JS entry points
-    };
-  };
-}
-```
-
 ## Outputs
 
 The `Bun.build` function returns a `Promise<BuildOutput>`, defined as:
@@ -1373,7 +1228,6 @@ interface BuildOutput {
   outputs: BuildArtifact[];
   success: boolean;
   logs: Array<object>; // see docs for details
-  metafile?: BuildMetafile; // only when metafile: true
 }
 
 interface BuildArtifact extends Blob {

docs/docs.json

@@ -121,7 +121,6 @@
               "/runtime/file-io",
               "/runtime/streams",
               "/runtime/binary-data",
-              "/runtime/archive",
               "/runtime/sql",
               "/runtime/sqlite",
               "/runtime/s3",

docs/guides/ecosystem/pm2.mdx

@@ -33,7 +33,7 @@ Alternatively, you can create a PM2 configuration file. Create a file named `pm2
 
 ```js pm2.config.js icon="file-code"
 module.exports = {
-  name: "app", // Name of your application
+  title: "app", // Name of your application
   script: "index.ts", // Entry point of your application
   interpreter: "bun", // Bun interpreter
   env: {

docs/pm/isolated-installs.mdx

@@ -189,7 +189,7 @@ Isolated installs are conceptually similar to pnpm, so migration should be strai
 
 ```bash terminal icon="terminal"
 # Remove pnpm files
-rm -rf node_modules pnpm-lock.yaml
+$ rm -rf node_modules pnpm-lock.yaml
 
 # Install with Bun's isolated linker
 bun install --linker isolated

docs/pm/npmrc.mdx

@@ -72,7 +72,6 @@ The following options are supported:
 - `username`
 - `_password` (base64 encoded password)
 - `_auth` (base64 encoded username:password, e.g. `btoa(username + ":" + password)`)
-- `email`
 
 The equivalent `bunfig.toml` option is to add a key in [`install.scopes`](/runtime/bunfig#install-registry):
 
@@ -110,136 +109,3 @@ The equivalent `bunfig.toml` option is [`install.exact`](/runtime/bunfig#install
 [install]
 exact = true
 ```
-
-### `ignore-scripts`: Skip lifecycle scripts
-
-Prevents running lifecycle scripts during installation:
-
-```ini .npmrc icon="npm"
-ignore-scripts=true
-```
-
-This is equivalent to using the `--ignore-scripts` flag with `bun install`.
-
-### `dry-run`: Preview changes without installing
-
-Shows what would be installed without actually installing:
-
-```ini .npmrc icon="npm"
-dry-run=true
-```
-
-The equivalent `bunfig.toml` option is [`install.dryRun`](/runtime/bunfig#install-dryrun):
-
-```toml bunfig.toml icon="settings"
-[install]
-dryRun = true
-```
-
-### `cache`: Configure cache directory
-
-Set the cache directory path, or disable caching:
-
-```ini .npmrc icon="npm"
-# set a custom cache directory
-cache=/path/to/cache
-
-# or disable caching
-cache=false
-```
-
-The equivalent `bunfig.toml` option is [`install.cache`](/runtime/bunfig#install-cache):
-
-```toml bunfig.toml icon="settings"
-[install.cache]
-# set a custom cache directory
-dir = "/path/to/cache"
-
-# or disable caching
-disable = true
-```
-
-### `ca` and `cafile`: Configure CA certificates
-
-Configure custom CA certificates for registry connections:
-
-```ini .npmrc icon="npm"
-# single CA certificate
-ca="-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----"
-
-# multiple CA certificates
-ca[]="-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----"
-ca[]="-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----"
-
-# or specify a path to a CA file
-cafile=/path/to/ca-bundle.crt
-```
-
-### `omit` and `include`: Control dependency types
-
-Control which dependency types are installed:
-
-```ini .npmrc icon="npm"
-# omit dev dependencies
-omit=dev
-
-# omit multiple types
-omit[]=dev
-omit[]=optional
-
-# include specific types (overrides omit)
-include=dev
-```
-
-Valid values: `dev`, `peer`, `optional`
-
-### `install-strategy` and `node-linker`: Installation strategy
-
-Control how packages are installed in `node_modules`. Bun supports two different configuration options for compatibility with different package managers.
-
-**npm's `install-strategy`:**
-
-```ini .npmrc icon="npm"
-# flat node_modules structure (default)
-install-strategy=hoisted
-
-# symlinked structure
-install-strategy=linked
-```
-
-**pnpm/yarn's `node-linker`:**
-
-The `node-linker` option controls the installation mode. Bun supports values from both pnpm and yarn:
-
-| Value          | Description                                     | Accepted by |
-| -------------- | ----------------------------------------------- | ----------- |
-| `isolated`     | Symlinked structure with isolated dependencies  | pnpm        |
-| `hoisted`      | Flat node_modules structure                     | pnpm        |
-| `pnpm`         | Symlinked structure (same as `isolated`)        | yarn        |
-| `node-modules` | Flat node_modules structure (same as `hoisted`) | yarn        |
-
-```ini .npmrc icon="npm"
-# symlinked/isolated mode
-node-linker=isolated
-node-linker=pnpm
-
-# flat/hoisted mode
-node-linker=hoisted
-node-linker=node-modules
-```
-
-### `public-hoist-pattern` and `hoist-pattern`: Control hoisting
-
-Control which packages are hoisted to the root `node_modules`:
-
-```ini .npmrc icon="npm"
-# packages matching this pattern will be hoisted to the root
-public-hoist-pattern=*eslint*
-
-# multiple patterns
-public-hoist-pattern[]=*eslint*
-public-hoist-pattern[]=*prettier*
-
-# control general hoisting behavior
-hoist-pattern=*
-```

docs/project/building-windows.mdx

@@ -14,7 +14,7 @@ It is strongly recommended to use [PowerShell 7 (`pwsh.exe`)](https://learn.micr
 By default, running unverified scripts are blocked.
 
 ```ps1
-Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted
+> Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted
 ```
 
 ### System Dependencies
@@ -22,7 +22,7 @@ Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted
 Bun v1.1 or later. We use Bun to run it's own code generators.
 
 ```ps1
-irm bun.sh/install.ps1 | iex
+> irm bun.sh/install.ps1 | iex
 ```
 
 [Visual Studio](https://visualstudio.microsoft.com) with the "Desktop Development with C++" workload. While installing, make sure to install Git as well, if Git for Windows is not already installed.
@@ -30,7 +30,7 @@ irm bun.sh/install.ps1 | iex
 Visual Studio can be installed graphically using the wizard or through WinGet:
 
 ```ps1
-winget install "Visual Studio Community 2022" --override "--add Microsoft.VisualStudio.Workload.NativeDesktop Microsoft.VisualStudio.Component.Git " -s msstore
+> winget install "Visual Studio Community 2022" --override "--add Microsoft.VisualStudio.Workload.NativeDesktop Microsoft.VisualStudio.Component.Git " -s msstore
 ```
 
 After Visual Studio, you need the following:
@@ -48,10 +48,10 @@ After Visual Studio, you need the following:
 [Scoop](https://scoop.sh) can be used to install these remaining tools easily.
 
 ```ps1 Scoop
-irm https://get.scoop.sh | iex
-scoop install nodejs-lts go rust nasm ruby perl ccache
+> irm https://get.scoop.sh | iex
+> scoop install nodejs-lts go rust nasm ruby perl sccache
 # scoop seems to be buggy if you install llvm and the rest at the same time
-scoop install llvm@19.1.7
+> scoop install llvm@19.1.7
 ```
 
 <Note>
@@ -63,19 +63,19 @@ scoop install llvm@19.1.7
 If you intend on building WebKit locally (optional), you should install these packages:
 
 ```ps1 Scoop
-scoop install make cygwin python
+> scoop install make cygwin python
 ```
 
 From here on out, it is **expected you use a PowerShell Terminal with `.\scripts\vs-shell.ps1` sourced**. This script is available in the Bun repository and can be loaded by executing it:
 
 ```ps1
-.\scripts\vs-shell.ps1
+> .\scripts\vs-shell.ps1
 ```
 
 To verify, you can check for an MSVC-only command line such as `mt.exe`
 
 ```ps1
-Get-Command mt
+> Get-Command mt
 ```
 
 <Note>
@@ -86,16 +86,16 @@ Get-Command mt
 ## Building
 
 ```ps1
-bun run build
+> bun run build
 
 # after the initial `bun run build` you can use the following to build
-ninja -Cbuild/debug
+> ninja -Cbuild/debug
 ```
 
 If this was successful, you should have a `bun-debug.exe` in the `build/debug` folder.
 
 ```ps1
-.\build\debug\bun-debug.exe --revision
+> .\build\debug\bun-debug.exe --revision
 ```
 
 You should add this to `$Env:PATH`. The simplest way to do so is to open the start menu, type "Path", and then navigate the environment variables menu to add `C:\.....\bun\build\debug` to the user environment variable `PATH`. You should then restart your editor (if it does not update still, log out and log back in).
@@ -111,15 +111,15 @@ You can run the test suite either using `bun test <path>` or by using the wrappe
 
 ```ps1
 # Setup
-bun i --cwd packages\bun-internal-test
+> bun i --cwd packages\bun-internal-test
 
 # Run the entire test suite with reporter
 # the package.json script "test" uses "build/debug/bun-debug.exe" by default
-bun run test
+> bun run test
 
 # Run an individual test file:
-bun-debug test node\fs
-bun-debug test "C:\bun\test\js\bun\resolve\import-meta.test.js"
+> bun-debug test node\fs
+> bun-debug test "C:\bun\test\js\bun\resolve\import-meta.test.js"
 ```
 
 ## Troubleshooting

docs/project/contributing.mdx

@@ -28,23 +28,23 @@ Using your system's package manager, install Bun's dependencies:
 <CodeGroup>
 
 ```bash macOS (Homebrew)
-brew install automake ccache cmake coreutils gnu-sed go icu4c libiconv libtool ninja pkg-config rust ruby
+$ brew install automake cmake coreutils gnu-sed go icu4c libiconv libtool ninja pkg-config rust ruby sccache
 ```
 
 ```bash Ubuntu/Debian
-sudo apt install curl wget lsb-release software-properties-common cargo cmake git golang libtool ninja-build pkg-config rustc ruby-full xz-utils
+$ sudo apt install curl wget lsb-release software-properties-common cargo cmake git golang libtool ninja-build pkg-config rustc ruby-full xz-utils
 ```
 
 ```bash Arch
-sudo pacman -S base-devel cmake git go libiconv libtool make ninja pkg-config python rust sed unzip ruby
+$ sudo pacman -S base-devel cmake git go libiconv libtool make ninja pkg-config python rust sed unzip ruby
 ```
 
 ```bash Fedora
-sudo dnf install cargo clang19 llvm19 lld19 cmake git golang libtool ninja-build pkg-config rustc ruby libatomic-static libstdc++-static sed unzip which libicu-devel 'perl(Math::BigInt)'
+$ sudo dnf install cargo clang19 llvm19 lld19 cmake git golang libtool ninja-build pkg-config rustc ruby libatomic-static libstdc++-static sed unzip which libicu-devel 'perl(Math::BigInt)'
 ```
 
 ```bash openSUSE Tumbleweed
-sudo zypper install go cmake ninja automake git icu rustup && rustup toolchain install stable
+$ sudo zypper install go cmake ninja automake git icu rustup && rustup toolchain install stable
 ```
 
 </CodeGroup>
@@ -56,42 +56,59 @@ Before starting, you will need to already have a release build of Bun installed,
 <CodeGroup>
 
 ```bash Native
-curl -fsSL https://bun.com/install | bash
+$ curl -fsSL https://bun.com/install | bash
 ```
 
 ```bash npm
-npm install -g bun
+$ npm install -g bun
 ```
 
 ```bash Homebrew
-brew tap oven-sh/bun
-brew install bun
+$ brew tap oven-sh/bun
+$ brew install bun
 ```
 
 </CodeGroup>
 
-### Optional: Install `ccache`
+### Optional: Install `sccache`
 
-ccache is used to cache compilation artifacts, significantly speeding up builds:
+sccache is used to cache compilation artifacts, significantly speeding up builds. It must be installed with S3 support:
 
 ```bash
 # For macOS
-brew install ccache
+$ brew install sccache
 
-# For Ubuntu/Debian
-sudo apt install ccache
-
-# For Arch
-sudo pacman -S ccache
-
-# For Fedora
-sudo dnf install ccache
-
-# For openSUSE
-sudo zypper install ccache
+# For Linux. Note that the version in your package manager may not have S3 support.
+$ cargo install sccache --features=s3
 ```
 
-Our build scripts will automatically detect and use `ccache` if available. You can check cache statistics with `ccache --show-stats`.
+This will install `sccache` with S3 support. Our build scripts will automatically detect and use `sccache` with our shared S3 cache. **Note**: Not all versions of `sccache` are compiled with S3 support, hence we recommend installing it via `cargo`.
+
+#### Registering AWS Credentials for `sccache` (Core Developers Only)
+
+Core developers have write access to the shared S3 cache. To enable write access, you must log in with AWS credentials. The easiest way to do this is to use the [`aws` CLI](https://aws.amazon.com/cli/) and invoke [`aws configure` to provide your AWS security info](https://docs.aws.amazon.com/cli/latest/reference/configure/).
+
+The `cmake` scripts should automatically detect your AWS credentials from the environment or the `~/.aws/credentials` file.
+
+<details>
+    <summary>Logging in to the `aws` CLI</summary>
+
+    1. Install the AWS CLI by following [the official guide](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
+    2. Log in to your AWS account console. A team member should provide you with your credentials.
+    3. Click your name in the top right > Security credentials.
+    4. Scroll to "Access keys" and create a new access key.
+    5. Run `aws configure` in your terminal and provide the access key ID and secret access key when prompted.
+
+</details>
+
+<details>
+    <summary>Common Issues You May Encounter</summary>
+
+    - To confirm that the cache is being used, you can use the `sccache --show-stats` command right after a build. This will expose very useful statistics, including cache hits/misses.
+    - If you have multiple AWS profiles configured, ensure that the correct profile is set in the `AWS_PROFILE` environment variable.
+    - `sccache` follows a server-client model. If you run into weird issues where `sccache` refuses to use S3, even though you have AWS credentials configured, try killing any running `sccache` servers with `sccache --stop-server` and then re-running the build.
+
+</details>
 
 ## Install LLVM
 
@@ -100,24 +117,24 @@ Bun requires LLVM 19 (`clang` is part of LLVM). This version requirement is to m
 <CodeGroup>
 
 ```bash macOS (Homebrew)
-brew install llvm@19
+$ brew install llvm@19
 ```
 
 ```bash Ubuntu/Debian
-# LLVM has an automatic installation script that is compatible with all versions of Ubuntu
-wget https://apt.llvm.org/llvm.sh -O - | sudo bash -s -- 19 all
+$ # LLVM has an automatic installation script that is compatible with all versions of Ubuntu
+$ wget https://apt.llvm.org/llvm.sh -O - | sudo bash -s -- 19 all
 ```
 
 ```bash Arch
-sudo pacman -S llvm clang lld
+$ sudo pacman -S llvm clang lld
 ```
 
 ```bash Fedora
-sudo dnf install llvm clang lld-devel
+$ sudo dnf install llvm clang lld-devel
 ```
 
 ```bash openSUSE Tumbleweed
-sudo zypper install clang19 lld19 llvm19
+$ sudo zypper install clang19 lld19 llvm19
 ```
 
 </CodeGroup>
@@ -127,7 +144,7 @@ If none of the above solutions apply, you will have to install it [manually](htt
 Make sure Clang/LLVM 19 is in your path:
 
 ```bash
-which clang-19
+$ which clang-19
 ```
 
 If not, run this to manually add it:
@@ -137,12 +154,12 @@ If not, run this to manually add it:
 ```bash macOS (Homebrew)
 # use fish_add_path if you're using fish
 # use path+="$(brew --prefix llvm@19)/bin" if you are using zsh
-export PATH="$(brew --prefix llvm@19)/bin:$PATH"
+$ export PATH="$(brew --prefix llvm@19)/bin:$PATH"
 ```
 
 ```bash Arch
 # use fish_add_path if you're using fish
-export PATH="$PATH:/usr/lib/llvm19/bin"
+$ export PATH="$PATH:/usr/lib/llvm19/bin"
 ```
 
 </CodeGroup>
@@ -162,7 +179,7 @@ bun run build
 The binary will be located at `./build/debug/bun-debug`. It is recommended to add this to your `$PATH`. To verify the build worked, let's print the version number on the development build of Bun.
 
 ```bash
-build/debug/bun-debug --version
+$ build/debug/bun-debug --version
 x.y.z_debug
 ```
 
@@ -261,17 +278,17 @@ WebKit is not cloned by default (to save time and disk space). To clone and buil
 
 ```bash
 # Clone WebKit into ./vendor/WebKit
-git clone https://github.com/oven-sh/WebKit vendor/WebKit
+$ git clone https://github.com/oven-sh/WebKit vendor/WebKit
 
 # Check out the commit hash specified in `set(WEBKIT_VERSION <commit_hash>)` in cmake/tools/SetupWebKit.cmake
-git -C vendor/WebKit checkout <commit_hash>
+$ 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 `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
+$ cmake --build vendor/WebKit/WebKitBuild/Debug --target jsc && rm vendor/WebKit/WebKitBuild/Debug/JavaScriptCore/DerivedSources/inspector/InspectorProtocolObjects.h
 
 # Build bun with the local JSC build
 bun run build:local
@@ -322,20 +339,20 @@ is not able to compile a simple test program.
 To fix the error, we need to update the GCC version to 11. To do this, we'll need to check if the latest version is available in the distribution's official repositories or use a third-party repository that provides GCC 11 packages. Here are general steps:
 
 ```bash
-sudo apt update
-sudo apt install gcc-11 g++-11
+$ sudo apt update
+$ sudo apt install gcc-11 g++-11
 # If the above command fails with `Unable to locate package gcc-11` we need
 # to add the APT repository
-sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
+$ sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
 # Now run `apt install` again
-sudo apt install gcc-11 g++-11
+$ sudo apt install gcc-11 g++-11
 ```
 
 Now, we need to set GCC 11 as the default compiler:
 
 ```bash
-sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-11 100
-sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-11 100
+$ sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-11 100
+$ sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-11 100
 ```
 
 ### libarchive
@@ -343,7 +360,7 @@ sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-11 100
 If you see an error on macOS when compiling `libarchive`, run:
 
 ```bash
-brew install pkg-config
+$ brew install pkg-config
 ```
 
 ### macOS `library not found for -lSystem`
@@ -351,7 +368,7 @@ brew install pkg-config
 If you see this error when compiling, run:
 
 ```bash
-xcode-select --install
+$ xcode-select --install
 ```
 
 ### Cannot find `libatomic.a`

docs/runtime/archive.mdx

@@ -1,444 +0,0 @@
----
-title: Archive
-description: Create and extract tar archives with Bun's fast native implementation
----
-
-Bun provides a fast, native implementation for working with tar archives through `Bun.Archive`. It supports creating archives from in-memory data, extracting archives to disk, and reading archive contents without extraction.
-
-## Quickstart
-
-**Create an archive from files:**
-
-```ts
-const archive = Bun.Archive.from({
-  "hello.txt": "Hello, World!",
-  "data.json": JSON.stringify({ foo: "bar" }),
-  "nested/file.txt": "Nested content",
-});
-
-// Write to disk
-await Bun.Archive.write("bundle.tar", archive);
-```
-
-**Extract an archive:**
-
-```ts
-const tarball = await Bun.file("package.tar.gz").bytes();
-const archive = Bun.Archive.from(tarball);
-const entryCount = await archive.extract("./output");
-console.log(`Extracted ${entryCount} entries`);
-```
-
-**Read archive contents without extracting:**
-
-```ts
-const tarball = await Bun.file("package.tar.gz").bytes();
-const archive = Bun.Archive.from(tarball);
-const files = await archive.files();
-
-for (const [path, file] of files) {
-  console.log(`${path}: ${await file.text()}`);
-}
-```
-
-## Creating Archives
-
-Use `Bun.Archive.from()` to create an archive from an object where keys are file paths and values are file contents:
-
-```ts
-const archive = Bun.Archive.from({
-  "README.md": "# My Project",
-  "src/index.ts": "console.log('Hello');",
-  "package.json": JSON.stringify({ name: "my-project" }),
-});
-```
-
-File contents can be:
-
-- **Strings** - Text content
-- **Blobs** - Binary data
-- **ArrayBufferViews** (e.g., `Uint8Array`) - Raw bytes
-- **ArrayBuffers** - Raw binary data
-
-```ts
-const data = "binary data";
-const arrayBuffer = new ArrayBuffer(8);
-
-const archive = Bun.Archive.from({
-  "text.txt": "Plain text",
-  "blob.bin": new Blob([data]),
-  "bytes.bin": new Uint8Array([1, 2, 3, 4]),
-  "buffer.bin": arrayBuffer,
-});
-```
-
-### Writing Archives to Disk
-
-Use `Bun.Archive.write()` to create and write an archive in one operation:
-
-```ts
-// Write uncompressed tar
-await Bun.Archive.write("output.tar", {
-  "file1.txt": "content1",
-  "file2.txt": "content2",
-});
-
-// Write gzipped tar
-const files = { "src/index.ts": "console.log('Hello');" };
-await Bun.Archive.write("output.tar.gz", files, "gzip");
-```
-
-### Getting Archive Bytes
-
-Get the archive data as bytes or a Blob:
-
-```ts
-const files = { "hello.txt": "Hello, World!" };
-const archive = Bun.Archive.from(files);
-
-// As Uint8Array
-const bytes = await archive.bytes();
-
-// As Blob
-const blob = await archive.blob();
-
-// With gzip compression
-const gzippedBytes = await archive.bytes("gzip");
-const gzippedBlob = await archive.blob("gzip");
-```
-
-## Extracting Archives
-
-### From Existing Archive Data
-
-Create an archive from existing tar/tar.gz data:
-
-```ts
-// From a file
-const tarball = await Bun.file("package.tar.gz").bytes();
-const archiveFromFile = Bun.Archive.from(tarball);
-```
-
-```ts
-// From a fetch response
-const response = await fetch("https://example.com/archive.tar.gz");
-const archiveFromFetch = Bun.Archive.from(await response.blob());
-```
-
-### Extracting to Disk
-
-Use `.extract()` to write all files to a directory:
-
-```ts
-const tarball = await Bun.file("package.tar.gz").bytes();
-const archive = Bun.Archive.from(tarball);
-const count = await archive.extract("./extracted");
-console.log(`Extracted ${count} entries`);
-```
-
-The target directory is created automatically if it doesn't exist. Existing files are overwritten. The returned count includes files, directories, and symlinks (on POSIX systems).
-
-**Note**: On Windows, symbolic links in archives are always skipped during extraction. Bun does not attempt to create them regardless of privilege level. On Linux and macOS, symlinks are extracted normally.
-
-**Security note**: Bun.Archive validates paths during extraction, rejecting absolute paths (POSIX `/`, Windows drive letters like `C:\` or `C:/`, and UNC paths like `\\server\share`). Path traversal components (`..`) are normalized away (e.g., `dir/sub/../file` becomes `dir/file`) to prevent directory escape attacks.
-
-### Filtering Extracted Files
-
-Use glob patterns to extract only specific files. Patterns are matched against archive entry paths normalized to use forward slashes (`/`). Positive patterns specify what to include, and negative patterns (prefixed with `!`) specify what to exclude. Negative patterns are applied after positive patterns, so **using only negative patterns will match nothing** (you must include a positive pattern like `**` first):
-
-```ts
-const tarball = await Bun.file("package.tar.gz").bytes();
-const archive = Bun.Archive.from(tarball);
-
-// Extract only TypeScript files
-const tsCount = await archive.extract("./extracted", { glob: "**/*.ts" });
-
-// Extract files from multiple directories
-const multiCount = await archive.extract("./extracted", {
-  glob: ["src/**", "lib/**"],
-});
-```
-
-Use negative patterns (prefixed with `!`) to exclude files. When mixing positive and negative patterns, entries must match at least one positive pattern and not match any negative pattern:
-
-```ts
-// Extract everything except node_modules
-const distCount = await archive.extract("./extracted", {
-  glob: ["**", "!node_modules/**"],
-});
-
-// Extract source files but exclude tests
-const srcCount = await archive.extract("./extracted", {
-  glob: ["src/**", "!**/*.test.ts", "!**/__tests__/**"],
-});
-```
-
-## Reading Archive Contents
-
-### Get All Files
-
-Use `.files()` to get archive contents as a `Map` of `File` objects without extracting to disk. Unlike `extract()` which processes all entry types, `files()` returns only regular files (no directories):
-
-```ts
-const tarball = await Bun.file("package.tar.gz").bytes();
-const archive = Bun.Archive.from(tarball);
-const files = await archive.files();
-
-for (const [path, file] of files) {
-  console.log(`${path}: ${file.size} bytes`);
-  console.log(await file.text());
-}
-```
-
-Each `File` object includes:
-
-- `name` - The file path within the archive (always uses forward slashes `/` as separators)
-- `size` - File size in bytes
-- `lastModified` - Modification timestamp
-- Standard `Blob` methods: `text()`, `arrayBuffer()`, `stream()`, etc.
-
-**Note**: `files()` loads file contents into memory. For large archives, consider using `extract()` to write directly to disk instead.
-
-### Error Handling
-
-Archive operations can fail due to corrupted data, I/O errors, or invalid paths. Use try/catch to handle these cases:
-
-```ts
-try {
-  const tarball = await Bun.file("package.tar.gz").bytes();
-  const archive = Bun.Archive.from(tarball);
-  const count = await archive.extract("./output");
-  console.log(`Extracted ${count} entries`);
-} catch (e: unknown) {
-  if (e instanceof Error) {
-    const error = e as Error & { code?: string };
-    if (error.code === "EACCES") {
-      console.error("Permission denied");
-    } else if (error.code === "ENOSPC") {
-      console.error("Disk full");
-    } else {
-      console.error("Archive error:", error.message);
-    }
-  } else {
-    console.error("Archive error:", String(e));
-  }
-}
-```
-
-Common error scenarios:
-
-- **Corrupted/truncated archives** - `Archive.from()` loads the archive data; errors may be deferred until read/extract operations
-- **Permission denied** - `extract()` throws if the target directory is not writable
-- **Disk full** - `extract()` throws if there's insufficient space
-- **Invalid paths** - Operations throw for malformed file paths
-
-The count returned by `extract()` includes all successfully written entries (files, directories, and symlinks on POSIX systems).
-
-**Security note**: Bun.Archive automatically validates paths during extraction. Absolute paths (POSIX `/`, Windows drive letters, UNC paths) and unsafe symlink targets are rejected. Path traversal components (`..`) are normalized away to prevent directory escape.
-
-For additional security with untrusted archives, you can enumerate and validate paths before extraction:
-
-```ts
-const archive = Bun.Archive.from(untrustedData);
-const files = await archive.files();
-
-// Optional: Custom validation for additional checks
-for (const [path] of files) {
-  // Example: Reject hidden files
-  if (path.startsWith(".") || path.includes("/.")) {
-    throw new Error(`Hidden file rejected: ${path}`);
-  }
-  // Example: Whitelist specific directories
-  if (!path.startsWith("src/") && !path.startsWith("lib/")) {
-    throw new Error(`Unexpected path: ${path}`);
-  }
-}
-
-// Extract to a controlled destination
-await archive.extract("./safe-output");
-```
-
-When using `files()` with a glob pattern, an empty `Map` is returned if no files match:
-
-```ts
-const matches = await archive.files("*.nonexistent");
-if (matches.size === 0) {
-  console.log("No matching files found");
-}
-```
-
-### Filtering with Glob Patterns
-
-Pass a glob pattern to filter which files are returned:
-
-```ts
-// Get only TypeScript files
-const tsFiles = await archive.files("**/*.ts");
-
-// Get files in src directory
-const srcFiles = await archive.files("src/*");
-
-// Get all JSON files (recursive)
-const jsonFiles = await archive.files("**/*.json");
-
-// Get multiple file types with array of patterns
-const codeFiles = await archive.files(["**/*.ts", "**/*.js"]);
-```
-
-Supported glob patterns (subset of [Bun.Glob](/docs/api/glob) syntax):
-
-- `*` - Match any characters except `/`
-- `**` - Match any characters including `/`
-- `?` - Match single character
-- `[abc]` - Match character set
-- `{a,b}` - Match alternatives
-- `!pattern` - Exclude files matching pattern (negation). Must be combined with positive patterns; using only negative patterns matches nothing.
-
-See [Bun.Glob](/docs/api/glob) for the full glob syntax including escaping and advanced patterns.
-
-## Compression
-
-Bun.Archive supports gzip compression for both reading and writing:
-
-```ts
-// Reading: automatically detects gzip
-const gzippedTarball = await Bun.file("archive.tar.gz").bytes();
-const archive = Bun.Archive.from(gzippedTarball);
-
-// Writing: specify compression
-const files = { "hello.txt": "Hello, World!" };
-await Bun.Archive.write("output.tar.gz", files, "gzip");
-
-// Getting bytes: specify compression
-const gzippedBytes = await archive.bytes("gzip");
-```
-
-The compression argument accepts:
-
-- `"gzip"` - Enable gzip compression
-- `true` - Same as `"gzip"`
-- `false` or `undefined` - No compression
-
-## Examples
-
-### Bundle Project Files
-
-```ts
-import { Glob } from "bun";
-
-// Collect source files
-const files: Record<string, string> = {};
-const glob = new Glob("src/**/*.ts");
-
-for await (const path of glob.scan(".")) {
-  // Normalize path separators to forward slashes for cross-platform compatibility
-  const archivePath = path.replaceAll("\\", "/");
-  files[archivePath] = await Bun.file(path).text();
-}
-
-// Add package.json
-files["package.json"] = await Bun.file("package.json").text();
-
-// Create compressed archive
-await Bun.Archive.write("bundle.tar.gz", files, "gzip");
-```
-
-### Extract and Process npm Package
-
-```ts
-const response = await fetch("https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz");
-const archive = Bun.Archive.from(await response.blob());
-
-// Get package.json
-const files = await archive.files("package/package.json");
-const packageJson = files.get("package/package.json");
-
-if (packageJson) {
-  const pkg = JSON.parse(await packageJson.text());
-  console.log(`Package: ${pkg.name}@${pkg.version}`);
-}
-```
-
-### Create Archive from Directory
-
-```ts
-import { readdir } from "node:fs/promises";
-import { join } from "node:path";
-
-async function archiveDirectory(dir: string): Promise<Bun.Archive> {
-  const files: Record<string, Blob> = {};
-
-  async function walk(currentDir: string, prefix: string = "") {
-    const entries = await readdir(currentDir, { withFileTypes: true });
-
-    for (const entry of entries) {
-      const fullPath = join(currentDir, entry.name);
-      const archivePath = prefix ? `${prefix}/${entry.name}` : entry.name;
-
-      if (entry.isDirectory()) {
-        await walk(fullPath, archivePath);
-      } else {
-        files[archivePath] = Bun.file(fullPath);
-      }
-    }
-  }
-
-  await walk(dir);
-  return Bun.Archive.from(files);
-}
-
-const archive = await archiveDirectory("./my-project");
-await Bun.Archive.write("my-project.tar.gz", archive, "gzip");
-```
-
-## Reference
-
-> **Note**: The following type signatures are simplified for documentation purposes. See [`packages/bun-types/bun.d.ts`](https://github.com/oven-sh/bun/blob/main/packages/bun-types/bun.d.ts) for the full type definitions.
-
-```ts
-type ArchiveCompression = "gzip" | boolean;
-
-type ArchiveInput =
-  | Record<string, string | Blob | Bun.ArrayBufferView | ArrayBufferLike>
-  | Blob
-  | Bun.ArrayBufferView
-  | ArrayBufferLike;
-
-interface ArchiveExtractOptions {
-  /** Glob pattern(s) to filter extraction. Supports negative patterns with "!" prefix. */
-  glob?: string | readonly string[];
-}
-
-class Archive {
-  /**
-   * Create an Archive from input data
-   */
-  static from(data: ArchiveInput): Archive;
-
-  /**
-   * Write an archive directly to disk
-   */
-  static write(path: string, data: ArchiveInput | Archive, compress?: ArchiveCompression): Promise<void>;
-
-  /**
-   * Extract archive to a directory
-   * @returns Number of entries extracted (files, directories, and symlinks)
-   */
-  extract(path: string, options?: ArchiveExtractOptions): Promise<number>;
-
-  /**
-   * Get archive as a Blob
-   */
-  blob(compress?: ArchiveCompression): Promise<Blob>;
-
-  /**
-   * Get archive as a Uint8Array
-   */
-  bytes(compress?: ArchiveCompression): Promise<Uint8Array<ArrayBuffer>>;
-
-  /**
-   * Get archive contents as File objects (regular files only, no directories)
-   */
-  files(glob?: string | readonly string[]): Promise<Map<string, File>>;
-}
-```

docs/runtime/bunfig.mdx

@@ -115,26 +115,6 @@ Currently we do not collect telemetry and this setting is only used for enabling
 telemetry = false
 ```
 
-### `env`
-
-Configure automatic `.env` file loading. By default, Bun automatically loads `.env` files. To disable this behavior:
-
-```toml title="bunfig.toml" icon="settings"
-# Disable automatic .env file loading
-env = false
-```
-
-You can also use object syntax with the `file` property:
-
-```toml title="bunfig.toml" icon="settings"
-[env]
-file = false
-```
-
-This is useful in production environments or CI/CD pipelines where you want to rely solely on system environment variables.
-
-Note: Explicitly provided environment files via `--env-file` will still be loaded even when default loading is disabled.
-
 ### `console`
 
 Configure console output behavior.

docs/runtime/ffi.mdx

@@ -358,8 +358,6 @@ Bun represents [pointers](<https://en.wikipedia.org/wiki/Pointer_(computer_progr
 
 **Why not `BigInt`?** `BigInt` is slower. JavaScript engines allocate a separate `BigInt` which means they can't fit into a regular JavaScript value. If you pass a `BigInt` to a function, it will be converted to a `number`
 
-**Windows Note**: The Windows API type HANDLE does not represent a virtual address, and using `ptr` for it will _not_ work as expected. Use `u64` to safely represent HANDLE values.
-
 </Accordion>
 
 To convert from a `TypedArray` to a pointer:

docs/runtime/networking/udp.mdx

@@ -127,54 +127,3 @@ const socket = await Bun.udpSocket({
   },
 });
 ```
-
-### Socket options
-
-UDP sockets support setting various socket options:
-
-```ts
-const socket = await Bun.udpSocket({});
-
-// Enable broadcasting to send packets to a broadcast address
-socket.setBroadcast(true);
-
-// Set the IP TTL (time to live) for outgoing packets
-socket.setTTL(64);
-```
-
-### Multicast
-
-Bun supports multicast operations for UDP sockets. Use `addMembership` and `dropMembership` to join and leave multicast groups:
-
-```ts
-const socket = await Bun.udpSocket({});
-
-// Join a multicast group
-socket.addMembership("224.0.0.1");
-
-// Join with a specific interface
-socket.addMembership("224.0.0.1", "192.168.1.100");
-
-// Leave a multicast group
-socket.dropMembership("224.0.0.1");
-```
-
-Additional multicast options:
-
-```ts
-// Set TTL for multicast packets (number of network hops)
-socket.setMulticastTTL(2);
-
-// Control whether multicast packets loop back to the local socket
-socket.setMulticastLoopback(true);
-
-// Specify which interface to use for outgoing multicast packets
-socket.setMulticastInterface("192.168.1.100");
-```
-
-For source-specific multicast (SSM), use `addSourceSpecificMembership` and `dropSourceSpecificMembership`:
-
-```ts
-socket.addSourceSpecificMembership("10.0.0.1", "232.0.0.1");
-socket.dropSourceSpecificMembership("10.0.0.1", "232.0.0.1");
-```

docs/runtime/sqlite.mdx

@@ -303,7 +303,7 @@ Internally, this calls [`sqlite3_reset`](https://www.sqlite.org/capi3ref.html#sq
 
 ### `.run()`
 
-Use `.run()` to run a query and get back an object with execution metadata. This is useful for schema-modifying queries (e.g. `CREATE TABLE`) or bulk write operations.
+Use `.run()` to run a query and get back `undefined`. This is useful for schema-modifying queries (e.g. `CREATE TABLE`) or bulk write operations.
 
 ```ts db.ts icon="/icons/typescript.svg" highlight={2}
 const query = db.query(`create table foo;`);

docs/runtime/templating/create.mdx

@@ -19,7 +19,7 @@ If you're looking to create a brand new empty project, use [`bun init`](/runtime
 `bun create ./MyComponent.tsx` turns an existing React component into a complete dev environment with hot reload and production builds in one command.
 
 ```bash
-bun create ./MyComponent.jsx # .tsx also supported
+$ bun create ./MyComponent.jsx # .tsx also supported
 ```
 
 <Frame>

docs/style.css

@@ -149,25 +149,25 @@ div.callout .code-block {
   margin-bottom: 0px;
 }
 
-[language="shellscript"] code span.line:not(:empty):has(span)::before {
+.code-block[language="shellscript"] code span.line:not(:empty):has(span)::before {
   content: "$ ";
   color: #6272a4;
   user-select: none;
 }
 
-[language="shellscript"] code span.line:has(> span:first-child[style*="color: rgb(98, 114, 164)"])::before,
-[language="shellscript"] code span.line:has(> span:first-child[style*="#6272A4"])::before {
+.code-block[language="shellscript"] code span.line:has(> span:first-child[style*="color: rgb(98, 114, 164)"])::before,
+.code-block[language="shellscript"] code span.line:has(> span:first-child[style*="#6272A4"])::before {
   content: "";
 }
 
-[language="powershell"] code span.line:not(:empty):has(span)::before {
+.code-block[language="powershell"] code span.line:not(:empty):has(span)::before {
   content: "> ";
   color: #6272a4;
   user-select: none;
 }
 
-[language="powershell"] code span.line:has(> span:first-child[style*="color: rgb(98, 114, 164)"])::before,
-[language="powershell"] code span.line:has(> span:first-child[style*="#6272A4"])::before {
+.code-block[language="powershell"] code span.line:has(> span:first-child[style*="color: rgb(98, 114, 164)"])::before,
+.code-block[language="powershell"] code span.line:has(> span:first-child[style*="#6272A4"])::before {
   content: "";
 }
 

docs/test/configuration.mdx

@@ -376,18 +376,16 @@ timeout = 10000
 
 ## Environment Variables
 
-Environment variables for tests should be set using `.env` files. Bun automatically loads `.env` files from your project root. For test-specific variables, create a `.env.test` file:
+You can also set environment variables in your configuration that affect test behavior:
 
-```ini title=".env.test" icon="settings"
-NODE_ENV=test
-DATABASE_URL=postgresql://localhost:5432/test_db
-LOG_LEVEL=error
-```
+```toml title="bunfig.toml" icon="settings"
+[env]
+NODE_ENV = "test"
+DATABASE_URL = "postgresql://localhost:5432/test_db"
+LOG_LEVEL = "error"
 
-Then load it with `--env-file`:
-
-```bash terminal icon="terminal"
-bun test --env-file=.env.test
+[test]
+coverage = true
 ```
 
 ## Complete Configuration Example
@@ -400,6 +398,13 @@ Here's a comprehensive example showing all available test configuration options:
 registry = "https://registry.npmjs.org/"
 exact = true
 
+[env]
+# Environment variables for tests
+NODE_ENV = "test"
+DATABASE_URL = "postgresql://localhost:5432/test_db"
+API_URL = "http://localhost:3001"
+LOG_LEVEL = "error"
+
 [test]
 # Test discovery
 root = "src"

flake.nix

@@ -40,7 +40,7 @@
           pkgs.cmake # Expected: 3.30+ on nixos-unstable as of 2025-10
           pkgs.ninja
           pkgs.pkg-config
-          pkgs.ccache
+          pkgs.sccache
 
           # Compilers and toolchain - version pinned to LLVM 19
           clang

package.json

@@ -1,7 +1,7 @@
 {
   "private": true,
   "name": "bun",
-  "version": "1.3.6",
+  "version": "1.3.5",
   "workspaces": [
     "./packages/bun-types",
     "./packages/@types/bun"

packages/bun-types/bun.d.ts

@@ -625,33 +625,6 @@ declare module "bun" {
     export function parse(input: string): object;
   }
 
-  /**
-   * JSONC related APIs
-   */
-  namespace JSONC {
-    /**
-     * Parse a JSONC (JSON with Comments) string into a JavaScript value.
-     *
-     * Supports both single-line (`//`) and block comments (`/* ... *\/`), as well as
-     * trailing commas in objects and arrays.
-     *
-     * @category Utilities
-     *
-     * @param input The JSONC string to parse
-     * @returns A JavaScript value
-     *
-     * @example
-     * ```js
-     * const result = Bun.JSONC.parse(`{
-     *   // This is a comment
-     *   "name": "my-app",
-     *   "version": "1.0.0", // trailing comma is allowed
-     * }`);
-     * ```
-     */
-    export function parse(input: string): unknown;
-  }
-
   /**
    * YAML related APIs
    */
@@ -842,20 +815,6 @@ declare module "bun" {
     destination: BunFile,
     input: BunFile,
     options?: {
-      /**
-       * Set the file permissions of the destination when it is created or overwritten.
-       *
-       * Must be a valid Unix permission mode (0 to 0o777 / 511 in decimal).
-       * If omitted, defaults to the system default based on umask (typically 0o644).
-       *
-       * @throws {RangeError} If the mode is outside the valid range (0 to 0o777).
-       *
-       * @example
-       * ```ts
-       * await Bun.write(Bun.file("./secret.txt"), Bun.file("./source.txt"), { mode: 0o600 });
-       * ```
-       */
-      mode?: number;
       /**
        * If `true`, create the parent directory if it doesn't exist. By default, this is `true`.
        *
@@ -889,20 +848,6 @@ declare module "bun" {
     destinationPath: PathLike,
     input: BunFile,
     options?: {
-      /**
-       * Set the file permissions of the destination when it is created or overwritten.
-       *
-       * Must be a valid Unix permission mode (0 to 0o777 / 511 in decimal).
-       * If omitted, defaults to the system default based on umask (typically 0o644).
-       *
-       * @throws {RangeError} If the mode is outside the valid range (0 to 0o777).
-       *
-       * @example
-       * ```ts
-       * await Bun.write("./secret.txt", Bun.file("./source.txt"), { mode: 0o600 });
-       * ```
-       */
-      mode?: number;
       /**
        * If `true`, create the parent directory if it doesn't exist. By default, this is `true`.
        *
@@ -1997,107 +1942,6 @@ declare module "bun" {
       development?: boolean;
     };
 
-    /**
-     * Enable React Fast Refresh transform.
-     *
-     * This adds the necessary code transformations for React Fast Refresh (hot module
-     * replacement for React components), but does not emit hot-module code itself.
-     *
-     * @default false
-     */
-    reactFastRefresh?: boolean;
-
-    /**
-     * A map of file paths to their contents for in-memory bundling.
-     *
-     * This allows you to bundle virtual files that don't exist on disk, or override
-     * the contents of files that do exist on disk. The keys are file paths (which should
-     * match how they're imported) and the values are the file contents.
-     *
-     * File contents can be provided as:
-     * - `string` - The source code as a string
-     * - `Blob` - A Blob containing the source code
-     * - `NodeJS.TypedArray` - A typed array (e.g., `Uint8Array`) containing the source code
-     * - `ArrayBufferLike` - An ArrayBuffer containing the source code
-     *
-     * @example
-     * ```ts
-     * // Bundle entirely from memory (no files on disk needed)
-     * await Bun.build({
-     *   entrypoints: ["/app/index.ts"],
-     *   files: {
-     *     "/app/index.ts": `
-     *       import { helper } from "./helper.ts";
-     *       console.log(helper());
-     *     `,
-     *     "/app/helper.ts": `
-     *       export function helper() {
-     *         return "Hello from memory!";
-     *       }
-     *     `,
-     *   },
-     * });
-     * ```
-     *
-     * @example
-     * ```ts
-     * // Override a file on disk with in-memory contents
-     * await Bun.build({
-     *   entrypoints: ["./src/index.ts"],
-     *   files: {
-     *     // This will be used instead of the actual ./src/config.ts file
-     *     "./src/config.ts": `export const API_URL = "https://production.api.com";`,
-     *   },
-     * });
-     * ```
-     *
-     * @example
-     * ```ts
-     * // Mix disk files with in-memory files
-     * // Entry point is on disk, but imports a virtual file
-     * await Bun.build({
-     *   entrypoints: ["./src/index.ts"], // Real file on disk
-     *   files: {
-     *     // Virtual file that ./src/index.ts can import via "./generated.ts"
-     *     "./src/generated.ts": `export const BUILD_TIME = ${Date.now()};`,
-     *   },
-     * });
-     * ```
-     */
-    files?: Record<string, string | Blob | NodeJS.TypedArray | ArrayBufferLike>;
-
-    /**
-     * Generate a JSON file containing metadata about the build.
-     *
-     * The metafile contains information about inputs, outputs, imports, and exports
-     * which can be used for bundle analysis, visualization, or integration with
-     * other tools.
-     *
-     * When `true`, the metafile JSON string is included in the {@link BuildOutput.metafile} property.
-     *
-     * @default false
-     *
-     * @example
-     * ```ts
-     * const result = await Bun.build({
-     *   entrypoints: ['./src/index.ts'],
-     *   outdir: './dist',
-     *   metafile: true,
-     * });
-     *
-     * // Write metafile to disk for analysis
-     * if (result.metafile) {
-     *   await Bun.write('./dist/meta.json', result.metafile);
-     * }
-     *
-     * // Parse and analyze the metafile
-     * const meta = JSON.parse(result.metafile!);
-     * console.log('Input files:', Object.keys(meta.inputs));
-     * console.log('Output files:', Object.keys(meta.outputs));
-     * ```
-     */
-    metafile?: boolean;
-
     outdir?: string;
   }
 
@@ -2126,26 +1970,6 @@ declare module "bun" {
      * @default true
      */
     autoloadBunfig?: boolean;
-    /**
-     * Whether to autoload tsconfig.json when the standalone executable runs
-     *
-     * Standalone-only: applies only when building/running the standalone executable.
-     *
-     * Equivalent CLI flags: `--compile-autoload-tsconfig`, `--no-compile-autoload-tsconfig`
-     *
-     * @default false
-     */
-    autoloadTsconfig?: boolean;
-    /**
-     * Whether to autoload package.json when the standalone executable runs
-     *
-     * Standalone-only: applies only when building/running the standalone executable.
-     *
-     * Equivalent CLI flags: `--compile-autoload-package-json`, `--no-compile-autoload-package-json`
-     *
-     * @default false
-     */
-    autoloadPackageJson?: boolean;
     windows?: {
       hideConsole?: boolean;
       icon?: string;
@@ -2749,106 +2573,6 @@ declare module "bun" {
     outputs: BuildArtifact[];
     success: boolean;
     logs: Array<BuildMessage | ResolveMessage>;
-    /**
-     * Metadata about the build including inputs, outputs, and their relationships.
-     *
-     * Only present when {@link BuildConfig.metafile} is `true`.
-     *
-     * The metafile contains detailed information about:
-     * - **inputs**: All source files that were bundled, their byte sizes, imports, and format
-     * - **outputs**: All generated output files, their byte sizes, which inputs contributed to each output, imports between chunks, and exports
-     *
-     * This can be used for:
-     * - Bundle size analysis and visualization
-     * - Detecting unused code or dependencies
-     * - Understanding the dependency graph
-     * - Integration with bundle analyzer tools
-     *
-     * @example
-     * ```ts
-     * const result = await Bun.build({
-     *   entrypoints: ['./src/index.ts'],
-     *   outdir: './dist',
-     *   metafile: true,
-     * });
-     *
-     * if (result.metafile) {
-     *   // Analyze input files
-     *   for (const [path, input] of Object.entries(result.metafile.inputs)) {
-     *     console.log(`${path}: ${input.bytes} bytes, ${input.imports.length} imports`);
-     *   }
-     *
-     *   // Analyze output files
-     *   for (const [path, output] of Object.entries(result.metafile.outputs)) {
-     *     console.log(`${path}: ${output.bytes} bytes`);
-     *     for (const [inputPath, info] of Object.entries(output.inputs)) {
-     *       console.log(`  - ${inputPath}: ${info.bytesInOutput} bytes`);
-     *     }
-     *   }
-     *
-     *   // Write to disk for external analysis tools
-     *   await Bun.write('./dist/meta.json', JSON.stringify(result.metafile));
-     * }
-     * ```
-     */
-    metafile?: BuildMetafile;
-  }
-
-  /**
-   * Metafile structure containing build metadata for analysis.
-   *
-   * @category Bundler
-   */
-  interface BuildMetafile {
-    /** Information about all input source files */
-    inputs: {
-      [path: string]: {
-        /** Size of the input file in bytes */
-        bytes: number;
-        /** List of imports from this file */
-        imports: Array<{
-          /** Resolved path of the imported file */
-          path: string;
-          /** Type of import statement */
-          kind: ImportKind;
-          /** Original import specifier before resolution (if different from path) */
-          original?: string;
-          /** Whether this import is external to the bundle */
-          external?: boolean;
-          /** Import attributes (e.g., `{ type: "json" }`) */
-          with?: Record<string, string>;
-        }>;
-        /** Module format of the input file */
-        format?: "esm" | "cjs" | "json" | "css";
-      };
-    };
-    /** Information about all output files */
-    outputs: {
-      [path: string]: {
-        /** Size of the output file in bytes */
-        bytes: number;
-        /** Map of input files to their contribution in this output */
-        inputs: {
-          [path: string]: {
-            /** Number of bytes this input contributed to the output */
-            bytesInOutput: number;
-          };
-        };
-        /** List of imports to other chunks */
-        imports: Array<{
-          /** Path to the imported chunk */
-          path: string;
-          /** Type of import */
-          kind: ImportKind;
-        }>;
-        /** List of exported names from this output */
-        exports: string[];
-        /** Entry point path if this output is an entry point */
-        entryPoint?: string;
-        /** Path to the associated CSS bundle (for JS entry points with CSS) */
-        cssBundle?: string;
-      };
-    };
   }
 
   /**
@@ -3318,29 +3042,16 @@ declare module "bun" {
 
   type WebSocketOptionsTLS = {
     /**
-     * Options for the TLS connection.
-     *
-     * Supports full TLS configuration including custom CA certificates,
-     * client certificates, and other TLS settings (same as fetch).
-     *
-     * @example
-     * ```ts
-     * // Using BunFile for certificates
-     * const ws = new WebSocket("wss://example.com", {
-     *   tls: {
-     *     ca: Bun.file("./ca.pem")
-     *   }
-     * });
-     *
-     * // Using Buffer
-     * const ws = new WebSocket("wss://example.com", {
-     *   tls: {
-     *     ca: fs.readFileSync("./ca.pem")
-     *   }
-     * });
-     * ```
+     * Options for the TLS connection
      */
-    tls?: TLSOptions;
+    tls?: {
+      /**
+       * Whether to reject the connection if the certificate is not valid
+       *
+       * @default true
+       */
+      rejectUnauthorized?: boolean;
+    };
   };
 
   type WebSocketOptionsHeaders = {
@@ -3350,57 +3061,10 @@ declare module "bun" {
     headers?: import("node:http").OutgoingHttpHeaders;
   };
 
-  type WebSocketOptionsProxy = {
-    /**
-     * HTTP proxy to use for the WebSocket connection.
-     *
-     * Can be a string URL or an object with `url` and optional `headers`.
-     *
-     * @example
-     * ```ts
-     * // String format
-     * const ws = new WebSocket("wss://example.com", {
-     *   proxy: "http://proxy.example.com:8080"
-     * });
-     *
-     * // With credentials
-     * const ws = new WebSocket("wss://example.com", {
-     *   proxy: "http://user:pass@proxy.example.com:8080"
-     * });
-     *
-     * // Object format with custom headers
-     * const ws = new WebSocket("wss://example.com", {
-     *   proxy: {
-     *     url: "http://proxy.example.com:8080",
-     *     headers: {
-     *       "Proxy-Authorization": "Bearer token"
-     *     }
-     *   }
-     * });
-     * ```
-     */
-    proxy?:
-      | string
-      | {
-          /**
-           * The proxy URL (http:// or https://)
-           */
-          url: string;
-          /**
-           * Custom headers to send to the proxy server.
-           * Supports plain objects or Headers class instances.
-           */
-          headers?: import("node:http").OutgoingHttpHeaders | Headers;
-        };
-  };
-
   /**
    * Constructor options for the `Bun.WebSocket` client
    */
-  type WebSocketOptions = WebSocketOptionsProtocolsOrProtocol &
-    WebSocketOptionsTLS &
-    WebSocketOptionsHeaders &
-    WebSocketOptionsProxy;
+  type WebSocketOptions = WebSocketOptionsProtocolsOrProtocol & WebSocketOptionsTLS & WebSocketOptionsHeaders;
 
   interface WebSocketEventMap {
     close: CloseEvent;
@@ -5644,67 +5308,6 @@ declare module "bun" {
       ref(): void;
       unref(): void;
       close(): void;
-      /**
-       * Enable or disable SO_BROADCAST socket option.
-       * @param enabled Whether to enable broadcast
-       * @returns The enabled value
-       */
-      setBroadcast(enabled: boolean): boolean;
-      /**
-       * Set the IP_TTL socket option.
-       * @param ttl Time to live value
-       * @returns The TTL value
-       */
-      setTTL(ttl: number): number;
-      /**
-       * Set the IP_MULTICAST_TTL socket option.
-       * @param ttl Time to live value for multicast packets
-       * @returns The TTL value
-       */
-      setMulticastTTL(ttl: number): number;
-      /**
-       * Enable or disable IP_MULTICAST_LOOP socket option.
-       * @param enabled Whether to enable multicast loopback
-       * @returns The enabled value
-       */
-      setMulticastLoopback(enabled: boolean): boolean;
-      /**
-       * Set the IP_MULTICAST_IF socket option to specify the outgoing interface
-       * for multicast packets.
-       * @param interfaceAddress The address of the interface to use
-       * @returns true on success
-       */
-      setMulticastInterface(interfaceAddress: string): boolean;
-      /**
-       * Join a multicast group.
-       * @param multicastAddress The multicast group address
-       * @param interfaceAddress Optional interface address to use
-       * @returns true on success
-       */
-      addMembership(multicastAddress: string, interfaceAddress?: string): boolean;
-      /**
-       * Leave a multicast group.
-       * @param multicastAddress The multicast group address
-       * @param interfaceAddress Optional interface address to use
-       * @returns true on success
-       */
-      dropMembership(multicastAddress: string, interfaceAddress?: string): boolean;
-      /**
-       * Join a source-specific multicast group.
-       * @param sourceAddress The source address
-       * @param groupAddress The multicast group address
-       * @param interfaceAddress Optional interface address to use
-       * @returns true on success
-       */
-      addSourceSpecificMembership(sourceAddress: string, groupAddress: string, interfaceAddress?: string): boolean;
-      /**
-       * Leave a source-specific multicast group.
-       * @param sourceAddress The source address
-       * @param groupAddress The multicast group address
-       * @param interfaceAddress Optional interface address to use
-       * @returns true on success
-       */
-      dropSourceSpecificMembership(sourceAddress: string, groupAddress: string, interfaceAddress?: string): boolean;
     }
 
     export interface ConnectedSocket<DataBinaryType extends BinaryType> extends BaseUDPSocket {
@@ -6965,296 +6568,6 @@ declare module "bun" {
     match(str: string): boolean;
   }
 
-  /**
-   * Input data for creating an archive. Can be:
-   * - An object mapping paths to file contents (string, Blob, TypedArray, or ArrayBuffer)
-   * - A Blob containing existing archive data
-   * - A TypedArray or ArrayBuffer containing existing archive data
-   */
-  type ArchiveInput = Record<string, BlobPart> | Blob | ArrayBufferView | ArrayBufferLike;
-
-  /**
-   * Compression format for archive output.
-   * - `"gzip"` - Compress with gzip
-   * - `true` - Same as `"gzip"`
-   * - `false` - Explicitly disable compression (no compression)
-   * - `undefined` - No compression (default behavior when omitted)
-   *
-   * Both `false` and `undefined` result in no compression; `false` can be used
-   * to explicitly indicate "no compression" in code where the intent should be clear.
-   */
-  type ArchiveCompression = "gzip" | boolean;
-
-  /**
-   * Options for extracting archive contents.
-   */
-  interface ArchiveExtractOptions {
-    /**
-     * Glob pattern(s) to filter which entries are extracted.
-     * Uses the same syntax as {@link Bun.Glob}, including support for wildcards (`*`, `**`),
-     * character classes (`[abc]`), alternation (`{a,b}`), and negation (`!pattern`).
-     *
-     * Patterns are matched against archive entry paths normalized to use forward slashes (`/`),
-     * regardless of the host operating system. Always write patterns using `/` as the separator.
-     *
-     * - Positive patterns: Only entries matching at least one pattern will be extracted.
-     * - Negative patterns (prefixed with `!`): Entries matching these patterns will be excluded.
-     *   Negative patterns are applied after positive patterns.
-     *
-     * If not specified, all entries are extracted.
-     *
-     * @example
-     * ```ts
-     * // Extract only TypeScript files
-     * await archive.extract("./out", { glob: "**" + "/*.ts" });
-     *
-     * // Extract files from multiple directories
-     * await archive.extract("./out", { glob: ["src/**", "lib/**"] });
-     *
-     * // Exclude node_modules using negative pattern
-     * await archive.extract("./out", { glob: ["**", "!node_modules/**"] });
-     *
-     * // Extract source files but exclude tests
-     * await archive.extract("./out", { glob: ["src/**", "!**" + "/*.test.ts"] });
-     * ```
-     */
-    glob?: string | readonly string[];
-  }
-
-  /**
-   * A class for creating and extracting tar archives with optional gzip compression.
-   *
-   * `Bun.Archive` provides a fast, native implementation for working with tar archives.
-   * It supports creating archives from in-memory data or extracting existing archives
-   * to disk or memory.
-   *
-   * @example
-   * **Create an archive from an object:**
-   * ```ts
-   * const archive = Bun.Archive.from({
-   *   "hello.txt": "Hello, World!",
-   *   "data.json": JSON.stringify({ foo: "bar" }),
-   *   "binary.bin": new Uint8Array([1, 2, 3, 4]),
-   * });
-   * ```
-   *
-   * @example
-   * **Extract an archive to disk:**
-   * ```ts
-   * const archive = Bun.Archive.from(tarballBytes);
-   * const entryCount = await archive.extract("./output");
-   * console.log(`Extracted ${entryCount} entries`);
-   * ```
-   *
-   * @example
-   * **Get archive contents as a Map of File objects:**
-   * ```ts
-   * const archive = Bun.Archive.from(tarballBytes);
-   * const entries = await archive.files();
-   * for (const [path, file] of entries) {
-   *   console.log(path, await file.text());
-   * }
-   * ```
-   *
-   * @example
-   * **Write a gzipped archive directly to disk:**
-   * ```ts
-   * await Bun.Archive.write("bundle.tar.gz", {
-   *   "src/index.ts": sourceCode,
-   *   "package.json": packageJson,
-   * }, "gzip");
-   * ```
-   */
-  export class Archive {
-    /**
-     * Create an `Archive` instance from input data.
-     *
-     * @param data - The input data for the archive:
-     *   - **Object**: Creates a new tarball with the object's keys as file paths and values as file contents
-     *   - **Blob/TypedArray/ArrayBuffer**: Wraps existing archive data (tar or tar.gz)
-     *
-     * @returns A new `Archive` instance
-     *
-     * @example
-     * **From an object (creates new tarball):**
-     * ```ts
-     * const archive = Bun.Archive.from({
-     *   "hello.txt": "Hello, World!",
-     *   "nested/file.txt": "Nested content",
-     * });
-     * ```
-     *
-     * @example
-     * **From existing archive data:**
-     * ```ts
-     * const response = await fetch("https://example.com/package.tar.gz");
-     * const archive = Bun.Archive.from(await response.blob());
-     * ```
-     */
-    static from(data: ArchiveInput): Archive;
-
-    /**
-     * Create and write an archive directly to disk in one operation.
-     *
-     * This is more efficient than creating an archive and then writing it separately,
-     * as it streams the data directly to disk.
-     *
-     * @param path - The file path to write the archive to
-     * @param data - The input data for the archive (same as `Archive.from()`)
-     * @param compress - Optional compression: `"gzip"`, `true` for gzip, or `false`/`undefined` for none
-     *
-     * @returns A promise that resolves when the write is complete
-     *
-     * @example
-     * **Write uncompressed tarball:**
-     * ```ts
-     * await Bun.Archive.write("output.tar", {
-     *   "file1.txt": "content1",
-     *   "file2.txt": "content2",
-     * });
-     * ```
-     *
-     * @example
-     * **Write gzipped tarball:**
-     * ```ts
-     * await Bun.Archive.write("output.tar.gz", files, "gzip");
-     * ```
-     */
-    static write(path: string, data: ArchiveInput | Archive, compress?: ArchiveCompression): Promise<void>;
-
-    /**
-     * Extract the archive contents to a directory on disk.
-     *
-     * Creates the target directory and any necessary parent directories if they don't exist.
-     * Existing files will be overwritten.
-     *
-     * @param path - The directory path to extract to
-     * @param options - Optional extraction options
-     * @param options.glob - Glob pattern(s) to filter entries (positive patterns include, negative patterns starting with `!` exclude)
-     * @returns A promise that resolves with the number of entries extracted (files, directories, and symlinks)
-     *
-     * @example
-     * **Extract all entries:**
-     * ```ts
-     * const archive = Bun.Archive.from(tarballBytes);
-     * const count = await archive.extract("./extracted");
-     * console.log(`Extracted ${count} entries`);
-     * ```
-     *
-     * @example
-     * **Extract only TypeScript files:**
-     * ```ts
-     * const count = await archive.extract("./src", { glob: "**" + "/*.ts" });
-     * ```
-     *
-     * @example
-     * **Extract everything except tests:**
-     * ```ts
-     * const count = await archive.extract("./dist", { glob: ["**", "!**" + "/*.test.*"] });
-     * ```
-     *
-     * @example
-     * **Extract source files but exclude tests:**
-     * ```ts
-     * const count = await archive.extract("./output", {
-     *   glob: ["src/**", "lib/**", "!**" + "/*.test.ts", "!**" + "/__tests__/**"]
-     * });
-     * ```
-     */
-    extract(path: string, options?: ArchiveExtractOptions): Promise<number>;
-
-    /**
-     * Get the archive contents as a `Blob`.
-     *
-     * @param compress - Optional compression: `"gzip"`, `true` for gzip, or `false`/`undefined` for none
-     * @returns A promise that resolves with the archive data as a Blob
-     *
-     * @example
-     * **Get uncompressed tarball:**
-     * ```ts
-     * const blob = await archive.blob();
-     * ```
-     *
-     * @example
-     * **Get gzipped tarball:**
-     * ```ts
-     * const gzippedBlob = await archive.blob("gzip");
-     * ```
-     */
-    blob(compress?: ArchiveCompression): Promise<Blob>;
-
-    /**
-     * Get the archive contents as a `Uint8Array`.
-     *
-     * @param compress - Optional compression: `"gzip"`, `true` for gzip, or `false`/`undefined` for none
-     * @returns A promise that resolves with the archive data as a Uint8Array
-     *
-     * @example
-     * **Get uncompressed tarball bytes:**
-     * ```ts
-     * const bytes = await archive.bytes();
-     * ```
-     *
-     * @example
-     * **Get gzipped tarball bytes:**
-     * ```ts
-     * const gzippedBytes = await archive.bytes("gzip");
-     * ```
-     */
-    bytes(compress?: ArchiveCompression): Promise<Uint8Array<ArrayBuffer>>;
-
-    /**
-     * Get the archive contents as a `Map` of `File` objects.
-     *
-     * Each file in the archive is returned as a `File` object with:
-     * - `name`: The file path within the archive
-     * - `lastModified`: The file's modification time from the archive
-     * - Standard Blob methods (`text()`, `arrayBuffer()`, `stream()`, etc.)
-     *
-     * Only regular files are included; directories are not returned.
-     * File contents are loaded into memory, so for large archives consider using `extract()` instead.
-     *
-     * @param glob - Optional glob pattern(s) to filter files. Supports the same syntax as {@link Bun.Glob},
-     *   including negation patterns (prefixed with `!`). Patterns are matched against paths normalized
-     *   to use forward slashes (`/`).
-     * @returns A promise that resolves with a Map where keys are file paths (always using forward slashes `/` as separators) and values are File objects
-     *
-     * @example
-     * **Get all files:**
-     * ```ts
-     * const entries = await archive.files();
-     * for (const [path, file] of entries) {
-     *   console.log(`${path}: ${file.size} bytes`);
-     * }
-     * ```
-     *
-     * @example
-     * **Filter by glob pattern:**
-     * ```ts
-     * const tsFiles = await archive.files("**" + "/*.ts");
-     * const srcFiles = await archive.files(["src/**", "lib/**"]);
-     * ```
-     *
-     * @example
-     * **Exclude files with negative patterns:**
-     * ```ts
-     * // Get all source files except tests
-     * const srcFiles = await archive.files(["src/**", "!**" + "/*.test.ts"]);
-     * ```
-     *
-     * @example
-     * **Read file contents:**
-     * ```ts
-     * const entries = await archive.files();
-     * const readme = entries.get("README.md");
-     * if (readme) {
-     *   console.log(await readme.text());
-     * }
-     * ```
-     */
-    files(glob?: string | readonly string[]): Promise<Map<string, File>>;
-  }
-
   /**
    * Generate a UUIDv7, which is a sequential ID based on the current timestamp with a random component.
    *

packages/bun-types/s3.d.ts

@@ -321,30 +321,6 @@ declare module "bun" {
       | "SNOW"
       | "STANDARD_IA";
 
-    /**
-     * When set to `true`, confirms that the requester knows they will be charged
-     * for the request and data transfer costs. Required for accessing objects
-     * in Requester Pays buckets.
-     *
-     * @see https://docs.aws.amazon.com/AmazonS3/latest/userguide/RequesterPaysBuckets.html
-     *
-     * @example
-     *    // Accessing a file in a Requester Pays bucket
-     *     const file = s3.file("data.csv", {
-     *       bucket: "requester-pays-bucket",
-     *       requestPayer: true
-     *     });
-     *     const content = await file.text();
-     *
-     * @example
-     *    // Uploading to a Requester Pays bucket
-     *     await s3.write("output.json", data, {
-     *       bucket: "requester-pays-bucket",
-     *       requestPayer: true
-     *     });
-     */
-    requestPayer?: boolean;
-
     /**
      * @deprecated The size of the internal buffer in bytes. Defaults to 5 MiB. use `partSize` and `queueSize` instead.
      */

packages/bun-types/sqlite.d.ts

@@ -154,6 +154,12 @@ declare module "bun:sqlite" {
      * | `bigint`        | `INTEGER`              |
      * | `null`          | `NULL`                 |
      *
+     * @example
+     * ```ts
+     * db.run("CREATE TABLE foo (bar TEXT)");
+     * db.run("INSERT INTO foo VALUES (?)", ["baz"]);
+     * ```
+     *
      * Useful for queries like:
      * - `CREATE TABLE`
      * - `INSERT INTO`
@@ -174,14 +180,8 @@ declare module "bun:sqlite" {
      *
      * @param sql The SQL query to run
      * @param bindings Optional bindings for the query
-     * @returns A `Changes` object with `changes` and `lastInsertRowid` properties
      *
-     * @example
-     * ```ts
-     * db.run("CREATE TABLE foo (bar TEXT)");
-     * db.run("INSERT INTO foo VALUES (?)", ["baz"]);
-     * // => { changes: 1, lastInsertRowid: 1 }
-     * ```
+     * @returns `Database` instance
      */
     run<ParamsType extends SQLQueryBindings[]>(sql: string, ...bindings: ParamsType[]): Changes;
 
@@ -670,19 +670,18 @@ declare module "bun:sqlite" {
      * Execute the prepared statement.
      *
      * @param params optional values to bind to the statement. If omitted, the statement is run with the last bound values or no parameters if there are none.
-     * @returns A `Changes` object with `changes` and `lastInsertRowid` properties
      *
      * @example
      * ```ts
-     * const insert = db.prepare("INSERT INTO users (name) VALUES (?)");
-     * insert.run("Alice");
-     * // => { changes: 1, lastInsertRowid: 1 }
-     * insert.run("Bob");
-     * // => { changes: 1, lastInsertRowid: 2 }
+     * const stmt = db.prepare("UPDATE foo SET bar = ?");
+     * stmt.run("baz");
+     * // => undefined
      *
-     * const update = db.prepare("UPDATE users SET name = ? WHERE id = ?");
-     * update.run("Charlie", 1);
-     * // => { changes: 1, lastInsertRowid: 2 }
+     * stmt.run();
+     * // => undefined
+     *
+     * stmt.run("foo");
+     * // => undefined
      * ```
      *
      * The following types can be used when binding parameters:

packages/bun-usockets/src/context.c

@@ -54,8 +54,8 @@ void us_listen_socket_close(int ssl, struct us_listen_socket_t *ls) {
         s->next = loop->data.closed_head;
         loop->data.closed_head = s;
 
-        /* Mark the socket as closed */
-        s->flags.is_closed = 1;
+        /* Any socket with prev = context is marked as closed */
+        s->prev = (struct us_socket_t *) context;
     }
 
     /* We cannot immediately free a listen socket as we can be inside an accept loop */
@@ -154,9 +154,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(int ssl, struct us_socket_context_t *context, struct us_listen_socket_t *ls) {
-
     struct us_socket_t* s = &ls->s;
-    if(us_socket_is_closed(ssl, s)) return;
     s->context = context;
     s->next = (struct us_socket_t *) context->head_listen_sockets;
     s->prev = 0;
@@ -168,8 +166,6 @@ void us_internal_socket_context_link_listen_socket(int ssl, struct us_socket_con
 }
 
 void us_internal_socket_context_link_connecting_socket(int ssl, struct us_socket_context_t *context, struct us_connecting_socket_t *c) {
-    if(c->closed) return;
-
     c->context = context;
     c->next_pending = context->head_connecting_sockets;
     c->prev_pending = 0;
@@ -184,8 +180,6 @@ 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(int ssl, struct us_socket_context_t *context, struct us_socket_t *s) {
-    if(us_socket_is_closed(ssl,s)) return;
-    
     s->context = context;
     s->next = context->head_sockets;
     s->prev = 0;
@@ -392,9 +386,6 @@ struct us_listen_socket_t *us_socket_context_listen(int ssl, struct us_socket_co
     s->flags.low_prio_state = 0;
     s->flags.is_paused = 0;
     s->flags.is_ipc = 0;
-    s->flags.is_closed = 0;
-    s->flags.adopted = 0;
-    s->flags.is_tls = ssl;
     s->next = 0;
     s->flags.allow_half_open = (options & LIBUS_SOCKET_ALLOW_HALF_OPEN);
     us_internal_socket_context_link_listen_socket(ssl, context, ls);
@@ -431,9 +422,6 @@ struct us_listen_socket_t *us_socket_context_listen_unix(int ssl, struct us_sock
     s->flags.allow_half_open = (options & LIBUS_SOCKET_ALLOW_HALF_OPEN);
     s->flags.is_paused = 0;
     s->flags.is_ipc = 0;
-    s->flags.is_closed = 0;
-    s->flags.adopted = 0;
-    s->flags.is_tls = ssl;
     s->next = 0;
     us_internal_socket_context_link_listen_socket(ssl, context, ls);
 
@@ -442,7 +430,7 @@ struct us_listen_socket_t *us_socket_context_listen_unix(int ssl, struct us_sock
     return ls;
 }
 
-struct us_socket_t* us_socket_context_connect_resolved_dns(int ssl, struct us_socket_context_t *context, struct sockaddr_storage* addr, int options, int socket_ext_size) {
+struct us_socket_t* us_socket_context_connect_resolved_dns(struct us_socket_context_t *context, struct sockaddr_storage* addr, int options, int socket_ext_size) {
     LIBUS_SOCKET_DESCRIPTOR connect_socket_fd = bsd_create_connect_socket(addr, options);
     if (connect_socket_fd == LIBUS_SOCKET_ERROR) {
         return NULL;
@@ -465,9 +453,6 @@ struct us_socket_t* us_socket_context_connect_resolved_dns(int ssl, struct us_so
     socket->flags.allow_half_open = (options & LIBUS_SOCKET_ALLOW_HALF_OPEN);
     socket->flags.is_paused = 0;
     socket->flags.is_ipc = 0;
-    socket->flags.is_closed = 0;
-    socket->flags.adopted = 0;
-    socket->flags.is_tls = ssl;
     socket->connect_state = NULL;
     socket->connect_next = NULL;
 
@@ -529,7 +514,7 @@ void *us_socket_context_connect(int ssl, struct us_socket_context_t *context, co
     struct sockaddr_storage addr;
     if (try_parse_ip(host, port, &addr)) {
         *has_dns_resolved = 1;
-        return us_socket_context_connect_resolved_dns(ssl, context, &addr, options, socket_ext_size);
+        return us_socket_context_connect_resolved_dns(context, &addr, options, socket_ext_size);
     }
 
     struct addrinfo_request* ai_req;
@@ -549,7 +534,7 @@ void *us_socket_context_connect(int ssl, struct us_socket_context_t *context, co
             struct sockaddr_storage addr;
             init_addr_with_port(&entries->info, port, &addr);
             *has_dns_resolved = 1;
-            struct us_socket_t *s = us_socket_context_connect_resolved_dns(ssl, context, &addr, options, socket_ext_size);
+            struct us_socket_t *s = us_socket_context_connect_resolved_dns(context, &addr, options, socket_ext_size);
             Bun__addrinfo_freeRequest(ai_req, s == NULL);
             return s;
         }
@@ -598,9 +583,6 @@ int start_connections(struct us_connecting_socket_t *c, int count) {
         flags->allow_half_open = (c->options & LIBUS_SOCKET_ALLOW_HALF_OPEN);
         flags->is_paused = 0;
         flags->is_ipc = 0;
-        flags->is_closed = 0;
-        flags->adopted = 0;
-        flags->is_tls = c->ssl;
         /* Link it into context so that timeout fires properly */
         us_internal_socket_context_link_socket(0, context, s);
 
@@ -778,9 +760,6 @@ struct us_socket_t *us_socket_context_connect_unix(int ssl, struct us_socket_con
     connect_socket->flags.allow_half_open = (options & LIBUS_SOCKET_ALLOW_HALF_OPEN);
     connect_socket->flags.is_paused = 0;
     connect_socket->flags.is_ipc = 0;
-    connect_socket->flags.is_closed = 0;
-    connect_socket->flags.adopted = 0;
-    connect_socket->flags.is_tls = ssl;
     connect_socket->connect_state = NULL;
     connect_socket->connect_next = NULL;
     us_internal_socket_context_link_socket(ssl, context, connect_socket);
@@ -801,10 +780,10 @@ struct us_socket_context_t *us_create_child_socket_context(int ssl, struct us_so
 }
 
 /* Note: This will set timeout to 0 */
-struct us_socket_t *us_socket_context_adopt_socket(int ssl, struct us_socket_context_t *context, struct us_socket_t *s, int old_ext_size, int ext_size) {
+struct us_socket_t *us_socket_context_adopt_socket(int ssl, struct us_socket_context_t *context, struct us_socket_t *s, int ext_size) {
 #ifndef LIBUS_NO_SSL
     if (ssl) {
-        return (struct us_socket_t *) us_internal_ssl_socket_context_adopt_socket((struct us_internal_ssl_socket_context_t *) context, (struct us_internal_ssl_socket_t *) s, old_ext_size, ext_size);
+        return (struct us_socket_t *) us_internal_ssl_socket_context_adopt_socket((struct us_internal_ssl_socket_context_t *) context, (struct us_internal_ssl_socket_t *) s, ext_size);
     }
 #endif
 
@@ -828,18 +807,7 @@ struct us_socket_t *us_socket_context_adopt_socket(int ssl, struct us_socket_con
     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) + old_ext_size, sizeof(struct us_socket_t) + ext_size);
-        if(new_s != s) {
-            /* Mark the old socket as closed */
-            s->flags.is_closed = 1;
-            /* Link this socket to the close-list and let it be deleted after this iteration */
-            s->next = s->context->loop->data.closed_head;
-            s->context->loop->data.closed_head = s;
-            /* Mark the old socket as adopted (reallocated) */
-            s->flags.adopted = 1;
-            /* Tell the event loop what is the new socket so we can process to send info to the right place and callbacks like more data and EOF*/
-            s->prev = new_s;
-        }
+        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;
             c->context = context;

packages/bun-usockets/src/crypto/openssl.c

@@ -396,7 +396,7 @@ void us_internal_update_handshake(struct us_internal_ssl_socket_t *s) {
   }
 
   int result = SSL_do_handshake(s->ssl);
-  
+
   if (SSL_get_shutdown(s->ssl) & SSL_RECEIVED_SHUTDOWN) {
     us_internal_ssl_socket_close(s, 0, NULL);
     return;
@@ -417,7 +417,7 @@ void us_internal_update_handshake(struct us_internal_ssl_socket_t *s) {
     }
     s->handshake_state = HANDSHAKE_PENDING;
     s->ssl_write_wants_read = 1;
-    s->s.flags.last_write_failed = 1;
+
     return;
   }
   // success
@@ -434,7 +434,6 @@ ssl_on_close(struct us_internal_ssl_socket_t *s, int code, void *reason) {
   struct us_internal_ssl_socket_t * ret = context->on_close(s, code, reason);
   SSL_free(s->ssl); // free SSL after on_close
   s->ssl = NULL; // set to NULL
-
   return ret;
 }
 
@@ -1856,16 +1855,15 @@ void us_internal_ssl_socket_shutdown(struct us_internal_ssl_socket_t *s) {
 
 struct us_internal_ssl_socket_t *us_internal_ssl_socket_context_adopt_socket(
     struct us_internal_ssl_socket_context_t *context,
-    struct us_internal_ssl_socket_t *s, int old_ext_size, int ext_size) {
+    struct us_internal_ssl_socket_t *s, int ext_size) {
   // todo: this is completely untested
-  int new_old_ext_size = sizeof(struct us_internal_ssl_socket_t) - sizeof(struct us_socket_t) + old_ext_size;
   int new_ext_size = ext_size;
   if (ext_size != -1) {
     new_ext_size = sizeof(struct us_internal_ssl_socket_t) - sizeof(struct us_socket_t) + ext_size;
   }
   return (struct us_internal_ssl_socket_t *)us_socket_context_adopt_socket(
       0, &context->sc, &s->s,
-      new_old_ext_size, new_ext_size);
+      new_ext_size);
 }
 
 struct us_internal_ssl_socket_t *
@@ -1922,11 +1920,10 @@ ssl_wrapped_context_on_data(struct us_internal_ssl_socket_t *s, char *data,
   struct us_wrapped_socket_context_t *wrapped_context =
       (struct us_wrapped_socket_context_t *)us_internal_ssl_socket_context_ext(
           context);
-          // raw data if needed
+  // raw data if needed
   if (wrapped_context->old_events.on_data) {
     wrapped_context->old_events.on_data((struct us_socket_t *)s, data, length);
   }
-  
   // ssl wrapped data
   return ssl_on_data(s, data, length);
 }
@@ -2031,7 +2028,7 @@ us_internal_ssl_socket_open(struct us_internal_ssl_socket_t *s, int is_client,
   // already opened
   if (s->ssl)
     return s;
-  
+
   // start SSL open
   return ssl_on_open(s, is_client, ip, ip_length, NULL);
 }
@@ -2043,7 +2040,6 @@ struct us_socket_t *us_socket_upgrade_to_tls(us_socket_r s, us_socket_context_r
   struct us_internal_ssl_socket_t *socket =
       (struct us_internal_ssl_socket_t *)us_socket_context_adopt_socket(
           0, new_context, s,
-          sizeof(void*),
           (sizeof(struct us_internal_ssl_socket_t) - sizeof(struct us_socket_t)) + sizeof(void*));
   socket->ssl = NULL;
   socket->ssl_write_wants_read = 0;
@@ -2062,7 +2058,7 @@ struct us_socket_t *us_socket_upgrade_to_tls(us_socket_r s, us_socket_context_r
 
 struct us_internal_ssl_socket_t *us_internal_ssl_socket_wrap_with_tls(
     struct us_socket_t *s, struct us_bun_socket_context_options_t options,
-    struct us_socket_events_t events, int old_socket_ext_size, int socket_ext_size) {
+    struct us_socket_events_t events, int socket_ext_size) {
   /* Cannot wrap a closed socket */
   if (us_socket_is_closed(0, s)) {
     return NULL;
@@ -2167,7 +2163,6 @@ us_socket_context_on_socket_connect_error(
   struct us_internal_ssl_socket_t *socket =
       (struct us_internal_ssl_socket_t *)us_socket_context_adopt_socket(
           0, context, s,
-          old_socket_ext_size,
           sizeof(struct us_internal_ssl_socket_t) - sizeof(struct us_socket_t) +
               socket_ext_size);
   socket->ssl = NULL;

packages/bun-usockets/src/eventing/epoll_kqueue.c

@@ -325,7 +325,7 @@ void us_internal_loop_update_pending_ready_polls(struct us_loop_t *loop, struct
     int num_entries_possibly_remaining = 1;
 #else
     /* Ready polls may contain same poll twice under kqueue, as one poll may hold two filters */
-    int num_entries_possibly_remaining = 2;
+    int num_entries_possibly_remaining = 2;//((old_events & LIBUS_SOCKET_READABLE) ? 1 : 0) + ((old_events & LIBUS_SOCKET_WRITABLE) ? 1 : 0);
 #endif
 
     /* Todo: for kqueue if we track things in us_change_poll it is possible to have a fast path with no seeking in cases of:
@@ -377,30 +377,22 @@ int kqueue_change(int kqfd, int fd, int old_events, int new_events, void *user_d
 }
 #endif
 
-struct us_poll_t *us_poll_resize(struct us_poll_t *p, struct us_loop_t *loop, unsigned int old_ext_size, unsigned int ext_size) {
-
-    unsigned int old_size = sizeof(struct us_poll_t) + old_ext_size;
-    unsigned int new_size = sizeof(struct us_poll_t) + ext_size;
-    if(new_size <= old_size) return p;
-
-    struct us_poll_t *new_p = us_calloc(1, new_size);
-    memcpy(new_p, p, old_size);
-
-    /* Increment poll count for the new poll - the old poll will be freed separately
-     * which decrements the count, keeping the total correct */
-    loop->num_polls++;
-    
+struct us_poll_t *us_poll_resize(struct us_poll_t *p, struct us_loop_t *loop, unsigned int ext_size) {
     int events = us_poll_events(p);
+    
+
+    struct us_poll_t *new_p = us_realloc(p, sizeof(struct us_poll_t) + ext_size);
+    if (p != new_p) {
 #ifdef LIBUS_USE_EPOLL
-    /* Hack: forcefully update poll by stripping away already set events */
-    new_p->state.poll_type = us_internal_poll_type(new_p);
-    us_poll_change(new_p, loop, events);
+        /* Hack: forcefully update poll by stripping away already set events */
+        new_p->state.poll_type = us_internal_poll_type(new_p);
+        us_poll_change(new_p, loop, events);
 #else
-    /* Forcefully update poll by resetting them with new_p as user data */
-    kqueue_change(loop->fd, new_p->state.fd, 0, LIBUS_SOCKET_WRITABLE | LIBUS_SOCKET_READABLE, new_p);
-#endif
-    /* This is needed for epoll also (us_change_poll doesn't update the old poll) */
-    us_internal_loop_update_pending_ready_polls(loop, p, new_p, events, events);
+        /* Forcefully update poll by resetting them with new_p as user data */
+        kqueue_change(loop->fd, new_p->state.fd, 0, LIBUS_SOCKET_WRITABLE | LIBUS_SOCKET_READABLE, new_p);
+#endif      /* This is needed for epoll also (us_change_poll doesn't update the old poll) */
+        us_internal_loop_update_pending_ready_polls(loop, p, new_p, events, events);
+    }
 
     return new_p;
 }
@@ -452,7 +444,7 @@ void us_poll_change(struct us_poll_t *p, struct us_loop_t *loop, int events) {
         kqueue_change(loop->fd, p->state.fd, old_events, events, p);
 #endif
         /* Set all removed events to null-polls in pending ready poll list */
-        us_internal_loop_update_pending_ready_polls(loop, p, p, old_events, events);
+        // us_internal_loop_update_pending_ready_polls(loop, p, p, old_events, events);
     }
 }
 

packages/bun-usockets/src/eventing/libuv.c

@@ -71,11 +71,6 @@ void us_poll_init(struct us_poll_t *p, LIBUS_SOCKET_DESCRIPTOR fd,
 }
 
 void us_poll_free(struct us_poll_t *p, struct us_loop_t *loop) {
-  // poll was resized and dont own uv_poll_t anymore
-  if(!p->uv_p) {
-    free(p);
-    return;
-  }
   /* The idea here is like so; in us_poll_stop we call uv_close after setting
    * data of uv-poll to 0. This means that in close_cb_free we call free on 0
    * with does nothing, since us_poll_stop should not really free the poll.
@@ -91,7 +86,6 @@ void us_poll_free(struct us_poll_t *p, struct us_loop_t *loop) {
 }
 
 void us_poll_start(struct us_poll_t *p, struct us_loop_t *loop, int events) {
-  if(!p->uv_p) return;
   p->poll_type = us_internal_poll_type(p) |
                  ((events & LIBUS_SOCKET_READABLE) ? POLL_TYPE_POLLING_IN : 0) |
                  ((events & LIBUS_SOCKET_WRITABLE) ? POLL_TYPE_POLLING_OUT : 0);
@@ -105,7 +99,6 @@ void us_poll_start(struct us_poll_t *p, struct us_loop_t *loop, int events) {
 }
 
 void us_poll_change(struct us_poll_t *p, struct us_loop_t *loop, int events) {
-  if(!p->uv_p) return;
   if (us_poll_events(p) != events) {
     p->poll_type =
         us_internal_poll_type(p) |
@@ -116,7 +109,6 @@ void us_poll_change(struct us_poll_t *p, struct us_loop_t *loop, int events) {
 }
 
 void us_poll_stop(struct us_poll_t *p, struct us_loop_t *loop) {
-  if(!p->uv_p) return;
   uv_poll_stop(p->uv_p);
 
   /* We normally only want to close the poll here, not free it. But if we stop
@@ -225,20 +217,10 @@ struct us_poll_t *us_create_poll(struct us_loop_t *loop, int fallthrough,
 /* If we update our block position we have to update the uv_poll data to point
  * to us */
 struct us_poll_t *us_poll_resize(struct us_poll_t *p, struct us_loop_t *loop,
-                                 unsigned int old_ext_size, unsigned int ext_size) {
-
-  // cannot resize if we dont own uv_poll_t
-  if(!p->uv_p) return p;
-
-  unsigned int old_size = sizeof(struct us_poll_t) + old_ext_size;
-  unsigned int new_size = sizeof(struct us_poll_t) + ext_size;
-  if(new_size <= old_size) return p;
-
-  struct us_poll_t *new_p = calloc(1, new_size);
-  memcpy(new_p, p, old_size);
+                                 unsigned int ext_size) {
 
+  struct us_poll_t *new_p = realloc(p, sizeof(struct us_poll_t) + ext_size);
   new_p->uv_p->data = new_p;
-  p->uv_p = NULL;
 
   return new_p;
 }

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

@@ -170,14 +170,6 @@ struct us_socket_flags {
     unsigned char low_prio_state: 2;
     /* If true, the socket should be read using readmsg to support receiving file descriptors */
     bool is_ipc: 1;
-    /* If true, the socket has been closed */
-    bool is_closed: 1;
-    /* If true, the socket was reallocated during adoption */
-    bool adopted: 1;
-    /* If true, the socket is a TLS socket */
-    bool is_tls: 1;
-    /* If true, the last write to this socket failed (would block) */
-    bool last_write_failed: 1;
 
 } __attribute__((packed));
 
@@ -443,11 +435,11 @@ void us_internal_ssl_socket_shutdown(us_internal_ssl_socket_r s);
 
 struct us_internal_ssl_socket_t *us_internal_ssl_socket_context_adopt_socket(
     us_internal_ssl_socket_context_r context,
-    us_internal_ssl_socket_r s, int old_ext_size, int ext_size);
+    us_internal_ssl_socket_r s, int ext_size);
 
 struct us_internal_ssl_socket_t *us_internal_ssl_socket_wrap_with_tls(
     us_socket_r s, struct us_bun_socket_context_options_t options,
-    struct us_socket_events_t events, int old_socket_ext_size, int socket_ext_size);
+    struct us_socket_events_t events, int socket_ext_size);
 struct us_internal_ssl_socket_context_t *
 us_internal_create_child_ssl_socket_context(
     us_internal_ssl_socket_context_r context, int context_ext_size);

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

@@ -37,6 +37,7 @@ struct us_internal_loop_data_t {
     struct us_timer_t *sweep_timer;
     int sweep_timer_count;
     struct us_internal_async *wakeup_async;
+    int last_write_failed;
     struct us_socket_context_t *head;
     struct us_socket_context_t *iterator;
     struct us_socket_context_t *closed_context_head;

packages/bun-usockets/src/libusockets.h

@@ -349,7 +349,7 @@ struct us_loop_t *us_socket_context_loop(int ssl, us_socket_context_r context) n
 
 /* Invalidates passed socket, returning a new resized socket which belongs to a different socket context.
  * Used mainly for "socket upgrades" such as when transitioning from HTTP to WebSocket. */
-struct us_socket_t *us_socket_context_adopt_socket(int ssl, us_socket_context_r context, us_socket_r s, int old_ext_size, int ext_size);
+struct us_socket_t *us_socket_context_adopt_socket(int ssl, us_socket_context_r context, us_socket_r s, int ext_size);
 
 struct us_socket_t *us_socket_upgrade_to_tls(us_socket_r s, us_socket_context_r new_context, const char *sni);
 
@@ -411,7 +411,7 @@ void *us_poll_ext(us_poll_r p) nonnull_fn_decl;
 LIBUS_SOCKET_DESCRIPTOR us_poll_fd(us_poll_r p) nonnull_fn_decl;
 
 /* Resize an active poll */
-struct us_poll_t *us_poll_resize(us_poll_r p, us_loop_r loop, unsigned int old_ext_size, unsigned int ext_size) nonnull_fn_decl;
+struct us_poll_t *us_poll_resize(us_poll_r p, us_loop_r loop, unsigned int ext_size) nonnull_fn_decl;
 
 /* Public interfaces for sockets */
 
@@ -470,7 +470,7 @@ void us_socket_local_address(int ssl, us_socket_r s, char *nonnull_arg buf, int
 /* Bun extras */
 struct us_socket_t *us_socket_pair(struct us_socket_context_t *ctx, int socket_ext_size, LIBUS_SOCKET_DESCRIPTOR* fds);
 struct us_socket_t *us_socket_from_fd(struct us_socket_context_t *ctx, int socket_ext_size, LIBUS_SOCKET_DESCRIPTOR fd, int ipc);
-struct us_socket_t *us_socket_wrap_with_tls(int ssl, us_socket_r s, struct us_bun_socket_context_options_t options, struct us_socket_events_t events, int old_socket_ext_size, int socket_ext_size);
+struct us_socket_t *us_socket_wrap_with_tls(int ssl, us_socket_r s, struct us_bun_socket_context_options_t options, struct us_socket_events_t events, int socket_ext_size);
 int us_socket_raw_write(int ssl, us_socket_r s, const char *data, int length);
 struct us_socket_t* us_socket_open(int ssl, struct us_socket_t * s, int is_client, char* ip, int ip_length);
 int us_raw_root_certs(struct us_cert_string_t**out);

packages/bun-usockets/src/loop.c

@@ -193,17 +193,9 @@ void us_internal_handle_low_priority_sockets(struct us_loop_t *loop) {
         loop_data->low_prio_head = s->next;
         if (s->next) s->next->prev = 0;
         s->next = 0;
-        int ssl = s->flags.is_tls;
-        
-        if(us_socket_is_closed(ssl, s)) {
-            s->flags.low_prio_state = 2;    
-            us_socket_context_unref(ssl, s->context);
-            continue;
-        }
 
-        us_internal_socket_context_link_socket(ssl, s->context, s);
-        us_socket_context_unref(ssl, s->context);
-        us_poll_change(&s->p, us_socket_context(ssl, s)->loop, us_poll_events(&s->p) | LIBUS_SOCKET_READABLE);
+        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;
     }
@@ -251,7 +243,6 @@ void us_internal_free_closed_sockets(struct us_loop_t *loop) {
     /* Free all closed sockets (maybe it is better to reverse order?) */
     for (struct us_socket_t *s = loop->data.closed_head; s; ) {
         struct us_socket_t *next = s->next;
-        s->prev = s->next = 0;
         us_poll_free((struct us_poll_t *) s, loop);
         s = next;
     }
@@ -356,9 +347,6 @@ void us_internal_dispatch_ready_poll(struct us_poll_t *p, int error, int eof, in
                         s->flags.allow_half_open = listen_socket->s.flags.allow_half_open;
                         s->flags.is_paused = 0;
                         s->flags.is_ipc = 0;
-                        s->flags.is_closed = 0;
-                        s->flags.adopted = 0;
-                        s->flags.is_tls = listen_socket->s.flags.is_tls;
 
                         /* We always use nodelay */
                         bsd_socket_nodelay(client_fd, 1);
@@ -366,10 +354,7 @@ void us_internal_dispatch_ready_poll(struct us_poll_t *p, int error, int eof, in
                         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));
-                        /* After socket adoption, track the new socket; the old one becomes invalid */
-                        if(s && s->flags.adopted && s->prev) {
-                            s = s->prev;
-                        }
+
                         /* Exit accept loop if listen socket was closed in on_open handler */
                         if (us_socket_is_closed(0, &listen_socket->s)) {
                             break;
@@ -384,31 +369,25 @@ void us_internal_dispatch_ready_poll(struct us_poll_t *p, int error, int eof, in
     case POLL_TYPE_SOCKET: {
             /* We should only use s, no p after this point */
             struct us_socket_t *s = (struct us_socket_t *) p;
-            /* After socket adoption, track the new socket; the old one becomes invalid */
-            if(s && s->flags.adopted && s->prev) {
-                s = s->prev;
-            }
             /* The context can change after calling a callback but the loop is always the same */
             struct us_loop_t* loop = s->context->loop;
             if (events & LIBUS_SOCKET_WRITABLE && !error) {
-                s->flags.last_write_failed = 0;
+                /* 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;
                 #ifdef LIBUS_USE_KQUEUE
                 /* Kqueue is one-shot so is not writable anymore */
                 p->state.poll_type = us_internal_poll_type(p) | ((events & LIBUS_SOCKET_READABLE) ? POLL_TYPE_POLLING_IN : 0);
                 #endif
-
+                
                 s = s->context->on_writable(s);
-                /* After socket adoption, track the new socket; the old one becomes invalid */
-                if(s && s->flags.adopted && s->prev) {
-                    s = s->prev;
-                }
 
                 if (!s || us_socket_is_closed(0, s)) {
                     return;
                 }
 
                 /* If we have no failed write or if we shut down, then stop polling for more writable */
-                if (!s->flags.last_write_failed || us_socket_is_shut_down(0, s)) {
+                if (!loop->data.last_write_failed || us_socket_is_shut_down(0, s)) {
                     us_poll_change(&s->p, loop, us_poll_events(&s->p) & LIBUS_SOCKET_READABLE);
                 } else {
                     #ifdef LIBUS_USE_KQUEUE
@@ -498,10 +477,6 @@ void us_internal_dispatch_ready_poll(struct us_poll_t *p, int error, int eof, in
 
                     if (length > 0) {
                         s = s->context->on_data(s, loop->data.recv_buf + LIBUS_RECV_BUFFER_PADDING, length);
-                        /* After socket adoption, track the new socket; the old one becomes invalid */
-                        if(s && s->flags.adopted && s->prev) {
-                            s = s->prev;
-                        }
                         // loop->num_ready_polls isn't accessible on Windows.
                         #ifndef WIN32
                         // rare case: we're reading a lot of data, there's more to be read, and either:

packages/bun-usockets/src/socket.c

@@ -125,7 +125,7 @@ int us_socket_is_closed(int ssl, struct us_socket_t *s) {
     if(ssl) {
         return us_internal_ssl_socket_is_closed((struct us_internal_ssl_socket_t *) s);
     }
-    return s->flags.is_closed;
+    return s->prev == (struct us_socket_t *) s->context;
 }
 
 int us_connecting_socket_is_closed(int ssl, struct us_connecting_socket_t *c) {
@@ -159,8 +159,8 @@ void us_connecting_socket_close(int ssl, struct us_connecting_socket_t *c) {
         s->next = s->context->loop->data.closed_head;
         s->context->loop->data.closed_head = s;
 
-        /* Mark the socket as closed */
-        s->flags.is_closed = 1;
+        /* Any socket with prev = context is marked as closed */
+        s->prev = (struct us_socket_t *) s->context;
     }
     if(!c->error) {
         // if we have no error, we have to set that we were aborted aka we called close
@@ -218,10 +218,11 @@ struct us_socket_t *us_socket_close(int ssl, struct us_socket_t *s, int code, vo
 
         bsd_close_socket(us_poll_fd((struct us_poll_t *) s));
 
-        /* Mark the socket as closed */
-        s->flags.is_closed = 1;
 
-        /* call the callback */
+        /* Any socket with prev = context is marked as closed */
+        s->prev = (struct us_socket_t *) s->context;
+
+        /* mark it as closed and call the callback */
         struct us_socket_t *res = s;
         if (!(us_internal_poll_type(&s->p) & POLL_TYPE_SEMI_SOCKET)) {
             res = s->context->on_close(s, code, reason);
@@ -267,8 +268,8 @@ struct us_socket_t *us_socket_detach(int ssl, struct us_socket_t *s) {
         s->next = s->context->loop->data.closed_head;
         s->context->loop->data.closed_head = s;
 
-        /* Mark the socket as closed */
-        s->flags.is_closed = 1;
+        /* Any socket with prev = context is marked as closed */
+        s->prev = (struct us_socket_t *) s->context;
 
         return s;
     }
@@ -320,10 +321,8 @@ struct us_socket_t *us_socket_from_fd(struct us_socket_context_t *ctx, int socke
     s->flags.low_prio_state = 0;
     s->flags.allow_half_open = 0;
     s->flags.is_paused = 0;
+    s->flags.is_ipc = 0;
     s->flags.is_ipc = ipc;
-    s->flags.is_closed = 0;
-    s->flags.adopted = 0;
-    s->flags.is_tls = 0;
     s->connect_state = NULL;
 
     /* We always use nodelay */
@@ -370,7 +369,7 @@ int us_socket_write(int ssl, struct us_socket_t *s, const char *data, int length
 
     int written = bsd_send(us_poll_fd(&s->p), data, length);
     if (written != length) {
-        s->flags.last_write_failed = 1;
+        s->context->loop->data.last_write_failed = 1;
         us_poll_change(&s->p, s->context->loop, LIBUS_SOCKET_READABLE | LIBUS_SOCKET_WRITABLE);
     }
 
@@ -407,7 +406,7 @@ int us_socket_ipc_write_fd(struct us_socket_t *s, const char* data, int length,
     int sent = bsd_sendmsg(us_poll_fd(&s->p), &msg, 0);
 
     if (sent != length) {
-        s->flags.last_write_failed = 1;
+        s->context->loop->data.last_write_failed = 1;
         us_poll_change(&s->p, s->context->loop, LIBUS_SOCKET_READABLE | LIBUS_SOCKET_WRITABLE);
     }
 
@@ -477,13 +476,13 @@ int us_connecting_socket_get_error(int ssl, struct us_connecting_socket_t *c) {
     Note: this assumes that the socket is non-TLS and will be adopted and wrapped with a new TLS context
           context ext will not be copied to the new context, new context will contain us_wrapped_socket_context_t on ext
 */
-struct us_socket_t *us_socket_wrap_with_tls(int ssl, struct us_socket_t *s, struct us_bun_socket_context_options_t options, struct us_socket_events_t events, int old_socket_ext_size, int socket_ext_size) {
+struct us_socket_t *us_socket_wrap_with_tls(int ssl, struct us_socket_t *s, struct us_bun_socket_context_options_t options, struct us_socket_events_t events, int socket_ext_size) {
     // only accepts non-TLS sockets
     if (ssl) {
         return NULL;
     }
 
-    return(struct us_socket_t *) us_internal_ssl_socket_wrap_with_tls(s, options, events, old_socket_ext_size, socket_ext_size);
+    return(struct us_socket_t *) us_internal_ssl_socket_wrap_with_tls(s, options, events, socket_ext_size);
 }
 
 // if a TLS socket calls this, it will start SSL call open event and TLS handshake if required

packages/bun-uws/src/HttpParser.h

@@ -30,7 +30,6 @@
 #include <algorithm>
 #include <climits>
 #include <string_view>
-#include <span>
 #include <map>
 #include "MoveOnlyFunction.h"
 #include "ChunkedEncoding.h"
@@ -161,13 +160,6 @@ namespace uWS
         std::map<std::string, unsigned short, std::less<>> *currentParameterOffsets = nullptr;
 
     public:
-        /* Any data pipelined after the HTTP headers (before response).
-         * Used for Node.js compatibility: 'connect' and 'upgrade' events
-         * pass this as the 'head' Buffer parameter.
-         * WARNING: This points to data in the receive buffer and may be stack-allocated.
-         * Must be cloned before the request handler returns. */
-        std::span<const char> head;
-
         bool isAncient()
         {
             return ancientHttp;
@@ -891,8 +883,6 @@ namespace uWS
             /* If returned socket is not what we put in we need
              * to break here as we either have upgraded to
              * WebSockets or otherwise closed the socket. */
-            /* Store any remaining data as head for Node.js compat (connect/upgrade events) */
-            req->head = std::span<const char>(data, length);
             void *returnedUser = requestHandler(user, req);
             if (returnedUser != user) {
                 /* We are upgraded to WebSocket or otherwise broken */
@@ -938,13 +928,9 @@ namespace uWS
                     consumedTotal += emittable;
                 }
             } else if(isConnectRequest) {
-                // This only serves to mark that the connect request read all headers
-                // and can start emitting data. Don't try to parse remaining data as HTTP -
-                // it's pipelined data that we've already captured in req->head.
+                // This only server to mark that the connect request read all headers
+                // and can starting emitting data
                 remainingStreamingBytes = STATE_IS_CHUNKED;
-                // Mark remaining data as consumed and break - it's not HTTP
-                consumedTotal += length;
-                break;
             } else {
                 /* If we came here without a body; emit an empty data chunk to signal no data */
                 dataHandler(user, {}, true);

packages/bun-uws/src/HttpResponse.h

@@ -331,7 +331,7 @@ public:
         
 
         /* Adopting a socket invalidates it, do not rely on it directly to carry any data */
-        us_socket_t *usSocket = us_socket_context_adopt_socket(SSL, (us_socket_context_t *) webSocketContext, (us_socket_t *) this, sizeof(HttpResponseData<SSL>), sizeof(WebSocketData) + sizeof(UserData));
+        us_socket_t *usSocket = us_socket_context_adopt_socket(SSL, (us_socket_context_t *) webSocketContext, (us_socket_t *) this, sizeof(WebSocketData) + sizeof(UserData));
         WebSocket<SSL, true, UserData> *webSocket = (WebSocket<SSL, true, UserData> *) usSocket;
 
         /* For whatever reason we were corked, update cork to the new socket */

rust-toolchain.toml

@@ -1,2 +0,0 @@
-[toolchain]
-channel = "nightly-2025-12-10"

scripts/bootstrap.ps1

@@ -313,7 +313,7 @@ function Install-Build-Essentials {
     strawberryperl `
     mingw
   Install-Rust
-  Install-Ccache
+  Install-Sccache
   # Needed to remap stack traces
   Install-PdbAddr2line
   Install-Llvm
@@ -376,8 +376,8 @@ function Install-Rust {
   Add-To-Path "$rustPath\cargo\bin"
 }
 
-function Install-Ccache {
-  Install-Package ccache
+function Install-Sccache {
+  Install-Package sccache -Version "0.12.0"
 }
 
 function Install-PdbAddr2line {

scripts/bootstrap.sh

@@ -1,5 +1,5 @@
 #!/bin/sh
-# Version: 26
+# Version: 21
 
 # A script that installs the dependencies needed to build and test Bun.
 # This should work on macOS and Linux with a POSIX shell.
@@ -281,6 +281,9 @@ check_operating_system() {
 	Darwin)
 		os="darwin"
 		;;
+	FreeBSD)
+		os="freebsd"
+		;;
 	*)
 		error "Unsupported operating system: $os"
 		;;
@@ -343,6 +346,11 @@ check_operating_system() {
 			;;
 		esac
 		;;
+	freebsd)
+		. /etc/os-release
+		distro="$ID"
+		release="$VERSION_ID"
+		;;
 	esac
 
 	if [ -n "$distro" ]; then
@@ -426,6 +434,9 @@ check_package_manager() {
 			error "No package manager found. (apt, dnf, yum, apk)"
 		fi
 		;;
+	freebsd)
+		pm="pkg"
+		;;
 	esac
 	print "Package manager: $pm"
 
@@ -438,6 +449,13 @@ check_package_manager() {
 	apk)
 		package_manager update
 		;;
+	pkg)
+		# may need to switch betwen 'latest' and 'quarterly' depending on which repo www/chromium is in. check https://www.freshports.org/www/chromium/.
+		# mkdir -p /usr/local/etc/pkg/repos
+		# echo 'FreeBSD: { url: "pkg+http://pkg.FreeBSD.org/${ABI}/quarterly" }' > /usr/local/etc/pkg/repos/FreeBSD.conf
+		export ASSUME_ALWAYS_YES=yes
+		package_manager update -f
+		;;
 	esac
 }
 
@@ -798,6 +816,9 @@ install_nodejs() {
 	linux)
 		nodejs_platform="linux"
 		;;
+	freebsd)
+		nodejs_platform="freebsd"
+		;;
 	*)
 		error "Unsupported OS for Node.js download: $os"
 		;;
@@ -816,6 +837,12 @@ install_nodejs() {
 		;;
 	esac
 
+	if [ "$os" = "freebsd" ]; then
+		# TODO: use nodejs_version_exact
+		install_packages "www/node$(nodejs_version)" "www/npm-node$(nodejs_version)"
+		return
+	fi
+
 	case "$abi" in
 	musl)
 		nodejs_mirror="https://bun-nodejs-release.s3.us-west-1.amazonaws.com"
@@ -905,6 +932,10 @@ install_nodejs() {
 }
 
 install_nodejs_headers() {
+	if [ "$os" = "freebsd" ]; then
+		return
+	fi
+
 	nodejs_version="$(nodejs_version_exact)"
 	nodejs_headers_tar="$(download_file "https://nodejs.org/download/release/v$nodejs_version/node-v$nodejs_version-headers.tar.gz")"
 	nodejs_headers_dir="$(dirname "$nodejs_headers_tar")"
@@ -919,6 +950,10 @@ install_nodejs_headers() {
 }
 
 setup_node_gyp_cache() {
+	if [ "$os" = "freebsd" ]; then
+		return
+	fi
+
 	nodejs_version="$1"
 	headers_source="$2"
 
@@ -957,6 +992,11 @@ bun_version_exact() {
 }
 
 install_bun() {
+	if [ "$os" = "freebsd" ]; then
+		# TODO: need to complete bun bootstrap for for this work
+		return
+	fi
+
 	install_packages unzip
 
 	case "$pm" in
@@ -1008,6 +1048,9 @@ install_cmake() {
 			--skip-license \
 			--prefix=/usr
 		;;
+	freebsd-pkg)
+		install_packages devel/cmake
+		;;
 	esac
 }
 
@@ -1079,6 +1122,17 @@ install_build_essentials() {
 				ruby \
 				perl \
 			;;
+		freebsd)
+			install_packages \
+				devel/ninja \
+				devel/pkgconf \
+				lang/go \
+				devel/gmake \
+				lang/python3 \
+				devel/libtool \
+				lang/ruby33 \
+				perl5 \
+			;;
 	esac
 
 	install_cmake
@@ -1086,7 +1140,7 @@ install_build_essentials() {
 	install_osxcross
 	install_gcc
 	install_rust
-	install_ccache
+	install_sccache
 	install_docker
 }
 
@@ -1101,23 +1155,23 @@ llvm_version() {
 install_llvm() {
 	case "$pm" in
 	apt)
-		# Debian 13 (Trixie) has LLVM 19 natively, and apt.llvm.org doesn't have a trixie repo
-		if [ "$distro" = "debian" ]; then
-			install_packages \
-				"llvm-$(llvm_version)" \
-				"clang-$(llvm_version)" \
-				"lld-$(llvm_version)" \
-				"llvm-$(llvm_version)-dev" \
-				"llvm-$(llvm_version)-tools" \
-				"libclang-rt-$(llvm_version)-dev"
-		else
-			bash="$(require bash)"
-			llvm_script="$(download_file "https://apt.llvm.org/llvm.sh")"
-			execute_sudo "$bash" "$llvm_script" "$(llvm_version)" all
+		bash="$(require bash)"
+		llvm_script="$(download_file "https://apt.llvm.org/llvm.sh")"
 
-			# Install llvm-symbolizer explicitly to ensure it's available for ASAN
-			install_packages "llvm-$(llvm_version)-tools"
+		# Debian trixie and newer don't have their own LLVM apt repo, use unstable
+		llvm_codename_arg=""
+		if [ "$distro" = "debian" ]; then
+			case "$VERSION_CODENAME" in
+			trixie|forky)
+				llvm_codename_arg="-n=unstable"
+				;;
+			esac
 		fi
+
+		execute_sudo "$bash" "$llvm_script" "$(llvm_version)" all $llvm_codename_arg
+
+		# Install llvm-symbolizer explicitly to ensure it's available for ASAN
+		install_packages "llvm-$(llvm_version)-tools"
 		;;
 	brew)
 		install_packages "llvm@$(llvm_version)"
@@ -1131,6 +1185,13 @@ install_llvm() {
 			"llvm$(llvm_version)-dev" # Ensures llvm-symbolizer is installed
 		;;
 	esac
+
+	case "$os" in
+		freebsd)
+			# TODO: use llvm_version_exact
+			install_packages "devel/llvm$(llvm_version)"
+		;;
+	esac
 }
 
 install_gcc() {
@@ -1206,39 +1267,69 @@ install_gcc() {
 	execute_sudo ln -sf $(which llvm-symbolizer-$llvm_v) /usr/bin/llvm-symbolizer
 }
 
-install_ccache() {
-	case "$pm" in
-	apt)
-		install_packages ccache
-		;;
-	brew)
-		install_packages ccache
-		;;
-	apk)
-		install_packages ccache
-		;;
-	dnf|yum)
-		install_packages ccache
-		;;
-	zypper)
-		install_packages ccache
-		;;
+install_sccache() {
+	case "$os" in
+		linux)
+			;;
+		freebsd)
+			cargo install sccache --locked --version 0.12.0
+			return
+			;;
+		*)
+			error "Unsupported platform: $os"
+			;;
 	esac
+
+	# Alright, look, this function is cobbled together but it's only as cobbled
+	# together as this whole script is.
+	#
+	# For some reason, move_to_bin doesn't work here due to permissions so I'm
+	# avoiding that function. It's also wrong with permissions and so on.
+	#
+	# Unfortunately, we cannot use install_packages since many package managers
+	# don't compile `sccache` with S3 support.
+	local opts=$-
+	set -ef
+
+	local sccache_http
+	sccache_http="https://github.com/mozilla/sccache/releases/download/v0.12.0/sccache-v0.12.0-$(uname -m)-unknown-linux-musl.tar.gz"
+
+	local file
+	file=$(download_file "$sccache_http")
+
+	local tmpdir
+	tmpdir=$(mktemp -d)
+
+	execute tar -xzf "$file" -C "$tmpdir"
+	execute_sudo install -m755 "$tmpdir/sccache-v0.12.0-$(uname -m)-unknown-linux-musl/sccache" "/usr/local/bin"
+
+	set +ef -"$opts"
 }
 
 install_rust() {
-	rust_home="/opt/rust"
-	create_directory "$rust_home"
-	append_to_profile "export RUSTUP_HOME=$rust_home"
-	append_to_profile "export CARGO_HOME=$rust_home"
+	case "$distro" in
+	alpine)
+		install_packages \
+			rust \
+			cargo
+		;;
+	freebsd)
+		install_packages lang/rust
+		create_directory "$HOME/.cargo/bin"
+		append_to_path "$HOME/.cargo/bin"
+		;;
+	*)
+		rust_home="/opt/rust"
+		create_directory "$rust_home"
+		append_to_profile "export RUSTUP_HOME=$rust_home"
+		append_to_profile "export CARGO_HOME=$rust_home"
 
-	sh="$(require sh)"
-	rustup_script=$(download_file "https://sh.rustup.rs")
-	execute "$sh" -lc "$rustup_script -y --no-modify-path"
-	append_to_path "$rust_home/bin"
-
-	# Ensure all rustup files are accessible (for CI builds where different users run builds)
-	grant_to_user "$rust_home"
+		sh="$(require sh)"
+		rustup_script=$(download_file "https://sh.rustup.rs")
+		execute "$sh" -lc "$rustup_script -y --no-modify-path"
+		append_to_path "$rust_home/bin"
+		;;
+	esac
 
 	case "$osxcross" in
 	1)
@@ -1355,6 +1446,9 @@ install_tailscale() {
 		execute_as_user go install tailscale.com/cmd/tailscale{,d}@latest
 		append_to_path "$home/go/bin"
 		;;
+	freebsd)
+		install_packages security/tailscale
+		;;
 	esac
 }
 
@@ -1421,6 +1515,14 @@ create_buildkite_user() {
 				--home "$home" \
 				--disabled-password
 			;;
+		freebsd)
+			execute_sudo pw group add -n "$group"
+			execute_sudo pw user add \
+				-n "$user" \
+				-g "$group" \
+				-s "$(require sh)" \
+				-d "$home" \
+			;;
 		*)
 			execute_sudo useradd "$user" \
 				--system \
@@ -1446,7 +1548,9 @@ create_buildkite_user() {
 	done
 
 	# The following is necessary to configure buildkite to use a stable
-	# checkout directory for ccache to be effective.
+	# checkout directory. sccache hashes absolute paths into its cache keys,
+	# so if buildkite uses a different checkout path each time (which it does
+	# by default), sccache will be useless.
 	local opts=$-
 	set -ef
 
@@ -1601,6 +1705,17 @@ install_age() {
 			;;
 		esac
 		;;
+	freebsd)
+		case "$arch" in
+		x64)
+			age_arch="amd64"
+			age_hash="943a7510a9973a1e589b913a70228aa1361a63cde39e3ed581435a4d4802df29"
+			;;
+		*)
+			error "Unsupported platform: $os-$arch"
+			;;
+		esac
+		;;
 	*)
 		error "Unsupported platform: $os-$arch"
 		;;

scripts/build-cache/bun.lock

@@ -0,0 +1,249 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "dependencies": {
+        "@aws-sdk/client-s3": "^3.928.0",
+        "@aws-sdk/property-provider": "^3.374.0",
+      },
+    },
+  },
+  "packages": {
+    "@aws-crypto/crc32": ["@aws-crypto/crc32@5.2.0", "", { "dependencies": { "@aws-crypto/util": "^5.2.0", "@aws-sdk/types": "^3.222.0", "tslib": "^2.6.2" } }, "sha512-nLbCWqQNgUiwwtFsen1AdzAtvuLRsQS8rYgMuxCrdKf9kOssamGLuPwyTY9wyYblNr9+1XM8v6zoDTPPSIeANg=="],
+
+    "@aws-crypto/crc32c": ["@aws-crypto/crc32c@5.2.0", "", { "dependencies": { "@aws-crypto/util": "^5.2.0", "@aws-sdk/types": "^3.222.0", "tslib": "^2.6.2" } }, "sha512-+iWb8qaHLYKrNvGRbiYRHSdKRWhto5XlZUEBwDjYNf+ly5SVYG6zEoYIdxvf5R3zyeP16w4PLBn3rH1xc74Rag=="],
+
+    "@aws-crypto/sha1-browser": ["@aws-crypto/sha1-browser@5.2.0", "", { "dependencies": { "@aws-crypto/supports-web-crypto": "^5.2.0", "@aws-crypto/util": "^5.2.0", "@aws-sdk/types": "^3.222.0", "@aws-sdk/util-locate-window": "^3.0.0", "@smithy/util-utf8": "^2.0.0", "tslib": "^2.6.2" } }, "sha512-OH6lveCFfcDjX4dbAvCFSYUjJZjDr/3XJ3xHtjn3Oj5b9RjojQo8npoLeA/bNwkOkrSQ0wgrHzXk4tDRxGKJeg=="],
+
+    "@aws-crypto/sha256-browser": ["@aws-crypto/sha256-browser@5.2.0", "", { "dependencies": { "@aws-crypto/sha256-js": "^5.2.0", "@aws-crypto/supports-web-crypto": "^5.2.0", "@aws-crypto/util": "^5.2.0", "@aws-sdk/types": "^3.222.0", "@aws-sdk/util-locate-window": "^3.0.0", "@smithy/util-utf8": "^2.0.0", "tslib": "^2.6.2" } }, "sha512-AXfN/lGotSQwu6HNcEsIASo7kWXZ5HYWvfOmSNKDsEqC4OashTp8alTmaz+F7TC2L083SFv5RdB+qU3Vs1kZqw=="],
+
+    "@aws-crypto/sha256-js": ["@aws-crypto/sha256-js@5.2.0", "", { "dependencies": { "@aws-crypto/util": "^5.2.0", "@aws-sdk/types": "^3.222.0", "tslib": "^2.6.2" } }, "sha512-FFQQyu7edu4ufvIZ+OadFpHHOt+eSTBaYaki44c+akjg7qZg9oOQeLlk77F6tSYqjDAFClrHJk9tMf0HdVyOvA=="],
+
+    "@aws-crypto/supports-web-crypto": ["@aws-crypto/supports-web-crypto@5.2.0", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-iAvUotm021kM33eCdNfwIN//F77/IADDSs58i+MDaOqFrVjZo9bAal0NK7HurRuWLLpF1iLX7gbWrjHjeo+YFg=="],
+
+    "@aws-crypto/util": ["@aws-crypto/util@5.2.0", "", { "dependencies": { "@aws-sdk/types": "^3.222.0", "@smithy/util-utf8": "^2.0.0", "tslib": "^2.6.2" } }, "sha512-4RkU9EsI6ZpBve5fseQlGNUWKMa1RLPQ1dnjnQoe07ldfIzcsGb5hC5W0Dm7u423KWzawlrpbjXBrXCEv9zazQ=="],
+
+    "@aws-sdk/client-s3": ["@aws-sdk/client-s3@3.928.0", "", { "dependencies": { "@aws-crypto/sha1-browser": "5.2.0", "@aws-crypto/sha256-browser": "5.2.0", "@aws-crypto/sha256-js": "5.2.0", "@aws-sdk/core": "3.928.0", "@aws-sdk/credential-provider-node": "3.928.0", "@aws-sdk/middleware-bucket-endpoint": "3.922.0", "@aws-sdk/middleware-expect-continue": "3.922.0", "@aws-sdk/middleware-flexible-checksums": "3.928.0", "@aws-sdk/middleware-host-header": "3.922.0", "@aws-sdk/middleware-location-constraint": "3.922.0", "@aws-sdk/middleware-logger": "3.922.0", "@aws-sdk/middleware-recursion-detection": "3.922.0", "@aws-sdk/middleware-sdk-s3": "3.928.0", "@aws-sdk/middleware-ssec": "3.922.0", "@aws-sdk/middleware-user-agent": "3.928.0", "@aws-sdk/region-config-resolver": "3.925.0", "@aws-sdk/signature-v4-multi-region": "3.928.0", "@aws-sdk/types": "3.922.0", "@aws-sdk/util-endpoints": "3.922.0", "@aws-sdk/util-user-agent-browser": "3.922.0", "@aws-sdk/util-user-agent-node": "3.928.0", "@aws-sdk/xml-builder": "3.921.0", "@smithy/config-resolver": "^4.4.2", "@smithy/core": "^3.17.2", "@smithy/eventstream-serde-browser": "^4.2.4", "@smithy/eventstream-serde-config-resolver": "^4.3.4", "@smithy/eventstream-serde-node": "^4.2.4", "@smithy/fetch-http-handler": "^5.3.5", "@smithy/hash-blob-browser": "^4.2.5", "@smithy/hash-node": "^4.2.4", "@smithy/hash-stream-node": "^4.2.4", "@smithy/invalid-dependency": "^4.2.4", "@smithy/md5-js": "^4.2.4", "@smithy/middleware-content-length": "^4.2.4", "@smithy/middleware-endpoint": "^4.3.6", "@smithy/middleware-retry": "^4.4.6", "@smithy/middleware-serde": "^4.2.4", "@smithy/middleware-stack": "^4.2.4", "@smithy/node-config-provider": "^4.3.4", "@smithy/node-http-handler": "^4.4.4", "@smithy/protocol-http": "^5.3.4", "@smithy/smithy-client": "^4.9.2", "@smithy/types": "^4.8.1", "@smithy/url-parser": "^4.2.4", "@smithy/util-base64": "^4.3.0", "@smithy/util-body-length-browser": "^4.2.0", "@smithy/util-body-length-node": "^4.2.1", "@smithy/util-defaults-mode-browser": "^4.3.5", "@smithy/util-defaults-mode-node": "^4.2.8", "@smithy/util-endpoints": "^3.2.4", "@smithy/util-middleware": "^4.2.4", "@smithy/util-retry": "^4.2.4", "@smithy/util-stream": "^4.5.5", "@smithy/util-utf8": "^4.2.0", "@smithy/util-waiter": "^4.2.4", "@smithy/uuid": "^1.1.0", "tslib": "^2.6.2" } }, "sha512-lXhhmcBjYa+ea0kRs00aq3WUwiXggwJkLwcMzOOsbW3CVYQaNpT7hztkfn2S6Qna7ETzd8M5+XZP+BmQRVE0Sg=="],
+
+    "@aws-sdk/client-sso": ["@aws-sdk/client-sso@3.928.0", "", { "dependencies": { "@aws-crypto/sha256-browser": "5.2.0", "@aws-crypto/sha256-js": "5.2.0", "@aws-sdk/core": "3.928.0", "@aws-sdk/middleware-host-header": "3.922.0", "@aws-sdk/middleware-logger": "3.922.0", "@aws-sdk/middleware-recursion-detection": "3.922.0", "@aws-sdk/middleware-user-agent": "3.928.0", "@aws-sdk/region-config-resolver": "3.925.0", "@aws-sdk/types": "3.922.0", "@aws-sdk/util-endpoints": "3.922.0", "@aws-sdk/util-user-agent-browser": "3.922.0", "@aws-sdk/util-user-agent-node": "3.928.0", "@smithy/config-resolver": "^4.4.2", "@smithy/core": "^3.17.2", "@smithy/fetch-http-handler": "^5.3.5", "@smithy/hash-node": "^4.2.4", "@smithy/invalid-dependency": "^4.2.4", "@smithy/middleware-content-length": "^4.2.4", "@smithy/middleware-endpoint": "^4.3.6", "@smithy/middleware-retry": "^4.4.6", "@smithy/middleware-serde": "^4.2.4", "@smithy/middleware-stack": "^4.2.4", "@smithy/node-config-provider": "^4.3.4", "@smithy/node-http-handler": "^4.4.4", "@smithy/protocol-http": "^5.3.4", "@smithy/smithy-client": "^4.9.2", "@smithy/types": "^4.8.1", "@smithy/url-parser": "^4.2.4", "@smithy/util-base64": "^4.3.0", "@smithy/util-body-length-browser": "^4.2.0", "@smithy/util-body-length-node": "^4.2.1", "@smithy/util-defaults-mode-browser": "^4.3.5", "@smithy/util-defaults-mode-node": "^4.2.8", "@smithy/util-endpoints": "^3.2.4", "@smithy/util-middleware": "^4.2.4", "@smithy/util-retry": "^4.2.4", "@smithy/util-utf8": "^4.2.0", "tslib": "^2.6.2" } }, "sha512-Efenb8zV2fJJDXmp2NE4xj8Ymhp4gVJCkQ6ixhdrpfQXgd2PODO7a20C2+BhFM6aGmN3m6XWYJ64ZyhXF4pAyQ=="],
+
+    "@aws-sdk/core": ["@aws-sdk/core@3.928.0", "", { "dependencies": { "@aws-sdk/types": "3.922.0", "@aws-sdk/xml-builder": "3.921.0", "@smithy/core": "^3.17.2", "@smithy/node-config-provider": "^4.3.4", "@smithy/property-provider": "^4.2.4", "@smithy/protocol-http": "^5.3.4", "@smithy/signature-v4": "^5.3.4", "@smithy/smithy-client": "^4.9.2", "@smithy/types": "^4.8.1", "@smithy/util-base64": "^4.3.0", "@smithy/util-middleware": "^4.2.4", "@smithy/util-utf8": "^4.2.0", "tslib": "^2.6.2" } }, "sha512-e28J2uKjy2uub4u41dNnmzAu0AN3FGB+LRcLN2Qnwl9Oq3kIcByl5sM8ZD+vWpNG+SFUrUasBCq8cMnHxwXZ4w=="],
+
+    "@aws-sdk/credential-provider-env": ["@aws-sdk/credential-provider-env@3.928.0", "", { "dependencies": { "@aws-sdk/core": "3.928.0", "@aws-sdk/types": "3.922.0", "@smithy/property-provider": "^4.2.4", "@smithy/types": "^4.8.1", "tslib": "^2.6.2" } }, "sha512-tB8F9Ti0/NFyFVQX8UQtgRik88evtHpyT6WfXOB4bAY6lEnEHA0ubJZmk9y+aUeoE+OsGLx70dC3JUsiiCPJkQ=="],
+
+    "@aws-sdk/credential-provider-http": ["@aws-sdk/credential-provider-http@3.928.0", "", { "dependencies": { "@aws-sdk/core": "3.928.0", "@aws-sdk/types": "3.922.0", "@smithy/fetch-http-handler": "^5.3.5", "@smithy/node-http-handler": "^4.4.4", "@smithy/property-provider": "^4.2.4", "@smithy/protocol-http": "^5.3.4", "@smithy/smithy-client": "^4.9.2", "@smithy/types": "^4.8.1", "@smithy/util-stream": "^4.5.5", "tslib": "^2.6.2" } }, "sha512-67ynC/8UW9Y8Gn1ZZtC3OgcQDGWrJelHmkbgpmmxYUrzVhp+NINtz3wiTzrrBFhPH/8Uy6BxvhMfXhn0ptcMEQ=="],
+
+    "@aws-sdk/credential-provider-ini": ["@aws-sdk/credential-provider-ini@3.928.0", "", { "dependencies": { "@aws-sdk/core": "3.928.0", "@aws-sdk/credential-provider-env": "3.928.0", "@aws-sdk/credential-provider-http": "3.928.0", "@aws-sdk/credential-provider-process": "3.928.0", "@aws-sdk/credential-provider-sso": "3.928.0", "@aws-sdk/credential-provider-web-identity": "3.928.0", "@aws-sdk/nested-clients": "3.928.0", "@aws-sdk/types": "3.922.0", "@smithy/credential-provider-imds": "^4.2.4", "@smithy/property-provider": "^4.2.4", "@smithy/shared-ini-file-loader": "^4.3.4", "@smithy/types": "^4.8.1", "tslib": "^2.6.2" } }, "sha512-WVWYyj+jox6mhKYp11mu8x1B6Xa2sLbXFHAv5K3Jg8CHvXYpePgTcYlCljq3d4XHC4Jl4nCcsdMtBahSpU9bAA=="],
+
+    "@aws-sdk/credential-provider-node": ["@aws-sdk/credential-provider-node@3.928.0", "", { "dependencies": { "@aws-sdk/credential-provider-env": "3.928.0", "@aws-sdk/credential-provider-http": "3.928.0", "@aws-sdk/credential-provider-ini": "3.928.0", "@aws-sdk/credential-provider-process": "3.928.0", "@aws-sdk/credential-provider-sso": "3.928.0", "@aws-sdk/credential-provider-web-identity": "3.928.0", "@aws-sdk/types": "3.922.0", "@smithy/credential-provider-imds": "^4.2.4", "@smithy/property-provider": "^4.2.4", "@smithy/shared-ini-file-loader": "^4.3.4", "@smithy/types": "^4.8.1", "tslib": "^2.6.2" } }, "sha512-SdXVjxZOIXefIR/NJx+lyXOrn4m0ScTAU2JXpLsFCkW2Cafo6vTqHUghyO8vak/XQ8PpPqpLXVpGbAYFuIPW6Q=="],
+
+    "@aws-sdk/credential-provider-process": ["@aws-sdk/credential-provider-process@3.928.0", "", { "dependencies": { "@aws-sdk/core": "3.928.0", "@aws-sdk/types": "3.922.0", "@smithy/property-provider": "^4.2.4", "@smithy/shared-ini-file-loader": "^4.3.4", "@smithy/types": "^4.8.1", "tslib": "^2.6.2" } }, "sha512-XL0juran8yhqwn0mreV+NJeHJOkcRBaExsvVn9fXWW37A4gLh4esSJxM2KbSNh0t+/Bk3ehBI5sL9xad+yRDuw=="],
+
+    "@aws-sdk/credential-provider-sso": ["@aws-sdk/credential-provider-sso@3.928.0", "", { "dependencies": { "@aws-sdk/client-sso": "3.928.0", "@aws-sdk/core": "3.928.0", "@aws-sdk/token-providers": "3.928.0", "@aws-sdk/types": "3.922.0", "@smithy/property-provider": "^4.2.4", "@smithy/shared-ini-file-loader": "^4.3.4", "@smithy/types": "^4.8.1", "tslib": "^2.6.2" } }, "sha512-md/y+ePDsO1zqPJrsOyPs4ciKmdpqLL7B0dln1NhqZPnKIS5IBfTqZJ5tJ9eTezqc7Tn4Dbg6HiuemcGvZTeFA=="],
+
+    "@aws-sdk/credential-provider-web-identity": ["@aws-sdk/credential-provider-web-identity@3.928.0", "", { "dependencies": { "@aws-sdk/core": "3.928.0", "@aws-sdk/nested-clients": "3.928.0", "@aws-sdk/types": "3.922.0", "@smithy/property-provider": "^4.2.4", "@smithy/shared-ini-file-loader": "^4.3.4", "@smithy/types": "^4.8.1", "tslib": "^2.6.2" } }, "sha512-rd97nLY5e/nGOr73ZfsXD+H44iZ9wyGZTKt/2QkiBN3hot/idhgT9+XHsWhRi+o/dThQbpL8RkpAnpF+0ZGthw=="],
+
+    "@aws-sdk/middleware-bucket-endpoint": ["@aws-sdk/middleware-bucket-endpoint@3.922.0", "", { "dependencies": { "@aws-sdk/types": "3.922.0", "@aws-sdk/util-arn-parser": "3.893.0", "@smithy/node-config-provider": "^4.3.4", "@smithy/protocol-http": "^5.3.4", "@smithy/types": "^4.8.1", "@smithy/util-config-provider": "^4.2.0", "tslib": "^2.6.2" } }, "sha512-Dpr2YeOaLFqt3q1hocwBesynE3x8/dXZqXZRuzSX/9/VQcwYBFChHAm4mTAl4zuvArtDbLrwzWSxmOWYZGtq5w=="],
+
+    "@aws-sdk/middleware-expect-continue": ["@aws-sdk/middleware-expect-continue@3.922.0", "", { "dependencies": { "@aws-sdk/types": "3.922.0", "@smithy/protocol-http": "^5.3.4", "@smithy/types": "^4.8.1", "tslib": "^2.6.2" } }, "sha512-xmnLWMtmHJHJBupSWMUEW1gyxuRIeQ1Ov2xa8Tqq77fPr4Ft2AluEwiDMaZIMHoAvpxWKEEt9Si59Li7GIA+bQ=="],
+
+    "@aws-sdk/middleware-flexible-checksums": ["@aws-sdk/middleware-flexible-checksums@3.928.0", "", { "dependencies": { "@aws-crypto/crc32": "5.2.0", "@aws-crypto/crc32c": "5.2.0", "@aws-crypto/util": "5.2.0", "@aws-sdk/core": "3.928.0", "@aws-sdk/types": "3.922.0", "@smithy/is-array-buffer": "^4.2.0", "@smithy/node-config-provider": "^4.3.4", "@smithy/protocol-http": "^5.3.4", "@smithy/types": "^4.8.1", "@smithy/util-middleware": "^4.2.4", "@smithy/util-stream": "^4.5.5", "@smithy/util-utf8": "^4.2.0", "tslib": "^2.6.2" } }, "sha512-9+aCRt7teItSIMbnGvOY+FhtJnW2ZBUbfD+ug29a/ZbobDfTwmtrmtgEIWdXryFaRbT03HHfaJ3a++lTw4osuw=="],
+
+    "@aws-sdk/middleware-host-header": ["@aws-sdk/middleware-host-header@3.922.0", "", { "dependencies": { "@aws-sdk/types": "3.922.0", "@smithy/protocol-http": "^5.3.4", "@smithy/types": "^4.8.1", "tslib": "^2.6.2" } }, "sha512-HPquFgBnq/KqKRVkiuCt97PmWbKtxQ5iUNLEc6FIviqOoZTmaYG3EDsIbuFBz9C4RHJU4FKLmHL2bL3FEId6AA=="],
+
+    "@aws-sdk/middleware-location-constraint": ["@aws-sdk/middleware-location-constraint@3.922.0", "", { "dependencies": { "@aws-sdk/types": "3.922.0", "@smithy/types": "^4.8.1", "tslib": "^2.6.2" } }, "sha512-T4iqd7WQ2DDjCH/0s50mnhdoX+IJns83ZE+3zj9IDlpU0N2aq8R91IG890qTfYkUEdP9yRm0xir/CNed+v6Dew=="],
+
+    "@aws-sdk/middleware-logger": ["@aws-sdk/middleware-logger@3.922.0", "", { "dependencies": { "@aws-sdk/types": "3.922.0", "@smithy/types": "^4.8.1", "tslib": "^2.6.2" } }, "sha512-AkvYO6b80FBm5/kk2E636zNNcNgjztNNUxpqVx+huyGn9ZqGTzS4kLqW2hO6CBe5APzVtPCtiQsXL24nzuOlAg=="],
+
+    "@aws-sdk/middleware-recursion-detection": ["@aws-sdk/middleware-recursion-detection@3.922.0", "", { "dependencies": { "@aws-sdk/types": "3.922.0", "@aws/lambda-invoke-store": "^0.1.1", "@smithy/protocol-http": "^5.3.4", "@smithy/types": "^4.8.1", "tslib": "^2.6.2" } }, "sha512-TtSCEDonV/9R0VhVlCpxZbp/9sxQvTTRKzIf8LxW3uXpby6Wl8IxEciBJlxmSkoqxh542WRcko7NYODlvL/gDA=="],
+
+    "@aws-sdk/middleware-sdk-s3": ["@aws-sdk/middleware-sdk-s3@3.928.0", "", { "dependencies": { "@aws-sdk/core": "3.928.0", "@aws-sdk/types": "3.922.0", "@aws-sdk/util-arn-parser": "3.893.0", "@smithy/core": "^3.17.2", "@smithy/node-config-provider": "^4.3.4", "@smithy/protocol-http": "^5.3.4", "@smithy/signature-v4": "^5.3.4", "@smithy/smithy-client": "^4.9.2", "@smithy/types": "^4.8.1", "@smithy/util-config-provider": "^4.2.0", "@smithy/util-middleware": "^4.2.4", "@smithy/util-stream": "^4.5.5", "@smithy/util-utf8": "^4.2.0", "tslib": "^2.6.2" } }, "sha512-LTkjS6cpJ2PEtsottTKq7JxZV0oH+QJ12P/dGNPZL4URayjEMBVR/dp4zh835X/FPXzijga3sdotlIKzuFy9FA=="],
+
+    "@aws-sdk/middleware-ssec": ["@aws-sdk/middleware-ssec@3.922.0", "", { "dependencies": { "@aws-sdk/types": "3.922.0", "@smithy/types": "^4.8.1", "tslib": "^2.6.2" } }, "sha512-eHvSJZTSRJO+/tjjGD6ocnPc8q9o3m26+qbwQTu/4V6yOJQ1q+xkDZNqwJQphL+CodYaQ7uljp8g1Ji/AN3D9w=="],
+
+    "@aws-sdk/middleware-user-agent": ["@aws-sdk/middleware-user-agent@3.928.0", "", { "dependencies": { "@aws-sdk/core": "3.928.0", "@aws-sdk/types": "3.922.0", "@aws-sdk/util-endpoints": "3.922.0", "@smithy/core": "^3.17.2", "@smithy/protocol-http": "^5.3.4", "@smithy/types": "^4.8.1", "tslib": "^2.6.2" } }, "sha512-ESvcfLx5PtpdUM3ptCwb80toBTd3y5I4w5jaeOPHihiZr7jkRLE/nsaCKzlqscPs6UQ8xI0maav04JUiTskcHw=="],
+
+    "@aws-sdk/nested-clients": ["@aws-sdk/nested-clients@3.928.0", "", { "dependencies": { "@aws-crypto/sha256-browser": "5.2.0", "@aws-crypto/sha256-js": "5.2.0", "@aws-sdk/core": "3.928.0", "@aws-sdk/middleware-host-header": "3.922.0", "@aws-sdk/middleware-logger": "3.922.0", "@aws-sdk/middleware-recursion-detection": "3.922.0", "@aws-sdk/middleware-user-agent": "3.928.0", "@aws-sdk/region-config-resolver": "3.925.0", "@aws-sdk/types": "3.922.0", "@aws-sdk/util-endpoints": "3.922.0", "@aws-sdk/util-user-agent-browser": "3.922.0", "@aws-sdk/util-user-agent-node": "3.928.0", "@smithy/config-resolver": "^4.4.2", "@smithy/core": "^3.17.2", "@smithy/fetch-http-handler": "^5.3.5", "@smithy/hash-node": "^4.2.4", "@smithy/invalid-dependency": "^4.2.4", "@smithy/middleware-content-length": "^4.2.4", "@smithy/middleware-endpoint": "^4.3.6", "@smithy/middleware-retry": "^4.4.6", "@smithy/middleware-serde": "^4.2.4", "@smithy/middleware-stack": "^4.2.4", "@smithy/node-config-provider": "^4.3.4", "@smithy/node-http-handler": "^4.4.4", "@smithy/protocol-http": "^5.3.4", "@smithy/smithy-client": "^4.9.2", "@smithy/types": "^4.8.1", "@smithy/url-parser": "^4.2.4", "@smithy/util-base64": "^4.3.0", "@smithy/util-body-length-browser": "^4.2.0", "@smithy/util-body-length-node": "^4.2.1", "@smithy/util-defaults-mode-browser": "^4.3.5", "@smithy/util-defaults-mode-node": "^4.2.8", "@smithy/util-endpoints": "^3.2.4", "@smithy/util-middleware": "^4.2.4", "@smithy/util-retry": "^4.2.4", "@smithy/util-utf8": "^4.2.0", "tslib": "^2.6.2" } }, "sha512-kXzfJkq2cD65KAHDe4hZCsnxcGGEWD5pjHqcZplwG4VFMa/iVn/mWrUY9QdadD2GBpXFNQbgOiKG3U2NkKu+4Q=="],
+
+    "@aws-sdk/property-provider": ["@aws-sdk/property-provider@3.374.0", "", { "dependencies": { "@smithy/property-provider": "^1.0.1", "tslib": "^2.5.0" } }, "sha512-UvsRnRtLD3g0tPMuiILJiGT9PIg4tgU3coRO4s+bAuT29mUiuViDAQB8DYPgaOtqA4qNFiWose+AMCpdxlOhRA=="],
+
+    "@aws-sdk/region-config-resolver": ["@aws-sdk/region-config-resolver@3.925.0", "", { "dependencies": { "@aws-sdk/types": "3.922.0", "@smithy/config-resolver": "^4.4.2", "@smithy/node-config-provider": "^4.3.4", "@smithy/types": "^4.8.1", "tslib": "^2.6.2" } }, "sha512-FOthcdF9oDb1pfQBRCfWPZhJZT5wqpvdAS5aJzB1WDZ+6EuaAhLzLH/fW1slDunIqq1PSQGG3uSnVglVVOvPHQ=="],
+
+    "@aws-sdk/signature-v4-multi-region": ["@aws-sdk/signature-v4-multi-region@3.928.0", "", { "dependencies": { "@aws-sdk/middleware-sdk-s3": "3.928.0", "@aws-sdk/types": "3.922.0", "@smithy/protocol-http": "^5.3.4", "@smithy/signature-v4": "^5.3.4", "@smithy/types": "^4.8.1", "tslib": "^2.6.2" } }, "sha512-1+Ic8+MyqQy+OE6QDoQKVCIcSZO+ETmLLLpVS5yu0fihBU85B5HHU7iaKX1qX7lEaGPMpSN/mbHW0VpyQ0Xqaw=="],
+
+    "@aws-sdk/token-providers": ["@aws-sdk/token-providers@3.928.0", "", { "dependencies": { "@aws-sdk/core": "3.928.0", "@aws-sdk/nested-clients": "3.928.0", "@aws-sdk/types": "3.922.0", "@smithy/property-provider": "^4.2.4", "@smithy/shared-ini-file-loader": "^4.3.4", "@smithy/types": "^4.8.1", "tslib": "^2.6.2" } }, "sha512-533NpTdUJNDi98zBwRp4ZpZoqULrAVfc0YgIy+8AZHzk0v7N+v59O0d2Du3YO6zN4VU8HU8766DgKiyEag6Dzg=="],
+
+    "@aws-sdk/types": ["@aws-sdk/types@3.922.0", "", { "dependencies": { "@smithy/types": "^4.8.1", "tslib": "^2.6.2" } }, "sha512-eLA6XjVobAUAMivvM7DBL79mnHyrm+32TkXNWZua5mnxF+6kQCfblKKJvxMZLGosO53/Ex46ogim8IY5Nbqv2w=="],
+
+    "@aws-sdk/util-arn-parser": ["@aws-sdk/util-arn-parser@3.893.0", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-u8H4f2Zsi19DGnwj5FSZzDMhytYF/bCh37vAtBsn3cNDL3YG578X5oc+wSX54pM3tOxS+NY7tvOAo52SW7koUA=="],
+
+    "@aws-sdk/util-endpoints": ["@aws-sdk/util-endpoints@3.922.0", "", { "dependencies": { "@aws-sdk/types": "3.922.0", "@smithy/types": "^4.8.1", "@smithy/url-parser": "^4.2.4", "@smithy/util-endpoints": "^3.2.4", "tslib": "^2.6.2" } }, "sha512-4ZdQCSuNMY8HMlR1YN4MRDdXuKd+uQTeKIr5/pIM+g3TjInZoj8imvXudjcrFGA63UF3t92YVTkBq88mg58RXQ=="],
+
+    "@aws-sdk/util-locate-window": ["@aws-sdk/util-locate-window@3.893.0", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-T89pFfgat6c8nMmpI8eKjBcDcgJq36+m9oiXbcUzeU55MP9ZuGgBomGjGnHaEyF36jenW9gmg3NfZDm0AO2XPg=="],
+
+    "@aws-sdk/util-user-agent-browser": ["@aws-sdk/util-user-agent-browser@3.922.0", "", { "dependencies": { "@aws-sdk/types": "3.922.0", "@smithy/types": "^4.8.1", "bowser": "^2.11.0", "tslib": "^2.6.2" } }, "sha512-qOJAERZ3Plj1st7M4Q5henl5FRpE30uLm6L9edZqZXGR6c7ry9jzexWamWVpQ4H4xVAVmiO9dIEBAfbq4mduOA=="],
+
+    "@aws-sdk/util-user-agent-node": ["@aws-sdk/util-user-agent-node@3.928.0", "", { "dependencies": { "@aws-sdk/middleware-user-agent": "3.928.0", "@aws-sdk/types": "3.922.0", "@smithy/node-config-provider": "^4.3.4", "@smithy/types": "^4.8.1", "tslib": "^2.6.2" }, "peerDependencies": { "aws-crt": ">=1.0.0" }, "optionalPeers": ["aws-crt"] }, "sha512-s0jP67nQLLWVWfBtqTkZUkSWK5e6OI+rs+wFya2h9VLyWBFir17XSDI891s8HZKIVCEl8eBrup+hhywm4nsIAA=="],
+
+    "@aws-sdk/xml-builder": ["@aws-sdk/xml-builder@3.921.0", "", { "dependencies": { "@smithy/types": "^4.8.1", "fast-xml-parser": "5.2.5", "tslib": "^2.6.2" } }, "sha512-LVHg0jgjyicKKvpNIEMXIMr1EBViESxcPkqfOlT+X1FkmUMTNZEEVF18tOJg4m4hV5vxtkWcqtr4IEeWa1C41Q=="],
+
+    "@aws/lambda-invoke-store": ["@aws/lambda-invoke-store@0.1.1", "", {}, "sha512-RcLam17LdlbSOSp9VxmUu1eI6Mwxp+OwhD2QhiSNmNCzoDb0EeUXTD2n/WbcnrAYMGlmf05th6QYq23VqvJqpA=="],
+
+    "@smithy/abort-controller": ["@smithy/abort-controller@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-j7HwVkBw68YW8UmFRcjZOmssE77Rvk0GWAIN1oFBhsaovQmZWYCIcGa9/pwRB0ExI8Sk9MWNALTjftjHZea7VA=="],
+
+    "@smithy/chunked-blob-reader": ["@smithy/chunked-blob-reader@5.2.0", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-WmU0TnhEAJLWvfSeMxBNe5xtbselEO8+4wG0NtZeL8oR21WgH1xiO37El+/Y+H/Ie4SCwBy3MxYWmOYaGgZueA=="],
+
+    "@smithy/chunked-blob-reader-native": ["@smithy/chunked-blob-reader-native@4.2.1", "", { "dependencies": { "@smithy/util-base64": "^4.3.0", "tslib": "^2.6.2" } }, "sha512-lX9Ay+6LisTfpLid2zZtIhSEjHMZoAR5hHCR4H7tBz/Zkfr5ea8RcQ7Tk4mi0P76p4cN+Btz16Ffno7YHpKXnQ=="],
+
+    "@smithy/config-resolver": ["@smithy/config-resolver@4.4.3", "", { "dependencies": { "@smithy/node-config-provider": "^4.3.5", "@smithy/types": "^4.9.0", "@smithy/util-config-provider": "^4.2.0", "@smithy/util-endpoints": "^3.2.5", "@smithy/util-middleware": "^4.2.5", "tslib": "^2.6.2" } }, "sha512-ezHLe1tKLUxDJo2LHtDuEDyWXolw8WGOR92qb4bQdWq/zKenO5BvctZGrVJBK08zjezSk7bmbKFOXIVyChvDLw=="],
+
+    "@smithy/core": ["@smithy/core@3.18.0", "", { "dependencies": { "@smithy/middleware-serde": "^4.2.5", "@smithy/protocol-http": "^5.3.5", "@smithy/types": "^4.9.0", "@smithy/util-base64": "^4.3.0", "@smithy/util-body-length-browser": "^4.2.0", "@smithy/util-middleware": "^4.2.5", "@smithy/util-stream": "^4.5.6", "@smithy/util-utf8": "^4.2.0", "@smithy/uuid": "^1.1.0", "tslib": "^2.6.2" } }, "sha512-vGSDXOJFZgOPTatSI1ly7Gwyy/d/R9zh2TO3y0JZ0uut5qQ88p9IaWaZYIWSSqtdekNM4CGok/JppxbAff4KcQ=="],
+
+    "@smithy/credential-provider-imds": ["@smithy/credential-provider-imds@4.2.5", "", { "dependencies": { "@smithy/node-config-provider": "^4.3.5", "@smithy/property-provider": "^4.2.5", "@smithy/types": "^4.9.0", "@smithy/url-parser": "^4.2.5", "tslib": "^2.6.2" } }, "sha512-BZwotjoZWn9+36nimwm/OLIcVe+KYRwzMjfhd4QT7QxPm9WY0HiOV8t/Wlh+HVUif0SBVV7ksq8//hPaBC/okQ=="],
+
+    "@smithy/eventstream-codec": ["@smithy/eventstream-codec@4.2.5", "", { "dependencies": { "@aws-crypto/crc32": "5.2.0", "@smithy/types": "^4.9.0", "@smithy/util-hex-encoding": "^4.2.0", "tslib": "^2.6.2" } }, "sha512-Ogt4Zi9hEbIP17oQMd68qYOHUzmH47UkK7q7Gl55iIm9oKt27MUGrC5JfpMroeHjdkOliOA4Qt3NQ1xMq/nrlA=="],
+
+    "@smithy/eventstream-serde-browser": ["@smithy/eventstream-serde-browser@4.2.5", "", { "dependencies": { "@smithy/eventstream-serde-universal": "^4.2.5", "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-HohfmCQZjppVnKX2PnXlf47CW3j92Ki6T/vkAT2DhBR47e89pen3s4fIa7otGTtrVxmj7q+IhH0RnC5kpR8wtw=="],
+
+    "@smithy/eventstream-serde-config-resolver": ["@smithy/eventstream-serde-config-resolver@4.3.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-ibjQjM7wEXtECiT6my1xfiMH9IcEczMOS6xiCQXoUIYSj5b1CpBbJ3VYbdwDy8Vcg5JHN7eFpOCGk8nyZAltNQ=="],
+
+    "@smithy/eventstream-serde-node": ["@smithy/eventstream-serde-node@4.2.5", "", { "dependencies": { "@smithy/eventstream-serde-universal": "^4.2.5", "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-+elOuaYx6F2H6x1/5BQP5ugv12nfJl66GhxON8+dWVUEDJ9jah/A0tayVdkLRP0AeSac0inYkDz5qBFKfVp2Gg=="],
+
+    "@smithy/eventstream-serde-universal": ["@smithy/eventstream-serde-universal@4.2.5", "", { "dependencies": { "@smithy/eventstream-codec": "^4.2.5", "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-G9WSqbST45bmIFaeNuP/EnC19Rhp54CcVdX9PDL1zyEB514WsDVXhlyihKlGXnRycmHNmVv88Bvvt4EYxWef/Q=="],
+
+    "@smithy/fetch-http-handler": ["@smithy/fetch-http-handler@5.3.6", "", { "dependencies": { "@smithy/protocol-http": "^5.3.5", "@smithy/querystring-builder": "^4.2.5", "@smithy/types": "^4.9.0", "@smithy/util-base64": "^4.3.0", "tslib": "^2.6.2" } }, "sha512-3+RG3EA6BBJ/ofZUeTFJA7mHfSYrZtQIrDP9dI8Lf7X6Jbos2jptuLrAAteDiFVrmbEmLSuRG/bUKzfAXk7dhg=="],
+
+    "@smithy/hash-blob-browser": ["@smithy/hash-blob-browser@4.2.6", "", { "dependencies": { "@smithy/chunked-blob-reader": "^5.2.0", "@smithy/chunked-blob-reader-native": "^4.2.1", "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-8P//tA8DVPk+3XURk2rwcKgYwFvwGwmJH/wJqQiSKwXZtf/LiZK+hbUZmPj/9KzM+OVSwe4o85KTp5x9DUZTjw=="],
+
+    "@smithy/hash-node": ["@smithy/hash-node@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "@smithy/util-buffer-from": "^4.2.0", "@smithy/util-utf8": "^4.2.0", "tslib": "^2.6.2" } }, "sha512-DpYX914YOfA3UDT9CN1BM787PcHfWRBB43fFGCYrZFUH0Jv+5t8yYl+Pd5PW4+QzoGEDvn5d5QIO4j2HyYZQSA=="],
+
+    "@smithy/hash-stream-node": ["@smithy/hash-stream-node@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "@smithy/util-utf8": "^4.2.0", "tslib": "^2.6.2" } }, "sha512-6+do24VnEyvWcGdHXomlpd0m8bfZePpUKBy7m311n+JuRwug8J4dCanJdTymx//8mi0nlkflZBvJe+dEO/O12Q=="],
+
+    "@smithy/invalid-dependency": ["@smithy/invalid-dependency@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-2L2erASEro1WC5nV+plwIMxrTXpvpfzl4e+Nre6vBVRR2HKeGGcvpJyyL3/PpiSg+cJG2KpTmZmq934Olb6e5A=="],
+
+    "@smithy/is-array-buffer": ["@smithy/is-array-buffer@4.2.0", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-DZZZBvC7sjcYh4MazJSGiWMI2L7E0oCiRHREDzIxi/M2LY79/21iXt6aPLHge82wi5LsuRF5A06Ds3+0mlh6CQ=="],
+
+    "@smithy/md5-js": ["@smithy/md5-js@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "@smithy/util-utf8": "^4.2.0", "tslib": "^2.6.2" } }, "sha512-Bt6jpSTMWfjCtC0s79gZ/WZ1w90grfmopVOWqkI2ovhjpD5Q2XRXuecIPB9689L2+cCySMbaXDhBPU56FKNDNg=="],
+
+    "@smithy/middleware-content-length": ["@smithy/middleware-content-length@4.2.5", "", { "dependencies": { "@smithy/protocol-http": "^5.3.5", "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-Y/RabVa5vbl5FuHYV2vUCwvh/dqzrEY/K2yWPSqvhFUwIY0atLqO4TienjBXakoy4zrKAMCZwg+YEqmH7jaN7A=="],
+
+    "@smithy/middleware-endpoint": ["@smithy/middleware-endpoint@4.3.7", "", { "dependencies": { "@smithy/core": "^3.18.0", "@smithy/middleware-serde": "^4.2.5", "@smithy/node-config-provider": "^4.3.5", "@smithy/shared-ini-file-loader": "^4.4.0", "@smithy/types": "^4.9.0", "@smithy/url-parser": "^4.2.5", "@smithy/util-middleware": "^4.2.5", "tslib": "^2.6.2" } }, "sha512-i8Mi8OuY6Yi82Foe3iu7/yhBj1HBRoOQwBSsUNYglJTNSFaWYTNM2NauBBs/7pq2sqkLRqeUXA3Ogi2utzpUlQ=="],
+
+    "@smithy/middleware-retry": ["@smithy/middleware-retry@4.4.7", "", { "dependencies": { "@smithy/node-config-provider": "^4.3.5", "@smithy/protocol-http": "^5.3.5", "@smithy/service-error-classification": "^4.2.5", "@smithy/smithy-client": "^4.9.3", "@smithy/types": "^4.9.0", "@smithy/util-middleware": "^4.2.5", "@smithy/util-retry": "^4.2.5", "@smithy/uuid": "^1.1.0", "tslib": "^2.6.2" } }, "sha512-E7Vc6WHCHlzDRTx1W0jZ6J1L6ziEV0PIWcUdmfL4y+c8r7WYr6I+LkQudaD8Nfb7C5c4P3SQ972OmXHtv6m/OA=="],
+
+    "@smithy/middleware-serde": ["@smithy/middleware-serde@4.2.5", "", { "dependencies": { "@smithy/protocol-http": "^5.3.5", "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-La1ldWTJTZ5NqQyPqnCNeH9B+zjFhrNoQIL1jTh4zuqXRlmXhxYHhMtI1/92OlnoAtp6JoN7kzuwhWoXrBwPqg=="],
+
+    "@smithy/middleware-stack": ["@smithy/middleware-stack@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-bYrutc+neOyWxtZdbB2USbQttZN0mXaOyYLIsaTbJhFsfpXyGWUxJpEuO1rJ8IIJm2qH4+xJT0mxUSsEDTYwdQ=="],
+
+    "@smithy/node-config-provider": ["@smithy/node-config-provider@4.3.5", "", { "dependencies": { "@smithy/property-provider": "^4.2.5", "@smithy/shared-ini-file-loader": "^4.4.0", "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-UTurh1C4qkVCtqggI36DGbLB2Kv8UlcFdMXDcWMbqVY2uRg0XmT9Pb4Vj6oSQ34eizO1fvR0RnFV4Axw4IrrAg=="],
+
+    "@smithy/node-http-handler": ["@smithy/node-http-handler@4.4.5", "", { "dependencies": { "@smithy/abort-controller": "^4.2.5", "@smithy/protocol-http": "^5.3.5", "@smithy/querystring-builder": "^4.2.5", "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-CMnzM9R2WqlqXQGtIlsHMEZfXKJVTIrqCNoSd/QpAyp+Dw0a1Vps13l6ma1fH8g7zSPNsA59B/kWgeylFuA/lw=="],
+
+    "@smithy/property-provider": ["@smithy/property-provider@1.2.0", "", { "dependencies": { "@smithy/types": "^1.2.0", "tslib": "^2.5.0" } }, "sha512-qlJd9gT751i4T0t/hJAyNGfESfi08Fek8QiLcysoKPgR05qHhG0OYhlaCJHhpXy4ECW0lHyjvFM1smrCLIXVfw=="],
+
+    "@smithy/protocol-http": ["@smithy/protocol-http@5.3.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-RlaL+sA0LNMp03bf7XPbFmT5gN+w3besXSWMkA8rcmxLSVfiEXElQi4O2IWwPfxzcHkxqrwBFMbngB8yx/RvaQ=="],
+
+    "@smithy/querystring-builder": ["@smithy/querystring-builder@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "@smithy/util-uri-escape": "^4.2.0", "tslib": "^2.6.2" } }, "sha512-y98otMI1saoajeik2kLfGyRp11e5U/iJYH/wLCh3aTV/XutbGT9nziKGkgCaMD1ghK7p6htHMm6b6scl9JRUWg=="],
+
+    "@smithy/querystring-parser": ["@smithy/querystring-parser@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-031WCTdPYgiQRYNPXznHXof2YM0GwL6SeaSyTH/P72M1Vz73TvCNH2Nq8Iu2IEPq9QP2yx0/nrw5YmSeAi/AjQ=="],
+
+    "@smithy/service-error-classification": ["@smithy/service-error-classification@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0" } }, "sha512-8fEvK+WPE3wUAcDvqDQG1Vk3ANLR8Px979te96m84CbKAjBVf25rPYSzb4xU4hlTyho7VhOGnh5i62D/JVF0JQ=="],
+
+    "@smithy/shared-ini-file-loader": ["@smithy/shared-ini-file-loader@4.4.0", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-5WmZ5+kJgJDjwXXIzr1vDTG+RhF9wzSODQBfkrQ2VVkYALKGvZX1lgVSxEkgicSAFnFhPj5rudJV0zoinqS0bA=="],
+
+    "@smithy/signature-v4": ["@smithy/signature-v4@5.3.5", "", { "dependencies": { "@smithy/is-array-buffer": "^4.2.0", "@smithy/protocol-http": "^5.3.5", "@smithy/types": "^4.9.0", "@smithy/util-hex-encoding": "^4.2.0", "@smithy/util-middleware": "^4.2.5", "@smithy/util-uri-escape": "^4.2.0", "@smithy/util-utf8": "^4.2.0", "tslib": "^2.6.2" } }, "sha512-xSUfMu1FT7ccfSXkoLl/QRQBi2rOvi3tiBZU2Tdy3I6cgvZ6SEi9QNey+lqps/sJRnogIS+lq+B1gxxbra2a/w=="],
+
+    "@smithy/smithy-client": ["@smithy/smithy-client@4.9.3", "", { "dependencies": { "@smithy/core": "^3.18.0", "@smithy/middleware-endpoint": "^4.3.7", "@smithy/middleware-stack": "^4.2.5", "@smithy/protocol-http": "^5.3.5", "@smithy/types": "^4.9.0", "@smithy/util-stream": "^4.5.6", "tslib": "^2.6.2" } }, "sha512-8tlueuTgV5n7inQCkhyptrB3jo2AO80uGrps/XTYZivv5MFQKKBj3CIWIGMI2fRY5LEduIiazOhAWdFknY1O9w=="],
+
+    "@smithy/types": ["@smithy/types@4.9.0", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-MvUbdnXDTwykR8cB1WZvNNwqoWVaTRA0RLlLmf/cIFNMM2cKWz01X4Ly6SMC4Kks30r8tT3Cty0jmeWfiuyHTA=="],
+
+    "@smithy/url-parser": ["@smithy/url-parser@4.2.5", "", { "dependencies": { "@smithy/querystring-parser": "^4.2.5", "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-VaxMGsilqFnK1CeBX+LXnSuaMx4sTL/6znSZh2829txWieazdVxr54HmiyTsIbpOTLcf5nYpq9lpzmwRdxj6rQ=="],
+
+    "@smithy/util-base64": ["@smithy/util-base64@4.3.0", "", { "dependencies": { "@smithy/util-buffer-from": "^4.2.0", "@smithy/util-utf8": "^4.2.0", "tslib": "^2.6.2" } }, "sha512-GkXZ59JfyxsIwNTWFnjmFEI8kZpRNIBfxKjv09+nkAWPt/4aGaEWMM04m4sxgNVWkbt2MdSvE3KF/PfX4nFedQ=="],
+
+    "@smithy/util-body-length-browser": ["@smithy/util-body-length-browser@4.2.0", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-Fkoh/I76szMKJnBXWPdFkQJl2r9SjPt3cMzLdOB6eJ4Pnpas8hVoWPYemX/peO0yrrvldgCUVJqOAjUrOLjbxg=="],
+
+    "@smithy/util-body-length-node": ["@smithy/util-body-length-node@4.2.1", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-h53dz/pISVrVrfxV1iqXlx5pRg3V2YWFcSQyPyXZRrZoZj4R4DeWRDo1a7dd3CPTcFi3kE+98tuNyD2axyZReA=="],
+
+    "@smithy/util-buffer-from": ["@smithy/util-buffer-from@4.2.0", "", { "dependencies": { "@smithy/is-array-buffer": "^4.2.0", "tslib": "^2.6.2" } }, "sha512-kAY9hTKulTNevM2nlRtxAG2FQ3B2OR6QIrPY3zE5LqJy1oxzmgBGsHLWTcNhWXKchgA0WHW+mZkQrng/pgcCew=="],
+
+    "@smithy/util-config-provider": ["@smithy/util-config-provider@4.2.0", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-YEjpl6XJ36FTKmD+kRJJWYvrHeUvm5ykaUS5xK+6oXffQPHeEM4/nXlZPe+Wu0lsgRUcNZiliYNh/y7q9c2y6Q=="],
+
+    "@smithy/util-defaults-mode-browser": ["@smithy/util-defaults-mode-browser@4.3.6", "", { "dependencies": { "@smithy/property-provider": "^4.2.5", "@smithy/smithy-client": "^4.9.3", "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-kbpuXbEf2YQ9zEE6eeVnUCQWO0e1BjMnKrXL8rfXgiWA0m8/E0leU4oSNzxP04WfCmW8vjEqaDeXWxwE4tpOjQ=="],
+
+    "@smithy/util-defaults-mode-node": ["@smithy/util-defaults-mode-node@4.2.9", "", { "dependencies": { "@smithy/config-resolver": "^4.4.3", "@smithy/credential-provider-imds": "^4.2.5", "@smithy/node-config-provider": "^4.3.5", "@smithy/property-provider": "^4.2.5", "@smithy/smithy-client": "^4.9.3", "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-dgyribrVWN5qE5usYJ0m5M93mVM3L3TyBPZWe1Xl6uZlH2gzfQx3dz+ZCdW93lWqdedJRkOecnvbnoEEXRZ5VQ=="],
+
+    "@smithy/util-endpoints": ["@smithy/util-endpoints@3.2.5", "", { "dependencies": { "@smithy/node-config-provider": "^4.3.5", "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-3O63AAWu2cSNQZp+ayl9I3NapW1p1rR5mlVHcF6hAB1dPZUQFfRPYtplWX/3xrzWthPGj5FqB12taJJCfH6s8A=="],
+
+    "@smithy/util-hex-encoding": ["@smithy/util-hex-encoding@4.2.0", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-CCQBwJIvXMLKxVbO88IukazJD9a4kQ9ZN7/UMGBjBcJYvatpWk+9g870El4cB8/EJxfe+k+y0GmR9CAzkF+Nbw=="],
+
+    "@smithy/util-middleware": ["@smithy/util-middleware@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-6Y3+rvBF7+PZOc40ybeZMcGln6xJGVeY60E7jy9Mv5iKpMJpHgRE6dKy9ScsVxvfAYuEX4Q9a65DQX90KaQ3bA=="],
+
+    "@smithy/util-retry": ["@smithy/util-retry@4.2.5", "", { "dependencies": { "@smithy/service-error-classification": "^4.2.5", "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-GBj3+EZBbN4NAqJ/7pAhsXdfzdlznOh8PydUijy6FpNIMnHPSMO2/rP4HKu+UFeikJxShERk528oy7GT79YiJg=="],
+
+    "@smithy/util-stream": ["@smithy/util-stream@4.5.6", "", { "dependencies": { "@smithy/fetch-http-handler": "^5.3.6", "@smithy/node-http-handler": "^4.4.5", "@smithy/types": "^4.9.0", "@smithy/util-base64": "^4.3.0", "@smithy/util-buffer-from": "^4.2.0", "@smithy/util-hex-encoding": "^4.2.0", "@smithy/util-utf8": "^4.2.0", "tslib": "^2.6.2" } }, "sha512-qWw/UM59TiaFrPevefOZ8CNBKbYEP6wBAIlLqxn3VAIo9rgnTNc4ASbVrqDmhuwI87usnjhdQrxodzAGFFzbRQ=="],
+
+    "@smithy/util-uri-escape": ["@smithy/util-uri-escape@4.2.0", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-igZpCKV9+E/Mzrpq6YacdTQ0qTiLm85gD6N/IrmyDvQFA4UnU3d5g3m8tMT/6zG/vVkWSU+VxeUyGonL62DuxA=="],
+
+    "@smithy/util-utf8": ["@smithy/util-utf8@4.2.0", "", { "dependencies": { "@smithy/util-buffer-from": "^4.2.0", "tslib": "^2.6.2" } }, "sha512-zBPfuzoI8xyBtR2P6WQj63Rz8i3AmfAaJLuNG8dWsfvPe8lO4aCPYLn879mEgHndZH1zQ2oXmG8O1GGzzaoZiw=="],
+
+    "@smithy/util-waiter": ["@smithy/util-waiter@4.2.5", "", { "dependencies": { "@smithy/abort-controller": "^4.2.5", "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-Dbun99A3InifQdIrsXZ+QLcC0PGBPAdrl4cj1mTgJvyc9N2zf7QSxg8TBkzsCmGJdE3TLbO9ycwpY0EkWahQ/g=="],
+
+    "@smithy/uuid": ["@smithy/uuid@1.1.0", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-4aUIteuyxtBUhVdiQqcDhKFitwfd9hqoSDYY2KRXiWtgoWJ9Bmise+KfEPDiVHWeJepvF8xJO9/9+WDIciMFFw=="],
+
+    "bowser": ["bowser@2.12.1", "", {}, "sha512-z4rE2Gxh7tvshQ4hluIT7XcFrgLIQaw9X3A+kTTRdovCz5PMukm/0QC/BKSYPj3omF5Qfypn9O/c5kgpmvYUCw=="],
+
+    "fast-xml-parser": ["fast-xml-parser@5.2.5", "", { "dependencies": { "strnum": "^2.1.0" }, "bin": { "fxparser": "src/cli/cli.js" } }, "sha512-pfX9uG9Ki0yekDHx2SiuRIyFdyAr1kMIMitPvb0YBo8SUfKvia7w7FIyd/l6av85pFYRhZscS75MwMnbvY+hcQ=="],
+
+    "strnum": ["strnum@2.1.1", "", {}, "sha512-7ZvoFTiCnGxBtDqJ//Cu6fWtZtc7Y3x+QOirG15wztbdngGSkht27o2pyGWrVy0b4WAy3jbKmnoK6g5VlVNUUw=="],
+
+    "tslib": ["tslib@2.8.1", "", {}, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
+
+    "@aws-crypto/sha1-browser/@smithy/util-utf8": ["@smithy/util-utf8@2.3.0", "", { "dependencies": { "@smithy/util-buffer-from": "^2.2.0", "tslib": "^2.6.2" } }, "sha512-R8Rdn8Hy72KKcebgLiv8jQcQkXoLMOGGv5uI1/k0l+snqkOzQ1R0ChUBCxWMlBsFMekWjq0wRudIweFs7sKT5A=="],
+
+    "@aws-crypto/sha256-browser/@smithy/util-utf8": ["@smithy/util-utf8@2.3.0", "", { "dependencies": { "@smithy/util-buffer-from": "^2.2.0", "tslib": "^2.6.2" } }, "sha512-R8Rdn8Hy72KKcebgLiv8jQcQkXoLMOGGv5uI1/k0l+snqkOzQ1R0ChUBCxWMlBsFMekWjq0wRudIweFs7sKT5A=="],
+
+    "@aws-crypto/util/@smithy/util-utf8": ["@smithy/util-utf8@2.3.0", "", { "dependencies": { "@smithy/util-buffer-from": "^2.2.0", "tslib": "^2.6.2" } }, "sha512-R8Rdn8Hy72KKcebgLiv8jQcQkXoLMOGGv5uI1/k0l+snqkOzQ1R0ChUBCxWMlBsFMekWjq0wRudIweFs7sKT5A=="],
+
+    "@aws-sdk/core/@smithy/property-provider": ["@smithy/property-provider@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-8iLN1XSE1rl4MuxvQ+5OSk/Zb5El7NJZ1td6Tn+8dQQHIjp59Lwl6bd0+nzw6SKm2wSSriH2v/I9LPzUic7EOg=="],
+
+    "@aws-sdk/credential-provider-env/@smithy/property-provider": ["@smithy/property-provider@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-8iLN1XSE1rl4MuxvQ+5OSk/Zb5El7NJZ1td6Tn+8dQQHIjp59Lwl6bd0+nzw6SKm2wSSriH2v/I9LPzUic7EOg=="],
+
+    "@aws-sdk/credential-provider-http/@smithy/property-provider": ["@smithy/property-provider@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-8iLN1XSE1rl4MuxvQ+5OSk/Zb5El7NJZ1td6Tn+8dQQHIjp59Lwl6bd0+nzw6SKm2wSSriH2v/I9LPzUic7EOg=="],
+
+    "@aws-sdk/credential-provider-ini/@smithy/property-provider": ["@smithy/property-provider@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-8iLN1XSE1rl4MuxvQ+5OSk/Zb5El7NJZ1td6Tn+8dQQHIjp59Lwl6bd0+nzw6SKm2wSSriH2v/I9LPzUic7EOg=="],
+
+    "@aws-sdk/credential-provider-node/@smithy/property-provider": ["@smithy/property-provider@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-8iLN1XSE1rl4MuxvQ+5OSk/Zb5El7NJZ1td6Tn+8dQQHIjp59Lwl6bd0+nzw6SKm2wSSriH2v/I9LPzUic7EOg=="],
+
+    "@aws-sdk/credential-provider-process/@smithy/property-provider": ["@smithy/property-provider@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-8iLN1XSE1rl4MuxvQ+5OSk/Zb5El7NJZ1td6Tn+8dQQHIjp59Lwl6bd0+nzw6SKm2wSSriH2v/I9LPzUic7EOg=="],
+
+    "@aws-sdk/credential-provider-sso/@smithy/property-provider": ["@smithy/property-provider@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-8iLN1XSE1rl4MuxvQ+5OSk/Zb5El7NJZ1td6Tn+8dQQHIjp59Lwl6bd0+nzw6SKm2wSSriH2v/I9LPzUic7EOg=="],
+
+    "@aws-sdk/credential-provider-web-identity/@smithy/property-provider": ["@smithy/property-provider@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-8iLN1XSE1rl4MuxvQ+5OSk/Zb5El7NJZ1td6Tn+8dQQHIjp59Lwl6bd0+nzw6SKm2wSSriH2v/I9LPzUic7EOg=="],
+
+    "@aws-sdk/token-providers/@smithy/property-provider": ["@smithy/property-provider@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-8iLN1XSE1rl4MuxvQ+5OSk/Zb5El7NJZ1td6Tn+8dQQHIjp59Lwl6bd0+nzw6SKm2wSSriH2v/I9LPzUic7EOg=="],
+
+    "@smithy/credential-provider-imds/@smithy/property-provider": ["@smithy/property-provider@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-8iLN1XSE1rl4MuxvQ+5OSk/Zb5El7NJZ1td6Tn+8dQQHIjp59Lwl6bd0+nzw6SKm2wSSriH2v/I9LPzUic7EOg=="],
+
+    "@smithy/node-config-provider/@smithy/property-provider": ["@smithy/property-provider@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-8iLN1XSE1rl4MuxvQ+5OSk/Zb5El7NJZ1td6Tn+8dQQHIjp59Lwl6bd0+nzw6SKm2wSSriH2v/I9LPzUic7EOg=="],
+
+    "@smithy/property-provider/@smithy/types": ["@smithy/types@1.2.0", "", { "dependencies": { "tslib": "^2.5.0" } }, "sha512-z1r00TvBqF3dh4aHhya7nz1HhvCg4TRmw51fjMrh5do3h+ngSstt/yKlNbHeb9QxJmFbmN8KEVSWgb1bRvfEoA=="],
+
+    "@smithy/util-defaults-mode-browser/@smithy/property-provider": ["@smithy/property-provider@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-8iLN1XSE1rl4MuxvQ+5OSk/Zb5El7NJZ1td6Tn+8dQQHIjp59Lwl6bd0+nzw6SKm2wSSriH2v/I9LPzUic7EOg=="],
+
+    "@smithy/util-defaults-mode-node/@smithy/property-provider": ["@smithy/property-provider@4.2.5", "", { "dependencies": { "@smithy/types": "^4.9.0", "tslib": "^2.6.2" } }, "sha512-8iLN1XSE1rl4MuxvQ+5OSk/Zb5El7NJZ1td6Tn+8dQQHIjp59Lwl6bd0+nzw6SKm2wSSriH2v/I9LPzUic7EOg=="],
+
+    "@aws-crypto/sha1-browser/@smithy/util-utf8/@smithy/util-buffer-from": ["@smithy/util-buffer-from@2.2.0", "", { "dependencies": { "@smithy/is-array-buffer": "^2.2.0", "tslib": "^2.6.2" } }, "sha512-IJdWBbTcMQ6DA0gdNhh/BwrLkDR+ADW5Kr1aZmd4k3DIF6ezMV4R2NIAmT08wQJ3yUK82thHWmC/TnK/wpMMIA=="],
+
+    "@aws-crypto/sha256-browser/@smithy/util-utf8/@smithy/util-buffer-from": ["@smithy/util-buffer-from@2.2.0", "", { "dependencies": { "@smithy/is-array-buffer": "^2.2.0", "tslib": "^2.6.2" } }, "sha512-IJdWBbTcMQ6DA0gdNhh/BwrLkDR+ADW5Kr1aZmd4k3DIF6ezMV4R2NIAmT08wQJ3yUK82thHWmC/TnK/wpMMIA=="],
+
+    "@aws-crypto/util/@smithy/util-utf8/@smithy/util-buffer-from": ["@smithy/util-buffer-from@2.2.0", "", { "dependencies": { "@smithy/is-array-buffer": "^2.2.0", "tslib": "^2.6.2" } }, "sha512-IJdWBbTcMQ6DA0gdNhh/BwrLkDR+ADW5Kr1aZmd4k3DIF6ezMV4R2NIAmT08wQJ3yUK82thHWmC/TnK/wpMMIA=="],
+
+    "@aws-crypto/sha1-browser/@smithy/util-utf8/@smithy/util-buffer-from/@smithy/is-array-buffer": ["@smithy/is-array-buffer@2.2.0", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-GGP3O9QFD24uGeAXYUjwSTXARoqpZykHadOmA8G5vfJPK0/DC67qa//0qvqrJzL1xc8WQWX7/yc7fwudjPHPhA=="],
+
+    "@aws-crypto/sha256-browser/@smithy/util-utf8/@smithy/util-buffer-from/@smithy/is-array-buffer": ["@smithy/is-array-buffer@2.2.0", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-GGP3O9QFD24uGeAXYUjwSTXARoqpZykHadOmA8G5vfJPK0/DC67qa//0qvqrJzL1xc8WQWX7/yc7fwudjPHPhA=="],
+
+    "@aws-crypto/util/@smithy/util-utf8/@smithy/util-buffer-from/@smithy/is-array-buffer": ["@smithy/is-array-buffer@2.2.0", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-GGP3O9QFD24uGeAXYUjwSTXARoqpZykHadOmA8G5vfJPK0/DC67qa//0qvqrJzL1xc8WQWX7/yc7fwudjPHPhA=="],
+  }
+}

scripts/build-cache/have-access.ts

@@ -0,0 +1,82 @@
+/**
+ * Test whether the current user has access to the Bun build-cache.
+ *
+ * Exits with code 0 if access is available, or 1 otherwise.
+ */
+import { HeadBucketCommand, S3Client } from "@aws-sdk/client-s3";
+import { CredentialsProviderError } from "@aws-sdk/property-provider";
+
+class CacheConfig {
+  #bucket: string;
+  #region: string;
+
+  get bucket(): string {
+    return this.#bucket;
+  }
+
+  get region(): string {
+    return this.#region;
+  }
+
+  static fromArgv(): CacheConfig {
+    const cacheConfig = new CacheConfig();
+
+    const exitWithHelp = (reason: string) => {
+      console.error(`Error: ${reason}\n`);
+      console.error("Usage: have-access --bucket <bucket-name> --region <region>");
+      process.exit(1);
+    };
+
+    for (let i = 2; i < process.argv.length; i++) {
+      switch (process.argv[i]) {
+        case "-b":
+        case "--bucket":
+          cacheConfig.#bucket = process.argv[++i];
+          break;
+        case "-r":
+        case "--region":
+          cacheConfig.#region = process.argv[++i];
+          break;
+        default:
+          exitWithHelp(`Unknown argument: ${process.argv[i]}`);
+      }
+    }
+
+    if (!cacheConfig.#bucket) {
+      exitWithHelp("Missing required argument: --bucket");
+    }
+
+    if (!cacheConfig.#region) {
+      exitWithHelp("Missing required argument: --region");
+    }
+
+    return cacheConfig;
+  }
+}
+
+/**
+ * Test whether the current user has access to the Bun build-cache.
+ */
+async function currentUserHasAccess(cacheConfig: CacheConfig): Promise<boolean> {
+  const s3Client = new S3Client({ region: cacheConfig.region });
+
+  try {
+    await s3Client.send(new HeadBucketCommand({ Bucket: cacheConfig.bucket }));
+    return true;
+  } catch (error) {
+    if (
+      error.name === "NotFound" ||
+      error.$metadata?.httpStatusCode === 404 ||
+      error.name === "Forbidden" ||
+      error.$metadata?.httpStatusCode === 403 ||
+      error instanceof CredentialsProviderError
+    ) {
+      return false;
+    }
+
+    throw error;
+  }
+}
+
+const ok = await currentUserHasAccess(CacheConfig.fromArgv());
+process.exit(ok ? 0 : 1);

scripts/build-cache/package.json

@@ -0,0 +1,6 @@
+{
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.928.0",
+    "@aws-sdk/property-provider": "^3.374.0"
+  }
+}

scripts/build.mjs

@@ -108,8 +108,8 @@ async function build(args) {
   await startGroup("CMake Build", () => spawn("cmake", buildArgs, { env }));
 
   if (ciCppBuild) {
-    await startGroup("ccache stats", () => {
-      spawn("ccache", ["--show-stats"], { env });
+    await startGroup("sccache stats", () => {
+      spawn("sccache", ["--show-stats"], { env });
     });
   }
 

scripts/create-link-metadata.mjs

@@ -1,52 +0,0 @@
-#!/usr/bin/env bun
-/**
- * Creates link-metadata.json with link command and build metadata
- *
- * Usage: bun scripts/create-link-metadata.mjs <build-path> <bun-target>
- */
-
-import { $ } from "bun";
-import { dirname, join } from "path";
-
-const [buildPath, bunTarget] = process.argv.slice(2);
-
-if (!buildPath || !bunTarget) {
-  console.error("Usage: bun scripts/create-link-metadata.mjs <build-path> <bun-target>");
-  process.exit(1);
-}
-
-// Get the repo root (parent of scripts directory)
-const repoRoot = dirname(import.meta.dir);
-
-// Extract link command using ninja
-console.log("Extracting link command...");
-const linkCommandResult = await $`ninja -C ${buildPath} -t commands ${bunTarget}`.quiet();
-const linkCommand = linkCommandResult.stdout.toString().trim();
-
-// Read linker-related files from src/
-console.log("Reading linker files...");
-const linkerLds = await Bun.file(join(repoRoot, "src", "linker.lds")).text();
-const symbolsDyn = await Bun.file(join(repoRoot, "src", "symbols.dyn")).text();
-const symbolsTxt = await Bun.file(join(repoRoot, "src", "symbols.txt")).text();
-const symbolsDef = await Bun.file(join(repoRoot, "src", "symbols.def")).text();
-
-// Create metadata JSON with link command included
-const metadata = {
-  bun_version: process.env.BUN_VERSION || "",
-  webkit_url: process.env.WEBKIT_DOWNLOAD_URL || "",
-  webkit_version: process.env.WEBKIT_VERSION || "",
-  zig_commit: process.env.ZIG_COMMIT || "",
-  target: bunTarget,
-  timestamp: new Date().toISOString(),
-  link_command: linkCommand,
-  linker_lds: linkerLds,
-  symbols_dyn: symbolsDyn,
-  symbols_txt: symbolsTxt,
-  symbols_def: symbolsDef,
-};
-
-const metadataPath = join(buildPath, "link-metadata.json");
-await Bun.write(metadataPath, JSON.stringify(metadata, null, 2));
-console.log(`Written to ${metadataPath}`);
-
-console.log("Done");

scripts/machine.mjs

@@ -387,6 +387,9 @@ const aws = {
         owner = "amazon";
         name = `Windows_Server-${release || "*"}-English-Full-Base-*`;
       }
+    } else if (os === "freebsd") {
+      owner = "782442783595"; // upstream member of FreeBSD team, likely Colin Percival
+      name = `FreeBSD ${release}-STABLE-${{ "aarch64": "arm64", "x64": "amd64" }[arch] ?? "amd64"}-* UEFI-PREFERRED cloud-init UFS`;
     }
 
     if (!name) {
@@ -673,6 +676,10 @@ function getCloudInit(cloudInit) {
     case "windows":
       // handled above
       break;
+    case "freebsd":
+      sftpPath = "/usr/libexec/openssh/sftp-server";
+      shell = "/bin/csh";
+      break;
     default:
       throw new Error(`Unsupported os: ${cloudInit["os"]}`);
   }
@@ -1064,7 +1071,7 @@ function getCloud(name) {
 }
 
 /**
- * @typedef {"linux" | "darwin" | "windows"} Os
+ * @typedef {"linux" | "darwin" | "windows" | "freebsd"} Os
  * @typedef {"aarch64" | "x64"} Arch
  * @typedef {"macos" | "windowsserver" | "debian" | "ubuntu" | "alpine" | "amazonlinux"} Distro
  */

scripts/runner.node.mjs

@@ -1128,7 +1128,6 @@ async function spawnBun(execPath, { args, cwd, timeout, env, stdout, stderr }) {
     ...process.env,
     PATH: path,
     TMPDIR: tmpdirPath,
-    BUN_TMPDIR: tmpdirPath,
     USER: username,
     HOME: homedir,
     SHELL: shellPath,

scripts/utils.mjs

@@ -1538,7 +1538,7 @@ export function parseNumber(value) {
 
 /**
  * @param {string} string
- * @returns {"darwin" | "linux" | "windows"}
+ * @returns {"darwin" | "linux" | "windows" | "freebsd"}
  */
 export function parseOs(string) {
   if (/darwin|apple|mac/i.test(string)) {
@@ -1550,6 +1550,9 @@ export function parseOs(string) {
   if (/win/i.test(string)) {
     return "windows";
   }
+  if (/freebsd/i.test(string)) {
+    return "freebsd";
+  }
   throw new Error(`Unsupported operating system: ${string}`);
 }
 
@@ -1912,6 +1915,10 @@ export function getUsernameForDistro(distro) {
   if (/amazon|amzn|al\d+|rhel/i.test(distro)) {
     return "ec2-user";
   }
+  if (/freebsd/i.test(distro)) {
+    return "root";
+  }
+
   throw new Error(`Unsupported distro: ${distro}`);
 }
 
@@ -2979,6 +2986,7 @@ const emojiMap = {
   gear: ["⚙️", "gear"],
   clipboard: ["📋", "clipboard"],
   rocket: ["🚀", "rocket"],
+  freebsd: ["😈", "freebsd"],
   openbsd: ["🐡", "openbsd"],
   netbsd: ["🚩", "netbsd"],
 };

shell.nix

@@ -17,7 +17,7 @@ pkgs.mkShell rec {
     cargo
     go
     python3
-    ccache
+    sccache
     pkg-config
     gnumake
     libtool

src/CLAUDE.md

@@ -8,5 +8,4 @@ Syntax reminders:
 Conventions:
 
 - Prefer `@import` at the **bottom** of the file, but the auto formatter will move them so you don't need to worry about it.
-- **Never** use `@import()` inline inside of functions. **Always** put them at the bottom of the file or containing struct. Imports in Zig are free of side-effects, so there's no such thing as a "dynamic" import.
 - You must be patient with the build.

src/OutputFile.zig

@@ -74,7 +74,7 @@ pub const FileOperation = struct {
 
     pub fn getPathname(file: *const FileOperation) string {
         if (file.is_tmpdir) {
-            return resolve_path.joinAbs(Fs.FileSystem.RealFS.tmpdirPath(), .auto, file.pathname);
+            return resolve_path.joinAbs(@TypeOf(Fs.FileSystem.instance.fs).tmpdir_path, .auto, file.pathname);
         } else {
             return file.pathname;
         }

src/StandaloneModuleGraph.zig

@@ -670,7 +670,7 @@ pub const StandaloneModuleGraph = struct {
                                 if (!tried_changing_abs_dir) {
                                     tried_changing_abs_dir = true;
                                     const zname_z = bun.strings.concat(bun.default_allocator, &.{
-                                        bun.fs.FileSystem.RealFS.tmpdirPath(),
+                                        bun.fs.FileSystem.instance.fs.tmpdirPath(),
                                         std.fs.path.sep_str,
                                         zname,
                                         &.{0},
@@ -1213,7 +1213,7 @@ pub const StandaloneModuleGraph = struct {
             }
         }
 
-        if (read_amount < trailer.len + @sizeOf(usize) + @sizeOf(Offsets))
+        if (read_amount < trailer.len + @sizeOf(usize) + 32)
             // definitely missing data
             return null;
 

src/allocators/LinuxMemFdAllocator.zig

@@ -132,7 +132,7 @@ pub fn create(bytes: []const u8) bun.sys.Maybe(bun.webcore.Blob.Store.Bytes) {
     const label = std.fmt.bufPrintZ(&label_buf, "memfd-num-{d}", .{memfd_counter.fetchAdd(1, .monotonic)}) catch "";
 
     // Using huge pages was slower.
-    const fd = switch (bun.sys.memfd_create(label, .non_executable)) {
+    const fd = switch (bun.sys.memfd_create(label, std.os.linux.MFD.CLOEXEC)) {
         .err => |err| return .{ .err = bun.sys.Error.fromCode(err.getErrno(), .open) },
         .result => |fd| fd,
     };

src/ast/ConvertESMExportsForHmr.zig

@@ -296,7 +296,7 @@ fn deduplicatedImport(
         // Disable this one since an older record is getting used.  It isn't
         // practical to delete this import record entry since an import or
         // require expression can exist.
-        ir.flags.is_unused = true;
+        ir.is_unused = true;
 
         const stmt = ctx.stmts.items[gop.value_ptr.stmt_index].data.s_import;
         if (items.len > 0) {

src/ast/Expr.zig

@@ -617,7 +617,7 @@ pub fn joinAllWithCommaCallback(all: []Expr, comptime Context: type, ctx: Contex
             return callback(ctx, all[0]);
         },
         2 => {
-            const result = Expr.joinWithComma(
+            return Expr.joinWithComma(
                 callback(ctx, all[0]) orelse Expr{
                     .data = .{ .e_missing = .{} },
                     .loc = all[0].loc,
@@ -628,10 +628,6 @@ pub fn joinAllWithCommaCallback(all: []Expr, comptime Context: type, ctx: Contex
                 },
                 allocator,
             );
-            if (result.isMissing()) {
-                return null;
-            }
-            return result;
         },
         else => {
             var i: usize = 1;
@@ -647,9 +643,6 @@ pub fn joinAllWithCommaCallback(all: []Expr, comptime Context: type, ctx: Contex
                 }, allocator);
             }
 
-            if (expr.isMissing()) {
-                return null;
-            }
             return expr;
         },
     }

src/ast/ImportScanner.zig

@@ -25,7 +25,7 @@ pub fn scan(
                 const record: *ImportRecord = &p.import_records.items[st.import_record_index];
 
                 if (record.path.isMacro()) {
-                    record.flags.is_unused = true;
+                    record.is_unused = true;
                     record.path.is_disabled = true;
                     continue;
                 }
@@ -190,8 +190,8 @@ pub fn scan(
                     {
                         // internal imports are presumed to be always used
                         // require statements cannot be stripped
-                        if (!record.flags.is_internal and !record.flags.was_originally_require) {
-                            record.flags.is_unused = true;
+                        if (!record.is_internal and !record.was_originally_require) {
+                            record.is_unused = true;
                             continue;
                         }
                     }
@@ -204,7 +204,7 @@ pub fn scan(
                     st.star_name_loc = null;
                 }
 
-                record.flags.contains_default_alias = record.flags.contains_default_alias or st.default_name != null;
+                record.contains_default_alias = record.contains_default_alias or st.default_name != null;
 
                 const existing_items: ImportItemForNamespaceMap = p.import_items_for_namespace.get(namespace_ref) orelse
                     ImportItemForNamespaceMap.init(allocator);
@@ -265,7 +265,7 @@ pub fn scan(
                     ) catch |err| bun.handleOom(err);
 
                     if (st.star_name_loc) |loc| {
-                        record.flags.contains_import_star = true;
+                        record.contains_import_star = true;
                         p.named_imports.putAssumeCapacity(
                             namespace_ref,
                             js_ast.NamedImport{
@@ -279,7 +279,7 @@ pub fn scan(
                     }
 
                     if (st.default_name) |default| {
-                        record.flags.contains_default_alias = true;
+                        record.contains_default_alias = true;
                         p.named_imports.putAssumeCapacity(
                             default.ref.?,
                             .{
@@ -313,7 +313,7 @@ pub fn scan(
                     // We do not know at this stage whether or not the import statement is bundled
                     // This keeps track of the `namespace_alias` incase, at printing time, we determine that we should print it with the namespace
                     for (st.items) |item| {
-                        record.flags.contains_default_alias = record.flags.contains_default_alias or strings.eqlComptime(item.alias, "default");
+                        record.contains_default_alias = record.contains_default_alias or strings.eqlComptime(item.alias, "default");
 
                         const name: LocRef = item.name;
                         const name_ref = name.ref.?;
@@ -327,7 +327,7 @@ pub fn scan(
 
                         // Make sure the printer prints this as a property access
                         var symbol: *Symbol = &p.symbols.items[name_ref.innerIndex()];
-                        if (record.flags.contains_import_star or st.star_name_loc != null)
+                        if (record.contains_import_star or st.star_name_loc != null)
                             symbol.namespace_alias = G.NamespaceAlias{
                                 .namespace_ref = namespace_ref,
                                 .alias = item.alias,
@@ -336,7 +336,7 @@ pub fn scan(
                             };
                     }
 
-                    if (record.flags.was_originally_require) {
+                    if (record.was_originally_require) {
                         var symbol = &p.symbols.items[namespace_ref.innerIndex()];
                         symbol.namespace_alias = G.NamespaceAlias{
                             .namespace_ref = namespace_ref,
@@ -349,12 +349,12 @@ pub fn scan(
 
                 try p.import_records_for_current_part.append(allocator, st.import_record_index);
 
-                record.flags.contains_import_star = record.flags.contains_import_star or st.star_name_loc != null;
-                record.flags.contains_default_alias = record.flags.contains_default_alias or st.default_name != null;
+                record.contains_import_star = record.contains_import_star or st.star_name_loc != null;
+                record.contains_default_alias = record.contains_default_alias or st.default_name != null;
 
                 for (st.items) |*item| {
-                    record.flags.contains_default_alias = record.flags.contains_default_alias or strings.eqlComptime(item.alias, "default");
-                    record.flags.contains_es_module_alias = record.flags.contains_es_module_alias or strings.eqlComptime(item.alias, "__esModule");
+                    record.contains_default_alias = record.contains_default_alias or strings.eqlComptime(item.alias, "default");
+                    record.contains_es_module_alias = record.contains_es_module_alias or strings.eqlComptime(item.alias, "__esModule");
                 }
             },
 
@@ -456,7 +456,7 @@ pub fn scan(
                     });
                     try p.recordExport(alias.loc, alias.original_name, st.namespace_ref);
                     var record = &p.import_records.items[st.import_record_index];
-                    record.flags.contains_import_star = true;
+                    record.contains_import_star = true;
                 } else {
                     // "export * from 'path'"
                     try p.export_star_import_records.append(allocator, st.import_record_index);
@@ -482,9 +482,9 @@ pub fn scan(
 
                     var record = &p.import_records.items[st.import_record_index];
                     if (strings.eqlComptime(item.original_name, "default")) {
-                        record.flags.contains_default_alias = true;
+                        record.contains_default_alias = true;
                     } else if (strings.eqlComptime(item.original_name, "__esModule")) {
-                        record.flags.contains_es_module_alias = true;
+                        record.contains_es_module_alias = true;
                     }
                 }
             },

src/ast/Macro.zig

@@ -480,7 +480,7 @@ pub const Runner = struct {
                     this.macro.vm.waitForPromise(promise);
 
                     const promise_result = promise.result(this.macro.vm.jsc_vm);
-                    const rejected = promise.status() == .rejected;
+                    const rejected = promise.status(this.macro.vm.jsc_vm) == .rejected;
 
                     if (promise_result.isUndefined() and this.is_top_level) {
                         this.is_top_level = false;

src/ast/P.zig

@@ -518,7 +518,7 @@ pub fn NewParser_(
                     p.import_records.items[import_record_index].tag = tag;
                 }
 
-                p.import_records.items[import_record_index].flags.handles_import_errors = (state.is_await_target and p.fn_or_arrow_data_visit.try_body_count != 0) or state.is_then_catch_target;
+                p.import_records.items[import_record_index].handles_import_errors = (state.is_await_target and p.fn_or_arrow_data_visit.try_body_count != 0) or state.is_then_catch_target;
                 p.import_records_for_current_part.append(p.allocator, import_record_index) catch unreachable;
 
                 return p.newExpr(E.Import{
@@ -573,7 +573,7 @@ pub fn NewParser_(
             }
 
             const import_record_index = p.addImportRecord(.require_resolve, arg.loc, arg.data.e_string.string(p.allocator) catch unreachable);
-            p.import_records.items[import_record_index].flags.handles_import_errors = p.fn_or_arrow_data_visit.try_body_count != 0;
+            p.import_records.items[import_record_index].handles_import_errors = p.fn_or_arrow_data_visit.try_body_count != 0;
             p.import_records_for_current_part.append(p.allocator, import_record_index) catch unreachable;
 
             return p.newExpr(
@@ -625,7 +625,7 @@ pub fn NewParser_(
 
                     if (should_unwrap_require) {
                         const import_record_index = p.addImportRecordByRangeAndPath(.stmt, p.source.rangeOfString(arg.loc), path);
-                        p.import_records.items[import_record_index].flags.handles_import_errors = handles_import_errors;
+                        p.import_records.items[import_record_index].handles_import_errors = handles_import_errors;
 
                         // Note that this symbol may be completely removed later.
                         var path_name = fs.PathName.init(path.text);
@@ -658,7 +658,7 @@ pub fn NewParser_(
                     }
 
                     const import_record_index = p.addImportRecordByRangeAndPath(.require, p.source.rangeOfString(arg.loc), path);
-                    p.import_records.items[import_record_index].flags.handles_import_errors = handles_import_errors;
+                    p.import_records.items[import_record_index].handles_import_errors = handles_import_errors;
                     p.import_records_for_current_part.append(p.allocator, import_record_index) catch unreachable;
 
                     return p.newExpr(E.RequireString{ .import_record_index = import_record_index }, arg.loc);
@@ -1332,7 +1332,7 @@ pub fn NewParser_(
             var import_record: *ImportRecord = &p.import_records.items[import_record_i];
             if (comptime is_internal)
                 import_record.path.namespace = "runtime";
-            import_record.flags.is_internal = is_internal;
+            import_record.is_internal = is_internal;
             const import_path_identifier = try import_record.path.name.nonUniqueNameString(allocator);
             var namespace_identifier = try allocator.alloc(u8, import_path_identifier.len + prefix.len);
             const clause_items = try allocator.alloc(js_ast.ClauseItem, imports.len);
@@ -2628,7 +2628,7 @@ pub fn NewParser_(
             if (is_macro) {
                 const id = p.addImportRecord(.stmt, path.loc, path.text);
                 p.import_records.items[id].path.namespace = js_ast.Macro.namespace;
-                p.import_records.items[id].flags.is_unused = true;
+                p.import_records.items[id].is_unused = true;
 
                 if (stmt.default_name) |name_loc| {
                     const name = p.loadNameFromRef(name_loc.ref.?);
@@ -2694,7 +2694,7 @@ pub fn NewParser_(
                 null;
 
             stmt.import_record_index = p.addImportRecord(.stmt, path.loc, path.text);
-            p.import_records.items[stmt.import_record_index].flags.was_originally_bare_import = was_originally_bare_import;
+            p.import_records.items[stmt.import_record_index].was_originally_bare_import = was_originally_bare_import;
 
             if (stmt.star_name_loc) |star| {
                 const name = p.loadNameFromRef(stmt.namespace_ref);
@@ -2755,9 +2755,9 @@ pub fn NewParser_(
                         });
 
                         p.import_records.items[new_import_id].path.namespace = js_ast.Macro.namespace;
-                        p.import_records.items[new_import_id].flags.is_unused = true;
+                        p.import_records.items[new_import_id].is_unused = true;
                         if (comptime only_scan_imports_and_do_not_visit) {
-                            p.import_records.items[new_import_id].flags.is_internal = true;
+                            p.import_records.items[new_import_id].is_internal = true;
                             p.import_records.items[new_import_id].path.is_disabled = true;
                         }
                         stmt.default_name = null;
@@ -2816,9 +2816,9 @@ pub fn NewParser_(
                         });
 
                         p.import_records.items[new_import_id].path.namespace = js_ast.Macro.namespace;
-                        p.import_records.items[new_import_id].flags.is_unused = true;
+                        p.import_records.items[new_import_id].is_unused = true;
                         if (comptime only_scan_imports_and_do_not_visit) {
-                            p.import_records.items[new_import_id].flags.is_internal = true;
+                            p.import_records.items[new_import_id].is_internal = true;
                             p.import_records.items[new_import_id].path.is_disabled = true;
                         }
                         remap_count += 1;
@@ -2844,11 +2844,11 @@ pub fn NewParser_(
 
             if (remap_count > 0 and stmt.items.len == 0 and stmt.default_name == null) {
                 p.import_records.items[stmt.import_record_index].path.namespace = js_ast.Macro.namespace;
-                p.import_records.items[stmt.import_record_index].flags.is_unused = true;
+                p.import_records.items[stmt.import_record_index].is_unused = true;
 
                 if (comptime only_scan_imports_and_do_not_visit) {
                     p.import_records.items[stmt.import_record_index].path.is_disabled = true;
-                    p.import_records.items[stmt.import_record_index].flags.is_internal = true;
+                    p.import_records.items[stmt.import_record_index].is_internal = true;
                 }
 
                 return p.s(S.Empty{}, loc);

src/ast/Parser.zig

@@ -134,17 +134,17 @@ pub const Parser = struct {
                 // - import 'foo';
                 // - import("foo")
                 // - require("foo")
-                import_record.flags.is_unused = import_record.flags.is_unused or
+                import_record.is_unused = import_record.is_unused or
                     (import_record.kind == .stmt and
-                        !import_record.flags.was_originally_bare_import and
-                        !import_record.flags.calls_runtime_re_export_fn);
+                        !import_record.was_originally_bare_import and
+                        !import_record.calls_runtime_re_export_fn);
             }
 
             var iter = scan_pass.used_symbols.iterator();
             while (iter.next()) |entry| {
                 const val = entry.value_ptr;
                 if (val.used) {
-                    scan_pass.import_records.items[val.import_record_index].flags.is_unused = false;
+                    scan_pass.import_records.items[val.import_record_index].is_unused = false;
                 }
             }
         }
@@ -1023,7 +1023,7 @@ pub const Parser = struct {
 
                 const import_record: ?*const ImportRecord = brk: {
                     for (p.import_records.items) |*import_record| {
-                        if (import_record.flags.is_internal or import_record.flags.is_unused) continue;
+                        if (import_record.is_internal or import_record.is_unused) continue;
                         if (import_record.kind == .stmt) break :brk import_record;
                     }
 
@@ -1094,7 +1094,7 @@ pub const Parser = struct {
                     // If they use an import statement, we say it's ESM because that's not allowed in CommonJS files.
                     const uses_any_import_statements = brk: {
                         for (p.import_records.items) |*import_record| {
-                            if (import_record.flags.is_internal or import_record.flags.is_unused) continue;
+                            if (import_record.is_internal or import_record.is_unused) continue;
                             if (import_record.kind == .stmt) break :brk true;
                         }
 
@@ -1494,7 +1494,7 @@ pub const Parser = struct {
 
         var state: PragmaState = .{};
 
-        while (cursor < end) : (cursor += 1) {
+        while (cursor < self.lexer.end) : (cursor += 1) {
             switch (contents[cursor]) {
                 '\n' => break,
                 '@' => {

src/ast/SideEffects.zig

@@ -315,10 +315,6 @@ pub const SideEffects = enum(u1) {
                     );
                 }
 
-                if (result.isMissing()) {
-                    return null;
-                }
-
                 return result;
             },
             .e_array => {

src/ast/parseStmt.zig

@@ -327,7 +327,7 @@ pub fn ParseStmt(
 
                     if (comptime track_symbol_usage_during_parse_pass) {
                         // In the scan pass, we need _some_ way of knowing *not* to mark as unused
-                        p.import_records.items[import_record_index].flags.calls_runtime_re_export_fn = true;
+                        p.import_records.items[import_record_index].calls_runtime_re_export_fn = true;
                     }
 
                     try p.lexer.expectOrInsertSemicolon();
@@ -381,7 +381,7 @@ pub fn ParseStmt(
 
                         if (comptime track_symbol_usage_during_parse_pass) {
                             // In the scan pass, we need _some_ way of knowing *not* to mark as unused
-                            p.import_records.items[import_record_index].flags.calls_runtime_re_export_fn = true;
+                            p.import_records.items[import_record_index].calls_runtime_re_export_fn = true;
                         }
                         p.current_scope.is_after_const_local_prefix = true;
                         p.has_es_module_syntax = true;

src/bake/BakeGlobalObject.cpp

@@ -36,7 +36,7 @@ bakeModuleLoaderImportModule(JSC::JSGlobalObject* global,
 
         if (!keyString) {
             auto promise = JSC::JSInternalPromise::create(vm, global->internalPromiseStructure());
-            promise->reject(vm, global, JSC::createError(global, "import() requires a string"_s));
+            promise->reject(global, JSC::createError(global, "import() requires a string"_s));
             return promise;
         }
 
@@ -94,7 +94,8 @@ static JSC::JSInternalPromise* rejectedInternalPromise(JSC::JSGlobalObject* glob
 {
     auto& vm = JSC::getVM(globalObject);
     JSC::JSInternalPromise* promise = JSC::JSInternalPromise::create(vm, globalObject->internalPromiseStructure());
-    promise->rejectAsHandled(vm, globalObject, value);
+    promise->internalField(JSC::JSPromise::Field::ReactionsOrResult).set(vm, promise, value);
+    promise->internalField(JSC::JSPromise::Field::Flags).set(vm, promise, JSC::jsNumber(promise->internalField(JSC::JSPromise::Field::Flags).get().asUInt32AsAnyInt() | JSC::JSPromise::isFirstResolvingFunctionCalledFlag | static_cast<unsigned>(JSC::JSPromise::Status::Rejected)));
     return promise;
 }
 
@@ -102,7 +103,8 @@ static JSC::JSInternalPromise* resolvedInternalPromise(JSC::JSGlobalObject* glob
 {
     auto& vm = JSC::getVM(globalObject);
     JSC::JSInternalPromise* promise = JSC::JSInternalPromise::create(vm, globalObject->internalPromiseStructure());
-    promise->fulfill(vm, globalObject, value);
+    promise->internalField(JSC::JSPromise::Field::ReactionsOrResult).set(vm, promise, value);
+    promise->internalField(JSC::JSPromise::Field::Flags).set(vm, promise, JSC::jsNumber(promise->internalField(JSC::JSPromise::Field::Flags).get().asUInt32AsAnyInt() | JSC::JSPromise::isFirstResolvingFunctionCalledFlag | static_cast<unsigned>(JSC::JSPromise::Status::Fulfilled)));
     return promise;
 }
 
@@ -139,10 +141,10 @@ JSC::JSInternalPromise* bakeModuleLoaderFetch(JSC::JSGlobalObject* globalObject,
                     globalObject,
                     source.toWTFString(),
                     origin,
-                    WTF::move(moduleKey),
+                    WTFMove(moduleKey),
                     WTF::TextPosition(),
                     JSC::SourceProviderSourceType::Module));
-                return resolvedInternalPromise(globalObject, JSC::JSSourceCode::create(vm, WTF::move(sourceCode)));
+                return resolvedInternalPromise(globalObject, JSC::JSSourceCode::create(vm, WTFMove(sourceCode)));
             }
 
             // We unconditionally prefix the key with "bake:" inside

src/bake/BakeSourceProvider.cpp

@@ -33,7 +33,7 @@ extern "C" JSC::EncodedJSValue BakeLoadInitialServerCode(JSC::JSGlobalObject* gl
     global,
     source.toWTFString(),
     origin,
-    WTF::move(string),
+    WTFMove(string),
     WTF::TextPosition(),
     JSC::SourceProviderSourceType::Program
   ));
@@ -67,7 +67,7 @@ extern "C" JSC::EncodedJSValue BakeLoadServerHmrPatch(GlobalObject* global, BunS
     global,
     source.toWTFString(),
     origin,
-    WTF::move(string),
+    WTFMove(string),
     WTF::TextPosition(),
     JSC::SourceProviderSourceType::Program
   ));
@@ -93,7 +93,7 @@ extern "C" JSC::EncodedJSValue BakeLoadServerHmrPatchWithSourceMap(GlobalObject*
     sourceMapJSONPtr,
     sourceMapJSONLength,
     origin,
-    WTF::move(string),
+    WTFMove(string),
     WTF::TextPosition(),
     JSC::SourceProviderSourceType::Program
   );
@@ -159,7 +159,7 @@ extern "C" JSC::EncodedJSValue BakeRegisterProductionChunk(JSC::JSGlobalObject*
     global,
     source.toWTFString(),
     origin,
-    WTF::move(string),
+    WTFMove(string),
     WTF::TextPosition(),
     JSC::SourceProviderSourceType::Module
   ));

src/bake/BakeSourceProvider.h

@@ -20,7 +20,7 @@ public:
         const TextPosition& startPosition,
         JSC::SourceProviderSourceType sourceType)
     {
-        auto provider = adoptRef(*new SourceProvider(source, sourceOrigin, WTF::move(sourceURL), startPosition, sourceType));
+        auto provider = adoptRef(*new SourceProvider(source, sourceOrigin, WTFMove(sourceURL), startPosition, sourceType));
         auto* zigGlobalObject = jsCast<Zig::GlobalObject*>(globalObject);
         auto specifier = Bun::toString(provider->sourceURL());
         Bun__addBakeSourceProviderSourceMap(zigGlobalObject->bunVM(), provider.ptr(), &specifier);
@@ -38,7 +38,7 @@ private:
               source,
               sourceOrigin,
               JSC::SourceTaintedOrigin::Untainted,
-              WTF::move(sourceURL),
+              WTFMove(sourceURL),
               startPosition,
               sourceType)
     {

src/bake/DevServer/IncrementalGraph.zig

@@ -925,7 +925,7 @@ pub fn IncrementalGraph(comptime side: bake.Side) type {
             // When an import record is duplicated, it gets marked unused.
             // This happens in `ConvertESMExportsForHmr.deduplicatedImport`
             // There is still a case where deduplication must happen.
-            if (import_record.flags.is_unused) return .stop;
+            if (import_record.is_unused) return .stop;
             if (import_record.source_index.isRuntime()) return .stop;
 
             const key = import_record.path.keyForIncrementalGraph();
@@ -1044,7 +1044,7 @@ pub fn IncrementalGraph(comptime side: bake.Side) type {
                 // When an import record is duplicated, it gets marked unused.
                 // This happens in `ConvertESMExportsForHmr.deduplicatedImport`
                 // There is still a case where deduplication must happen.
-                if (import_record.flags.is_unused) continue;
+                if (import_record.is_unused) continue;
 
                 if (!import_record.source_index.isRuntime()) try_index_record: {
                     // TODO: move this block into a function

src/bake/DevServer/WatcherAtomics.zig

@@ -132,6 +132,8 @@ pub fn watcherReleaseAndSubmitEvent(self: *Self, ev: *HotReloadEvent) void {
                 self.dbg_server_event = ev;
             }
             ev.concurrent_task = .{
+                .auto_delete = false,
+                .next = null,
                 .task = jsc.Task.init(ev),
             };
             ev.owner.vm.event_loop.enqueueTaskConcurrent(&ev.concurrent_task);

src/bake/DevServerSourceProvider.h

@@ -25,7 +25,7 @@ public:
         const TextPosition& startPosition,
         JSC::SourceProviderSourceType sourceType)
     {
-        auto provider = adoptRef(*new DevServerSourceProvider(source, sourceMapJSONPtr, sourceMapJSONLength, sourceOrigin, WTF::move(sourceURL), startPosition, sourceType));
+        auto provider = adoptRef(*new DevServerSourceProvider(source, sourceMapJSONPtr, sourceMapJSONLength, sourceOrigin, WTFMove(sourceURL), startPosition, sourceType));
         auto* zigGlobalObject = jsCast<::Zig::GlobalObject*>(globalObject);
         auto specifier = Bun::toString(provider->sourceURL());
         provider->m_globalObject = zigGlobalObject;
@@ -52,7 +52,7 @@ private:
               source,
               sourceOrigin,
               JSC::SourceTaintedOrigin::Untainted,
-              WTF::move(sourceURL),
+              WTFMove(sourceURL),
               startPosition,
               sourceType)
         , m_sourceMapJSON(sourceMapJSONPtr, sourceMapJSONLength)

src/bake/production.zig

@@ -697,7 +697,7 @@ pub fn buildWithVm(ctx: bun.cli.Command.Context, cwd: []const u8, vm: *VirtualMa
         route_param_info,
         route_style_references,
     );
-    render_promise.setHandled();
+    render_promise.setHandled(vm.jsc_vm);
     vm.waitForPromise(.{ .normal = render_promise });
     switch (render_promise.unwrap(vm.jsc_vm, .mark_handled)) {
         .pending => unreachable,

src/boringssl.zig

@@ -167,30 +167,16 @@ pub fn checkX509ServerIdentity(
                                 if (dnsNameSlice.len > 0) {
                                     if (X509.isSafeAltName(dnsNameSlice, false)) {
                                         if (dnsNameSlice[0] == '*') {
-                                            // RFC 6125 Section 6.4.3: Wildcard must match exactly one label
-                                            // Enforce "*." prefix (wildcards must be leftmost and followed by a dot)
-                                            if (dnsNameSlice.len >= 2 and dnsNameSlice[1] == '.') {
-                                                const suffix = dnsNameSlice[2..];
-                                                // Disallow "*.tld" (suffix must contain at least one dot for proper domain hierarchy)
-                                                if (std.mem.indexOfScalar(u8, suffix, '.') != null) {
-                                                    // Host must be at least "label.suffix" (suffix_len + 1 for dot + at least 1 char for label)
-                                                    if (hostname.len > suffix.len + 1) {
-                                                        const dot_index = hostname.len - suffix.len - 1;
-                                                        // The character before suffix must be a dot, and there must be no other dots
-                                                        // in the prefix (single-label wildcard only)
-                                                        if (hostname[dot_index] == '.' and std.mem.indexOfScalar(u8, hostname[0..dot_index], '.') == null) {
-                                                            const host_suffix = hostname[dot_index + 1 ..];
-                                                            // RFC 4343: DNS names are case-insensitive
-                                                            if (strings.eqlCaseInsensitiveASCII(suffix, host_suffix, true)) {
-                                                                return true;
-                                                            }
-                                                        }
-                                                    }
-                                                }
+                                            dnsNameSlice = dnsNameSlice[1..dnsNameSlice.len];
+                                            var host = hostname;
+                                            if (hostname.len > dnsNameSlice.len) {
+                                                host = hostname[hostname.len - dnsNameSlice.len .. hostname.len];
+                                            }
+                                            if (strings.eql(dnsNameSlice, host)) {
+                                                return true;
                                             }
                                         }
-                                        // RFC 4343: DNS names are case-insensitive
-                                        if (strings.eqlCaseInsensitiveASCII(dnsNameSlice, hostname, true)) {
+                                        if (strings.eql(dnsNameSlice, hostname)) {
                                             return true;
                                         }
                                     }

src/bun.js.zig

@@ -38,9 +38,6 @@ pub const Run = struct {
                 .args = ctx.args,
                 .graph = graph_ptr,
                 .is_main_thread = true,
-                .smol = ctx.runtime_options.smol,
-                .debugger = ctx.runtime_options.debugger,
-                .dns_result_order = DNSResolver.Order.fromStringOrDie(ctx.runtime_options.dns_result_order),
             }),
             .arena = arena,
             .ctx = ctx,
@@ -350,8 +347,8 @@ pub const Run = struct {
         var printed_sourcemap_warning_and_version = false;
 
         if (vm.loadEntryPoint(this.entry_path)) |promise| {
-            if (promise.status() == .rejected) {
-                const handled = vm.uncaughtException(vm.global, promise.result(), true);
+            if (promise.status(vm.global.vm()) == .rejected) {
+                const handled = vm.uncaughtException(vm.global, promise.result(vm.global.vm()), true);
                 promise.setHandled(vm.global.vm());
 
                 if (vm.hot_reload != .none or handled) {
@@ -375,7 +372,7 @@ pub const Run = struct {
                 }
             }
 
-            _ = promise.result();
+            _ = promise.result(vm.global.vm());
 
             if (vm.log.msgs.items.len > 0) {
                 dumpBuildError(vm);
@@ -445,7 +442,7 @@ pub const Run = struct {
                     const to_print = brk: {
                         const result: jsc.JSValue = vm.entry_point_result.value.get() orelse .js_undefined;
                         if (result.asAnyPromise()) |promise| {
-                            switch (promise.status()) {
+                            switch (promise.status(vm.jsc_vm)) {
                                 .pending => {
                                     result.then2(vm.global, .js_undefined, Bun__onResolveEntryPointResult, Bun__onRejectEntryPointResult) catch {}; // TODO: properly propagate exception upwards
 

src/bun.js/ConsoleObject.zig

@@ -1629,11 +1629,11 @@ pub const Formatter = struct {
                         },
 
                         .j => {
-                            // JSON.stringify the value using FastStringifier for SIMD optimization
+                            // JSON.stringify the value
                             var str = bun.String.empty;
                             defer str.deref();
 
-                            try next_value.jsonStringifyFast(global, &str);
+                            try next_value.jsonStringify(global, 0, &str);
                             this.addForNewLine(str.length());
                             writer.print("{f}", .{str});
                         },
@@ -2596,9 +2596,6 @@ pub const Formatter = struct {
                 } else if (value.as(jsc.WebCore.S3Client)) |s3client| {
                     s3client.writeFormat(ConsoleObject.Formatter, this, writer_, enable_ansi_colors) catch {};
                     return;
-                } else if (value.as(jsc.API.Archive)) |archive| {
-                    archive.writeFormat(ConsoleObject.Formatter, this, writer_, enable_ansi_colors) catch {};
-                    return;
                 } else if (value.as(bun.webcore.FetchHeaders) != null) {
                     if (try value.get(this.globalThis, "toJSON")) |toJSONFunction| {
                         this.addForNewLine("Headers ".len);
@@ -2706,7 +2703,7 @@ pub const Formatter = struct {
 
                 writer.writeAll("Promise { " ++ comptime Output.prettyFmt("<r><cyan>", enable_ansi_colors));
 
-                switch (JSPromise.status(@as(*JSPromise, @ptrCast(value.asObjectRef().?)))) {
+                switch (JSPromise.status(@as(*JSPromise, @ptrCast(value.asObjectRef().?)), this.globalThis.vm())) {
                     .pending => writer.writeAll("<pending>"),
                     .fulfilled => writer.writeAll("<resolved>"),
                     .rejected => writer.writeAll("<rejected>"),

src/bun.js/JSONLineBuffer.zig

@@ -1,135 +0,0 @@
-/// Buffer for newline-delimited data that tracks scan positions to avoid O(n²) scanning.
-/// Each byte is scanned exactly once. We track:
-/// - newline_pos: position of first known newline (if any)
-/// - scanned_pos: how far we've scanned (bytes before this have been checked)
-/// - head: offset into the buffer where unconsumed data starts (avoids copying on each consume)
-///
-/// When data arrives, we only scan the NEW bytes.
-/// When we consume a message, we just advance `head` instead of copying.
-/// Compaction only happens when head exceeds a threshold.
-pub const JSONLineBuffer = struct {
-    data: bun.ByteList = .{},
-    /// Offset into data where unconsumed content starts.
-    head: u32 = 0,
-    /// Position of a known upcoming newline relative to head, if any.
-    newline_pos: ?u32 = null,
-    /// How far we've scanned for newlines relative to head.
-    scanned_pos: u32 = 0,
-
-    /// Compact the buffer when head exceeds this threshold.
-    const compaction_threshold = 16 * 1024 * 1024; // 16 MB
-
-    /// Get the active (unconsumed) portion of the buffer.
-    fn activeSlice(self: *const @This()) []const u8 {
-        return self.data.slice()[self.head..];
-    }
-
-    /// Scan for newline in unscanned portion of the buffer.
-    fn scanForNewline(self: *@This()) void {
-        if (self.newline_pos != null) return;
-        const slice = self.activeSlice();
-        if (self.scanned_pos >= slice.len) return;
-
-        const unscanned = slice[self.scanned_pos..];
-        if (bun.strings.indexOfChar(unscanned, '\n')) |local_idx| {
-            bun.debugAssert(local_idx <= std.math.maxInt(u32));
-            const pos = self.scanned_pos +| @as(u32, @intCast(local_idx));
-            self.newline_pos = pos;
-            self.scanned_pos = pos +| 1; // Only scanned up to (and including) the newline
-        } else {
-            bun.debugAssert(slice.len <= std.math.maxInt(u32));
-            self.scanned_pos = @intCast(slice.len); // No newline, scanned everything
-        }
-    }
-
-    /// Compact the buffer by moving data to the front. Called when head exceeds threshold.
-    fn compact(self: *@This()) void {
-        if (self.head == 0) return;
-        const slice = self.activeSlice();
-        bun.copy(u8, self.data.ptr[0..slice.len], slice);
-        bun.debugAssert(slice.len <= std.math.maxInt(u32));
-        self.data.len = @intCast(slice.len);
-        self.head = 0;
-    }
-
-    /// Append bytes to the buffer, scanning only new data for newline.
-    pub fn append(self: *@This(), bytes: []const u8) void {
-        _ = bun.handleOom(self.data.write(bun.default_allocator, bytes));
-        self.scanForNewline();
-    }
-
-    /// Returns the next complete message (up to and including newline) if available.
-    pub fn next(self: *const @This()) ?struct { data: []const u8, newline_pos: u32 } {
-        const pos = self.newline_pos orelse return null;
-        return .{
-            .data = self.activeSlice()[0 .. pos + 1],
-            .newline_pos = pos,
-        };
-    }
-
-    /// Consume bytes from the front of the buffer after processing a message.
-    /// Just advances head offset - no copying until compaction threshold is reached.
-    pub fn consume(self: *@This(), bytes: u32) void {
-        self.head +|= bytes;
-
-        // Adjust scanned_pos (subtract consumed bytes, but don't go negative)
-        self.scanned_pos = if (bytes >= self.scanned_pos) 0 else self.scanned_pos - bytes;
-
-        // Adjust newline_pos
-        if (self.newline_pos) |pos| {
-            if (bytes > pos) {
-                // Consumed past the known newline - clear it and scan for next
-                self.newline_pos = null;
-                self.scanForNewline();
-            } else {
-                self.newline_pos = pos - bytes;
-            }
-        }
-
-        // Check if we've consumed everything
-        if (self.head >= self.data.len) {
-            // Free memory if capacity exceeds threshold, otherwise just reset
-            if (self.data.cap >= compaction_threshold) {
-                self.data.deinit(bun.default_allocator);
-                self.data = .{};
-            } else {
-                self.data.len = 0;
-            }
-            self.head = 0;
-            self.scanned_pos = 0;
-            self.newline_pos = null;
-            return;
-        }
-
-        // Compact if head exceeds threshold to avoid unbounded memory growth
-        if (self.head >= compaction_threshold) {
-            self.compact();
-        }
-    }
-
-    pub fn isEmpty(self: *const @This()) bool {
-        return self.head >= self.data.len;
-    }
-
-    pub fn unusedCapacitySlice(self: *@This()) []u8 {
-        return self.data.unusedCapacitySlice();
-    }
-
-    pub fn ensureUnusedCapacity(self: *@This(), additional: usize) void {
-        bun.handleOom(self.data.ensureUnusedCapacity(bun.default_allocator, additional));
-    }
-
-    /// Notify the buffer that data was written directly (e.g., via pre-allocated slice).
-    pub fn notifyWritten(self: *@This(), new_data: []const u8) void {
-        bun.debugAssert(new_data.len <= std.math.maxInt(u32));
-        self.data.len +|= @as(u32, @intCast(new_data.len));
-        self.scanForNewline();
-    }
-
-    pub fn deinit(self: *@This()) void {
-        self.data.deinit(bun.default_allocator);
-    }
-};
-
-const bun = @import("bun");
-const std = @import("std");