# @alchemy.run/node-utils > Runtime utilities for Alchemy packages. Latest version **2.0.0-beta.80** (published 2026-10-02) · Apache-2.0 license · 0 weekly downloads ## Install ```sh npm install @alchemy.run/node-utils pnpm add @alchemy.run/node-utils yarn add @alchemy.run/node-utils bun add @alchemy.run/node-utils ``` ## Health **Score 65/100 (B)** — status: active. Positive: esm support; no vulnerabilities; has provenance; recently updated; high maintenance score. Warnings: low downloads; no types. ## Facts | | | |---|---| | Version | 2.0.0-beta.80 | | Published | 2026-10-02 | | First published | 2026-05-15 | | Weekly downloads | 0 | | License | Apache-2.0 | | TypeScript types | none | | Module format | ESM | | Dependencies | 2 | | Unpacked size | 214 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Provenance | attested (GitHub Actions) | | GitHub stars | 1344 | | Author | Sam Goodwin | | Maintainers | pear-alchemy, blankparticle, sam-goodwin | | Keywords | alchemy, gitignore, node, utilities | ## Links - npm: https://www.npmjs.com/package/@alchemy.run/node-utils - Repository: https://github.com/alchemy-run/alchemy - Homepage: https://alchemy.run - Issues: https://github.com/alchemy-run/alchemy/issues - npm.io page: https://npm.io/package/@alchemy.run/node-utils ## Dependencies (2) - [chokidar](https://npm.io/package/chokidar.md) ^5.0.0 - [rolldown](https://npm.io/package/rolldown.md) 1.2.5 ## Alternatives - [@expo/fingerprint](https://npm.io/package/@expo/fingerprint.md) — 6.2M weekly downloads - [@azure/monitor-opentelemetry-exporter](https://npm.io/package/@azure/monitor-opentelemetry-exporter.md) — 850.0K weekly downloads - [@azure/monitor-opentelemetry](https://npm.io/package/@azure/monitor-opentelemetry.md) — 624.0K weekly downloads - [@posthog/ai](https://npm.io/package/@posthog/ai.md) — 423.3K weekly downloads - [fakefilter](https://npm.io/package/fakefilter.md) — 63.9K weekly downloads ## Recent versions - 2.0.0-beta.80 (latest) — 2026-10-02 - 2.0.0-beta.79 — 2026-09-18 - 2.0.0-beta.78 — 2026-09-17 - 2.0.0-beta.77 — 2026-09-09 - 2.0.0-beta.76 — 2026-08-31 - 2.0.0-beta.75 — 2026-08-30 - 2.0.0-beta.74 — 2026-08-21 - 2.0.0-beta.73 — 2026-08-21 - 2.0.0-beta.72 — 2026-08-21 - 0.0.5 — 2026-06-05 - 0.0.4 — 2026-05-22 - 0.0.3 — 2026-05-21 - 0.0.2 — 2026-05-15 - 0.0.1 — 2026-05-15 - 0.0.0 — 2026-05-15 ## README
Alchemy — Infrastructure as Effects
[![npm](https://img.shields.io/npm/v/alchemy?style=flat-square&color=3f5a2a&label=alchemy)](https://www.npmjs.com/package/alchemy) [![license](https://img.shields.io/badge/license-Apache%202.0-3f5a2a?style=flat-square)](./LICENSE) [![discord](https://img.shields.io/badge/discord-join-3f5a2a?style=flat-square&logo=discord&logoColor=white)](https://alchemy.run/discord) **Infrastructure-as-Effects** — cloud infrastructure and application logic as a single, type-safe [Effect](https://effect.website) program. [Docs](https://alchemy.run) · [Tutorial](https://alchemy.run/tutorial/part-1) · [Examples](./examples) · [Discord](https://alchemy.run/discord)
--- A Worker bound to a R2 bucket and serving objects from it: ```typescript const Bucket = Cloudflare.R2.Bucket("bucket"); export default Cloudflare.Worker( "api", { main: import.meta.url }, Effect.gen(function* () { const bucket = yield* Cloudflare.R2.ReadWriteBucket(Bucket); return { fetch: Effect.gen(function* () { const request = yield* HttpServerRequest; const object = yield* bucket.get(request.url); return HttpServerResponse.stream(object!.body); }) }; }).pipe(Effect.provide(Cloudflare.R2.ReadWriteBucketBinding)), ); ``` One `ReadWriteBucket(Bucket)` call wires the binding, env var, and typed client — at deploy time and at runtime. --- - **One program, one language.** Resources, Lambdas/Workers, IAM, and SDKs live in the same Effect program — no YAML, no second runtime. - **Bindings, not glue code.** `S3.GetObject(bucket)` wires the IAM policy, env var, and a typed SDK call in a single line. - **Errors in the type system.** Every cloud API failure is a tagged Effect error you handle — or don't — on purpose. - **AWS + Cloudflare today.** S3, SQS, DynamoDB, Kinesis, Lambda, EC2 / Workers, R2, D1, Durable Objects, Containers. - **Same code, every stage.** Local dev, `plan` / `deploy`, smoke tests, and CI all share one mental model. ```sh bun add alchemy@latest effect@rc ``` ## GitHub Action Use the root action to deploy `prod` from `main`, deploy PR previews as `staging-{number}`, and destroy PR previews when the PR closes: ```yaml - uses: alchemy-run/alchemy@v1 env: CLOUDFLARE_ACCOUNT_ID: ${{ vars.CLOUDFLARE_ACCOUNT_ID }} CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }} GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} ``` The workflow must install the `alchemy` CLI before this action runs. ## Bootstrap with an AI coding agent Paste this into Claude Code, Cursor, or any agent that can fetch a URL: ``` You are an Alchemy expert. Read https://alchemy.run/llms.txt to load the full documentation index, then act as my pair on this project. Goal: help me set up, build, test, and deploy a cloud application with `alchemy` (Infrastructure-as-Effects, powered by Effect). Follow the patterns from the docs and the /examples folder. Stay idiomatic to Effect: use Layers for wiring, return Effects from lifecycle code, and keep infra and runtime in the same program. Ask before introducing new dependencies or breaking conventions. ``` ## Learn more - [What is Alchemy?](https://alchemy.run/what-is-alchemy) — the framework in 2 minutes - [Getting Started](https://alchemy.run/getting-started) — your first Stack - [Tutorial](https://alchemy.run/tutorial/part-1) — five-part walkthrough to a tested, CI-deployed app - [Examples](./examples) — runnable projects on AWS and Cloudflare - [llms.txt](https://alchemy.run/llms.txt) — agent-ready documentation index > **alchemy** is in alpha. Expect breaking changes. Come hang in our [Discord](https://alchemy.run/discord). ## Credits ### Blacksmith Thanks to [Blacksmith](https://blacksmith.sh/?ref=alchemy.run) for sponsoring our CI runners. Their fast Linux, macOS, and Windows runners help us test our packages across platforms and deploy our content-heavy website in mere minutes. ## License Licensed under the [Apache License 2.0](./LICENSE). See [Third-Party Licenses](./THIRD_PARTY_LICENSES.md) for code incorporated from upstream projects. --- _Source: https://npm.io/package/@alchemy.run/node-utils · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._