bun-types 1.1.42-canary.20250102T140513 → 1.1.43-canary.20250103T140555

package/bun.d.ts

@@ -3749,9 +3749,24 @@ declare module "bun" {
 	function nanoseconds(): number;
 
 	/**
-	 * Generate a heap snapshot for seeing where the heap is being used
+	 * Show precise statistics about memory usage of your application
+	 *
+	 * Generate a heap snapshot in JavaScriptCore's format that can be viewed with `bun --inspect` or Safari's Web Inspector
+	 */
+	function generateHeapSnapshot(format?: "jsc"): HeapSnapshot;
+
+	/**
+	 * Show precise statistics about memory usage of your application
+	 *
+	 * Generate a V8 Heap Snapshot that can be used with Chrome DevTools & Visual Studio Code
+	 *
+	 * This is a JSON string that can be saved to a file.
+	 * ```ts
+	 * const snapshot = Bun.generateHeapSnapshot("v8");
+	 * await Bun.write("heap.heapsnapshot", snapshot);
+	 * ```
 	 */
-	function generateHeapSnapshot(): HeapSnapshot;
+	function generateHeapSnapshot(format: "v8"): string;
 
 	/**
 	 * The next time JavaScriptCore is idle, clear unused memory and attempt to reduce the heap size.

package/docs/install/cache.md

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

package/docs/runtime/nodejs-apis.md

@@ -53,7 +53,7 @@ Some methods are not optimized yet.
 
 ### [`node:events`](https://nodejs.org/api/events.html)
 
-🟡 `events.addAbortListener` & `events.getMaxListeners` do not support (web api) `EventTarget`
+🟢 Fully implemented. `EventEmitterAsyncResource` uses `AsyncResource` underneath.
 
 ### [`node:fs`](https://nodejs.org/api/fs.html)
 
@@ -157,11 +157,11 @@ Some methods are not optimized yet.
 
 ### [`node:v8`](https://nodejs.org/api/v8.html)
 
-🔴 `serialize` and `deserialize` use JavaScriptCore's wire format instead of V8's. Otherwise, not implemented. For profiling, use [`bun:jsc`](https://bun.sh/docs/project/benchmarking#bunjsc) instead.
+🟡 `writeHeapSnapshot` and `getHeapSnapshot` are implemented. `serialize` and `deserialize` use JavaScriptCore's wire format instead of V8's. Other methods are not implemented. For profiling, use [`bun:jsc`](https://bun.sh/docs/project/benchmarking#bunjsc) instead.
 
 ### [`node:vm`](https://nodejs.org/api/vm.html)
 
-🟡 Core functionality works, but experimental VM ES modules are not implemented, including `vm.Module`, `vm.SourceTextModule`, `vm.SyntheticModule`,`importModuleDynamically`, and `vm.measureMemory`. Options like `timeout`, `breakOnSigint`, `cachedData` are not implemented yet. There is a bug with `this` value for contextified options not having the correct prototype.
+🟡 Core functionality works, but experimental VM ES modules are not implemented, including `vm.Module`, `vm.SourceTextModule`, `vm.SyntheticModule`,`importModuleDynamically`, and `vm.measureMemory`. Options like `timeout`, `breakOnSigint`, `cachedData` are not implemented yet.
 
 ### [`node:wasi`](https://nodejs.org/api/wasi.html)
 

package/package.json

@@ -1,5 +1,5 @@
 {
-	"version": "1.1.42-canary.20250102T140513",
+	"version": "1.1.43-canary.20250103T140555",
 	"name": "bun-types",
 	"license": "MIT",
 	"main": "",