npm - bun-types - Versions diffs - 1.3.2-canary.20251105T140650 → 1.3.2-canary.20251106T140813 - Mend

bun-types 1.3.2-canary.20251105T140650 → 1.3.2-canary.20251106T140813

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (308) hide show

package/docs/README.md +28 -0
package/package.json +1 -1
package/docs/api/binary-data.md +0 -1038
package/docs/api/cc.md +0 -197
package/docs/api/color.md +0 -262
package/docs/api/console.md +0 -57
package/docs/api/cookie.md +0 -449
package/docs/api/dns.md +0 -110
package/docs/api/fetch.md +0 -463
package/docs/api/ffi.md +0 -557
package/docs/api/file-io.md +0 -366
package/docs/api/file-system-router.md +0 -112
package/docs/api/file.md +0 -19
package/docs/api/glob.md +0 -178
package/docs/api/globals.md +0 -387
package/docs/api/hashing.md +0 -319
package/docs/api/html-rewriter.md +0 -334
package/docs/api/http.md +0 -1408
package/docs/api/import-meta.md +0 -69
package/docs/api/node-api.md +0 -14
package/docs/api/redis.md +0 -597
package/docs/api/s3.md +0 -850
package/docs/api/secrets.md +0 -319
package/docs/api/semver.md +0 -52
package/docs/api/spawn.md +0 -582
package/docs/api/sql.md +0 -1374
package/docs/api/sqlite.md +0 -694
package/docs/api/streams.md +0 -230
package/docs/api/tcp.md +0 -221
package/docs/api/transpiler.md +0 -276
package/docs/api/udp.md +0 -123
package/docs/api/utils.md +0 -891
package/docs/api/websockets.md +0 -573
package/docs/api/workers.md +0 -322
package/docs/api/yaml.md +0 -668
package/docs/benchmarks.md +0 -120
package/docs/bun-flavored-toml.md +0 -42
package/docs/bundler/css.md +0 -1028
package/docs/bundler/css_modules.md +0 -145
package/docs/bundler/executables.md +0 -626
package/docs/bundler/fullstack.md +0 -418
package/docs/bundler/hmr.md +0 -234
package/docs/bundler/html.md +0 -349
package/docs/bundler/index.md +0 -1735
package/docs/bundler/intro.md +0 -75
package/docs/bundler/loaders.md +0 -410
package/docs/bundler/macros.md +0 -329
package/docs/bundler/plugins.md +0 -449
package/docs/bundler/vs-esbuild.md +0 -1127
package/docs/cli/add.md +0 -173
package/docs/cli/bun-completions.md +0 -3
package/docs/cli/bun-create.md +0 -338
package/docs/cli/bun-install.md +0 -349
package/docs/cli/bun-upgrade.md +0 -39
package/docs/cli/bunx.md +0 -89
package/docs/cli/filter.md +0 -90
package/docs/cli/info.md +0 -65
package/docs/cli/init.md +0 -85
package/docs/cli/install.md +0 -344
package/docs/cli/link.md +0 -40
package/docs/cli/outdated.md +0 -90
package/docs/cli/patch-commit.md +0 -11
package/docs/cli/pm.md +0 -285
package/docs/cli/publish.md +0 -120
package/docs/cli/remove.md +0 -7
package/docs/cli/run.md +0 -261
package/docs/cli/test.md +0 -397
package/docs/cli/unlink.md +0 -9
package/docs/cli/update.md +0 -129
package/docs/cli/why.md +0 -67
package/docs/contributing/upgrading-webkit.md +0 -57
package/docs/ecosystem/elysia.md +0 -24
package/docs/ecosystem/express.md +0 -37
package/docs/ecosystem/hono.md +0 -18
package/docs/ecosystem/react.md +0 -65
package/docs/ecosystem/stric.md +0 -38
package/docs/guides/binary/arraybuffer-to-array.md +0 -27
package/docs/guides/binary/arraybuffer-to-blob.md +0 -24
package/docs/guides/binary/arraybuffer-to-buffer.md +0 -25
package/docs/guides/binary/arraybuffer-to-string.md +0 -15
package/docs/guides/binary/arraybuffer-to-typedarray.md +0 -39
package/docs/guides/binary/blob-to-arraybuffer.md +0 -14
package/docs/guides/binary/blob-to-dataview.md +0 -14
package/docs/guides/binary/blob-to-stream.md +0 -14
package/docs/guides/binary/blob-to-string.md +0 -15
package/docs/guides/binary/blob-to-typedarray.md +0 -14
package/docs/guides/binary/buffer-to-arraybuffer.md +0 -14
package/docs/guides/binary/buffer-to-blob.md +0 -14
package/docs/guides/binary/buffer-to-readablestream.md +0 -41
package/docs/guides/binary/buffer-to-string.md +0 -25
package/docs/guides/binary/buffer-to-typedarray.md +0 -14
package/docs/guides/binary/dataview-to-string.md +0 -15
package/docs/guides/binary/typedarray-to-arraybuffer.md +0 -25
package/docs/guides/binary/typedarray-to-blob.md +0 -16
package/docs/guides/binary/typedarray-to-buffer.md +0 -14
package/docs/guides/binary/typedarray-to-dataview.md +0 -14
package/docs/guides/binary/typedarray-to-readablestream.md +0 -41
package/docs/guides/binary/typedarray-to-string.md +0 -16
package/docs/guides/deployment/railway.md +0 -157
package/docs/guides/ecosystem/astro.md +0 -72
package/docs/guides/ecosystem/discordjs.md +0 -77
package/docs/guides/ecosystem/docker.md +0 -140
package/docs/guides/ecosystem/drizzle.md +0 -185
package/docs/guides/ecosystem/edgedb.md +0 -228
package/docs/guides/ecosystem/elysia.md +0 -31
package/docs/guides/ecosystem/express.md +0 -40
package/docs/guides/ecosystem/hono.md +0 -39
package/docs/guides/ecosystem/mongoose.md +0 -87
package/docs/guides/ecosystem/neon-drizzle.md +0 -220
package/docs/guides/ecosystem/neon-serverless-postgres.md +0 -55
package/docs/guides/ecosystem/nextjs.md +0 -49
package/docs/guides/ecosystem/nuxt.md +0 -56
package/docs/guides/ecosystem/pm2.md +0 -57
package/docs/guides/ecosystem/prisma.md +0 -141
package/docs/guides/ecosystem/qwik.md +0 -107
package/docs/guides/ecosystem/react.md +0 -50
package/docs/guides/ecosystem/remix.md +0 -78
package/docs/guides/ecosystem/render.md +0 -79
package/docs/guides/ecosystem/sentry.md +0 -52
package/docs/guides/ecosystem/solidstart.md +0 -58
package/docs/guides/ecosystem/ssr-react.md +0 -51
package/docs/guides/ecosystem/stric.md +0 -55
package/docs/guides/ecosystem/sveltekit.md +0 -125
package/docs/guides/ecosystem/systemd.md +0 -113
package/docs/guides/ecosystem/vite.md +0 -71
package/docs/guides/html-rewriter/extract-links.md +0 -68
package/docs/guides/html-rewriter/extract-social-meta.md +0 -93
package/docs/guides/http/cluster.md +0 -66
package/docs/guides/http/fetch-unix.md +0 -33
package/docs/guides/http/fetch.md +0 -24
package/docs/guides/http/file-uploads.md +0 -94
package/docs/guides/http/hot.md +0 -26
package/docs/guides/http/proxy.md +0 -24
package/docs/guides/http/server.md +0 -46
package/docs/guides/http/simple.md +0 -18
package/docs/guides/http/stream-file.md +0 -48
package/docs/guides/http/stream-iterator.md +0 -47
package/docs/guides/http/stream-node-streams-in-bun.md +0 -20
package/docs/guides/http/tls.md +0 -30
package/docs/guides/install/add-dev.md +0 -26
package/docs/guides/install/add-git.md +0 -36
package/docs/guides/install/add-optional.md +0 -25
package/docs/guides/install/add-peer.md +0 -43
package/docs/guides/install/add-tarball.md +0 -33
package/docs/guides/install/add.md +0 -42
package/docs/guides/install/azure-artifacts.md +0 -73
package/docs/guides/install/cicd.md +0 -41
package/docs/guides/install/custom-registry.md +0 -30
package/docs/guides/install/from-npm-install-to-bun-install.md +0 -214
package/docs/guides/install/git-diff-bun-lockfile.md +0 -44
package/docs/guides/install/jfrog-artifactory.md +0 -28
package/docs/guides/install/npm-alias.md +0 -23
package/docs/guides/install/registry-scope.md +0 -38
package/docs/guides/install/trusted.md +0 -46
package/docs/guides/install/workspaces.md +0 -70
package/docs/guides/install/yarnlock.md +0 -44
package/docs/guides/process/argv.md +0 -58
package/docs/guides/process/ctrl-c.md +0 -16
package/docs/guides/process/ipc.md +0 -66
package/docs/guides/process/nanoseconds.md +0 -13
package/docs/guides/process/os-signals.md +0 -39
package/docs/guides/process/spawn-stderr.md +0 -31
package/docs/guides/process/spawn-stdout.md +0 -26
package/docs/guides/process/spawn.md +0 -41
package/docs/guides/process/stdin.md +0 -54
package/docs/guides/read-file/arraybuffer.md +0 -28
package/docs/guides/read-file/buffer.md +0 -19
package/docs/guides/read-file/exists.md +0 -16
package/docs/guides/read-file/json.md +0 -17
package/docs/guides/read-file/mime.md +0 -20
package/docs/guides/read-file/stream.md +0 -26
package/docs/guides/read-file/string.md +0 -22
package/docs/guides/read-file/uint8array.md +0 -21
package/docs/guides/read-file/watch.md +0 -68
package/docs/guides/runtime/build-time-constants.md +0 -293
package/docs/guides/runtime/cicd.md +0 -43
package/docs/guides/runtime/codesign-macos-executable.md +0 -56
package/docs/guides/runtime/define-constant.md +0 -145
package/docs/guides/runtime/delete-directory.md +0 -37
package/docs/guides/runtime/delete-file.md +0 -19
package/docs/guides/runtime/heap-snapshot.md +0 -26
package/docs/guides/runtime/import-html.md +0 -15
package/docs/guides/runtime/import-json.md +0 -44
package/docs/guides/runtime/import-toml.md +0 -30
package/docs/guides/runtime/import-yaml.md +0 -102
package/docs/guides/runtime/read-env.md +0 -32
package/docs/guides/runtime/set-env.md +0 -47
package/docs/guides/runtime/shell.md +0 -40
package/docs/guides/runtime/timezone.md +0 -35
package/docs/guides/runtime/tsconfig-paths.md +0 -29
package/docs/guides/runtime/typescript.md +0 -49
package/docs/guides/runtime/vscode-debugger.md +0 -47
package/docs/guides/runtime/web-debugger.md +0 -82
package/docs/guides/streams/node-readable-to-arraybuffer.md +0 -11
package/docs/guides/streams/node-readable-to-blob.md +0 -11
package/docs/guides/streams/node-readable-to-json.md +0 -12
package/docs/guides/streams/node-readable-to-string.md +0 -12
package/docs/guides/streams/node-readable-to-uint8array.md +0 -11
package/docs/guides/streams/to-array.md +0 -14
package/docs/guides/streams/to-arraybuffer.md +0 -14
package/docs/guides/streams/to-blob.md +0 -14
package/docs/guides/streams/to-buffer.md +0 -15
package/docs/guides/streams/to-json.md +0 -14
package/docs/guides/streams/to-string.md +0 -14
package/docs/guides/streams/to-typedarray.md +0 -22
package/docs/guides/test/bail.md +0 -22
package/docs/guides/test/coverage-threshold.md +0 -60
package/docs/guides/test/coverage.md +0 -44
package/docs/guides/test/happy-dom.md +0 -68
package/docs/guides/test/migrate-from-jest.md +0 -143
package/docs/guides/test/mock-clock.md +0 -48
package/docs/guides/test/mock-functions.md +0 -68
package/docs/guides/test/rerun-each.md +0 -14
package/docs/guides/test/run-tests.md +0 -111
package/docs/guides/test/skip-tests.md +0 -39
package/docs/guides/test/snapshot.md +0 -95
package/docs/guides/test/spy-on.md +0 -46
package/docs/guides/test/svelte-test.md +0 -120
package/docs/guides/test/testing-library.md +0 -92
package/docs/guides/test/timeout.md +0 -15
package/docs/guides/test/todo-tests.md +0 -67
package/docs/guides/test/update-snapshots.md +0 -46
package/docs/guides/test/watch-mode.md +0 -19
package/docs/guides/util/base64.md +0 -15
package/docs/guides/util/deep-equals.md +0 -39
package/docs/guides/util/deflate.md +0 -18
package/docs/guides/util/detect-bun.md +0 -23
package/docs/guides/util/entrypoint.md +0 -17
package/docs/guides/util/escape-html.md +0 -22
package/docs/guides/util/file-url-to-path.md +0 -14
package/docs/guides/util/gzip.md +0 -18
package/docs/guides/util/hash-a-password.md +0 -54
package/docs/guides/util/import-meta-dir.md +0 -13
package/docs/guides/util/import-meta-file.md +0 -13
package/docs/guides/util/import-meta-path.md +0 -13
package/docs/guides/util/javascript-uuid.md +0 -23
package/docs/guides/util/main.md +0 -32
package/docs/guides/util/path-to-file-url.md +0 -14
package/docs/guides/util/sleep.md +0 -22
package/docs/guides/util/version.md +0 -21
package/docs/guides/util/which-path-to-executable-bin.md +0 -15
package/docs/guides/websocket/compression.md +0 -31
package/docs/guides/websocket/context.md +0 -77
package/docs/guides/websocket/pubsub.md +0 -41
package/docs/guides/websocket/simple.md +0 -33
package/docs/guides/write-file/append.md +0 -52
package/docs/guides/write-file/basic.md +0 -44
package/docs/guides/write-file/blob.md +0 -28
package/docs/guides/write-file/cat.md +0 -17
package/docs/guides/write-file/file-cp.md +0 -16
package/docs/guides/write-file/filesink.md +0 -52
package/docs/guides/write-file/response.md +0 -17
package/docs/guides/write-file/stdout.md +0 -21
package/docs/guides/write-file/stream.md +0 -17
package/docs/guides/write-file/unlink.md +0 -16
package/docs/index.md +0 -77
package/docs/install/audit.md +0 -57
package/docs/install/cache.md +0 -59
package/docs/install/catalogs.md +0 -298
package/docs/install/index.md +0 -248
package/docs/install/isolated.md +0 -197
package/docs/install/lifecycle.md +0 -46
package/docs/install/lockfile.md +0 -58
package/docs/install/npmrc.md +0 -105
package/docs/install/overrides.md +0 -73
package/docs/install/patch.md +0 -59
package/docs/install/registries.md +0 -30
package/docs/install/security-scanner-api.md +0 -81
package/docs/install/workspaces.md +0 -114
package/docs/installation.md +0 -327
package/docs/project/asan.md +0 -124
package/docs/project/benchmarking.md +0 -203
package/docs/project/bindgen.md +0 -225
package/docs/project/building-windows.md +0 -162
package/docs/project/contributing.md +0 -347
package/docs/project/internals/build-process-for-ci.md +0 -75
package/docs/project/licensing.md +0 -73
package/docs/project/roadmap.md +0 -87
package/docs/quickstart.md +0 -157
package/docs/runtime/autoimport.md +0 -94
package/docs/runtime/bun-apis.md +0 -207
package/docs/runtime/bunfig.md +0 -772
package/docs/runtime/debugger.md +0 -325
package/docs/runtime/env.md +0 -253
package/docs/runtime/hot.md +0 -145
package/docs/runtime/index.md +0 -312
package/docs/runtime/jsx.md +0 -385
package/docs/runtime/loaders.md +0 -130
package/docs/runtime/modules.md +0 -320
package/docs/runtime/nodejs-apis.md +0 -463
package/docs/runtime/plugins.md +0 -561
package/docs/runtime/shell.md +0 -605
package/docs/runtime/typescript.md +0 -139
package/docs/runtime/web-apis.md +0 -128
package/docs/test/configuration.md +0 -154
package/docs/test/coverage.md +0 -142
package/docs/test/discovery.md +0 -85
package/docs/test/dom.md +0 -75
package/docs/test/examples/concurrent-test-glob.md +0 -132
package/docs/test/hot.md +0 -15
package/docs/test/lifecycle.md +0 -81
package/docs/test/mocks.md +0 -313
package/docs/test/reporters.md +0 -117
package/docs/test/runtime-behavior.md +0 -95
package/docs/test/snapshots.md +0 -68
package/docs/test/time.md +0 -126
package/docs/test/writing.md +0 -825
package/docs/typescript.md +0 -53

