robobun 7076a49bb1 feat(archive): add TypeScript types, docs, and files() benchmark (#25922) ...

## Summary

- Add comprehensive TypeScript type definitions for `Bun.Archive` in
`bun.d.ts`
  - `ArchiveInput` and `ArchiveCompression` types
- Full JSDoc documentation with examples for all methods (`from`,
`write`, `extract`, `blob`, `bytes`, `files`)
- Add documentation page at `docs/runtime/archive.mdx`
  - Quickstart examples
  - Creating and extracting archives
  - `files()` method with glob filtering
  - Compression support
  - Full API reference section
- Add Archive to docs sidebar under "Data & Storage"
- Add `files()` benchmark comparing `Bun.Archive.files()` vs node-tar
- Shows ~7x speedup for reading archive contents into memory (59µs vs
434µs)

## Test plan

- [x] TypeScript types compile correctly
- [x] Documentation renders properly in Mintlify format
- [x] Benchmark runs successfully and shows performance comparison
- [x] Verified `files()` method works correctly with both Bun.Archive
and node-tar

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

---------

Co-authored-by: Claude Bot <claude-bot@bun.sh>
Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
Co-authored-by: Jarred Sumner <jarred@jarredsumner.com>

2026-01-09 19:00:19 -08:00

..

_fixture.txt

cleanup benchmarks folder (#587)

2022-07-12 01:40:12 -07:00

archive.mjs

feat(archive): add TypeScript types, docs, and files() benchmark (#25922)

2026-01-09 19:00:19 -08:00

array-arguments-slice.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

array-map.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

array-of.js

Add simple benchmark for Array.of (#25711)

2025-12-27 00:05:57 -08:00

array-shift.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

array-sort.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

arraybuffersink.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

assert.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

async-overhead.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

atob.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

blob.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

buffer-base64.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

buffer-concat.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

buffer-create.mjs

js: fix Buffer constructor and Buffer.from (#16731)

2025-02-07 15:13:21 -08:00

buffer-fill.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

buffer-includes.js

node: fix buffer includes+indexof (#16642)

2025-02-18 13:12:03 -08:00

buffer-read.js

Add a zig fmt action (#2277)

2023-03-02 19:02:10 -08:00

buffer-to-string.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

buffer.js

node:buffer: fix read (#17299)

2025-02-12 23:37:36 -08:00

byteLength.mjs

Avoid resolving substrings in bun:sqlite and Buffer.byteLength (#16092)

2024-12-31 19:48:33 -08:00

callbacks-overhead.mjs

Add a zig fmt action (#2277)

2023-03-02 19:02:10 -08:00

color.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

compression-streams.mjs

runtime: implement CompressionStream/DecompressionStream (#24757)

2025-11-20 17:14:37 -08:00

concat.js

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

console-log.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

cp-r.mjs

get name if not provided in FormData.append (#4434)

2023-08-31 17:33:08 -07:00

cp.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

crypto-2190.mjs

Avoid emitting DCE annotations at runtime (#22300)

2025-09-01 02:56:59 -07:00

crypto-hasher.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

crypto-randomUUID.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

crypto-stream.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

crypto.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

decode.js

Add routes to Bun.serve() (#17357)

2025-02-16 00:42:05 -08:00

deep-equals.js

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

define-properties.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

dns-prefetch.mjs

bun.sh -> bun.com (#20909)

2025-07-10 00:10:43 -07:00

dns.node.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

dns.ts

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

encode-into.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

error-capturestack.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

escapeHTML.js

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

exists.js

cleanup benchmarks folder (#587)

2022-07-12 01:40:12 -07:00

express-hello.mjs

node:http improvements (#17093)

2025-03-10 20:19:29 -07:00

fastify.mjs

node:http improvements (#17093)

2025-03-10 20:19:29 -07:00

ffi-overhead.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

form-data.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

hash.mjs

Added rapidhash algorithm (#20163)

2025-06-03 03:34:35 -07:00

headers.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

http-hello.deno.js

Add snippet

2022-12-06 14:18:25 -08:00

http-hello.js

Add snippet

2022-12-06 14:18:25 -08:00

http-hello.node.mjs

Fix a couple bugs with node:http (#6924)

2023-11-06 03:51:49 -08:00

index-of.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

ipc-json-child.mjs

perf(ipc): fix O(n²) JSON scanning for large chunked messages (#25743)

2025-12-29 20:02:18 -08:00

ipc-json.mjs

perf(ipc): fix O(n²) JSON scanning for large chunked messages (#25743)

2025-12-29 20:02:18 -08:00

json-parse-stringify.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

json-stringify.js

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

jsx-entity-decoding.jsx

cleanup benchmarks folder (#587)

2022-07-12 01:40:12 -07:00

module-exports-putter.cjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

native-overhead.mjs

Expose some no-ops (#16125)

2025-01-03 13:57:46 -08:00

new-incomingmessage.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

node-vm.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

node-zlib-brotli.mjs

Update node-zlib-brotli.mjs

2025-08-01 14:35:04 -07:00

noop.js

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

object-entries.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

object-hasown.mjs

[publish images] (+ add Object.hasOwn benchmark)

2025-12-24 19:55:44 -08:00

object-values.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

path-relative.mjs

hmr fixes (#17239)

2025-02-12 23:14:02 -08:00

path-resolve.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

pbkdf2.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

peek-promise.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

performance-now-overhead.js

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

private.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

process-cwd.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

process-info.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

process.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

promise-race.mjs

Add Promise.race microbenchmark

2025-12-23 22:53:24 -08:00

react-dom-render.bun.js

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

read-file-chunk.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

read-file.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

readdir.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

readfile-not-found.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

realpath.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

redis-simple.mjs

Clean up some docs

2025-04-08 03:57:35 -07:00

render.js

run prettier and add back format action (#13722)

2024-09-03 21:32:52 -07:00

request-method-getter.mjs

Make request.method getter not allocate memory (#18961)

2025-04-11 20:59:38 -07:00

request-response-clone.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

require-builtins.mjs

js: update node:_http_agent (#24275)

2025-11-04 11:56:33 -08:00

response-arrayBuffer.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

response-json.mjs

perf(Response.json): use JSC's FastStringifier by passing undefined for space (#25717)

2025-12-27 15:01:28 -08:00

resposne-constructor.mjs

Fix memory leak in response.clone(), further reduce memory usage of Request & Response (#3902)

2023-07-30 23:51:43 -07:00

return-await.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

rewriter.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

rmdir.mjs

run prettier and add back format action (#13722)

2024-09-03 21:32:52 -07:00

runner-entrypoint.js

run prettier and add back format action (#13722)

2024-09-03 21:32:52 -07:00

semver.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

serialize.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

set-timeout.mjs

run prettier and add back format action (#13722)

2024-09-03 21:32:52 -07:00

sha512.deno.mjs

Add a bench snippet for sha512

2022-08-21 00:51:27 -07:00

sha512.js

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

sha512.node.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

shell-spawn.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

source-map.js

Implement "node:module"'s findSourceMap and SourceMap class (#20863)

2025-07-07 23:08:12 -07:00

spawn-hugemem.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

spawn-hugemem.node.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

spawn.deno.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

spawn.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

spawn.node.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

stat.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

stderr.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

string-decoder.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

string-includes.mjs

Add microbench for String#includes (#25699)

2025-12-26 21:49:00 -08:00

string-width.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

strip-ansi.mjs

Introduce Bun.stripANSI (#21801)

2025-08-14 22:42:05 -07:00

structuredClone.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

tcp-echo.bun.ts

run prettier and add back format action (#13722)

2024-09-03 21:32:52 -07:00

tcp-echo.node.mjs

split server/client for tcp echo benchmark to better measure net.Socket perf

2023-01-04 18:55:16 -08:00

text-decoder-stream.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

text-decoder.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

text-encoder-stream.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

text-encoder.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

transpiler-2.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

transpiler.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

url.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

urlpattern.js

feat(url): implement URLPattern API (#25168)

2025-11-28 00:04:30 -08:00

urlsearchparams.mjs

ci: repair lint setup and run it in CI (#15720)

2025-01-08 07:12:18 +00:00

util-deprecate.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

webcrypto.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

write-file-huge.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

write-file.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

write.bun.js

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

write.node.mjs

Bench updates (#15029)

2024-11-08 23:15:24 -08:00

zlib.mjs

Add zlib microbenchmark

2024-12-24 04:20:24 -08:00