bun-types 1.2.11-canary.20250423T140629 → 1.2.11-canary.20250425T140632

package/bun.d.ts

@@ -6393,11 +6393,7 @@ declare module "bun" {
       | Response
       | Request;
 
-    interface OptionsObject<
-      In extends Writable = Writable,
-      Out extends Readable = Readable,
-      Err extends Readable = Readable,
-    > {
+    interface OptionsObject<In extends Writable, Out extends Readable, Err extends Readable> {
       /**
        * The current working directory of the process
        *
@@ -6624,22 +6620,6 @@ declare module "bun" {
       maxBuffer?: number;
     }
 
-    type OptionsToSubprocess<Opts extends OptionsObject> =
-      Opts extends OptionsObject<infer In, infer Out, infer Err>
-        ? Subprocess<
-            // "Writable extends In" means "if In === Writable",
-            // aka if true that means the user didn't specify anything
-            Writable extends In ? "ignore" : In,
-            Readable extends Out ? "pipe" : Out,
-            Readable extends Err ? "inherit" : Err
-          >
-        : Subprocess<Writable, Readable, Readable>;
-
-    type OptionsToSyncSubprocess<Opts extends OptionsObject> =
-      Opts extends OptionsObject<any, infer Out, infer Err>
-        ? SyncSubprocess<Readable extends Out ? "pipe" : Out, Readable extends Err ? "pipe" : Err>
-        : SyncSubprocess<Readable, Readable>;
-
     type ReadableIO = ReadableStream<Uint8Array> | number | undefined;
 
     type ReadableToIO<X extends Readable> = X extends "pipe" | undefined
@@ -6746,9 +6726,9 @@ declare module "bun" {
    * - {@link NullSubprocess} (ignore, ignore, ignore)
    */
   interface Subprocess<
-    In extends SpawnOptions.Writable = SpawnOptions.Writable,
-    Out extends SpawnOptions.Readable = SpawnOptions.Readable,
-    Err extends SpawnOptions.Readable = SpawnOptions.Readable,
+    In extends SpawnOptions.Writable,
+    Out extends SpawnOptions.Readable,
+    Err extends SpawnOptions.Readable,
   > extends AsyncDisposable {
     readonly stdin: SpawnOptions.WritableToIO<In>;
     readonly stdout: SpawnOptions.ReadableToIO<Out>;
@@ -6853,10 +6833,7 @@ declare module "bun" {
    * - {@link ReadableSyncSubprocess} (pipe, pipe)
    * - {@link NullSyncSubprocess} (ignore, ignore)
    */
-  interface SyncSubprocess<
-    Out extends SpawnOptions.Readable = SpawnOptions.Readable,
-    Err extends SpawnOptions.Readable = SpawnOptions.Readable,
-  > {
+  interface SyncSubprocess<Out extends SpawnOptions.Readable, Err extends SpawnOptions.Readable> {
     stdout: SpawnOptions.ReadableToSyncIO<Out>;
     stderr: SpawnOptions.ReadableToSyncIO<Err>;
     exitCode: number;
@@ -6888,8 +6865,12 @@ declare module "bun" {
    *
    * Internally, this uses [posix_spawn(2)](https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/posix_spawn.2.html)
    */
-  function spawn<Opts extends SpawnOptions.OptionsObject>(
-    options: Opts & {
+  function spawn<
+    const In extends SpawnOptions.Writable = "ignore",
+    const Out extends SpawnOptions.Readable = "pipe",
+    const Err extends SpawnOptions.Readable = "inherit",
+  >(
+    options: SpawnOptions.OptionsObject<In, Out, Err> & {
       /**
        * The command to run
        *
@@ -6906,7 +6887,7 @@ declare module "bun" {
        */
       cmd: string[]; // to support dynamically constructed commands
     },
-  ): SpawnOptions.OptionsToSubprocess<Opts>;
+  ): Subprocess<In, Out, Err>;
 
   /**
    * Spawn a new process
@@ -6919,7 +6900,11 @@ declare module "bun" {
    *
    * Internally, this uses [posix_spawn(2)](https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/posix_spawn.2.html)
    */
-  function spawn<Opts extends SpawnOptions.OptionsObject>(
+  function spawn<
+    const In extends SpawnOptions.Writable = "ignore",
+    const Out extends SpawnOptions.Readable = "pipe",
+    const Err extends SpawnOptions.Readable = "inherit",
+  >(
     /**
      * The command to run
      *
@@ -6935,8 +6920,8 @@ declare module "bun" {
      * ```
      */
     cmds: string[],
-    options?: Opts,
-  ): SpawnOptions.OptionsToSubprocess<Opts>;
+    options?: SpawnOptions.OptionsObject<In, Out, Err>,
+  ): Subprocess<In, Out, Err>;
 
   /**
    * Spawn a new process
@@ -6952,8 +6937,11 @@ declare module "bun" {
    *
    * Internally, this uses [posix_spawn(2)](https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/posix_spawn.2.html)
    */
-  function spawnSync<Opts extends SpawnOptions.OptionsObject>(
-    options: Opts & {
+  function spawnSync<
+    const Out extends SpawnOptions.Readable = "pipe",
+    const Err extends SpawnOptions.Readable = "inherit",
+  >(
+    options: SpawnOptions.OptionsObject<"ignore", Out, Err> & {
       /**
        * The command to run
        *
@@ -6972,7 +6960,7 @@ declare module "bun" {
 
       onExit?: never;
     },
-  ): SpawnOptions.OptionsToSyncSubprocess<Opts>;
+  ): SyncSubprocess<Out, Err>;
 
   /**
    * Synchronously spawn a new process
@@ -6984,7 +6972,10 @@ declare module "bun" {
    *
    * Internally, this uses [posix_spawn(2)](https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/posix_spawn.2.html)
    */
-  function spawnSync<Opts extends SpawnOptions.OptionsObject>(
+  function spawnSync<
+    const Out extends SpawnOptions.Readable = "pipe",
+    const Err extends SpawnOptions.Readable = "inherit",
+  >(
     /**
      * The command to run
      *
@@ -7000,8 +6991,8 @@ declare module "bun" {
      * ```
      */
     cmds: string[],
-    options?: Opts,
-  ): SpawnOptions.OptionsToSyncSubprocess<Opts>;
+    options?: SpawnOptions.OptionsObject<"ignore", Out, Err>,
+  ): SyncSubprocess<Out, Err>;
 
   /** Utility type for any process from {@link Bun.spawn()} with both stdout and stderr set to `"pipe"` */
   type ReadableSubprocess = Subprocess<any, "pipe", "pipe">;

package/docs/api/fetch.md

@@ -337,7 +337,7 @@ This will print the request and response headers to your terminal:
 ```sh
 [fetch] > HTTP/1.1 GET http://example.com/
 [fetch] > Connection: keep-alive
-[fetch] > User-Agent: Bun/1.2.11-canary.20250423T140629
+[fetch] > User-Agent: Bun/1.2.11-canary.20250425T140632
 [fetch] > Accept: */*
 [fetch] > Host: example.com
 [fetch] > Accept-Encoding: gzip, deflate, br

package/docs/api/spawn.md

@@ -120,7 +120,7 @@ You can read results from the subprocess via the `stdout` and `stderr` propertie
 ```ts
 const proc = Bun.spawn(["bun", "--version"]);
 const text = await new Response(proc.stdout).text();
-console.log(text); // => "1.2.11-canary.20250423T140629"
+console.log(text); // => "1.2.11-canary.20250425T140632"
 ```
 
 Configure the output stream by passing one of the following values to `stdout/stderr`:

package/docs/api/websockets.md

@@ -117,14 +117,14 @@ type WebSocketData = {
 // TypeScript: specify the type of `data`
 Bun.serve<WebSocketData>({
   fetch(req, server) {
-    // use a library to parse cookies
-    const cookies = parseCookies(req.headers.get("Cookie"));
+    const cookies = new Bun.CookieMap(req.headers.get("cookie")!);
+
     server.upgrade(req, {
       // this object must conform to WebSocketData
       data: {
         createdAt: Date.now(),
         channelId: new URL(req.url).searchParams.get("channelId"),
-        authToken: cookies["X-Token"],
+        authToken: cookies.get("X-Token"),
       },
     });
 

package/docs/cli/publish.md

@@ -7,7 +7,7 @@ Use `bun publish` to publish a package to the npm registry.
 $ bun publish
 
 ## Output
-bun publish v1.2.11-canary.20250423T140629 (ca7428e9)
+bun publish v1.2.11-canary.20250425T140632 (ca7428e9)
 
 packed 203B package.json
 packed 224B README.md

package/docs/guides/ecosystem/nuxt.md

@@ -9,7 +9,7 @@ $ bunx nuxi init my-nuxt-app
 ✔ Which package manager would you like to use?
 bun
 ◐ Installing dependencies...
-bun install v1.2.11-canary.20250423T140629 (16b4bf34)
+bun install v1.2.11-canary.20250425T140632 (16b4bf34)
  + @nuxt/devtools@0.8.2
  + nuxt@3.7.0
  785 packages installed [2.67s]

package/docs/guides/install/add-peer.md

@@ -16,7 +16,7 @@ This will add the package to `peerDependencies` in `package.json`.
 ```json-diff
 {
   "peerDependencies": {
-+   "@types/bun": "^1.2.11-canary.20250423T140629"
++   "@types/bun": "^1.2.11-canary.20250425T140632"
   }
 }
 ```
@@ -28,7 +28,7 @@ Running `bun install` will install peer dependencies by default, unless marked o
 ```json-diff
 {
   "peerDependencies": {
-    "@types/bun": "^1.2.11-canary.20250423T140629"
+    "@types/bun": "^1.2.11-canary.20250425T140632"
   },
   "peerDependenciesMeta": {
 +   "@types/bun": {

package/docs/guides/install/from-npm-install-to-bun-install.md

@@ -97,7 +97,7 @@ $ bun update
 $ bun update @types/bun --latest
 
 # Update a dependency to a specific version
-$ bun update @types/bun@1.2.11-canary.20250423T140629
+$ bun update @types/bun@1.2.11-canary.20250425T140632
 
 # Update all dependencies to the latest versions
 $ bun update --latest

package/docs/guides/test/run-tests.md

@@ -21,7 +21,7 @@ Here's what the output of a typical test run looks like. In this case, there are
 
 ```sh
 $ bun test
-bun test v1.2.11-canary.20250423T140629 (9c68abdb)
+bun test v1.2.11-canary.20250425T140632 (9c68abdb)
 
 test.test.js:
 ✓ add [0.87ms]
@@ -47,7 +47,7 @@ To only run certain test files, pass a positional argument to `bun test`. The ru
 
 ```sh
 $ bun test test3
-bun test v1.2.11-canary.20250423T140629 (9c68abdb)
+bun test v1.2.11-canary.20250425T140632 (9c68abdb)
 
 test3.test.js:
 ✓ add [1.40ms]
@@ -85,7 +85,7 @@ Adding `-t add` will only run tests with "add" in the name. This works with test
 
 ```sh
 $ bun test -t add
-bun test v1.2.11-canary.20250423T140629 (9c68abdb)
+bun test v1.2.11-canary.20250425T140632 (9c68abdb)
 
 test.test.js:
 ✓ add [1.79ms]

package/docs/guides/test/snapshot.md

@@ -18,7 +18,7 @@ The first time this test is executed, Bun will evaluate the value passed into `e
 
 ```sh
 $ bun test test/snap
-bun test v1.2.11-canary.20250423T140629 (9c68abdb)
+bun test v1.2.11-canary.20250425T140632 (9c68abdb)
 
 test/snap.test.ts:
 ✓ snapshot [1.48ms]
@@ -61,7 +61,7 @@ Later, when this test file is executed again, Bun will read the snapshot file an
 
 ```sh
 $ bun test
-bun test v1.2.11-canary.20250423T140629 (9c68abdb)
+bun test v1.2.11-canary.20250425T140632 (9c68abdb)
 
 test/snap.test.ts:
 ✓ snapshot [1.05ms]
@@ -78,7 +78,7 @@ To update snapshots, use the `--update-snapshots` flag.
 
 ```sh
 $ bun test --update-snapshots
-bun test v1.2.11-canary.20250423T140629 (9c68abdb)
+bun test v1.2.11-canary.20250425T140632 (9c68abdb)
 
 test/snap.test.ts:
 ✓ snapshot [0.86ms]

package/docs/guides/test/update-snapshots.md

@@ -29,7 +29,7 @@ To regenerate snapshots, use the `--update-snapshots` flag.
 
 ```sh
 $ bun test --update-snapshots
-bun test v1.2.11-canary.20250423T140629 (9c68abdb)
+bun test v1.2.11-canary.20250425T140632 (9c68abdb)
 
 test/snap.test.ts:
 ✓ snapshot [0.86ms]

package/docs/guides/util/version.md

@@ -5,7 +5,7 @@ name: Get the current Bun version
 Get the current version of Bun in a semver format.
 
 ```ts#index.ts
-Bun.version; // => "1.2.11-canary.20250423T140629"
+Bun.version; // => "1.2.11-canary.20250425T140632"
 ```
 
 ---

package/docs/installation.md

@@ -14,7 +14,7 @@ Kernel version 5.6 or higher is strongly recommended, but the minimum is 5.1. Us
 ```bash#macOS/Linux_(curl)
 $ curl -fsSL https://bun.sh/install | bash # for macOS, Linux, and WSL
 # to install a specific version
-$ curl -fsSL https://bun.sh/install | bash -s "bun-v1.2.11-canary.20250423T140629"
+$ curl -fsSL https://bun.sh/install | bash -s "bun-v1.2.11-canary.20250425T140632"
 ```
 
 ```bash#npm
@@ -189,10 +189,10 @@ Since Bun is a single binary, you can install older versions of Bun by re-runnin
 
 ### Installing a specific version of Bun on Linux/Mac
 
-To install a specific version of Bun, you can pass the git tag of the version you want to install to the install script, such as `bun-v1.2.0` or `bun-v1.2.11-canary.20250423T140629`.
+To install a specific version of Bun, you can pass the git tag of the version you want to install to the install script, such as `bun-v1.2.0` or `bun-v1.2.11-canary.20250425T140632`.
 
 ```sh
-$ curl -fsSL https://bun.sh/install | bash -s "bun-v1.2.11-canary.20250423T140629"
+$ curl -fsSL https://bun.sh/install | bash -s "bun-v1.2.11-canary.20250425T140632"
 ```
 
 ### Installing a specific version of Bun on Windows
@@ -201,7 +201,7 @@ On Windows, you can install a specific version of Bun by passing the version num
 
 ```sh
 # PowerShell:
-$ iex "& {$(irm https://bun.sh/install.ps1)} -Version 1.2.11-canary.20250423T140629"
+$ iex "& {$(irm https://bun.sh/install.ps1)} -Version 1.2.11-canary.20250425T140632"
 ```
 
 ## Downloading Bun binaries directly

package/docs/project/contributing.md

@@ -222,6 +222,9 @@ $ git -C vendor/WebKit checkout <commit_hash>
 # Optionally, you can use `make jsc` for a release build
 $ make jsc-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
+
 # Build bun with the local JSC build
 $ bun run build:local
 ```

package/docs/runtime/debugger.md

@@ -124,11 +124,11 @@ await fetch("https://example.com", {
 This prints the `fetch` request as a single-line `curl` command to let you copy-paste into your terminal to replicate the request.
 
 ```sh
-[fetch] $ curl --http1.1 "https://example.com/" -X POST -H "content-type: application/json" -H "Connection: keep-alive" -H "User-Agent: Bun/1.2.11-canary.20250423T140629" -H "Accept: */*" -H "Host: example.com" -H "Accept-Encoding: gzip, deflate, br" --compressed -H "Content-Length: 13" --data-raw "{\"foo\":\"bar\"}"
+[fetch] $ curl --http1.1 "https://example.com/" -X POST -H "content-type: application/json" -H "Connection: keep-alive" -H "User-Agent: Bun/1.2.11-canary.20250425T140632" -H "Accept: */*" -H "Host: example.com" -H "Accept-Encoding: gzip, deflate, br" --compressed -H "Content-Length: 13" --data-raw "{\"foo\":\"bar\"}"
 [fetch] > HTTP/1.1 POST https://example.com/
 [fetch] > content-type: application/json
 [fetch] > Connection: keep-alive
-[fetch] > User-Agent: Bun/1.2.11-canary.20250423T140629
+[fetch] > User-Agent: Bun/1.2.11-canary.20250425T140632
 [fetch] > Accept: */*
 [fetch] > Host: example.com
 [fetch] > Accept-Encoding: gzip, deflate, br
@@ -170,7 +170,7 @@ This prints the following to the console:
 [fetch] > HTTP/1.1 POST https://example.com/
 [fetch] > content-type: application/json
 [fetch] > Connection: keep-alive
-[fetch] > User-Agent: Bun/1.2.11-canary.20250423T140629
+[fetch] > User-Agent: Bun/1.2.11-canary.20250425T140632
 [fetch] > Accept: */*
 [fetch] > Host: example.com
 [fetch] > Accept-Encoding: gzip, deflate, br

package/docs/test/dom.md

@@ -55,7 +55,7 @@ Let's run this test with `bun test`:
 
 ```bash
 $ bun test
-bun test v1.2.11-canary.20250423T140629
+bun test v1.2.11-canary.20250425T140632
 
 dom.test.ts:
 ✓ dom test [0.82ms]

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.2.11-canary.20250423T140629",
+  "version": "1.2.11-canary.20250425T140632",
   "name": "bun-types",
   "license": "MIT",
   "types": "./index.d.ts",

package/shell.d.ts

@@ -6,7 +6,7 @@ declare module "bun" {
     | Array<ShellExpression>
     | string
     | { raw: string }
-    | Subprocess
+    | Subprocess<SpawnOptions.Writable, SpawnOptions.Readable, SpawnOptions.Readable>
     | SpawnOptions.Readable
     | SpawnOptions.Writable
     | ReadableStream;
@@ -24,9 +24,9 @@ declare module "bun" {
    */
   function $(strings: TemplateStringsArray, ...expressions: ShellExpression[]): $.ShellPromise;
 
-  namespace $ {
-    const Shell: new () => typeof $;
+  type $ = typeof $;
 
+  namespace $ {
     /**
      * Perform bash-like brace expansion on the given pattern.
      * @param pattern - Brace pattern to expand
@@ -60,23 +60,23 @@ declare module "bun" {
      * // "bun"
      * ```
      */
-    function env(newEnv?: Record<string, string | undefined>): typeof $;
+    function env(newEnv?: Record<string, string | undefined>): $;
 
     /**
      *
      * @param newCwd Default working directory to use for shells created by this instance.
      */
-    function cwd(newCwd?: string): typeof $;
+    function cwd(newCwd?: string): $;
 
     /**
      * Configure the shell to not throw an exception on non-zero exit codes.
      */
-    function nothrow(): typeof $;
+    function nothrow(): $;
 
     /**
      * Configure whether or not the shell should throw an exception on non-zero exit codes.
      */
-    function throws(shouldThrow: boolean): typeof $;
+    function throws(shouldThrow: boolean): $;
 
     /**
      * The `Bun.$.ShellPromise` class represents a shell command that gets executed
@@ -375,5 +375,7 @@ declare module "bun" {
        */
       blob(): Blob;
     }
+
+    const Shell: new () => $;
   }
 }