package/docs/guides/ecosystem/solidstart.md DELETED Viewed

@@ -1,58 +0,0 @@
----
-name: Build an app with SolidStart and Bun
----
-{% callout %}
-SolidStart currently relies on Node.js APIs that Bun does not yet implement. The guide below uses Bun to initialize a project and install dependencies, but it uses Node.js to run the dev server.
-{% /callout %}
----
-Initialize a SolidStart app with `create-solid`.
-```sh
-$ bun create solid my-app
-create-solid version 0.2.31
-Welcome to the SolidStart setup wizard!
-There are definitely bugs and some feature might not work yet.
-If you encounter an issue, have a look at
-https://github.com/solidjs/solid-start/issues and open a new one,
-if it is not already tracked.
-✔ Which template do you want to use? › todomvc
-✔ Server Side Rendering? … yes
-✔ Use TypeScript? … yes
-cloned solidjs/solid-start#main to /path/to/my-app/.solid-start
-✔ Copied project files
-```
----
-As instructed by the `create-solid` CLI, let's install our dependencies.
-```sh
-$ cd my-app
-$ bun install
-```
----
-Then run the development server.
-```sh
-$ bun run dev
-# or, equivalently
-$ bunx solid-start dev
-```
----
-Open [localhost:3000](http://localhost:3000). Any changes you make to `src/routes/index.tsx` will be hot-reloaded automatically.
-{% image src="https://github.com/oven-sh/bun/assets/3084745/1e8043c4-49d1-498c-9add-c1eaab6c7167" alt="SolidStart demo app" /%}
----
-Refer to the [SolidStart website](https://start.solidjs.com/getting-started/what-is-solidstart) for complete framework documentation.

package/docs/guides/ecosystem/ssr-react.md DELETED Viewed

@@ -1,51 +0,0 @@
----
-name: Server-side render (SSR) a React component
----
-To get started, install `react` & `react-dom`:
-```sh
-# Any package manager can be used
-$ bun add react react-dom
-```
----
-To render a React component to an HTML stream server-side (SSR):
-```tsx
-import { renderToReadableStream } from "react-dom/server";
-function Component(props: { message: string }) {
-  return (
-    <body>
-      <h1>{props.message}</h1>
-    </body>
-  );
-}
-const stream = await renderToReadableStream(
-  <Component message="Hello from server!" />,
-);
-```
----
-Combining this with `Bun.serve()`, we get a simple SSR HTTP server:
-```tsx
-Bun.serve({
-  async fetch() {
-    const stream = await renderToReadableStream(
-      <Component message="Hello from server!" />,
-    );
-    return new Response(stream, {
-      headers: { "Content-Type": "text/html" },
-    });
-  },
-});
-```
----
-React `19` and later includes an [SSR optimization](https://github.com/facebook/react/pull/25597) that takes advantage of Bun's "direct" `ReadableStream` implementation. If you run into an error like `export named 'renderToReadableStream' not found`, please make sure to install version `19` of `react` & `react-dom`, or import from `react-dom/server.browser` instead of `react-dom/server`. See [facebook/react#28941](https://github.com/facebook/react/issues/28941) for more information.

package/docs/guides/ecosystem/stric.md DELETED Viewed

@@ -1,55 +0,0 @@
----
-name: Build an HTTP server using StricJS and Bun
----
-[StricJS](https://github.com/bunsvr) is a Bun framework for building high-performance web applications and APIs.
-- **Fast** — Stric is one of the fastest Bun frameworks. See [benchmark](https://github.com/bunsvr/benchmark) for more details.
-- **Minimal** — The basic components like `@stricjs/router` and `@stricjs/utils` are under 50kB and require no external dependencies.
-- **Extensible** — Stric includes with a plugin system, dependency injection, and optional optimizations for handling requests.
----
-Use `bun init` to create an empty project.
-```bash
-$ mkdir myapp
-$ cd myapp
-$ bun init
-$ bun add @stricjs/router @stricjs/utils
-```
----
-To implement a simple HTTP server with StricJS:
-```ts#index.ts
-import { Router } from '@stricjs/router';
-export default new Router()
-  .get('/', () => new Response('Hi'));
-```
----
-To serve static files from `/public`:
-```ts#index.ts
-import { dir } from '@stricjs/utils';
-export default new Router()
-  .get('/', () => new Response('Hi'))
-  .get('/*', dir('./public'));
-```
----
-Run the file in watch mode to start the development server.
-```bash
-$ bun --watch run index.ts
-```
----
-For more info, see Stric's [documentation](https://stricjs.netlify.app).

package/docs/guides/ecosystem/sveltekit.md DELETED Viewed

@@ -1,125 +0,0 @@
----
-name: Build an app with SvelteKit and Bun
----
-Use `sv create my-app` to create a SvelteKit project with SvelteKit CLI. Answer the prompts to select a template and set up your development environment.
-```sh
-$ bunx sv create my-app
-┌  Welcome to the Svelte CLI! (v0.5.7)
-│
-◇  Which template would you like?
-│  SvelteKit demo
-│
-◇  Add type checking with Typescript?
-│  Yes, using Typescript syntax
-│
-◆  Project created
-│
-◇  What would you like to add to your project?
-│  none
-│
-◇  Which package manager do you want to install dependencies with?
-│  bun
-│
-◇  Successfully installed dependencies
-│
-◇  Project next steps ─────────────────────────────────────────────────────╮
-│                                                                          │
-│  1: cd my-app                                                            │
-│  2: git init && git add -A && git commit -m "Initial commit" (optional)  │
-│  3: bun run dev -- --open                                                │
-│                                                                          │
-│  To close the dev server, hit Ctrl-C                                     │
-│                                                                          │
-│  Stuck? Visit us at https://svelte.dev/chat                              │
-│                                                                          │
-├──────────────────────────────────────────────────────────────────────────╯
-│
-└  You're all set!
-```
----
-Once the project is initialized, `cd` into the new project. You don't need to run 'bun install' since the dependencies are already installed.
-Then start the development server with `bun --bun run dev`.
-To run the dev server with Node.js instead of Bun, you can omit the `--bun` flag.
-```sh
-$ cd my-app
-$ bun --bun run dev
-  $ vite dev
-  Forced re-optimization of dependencies
-    VITE v5.4.10  ready in 424 ms
-    ➜  Local:   http://localhost:5173/
-    ➜  Network: use --host to expose
-    ➜  press h + enter to show help
-```
----
-Visit [http://localhost:5173](http://localhost:5173/) in a browser to see the template app.
-{% image src="https://github.com/oven-sh/bun/assets/3084745/7c76eae8-78f9-44fa-9f15-1bd3ca1a47c0" /%}
----
-If you edit and save `src/routes/+page.svelte`, you should see your changes hot-reloaded in the browser.
----
-To build for production, you'll need to add the right SvelteKit adapter. Currently we recommend the
-`bun add -D svelte-adapter-bun`.
-Now, make the following changes to your `svelte.config.js`.
-```ts-diff
-- import adapter from "@sveltejs/adapter-auto";
-+ import adapter from "svelte-adapter-bun";
-  import { vitePreprocess } from '@sveltejs/vite-plugin-svelte';
-  /** @type {import('@sveltejs/kit').Config} */
-  const config = {
-  	// Consult https://svelte.dev/docs/kit/integrations#preprocessors
-  	// for more information about preprocessors
-  	preprocess: vitePreprocess(),
-  	kit: {
-  		// adapter-auto only supports some environments, see https://svelte.dev/docs/kit/adapter-auto for a list.
-  		// If your environment is not supported, or you settled on a specific environment, switch out the adapter.
-  		// See https://svelte.dev/docs/kit/adapters for more information about adapters.
-  		adapter: adapter()
-  	}
-  };
-  export default config;
-```
----
-To build a production bundle:
-```sh
-$ bun --bun run build
-  $ vite build
-  vite v5.4.10 building SSR bundle for production...
-  "confetti" is imported from external module "@neoconfetti/svelte" but never used in "src/routes/sverdle/+page.svelte".
-  ✓ 130 modules transformed.
-  vite v5.4.10 building for production...
-  ✓ 148 modules transformed.
-  ...
-  ✓ built in 231ms
-  ...
-  ✓ built in 899ms
-  Run npm run preview to preview your production build locally.
-  > Using svelte-adapter-bun
-    ✔ Start server with: bun ./build/index.js
-    ✔ done
-```

package/docs/guides/ecosystem/systemd.md DELETED Viewed

@@ -1,113 +0,0 @@
----
-name: Run Bun as a daemon with systemd
----
-[systemd](https://systemd.io) is an init system and service manager for Linux operating systems that manages the startup and control of system processes and services.
-<!-- systemd provides aggressive parallelization capabilities, uses socket and D-Bus activation for starting services, offers on-demand starting of daemons, keeps track of processes using Linux control groups, maintains mount and auto mount points, and implements an elaborate transactional dependency-based service control logic. systemd supports SysV and LSB init scripts and works as a replacement for sysvinit. -->
-<!-- Other parts include a logging daemon, utilities to control basic system configuration like the hostname, date, locale, maintain a list of logged-in users and running containers and virtual machines, system accounts, runtime directories and settings, and daemons to manage simple network configuration, network time synchronization, log forwarding, and name resolution. -->
----
-To run a Bun application as a daemon using **systemd** you'll need to create a _service file_ in `/lib/systemd/system/`.
-```sh
-$ cd /lib/systemd/system
-$ touch my-app.service
-```
----
-Here is a typical service file that runs an application on system start. You can use this as a template for your own service. Replace `YOUR_USER` with the name of the user you want to run the application as. To run as `root`, replace `YOUR_USER` with `root`, though this is generally not recommended for security reasons.
-Refer to the [systemd documentation](https://www.freedesktop.org/software/systemd/man/systemd.service.html) for more information on each setting.
-```ini#my-app.service
-[Unit]
-# describe the app
-Description=My App
-# start the app after the network is available
-After=network.target
-[Service]
-# usually you'll use 'simple'
-# one of https://www.freedesktop.org/software/systemd/man/systemd.service.html#Type=
-Type=simple
-# which user to use when starting the app
-User=YOUR_USER
-# path to your application's root directory
-WorkingDirectory=/home/YOUR_USER/path/to/my-app
-# the command to start the app
-# requires absolute paths
-ExecStart=/home/YOUR_USER/.bun/bin/bun run index.ts
-# restart policy
-# one of {no|on-success|on-failure|on-abnormal|on-watchdog|on-abort|always}
-Restart=always
-[Install]
-# start the app automatically
-WantedBy=multi-user.target
-```
----
-If your application starts a webserver, note that non-`root` users are not able to listen on ports 80 or 443 by default. To permanently allow Bun to listen on these ports when executed by a non-`root` user, use the following command. This step isn't necessary when running as `root`.
-```bash
-$ sudo setcap CAP_NET_BIND_SERVICE=+eip ~/.bun/bin/bun
-```
----
-With the service file configured, you can now _enable_ the service. Once enabled, it will start automatically on reboot. This requires `sudo` permissions.
-```bash
-$ sudo systemctl enable my-app
-```
----
-To start the service without rebooting, you can manually _start_ it.
-```bash
-$ sudo systemctl start my-app
-```
----
-Check the status of your application with `systemctl status`. If you've started your app successfully, you should see something like this:
-```bash
-$ sudo systemctl status my-app
-● my-app.service - My App
-     Loaded: loaded (/lib/systemd/system/my-app.service; enabled; preset: enabled)
-     Active: active (running) since Thu 2023-10-12 11:34:08 UTC; 1h 8min ago
-   Main PID: 309641 (bun)
-      Tasks: 3 (limit: 503)
-     Memory: 40.9M
-        CPU: 1.093s
-     CGroup: /system.slice/my-app.service
-             └─309641 /home/YOUR_USER/.bun/bin/bun run /home/YOUR_USER/application/index.ts
-```
----
-To update the service, edit the contents of the service file, then reload the daemon.
-```bash
-$ sudo systemctl daemon-reload
-```
----
-For a complete guide on the service unit configuration, you can check [this page](https://www.freedesktop.org/software/systemd/man/systemd.service.html). Or refer to this cheatsheet of common commands:
-```bash
-$ sudo systemctl daemon-reload # tell systemd that some files got changed
-$ sudo systemctl enable my-app # enable the app (to allow auto-start)
-$ sudo systemctl disable my-app # disable the app (turns off auto-start)
-$ sudo systemctl start my-app # start the app if is stopped
-$ sudo systemctl stop my-app # stop the app
-$ sudo systemctl restart my-app # restart the app
-```

package/docs/guides/ecosystem/vite.md DELETED Viewed

@@ -1,71 +0,0 @@
----
-name: Build a frontend using Vite and Bun
----
-{% callout %}
-You can use Vite with Bun, but many projects get faster builds & drop hundreds of dependencies by switching to [HTML imports](/docs/bundler/html).
-{% /callout %}
----
-Vite works out of the box with Bun. Get started with one of Vite's templates.
-```bash
-$ bun create vite my-app
-✔ Select a framework: › React
-✔ Select a variant: › TypeScript + SWC
-Scaffolding project in /path/to/my-app...
-```
----
-Then `cd` into the project directory and install dependencies.
-```bash
-cd my-app
-bun install
-```
----
-Start the development server with the `vite` CLI using `bunx`.
-The `--bun` flag tells Bun to run Vite's CLI using `bun` instead of `node`; by default Bun respects Vite's `#!/usr/bin/env node` [shebang line](<https://en.wikipedia.org/wiki/Shebang_(Unix)>).
-```bash
-bunx --bun vite
-```
----
-To simplify this command, update the `"dev"` script in `package.json` to the following.
-```json-diff#package.json
-  "scripts": {
--   "dev": "vite",
-+   "dev": "bunx --bun vite",
-    "build": "vite build",
-    "serve": "vite preview"
-  },
-  // ...
-```
----
-Now you can start the development server with `bun run dev`.
-```bash
-bun run dev
-```
----
-The following command will build your app for production.
-```sh
-$ bunx --bun vite build
-```
----
-This is a stripped down guide to get you started with Vite + Bun. For more information, see the [Vite documentation](https://vitejs.dev/guide/).

package/docs/guides/html-rewriter/extract-links.md DELETED Viewed

@@ -1,68 +0,0 @@
----
-name: Extract links from a webpage using HTMLRewriter
----
-## Extract links from a webpage
-Bun's [HTMLRewriter](https://bun.com/docs/api/html-rewriter) API can be used to efficiently extract links from HTML content. It works by chaining together CSS selectors to match the elements, text, and attributes you want to process. This is a simple example of how to extract links from a webpage. You can pass `.transform` a `Response`, `Blob`, or `string`.
-```ts
-async function extractLinks(url: string) {
-  const links = new Set<string>();
-  const response = await fetch(url);
-  const rewriter = new HTMLRewriter().on("a[href]", {
-    element(el) {
-      const href = el.getAttribute("href");
-      if (href) {
-        links.add(href);
-      }
-    },
-  });
-  // Wait for the response to be processed
-  await rewriter.transform(response).blob();
-  console.log([...links]); // ["https://bun.com", "/docs", ...]
-}
-// Extract all links from the Bun website
-await extractLinks("https://bun.com");
-```
----
-## Convert relative URLs to absolute
-When scraping websites, you often want to convert relative URLs (like `/docs`) to absolute URLs. Here's how to handle URL resolution:
-```ts
-async function extractLinksFromURL(url: string) {
-  const response = await fetch(url);
-  const links = new Set<string>();
-  const rewriter = new HTMLRewriter().on("a[href]", {
-    element(el) {
-      const href = el.getAttribute("href");
-      if (href) {
-        // Convert relative URLs to absolute
-        try {
-          const absoluteURL = new URL(href, url).href;
-          links.add(absoluteURL);
-        } catch {
-          links.add(href);
-        }
-      }
-    },
-  });
-  // Wait for the response to be processed
-  await rewriter.transform(response).blob();
-  return [...links];
-}
-const websiteLinks = await extractLinksFromURL("https://example.com");
-```
----
-See [Docs > API > HTMLRewriter](https://bun.com/docs/api/html-rewriter) for complete documentation on HTML transformation with Bun.

package/docs/guides/html-rewriter/extract-social-meta.md DELETED Viewed

@@ -1,93 +0,0 @@
----
-name: Extract social share images and Open Graph tags
----
-## Extract social share images and Open Graph tags
-Bun's [HTMLRewriter](https://bun.com/docs/api/html-rewriter) API can be used to efficiently extract social share images and Open Graph metadata from HTML content. This is particularly useful for building link preview features, social media cards, or web scrapers. We can use HTMLRewriter to match CSS selectors to HTML elements, text, and attributes we want to process.
-```ts
-interface SocialMetadata {
-  title?: string;
-  description?: string;
-  image?: string;
-  url?: string;
-  siteName?: string;
-  type?: string;
-}
-async function extractSocialMetadata(url: string): Promise<SocialMetadata> {
-  const metadata: SocialMetadata = {};
-  const response = await fetch(url);
-  const rewriter = new HTMLRewriter()
-    // Extract Open Graph meta tags
-    .on('meta[property^="og:"]', {
-      element(el) {
-        const property = el.getAttribute("property");
-        const content = el.getAttribute("content");
-        if (property && content) {
-          // Convert "og:image" to "image" etc.
-          const key = property.replace("og:", "") as keyof SocialMetadata;
-          metadata[key] = content;
-        }
-      },
-    })
-    // Extract Twitter Card meta tags as fallback
-    .on('meta[name^="twitter:"]', {
-      element(el) {
-        const name = el.getAttribute("name");
-        const content = el.getAttribute("content");
-        if (name && content) {
-          const key = name.replace("twitter:", "") as keyof SocialMetadata;
-          // Only use Twitter Card data if we don't have OG data
-          if (!metadata[key]) {
-            metadata[key] = content;
-          }
-        }
-      },
-    })
-    // Fallback to regular meta tags
-    .on('meta[name="description"]', {
-      element(el) {
-        const content = el.getAttribute("content");
-        if (content && !metadata.description) {
-          metadata.description = content;
-        }
-      },
-    })
-    // Fallback to title tag
-    .on("title", {
-      text(text) {
-        if (!metadata.title) {
-          metadata.title = text.text;
-        }
-      },
-    });
-  // Process the response
-  await rewriter.transform(response).blob();
-  // Convert relative image URLs to absolute
-  if (metadata.image && !metadata.image.startsWith("http")) {
-    try {
-      metadata.image = new URL(metadata.image, url).href;
-    } catch {
-      // Keep the original URL if parsing fails
-    }
-  }
-  return metadata;
-}
-// Example usage
-const metadata = await extractSocialMetadata("https://bun.com");
-console.log(metadata);
-// {
-//   title: "Bun — A fast all-in-one JavaScript runtime",
-//   description: "Bundle, transpile, install and run JavaScript & TypeScript projects — all in Bun. Bun is a fast all-in-one JavaScript runtime & toolkit designed for speed, complete with a bundler, test runner, and Node.js-compatible package manager.",
-//   image: "https://bun.com/share.jpg",
-//   type: "website",
-//   ...
-// }
-```