# fs-aux

> A minimalistic augmentation of the native fs/promises API

Latest version **0.2.0** (published 2026-01-07) · MIT license · 0 weekly downloads

## Install

```sh
npm install fs-aux
pnpm add fs-aux
yarn add fs-aux
bun add fs-aux
```

## Health

**Score 60/100 (C)** — status: stable.

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

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.2.0 |
| Published | 2026-01-07 |
| First published | 2022-01-22 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=16.0.0 |
| Dependencies | 2 |
| Unpacked size | 9.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Jeremy Chone |
| Maintainers | jeremychone |
| Keywords | fs, file, fs-extra, list files, watch |

## Links

- npm: https://www.npmjs.com/package/fs-aux
- Repository: https://github.com/BriteSnow/node-fs-aux
- Homepage: https://github.com/BriteSnow/node-fs-aux#readme
- Issues: https://github.com/BriteSnow/node-fs-aux/issues
- npm.io page: https://npm.io/package/fs-aux

## Dependencies (2)

- [rimraf](https://npm.io/package/rimraf.md) ^6.1.2
- [fast-glob](https://npm.io/package/fast-glob.md) ^3.3.3

## Alternatives

- [unionfs](https://npm.io/package/unionfs.md) — 2.2M weekly downloads
- [path-starts-with](https://npm.io/package/path-starts-with.md) — 35.9K weekly downloads
- [redzip](https://npm.io/package/redzip.md) — 1.2K weekly downloads
- [vscode-anymatch](https://npm.io/package/vscode-anymatch.md) — 848 weekly downloads
- [@ledgerhq/coin-filecoin](https://npm.io/package/@ledgerhq/coin-filecoin.md) — 793 weekly downloads

## Recent versions

- 0.2.0 (latest) — 2026-01-07
- 0.1.1 — 2022-09-04
- 0.1.0 — 2022-01-22

## README

**fs-aux** is a minimalistic modern fs API extension, not a drop-in, just very few extra "missing" functions. 

- Does not monkey-patch anything
- Uses native `fs/promises` (with the ups and the downs)
- Only async functions
- Uses `fast-glob` for glob
- ESM only

##  API

```ts 
import { saferRemove, glob, pathExists} from 'fs-aux';

// Will use fast-glob and then sort file paths 
let tsFiles = await glob('src/**/*.ts');

// Will remove only if child of ./ (by default) or throw error
await saferRemove('dist/');

// Will test if path "exists" (use fs/promises access and map try/catch to boolean
let distExists = await pathExists('dist/')
```

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