# @chunkd/fs-aws

> File system abstraction for AWS S3 using `@aws-sdk/client-s3`

Latest version **11.6.2** (published 2026-05-23) · MIT license · 0 weekly downloads

## Install

```sh
npm install @chunkd/fs-aws
pnpm add @chunkd/fs-aws
yarn add @chunkd/fs-aws
bun add @chunkd/fs-aws
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 11.6.2 |
| Published | 2026-05-23 |
| First published | 2023-07-20 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=16.0.0 |
| Dependencies | 5 |
| Unpacked size | 71.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 8 |
| Author | Blayne Chard |
| Maintainers | blacha |

## Links

- npm: https://www.npmjs.com/package/@chunkd/fs-aws
- Repository: https://github.com/blacha/chunkd
- Homepage: https://github.com/blacha/chunkd#readme
- Issues: https://github.com/blacha/chunkd/issues
- npm.io page: https://npm.io/package/@chunkd/fs-aws

## Dependencies (5)

- [@chunkd/fs](https://npm.io/package/@chunkd/fs.md) 11.5.2
- [@aws-sdk/client-s3](https://npm.io/package/@aws-sdk/client-s3.md) *
- [@chunkd/source-aws](https://npm.io/package/@chunkd/source-aws.md) 11.2.1
- [@aws-sdk/lib-storage](https://npm.io/package/@aws-sdk/lib-storage.md) *
- [@aws-sdk/credential-providers](https://npm.io/package/@aws-sdk/credential-providers.md) *

## Recent versions

- 11.6.2 (latest) — 2026-05-23
- 11.6.1 — 2026-04-08
- 11.6.0 — 2026-03-26
- 11.5.0 — 2026-03-24
- 11.4.2 — 2026-03-03
- 11.4.1 — 2026-01-29
- 11.4.0 — 2025-07-17
- 11.3.0 — 2024-11-04
- 11.2.2 — 2024-02-20
- 11.2.1 — 2023-11-08
- 11.2.0 — 2023-09-07
- 11.1.0 — 2023-08-23
- 11.0.2 — 2023-08-02
- 11.0.1 — 2023-07-26
- 11.0.0 — 2023-07-20

## README

# @chunkd/fs-aws

File system abstraction for AWS S3 using `@aws-sdk/client-s3`

see [@chunkd/fs](../fs/README.md) for more usage

## Usage

```javascript
import { FsAwsS3 } from '@chunkd/fs-aws';
import S3Client from '@aws-sdk/clients-s3';

const fsS3 = new FsAwsS3(new S3Client());

// Read in the first 1KB of data

for await (const url of fsS3.list(new URL("s3://foo/bar/baz")) {
    // files
}

// Stream a file from one bucket to another
await fsS3.write(new URL("s3://foo/bar/baz.txt"), fsS3.readStream(new URL("s3://bar/baz.txt")))
```

---
_Source: https://npm.io/package/@chunkd/fs-aws · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._