# Change Log

- **Last updated**: 2026-07-02T14:22:51Z
- **Generator**: [thi.ng/monopub](https://thi.ng/monopub)

All notable changes to this project will be documented in this file.
Only versions published since **2023-01-01** are listed here.
Please consult the Git history for older version information.
See [Conventional Commits](https://conventionalcommits.org/) for commit guidelines.

**Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
and/or version bumps of transitive dependencies.

## [2.3.0](https://codeberg.org/thi.ng/umbrella/src/tag/@thi.ng/file-io@2.3.0/packages/file-io) (2026-06-05)

#### 🚀 Features

- add `readJSONC()`/`readJSONCAsync()` ([c7edf9a](https://codeberg.org/thi.ng/umbrella/commit/c7edf9a))

### [2.2.20](https://codeberg.org/thi.ng/umbrella/src/tag/@thi.ng/file-io@2.2.20/packages/file-io) (2025-12-03)

#### ♻️ Refactoring

- update for-loops (use const where possible) ([5ceaf1a](https://codeberg.org/thi.ng/umbrella/commit/5ceaf1a))

## [2.2.0](https://codeberg.org/thi.ng/umbrella/src/tag/@thi.ng/file-io@2.2.0/packages/file-io) (2025-07-03)

#### 🚀 Features

- add makedPath() and mask registry fns ([74796f8](https://codeberg.org/thi.ng/umbrella/commit/74796f8))
- add copyFile() fns (incl. async version) ([19ad5f3](https://codeberg.org/thi.ng/umbrella/commit/19ad5f3))
- update logging calls to use masked paths only ([c25a2cb](https://codeberg.org/thi.ng/umbrella/commit/c25a2cb))
- add async versions of various file fns ([eff47b7](https://codeberg.org/thi.ng/umbrella/commit/eff47b7))
- add deleteFiles() and async versions ([1185911](https://codeberg.org/thi.ng/umbrella/commit/1185911))

### [2.1.21](https://codeberg.org/thi.ng/umbrella/src/tag/@thi.ng/file-io@2.1.21/packages/file-io) (2025-01-14)

#### ♻️ Refactoring

- use optional chaining & nullish coalescing ([c5a0a13](https://codeberg.org/thi.ng/umbrella/commit/c5a0a13))

## [2.1.0](https://codeberg.org/thi.ng/umbrella/src/tag/@thi.ng/file-io@2.1.0/packages/file-io) (2024-04-23)

#### 🚀 Features

- add deleteDir() ([06b4ffc](https://codeberg.org/thi.ng/umbrella/commit/06b4ffc))

### [2.0.3](https://codeberg.org/thi.ng/umbrella/src/tag/@thi.ng/file-io@2.0.3/packages/file-io) (2024-04-20)

#### ♻️ Refactoring

- update type usage ([7dc9551](https://codeberg.org/thi.ng/umbrella/commit/7dc9551))

# [2.0.0](https://codeberg.org/thi.ng/umbrella/src/tag/@thi.ng/file-io@2.0.0/packages/file-io) (2024-03-29)

#### 🛑 Breaking changes

- add `streamHash()`, update other hashing fns ([64a8cad](https://codeberg.org/thi.ng/umbrella/commit/64a8cad))
- BREAKING CHANGE: `fileHash()` now async, rename `stringHash()` => `bufferHash()`

#### 🚀 Features

- update args for `createTempFile()` & `tempFilePath()` ([d944789](https://codeberg.org/thi.ng/umbrella/commit/d944789))
  - add docstrings

### [1.3.3](https://codeberg.org/thi.ng/umbrella/src/tag/@thi.ng/file-io@1.3.3/packages/file-io) (2024-02-22)

#### ♻️ Refactoring

- update object destructuring in all pkgs & examples ([f36aeb0](https://codeberg.org/thi.ng/umbrella/commit/f36aeb0))

### [1.3.2](https://codeberg.org/thi.ng/umbrella/src/tag/@thi.ng/file-io@1.3.2/packages/file-io) (2024-02-22)

#### ♻️ Refactoring

- update all `node:*` imports ([c71a526](https://codeberg.org/thi.ng/umbrella/commit/c71a526))

## [1.3.0](https://codeberg.org/thi.ng/umbrella/src/tag/@thi.ng/file-io@1.3.0/packages/file-io) (2024-02-19)

#### 🚀 Features

- add ensureDir() ([8ca3085](https://codeberg.org/thi.ng/umbrella/commit/8ca3085))

## [1.2.0](https://codeberg.org/thi.ng/umbrella/src/tag/@thi.ng/file-io@1.2.0/packages/file-io) (2024-01-26)

#### 🚀 Features

- add fileWatcher() ([71c1d8f](https://codeberg.org/thi.ng/umbrella/commit/71c1d8f))

#### ♻️ Refactoring

- migrate internal predicates ([52c985a](https://codeberg.org/thi.ng/umbrella/commit/52c985a))

## [1.1.0](https://codeberg.org/thi.ng/umbrella/src/tag/@thi.ng/file-io@1.1.0/packages/file-io) (2023-12-18)

#### 🚀 Features

- add generics for readJSON() ([34bdfc8](https://codeberg.org/thi.ng/umbrella/commit/34bdfc8))

# [1.0.0](https://codeberg.org/thi.ng/umbrella/src/tag/@thi.ng/file-io@1.0.0/packages/file-io) (2023-11-09)

#### 🛑 Breaking changes

- update matching logic for files()/dirs() ([8f275b5](https://codeberg.org/thi.ng/umbrella/commit/8f275b5))
- BREAKING CHANGE: files()/dirs() matchers use full relative sub-path
  - add support for arbitrary predicate fns as matcher

#### ♻️ Refactoring

- update all tests (packages A-S) ([e3085e4](https://codeberg.org/thi.ng/umbrella/commit/e3085e4))

#### 🧪 Tests

- update/refactor tests to use bun test runner ([8f6edb1](https://codeberg.org/thi.ng/umbrella/commit/8f6edb1))
- update/rename test files/imports (still many broken) ([1cb3c49](https://codeberg.org/thi.ng/umbrella/commit/1cb3c49))

## [0.5.0](https://codeberg.org/thi.ng/umbrella/src/tag/@thi.ng/file-io@0.5.0/packages/file-io) (2023-02-05)

#### 🚀 Features

- add fileChunks() ([bcff691](https://codeberg.org/thi.ng/umbrella/commit/bcff691))

## [0.4.0](https://codeberg.org/thi.ng/umbrella/src/tag/@thi.ng/file-io@0.4.0/packages/file-io) (2023-01-10)

#### 🚀 Features

- add readText() encoding opts ([22366c0](https://codeberg.org/thi.ng/umbrella/commit/22366c0))
- add readBinary(), update pkg exports ([2c647ed](https://codeberg.org/thi.ng/umbrella/commit/2c647ed))