# @alanscodelog/utils

> My utility functions and typescript types.

Latest version **6.6.1** (published 2026-08-07) · MIT license · 0 weekly downloads

## Install

```sh
npm install @alanscodelog/utils
pnpm add @alanscodelog/utils
yarn add @alanscodelog/utils
bun add @alanscodelog/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 | 6.6.1 |
| Published | 2026-08-07 |
| First published | 2020-06-06 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | >=20.0.0 |
| Dependencies | 0 |
| Unpacked size | 258.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 0 |
| Author | Alan <alanscodelog@gmail.com> |
| Maintainers | alanscodelog |

## Links

- npm: https://www.npmjs.com/package/@alanscodelog/utils
- Repository: https://github.com/alanscodelog/utils
- npm.io page: https://npm.io/package/@alanscodelog/utils

## Recent versions

- 6.6.1 (latest) — 2026-08-07
- 6.0.0-beta.1 (beta) — 2025-07-26
- 6.6.0 — 2026-07-22
- 6.5.0 — 2026-07-07
- 6.4.0 — 2026-06-17
- 6.3.1 — 2026-06-13
- 6.3.0 — 2026-06-13
- 6.2.1 — 2026-06-02
- 6.2.0 — 2026-03-25
- 6.1.0 — 2026-03-14
- 6.0.2 — 2025-09-17
- 6.0.1 — 2025-08-27
- 6.0.0 — 2025-08-27
- 5.2.1 — 2025-07-27
- 5.2.0 — 2025-07-26
- … 44 more at https://npm.io/package/@alanscodelog/utils/versions

## README

[![Docs][docs-src]][docs-href]
[![Release][release-src]][release-href]
[![npm version][npm-version-src]][npm-version-href]
[![npm version (beta)][npm-version-beta-src]][npm-version-beta-href]
[![License][license-src]][license-href]

A collection of my utility functions and types. Mostly intended for use within my own projects to avoid having to depend on third party libraries.

Contains:
- Base utility functions (is*) for checking simple types and making code more readable.
- String utilities (pretty, crop, indent, readable, etc.) which I use a lot to format nice errors.
- Useful functions for prototyping, quick scripts, etc (run, RingBuffer, browserSaveFile, generateCopyRightNotice).
- Common utilities like debounce, throttle, etc. + some slighly novel onces like multisplice, changeObjectKeys, etc.

I try to keep the utilities simple, fast, and easy to maintain. Where type checks are enough, no runtime checks are done. I only include utilities and options I find myself using 3+ times, not every variation under the sun just because it looks useful and I might need it. If I find myself not using or replacing a function it will be removed.

Rarely used edge cases will not be covered (e.g. `walk` only walks simple objects/arrays, and does not handle cyclic objects).

Most utilities use mutability but can be made to work immutably if needed.

# [Docs](https://alanscodelog.github.io/utils)

# Install

```bash
npm install @alanscodelog/utils
```

# Usage

The utility functions are all available as a subpath exports from the root of the package. Note that some are node only, and also some contain additional type exports (these can also be imported from the root or from `/types` as well).

```ts
// recommended import styles
import { keys } from "@alanscodelog/utils/keys"
import { debounce, Debounced } from "@alanscodelog/utils/debounce" 
import type { Debounced } from "@alanscodelog/utils/types"
import type { Debounced } from "@alanscodelog/utils"

// convenience import styles, not recommended, see why below
import { keys } from "@alanscodelog/utils"
import { run } from "@alanscodelog/utils/node"

// convenience import style for testing, this is usually fine
import { inspectError } from "@alanscodelog/utils/testing"
```

The following subpath exports are available for convenience:

- `/utils` - all non-node and non-testing utility functions
- `/node` - node only utility functions
- `/testing` - functions that are only useful for testing purposes
- `/types` - all the types used internally + any utility types

*Note that while convenient, they should be avoided in most situations.* Although the package is tree-shakeable, if using vite, for example, it's dev server does not tree-shake the imports from index files that re-export functions. This means importing from index files (i.e. the convenience subpath exports) slows things down.

Some utility functions are browser only, but they are included with the regular functions since they'll just throw when you try to use them (they should not cause errors when just getting imported).

<!-- Badges -->
[docs-src]: https://github.com/alanscodelog/utils/actions/workflows/docs.yml/badge.svg
[docs-href]: https://github.com/alanscodelog/utils/actions/workflows/docs.yml
[release-src]: https://github.com/alanscodelog/utils/actions/workflows/release.yml/badge.svg
[release-href]: https://github.com/alanscodelog/utils/actions/workflows/release.yml
[npm-version-src]: https://img.shields.io/npm/v/@alanscodelog/utils/latest
[npm-version-href]: https://www.npmjs.com/package/@alanscodelog/utils/v/latest
[npm-version-beta-src]: https://img.shields.io/npm/v/@alanscodelog/utils/beta
[npm-version-beta-href]: https://www.npmjs.com/package/@alanscodelog/utils/v/beta
[license-src]: https://img.shields.io/npm/l/@alanscodelog/utils.svg?style=flat&colorA=020420&colorB=00DC82
[license-href]: https://npmjs.com/package/@alanscodelog/utils

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