# @verdaccio/core

> Verdaccio Core Components

Latest version **8.3.0** (published 2026-08-26) · MIT license · 0 weekly downloads

## Install

```sh
npm install @verdaccio/core
pnpm add @verdaccio/core
yarn add @verdaccio/core
bun add @verdaccio/core
```

## Health

**Score 80/100 (A)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score; popular repo.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 8.3.0 |
| Published | 2026-08-26 |
| First published | 2021-09-08 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=22 |
| Dependencies | 7 |
| Unpacked size | 241.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 17880 |
| Author | Juan Picado <juanpicado19@gmail.com> |
| Maintainers | sergiohgz, verdaccio.npm, jotadeveloper, verdacciopack |
| Keywords | enterprise, modules, package, private, proxy, registry, repository, server, verdaccio |

## Links

- npm: https://www.npmjs.com/package/@verdaccio/core
- Repository: https://github.com/verdaccio/verdaccio
- Homepage: https://verdaccio.org
- Issues: https://github.com/verdaccio/verdaccio/issues
- Funding: https://opencollective.com/verdaccio
- npm.io page: https://npm.io/package/@verdaccio/core

## Dependencies (7)

- [ajv](https://npm.io/package/ajv.md) 8.20.0
- [lodash](https://npm.io/package/lodash.md) 4.18.1
- [semver](https://npm.io/package/semver.md) 7.8.5
- [minimatch](https://npm.io/package/minimatch.md) 10.2.6
- [http-errors](https://npm.io/package/http-errors.md) 2.0.1
- [process-warning](https://npm.io/package/process-warning.md) 1.0.0
- [http-status-codes](https://npm.io/package/http-status-codes.md) 2.3.0

## Recent versions

- 8.3.0 (latest) — 2026-08-26
- 9.0.0-next-9.31 (next-9) — 2026-09-04
- 8.0.0-next-8.38 (next-8) — 2026-04-12
- 7.0.0-next-7.20 (next-7) — 2024-08-01
- 7.0.0-next.6 (next) — 2024-01-07
- 6.0.0-6-next.1 (6-next) — 2021-09-08
- 9.0.0-next-9.30 — 2026-08-30
- 9.0.0-next-9.29 — 2026-08-30
- 9.0.0-next-9.28 — 2026-08-26
- 9.0.0-next-9.27 — 2026-08-20
- 9.0.0-next-9.26 — 2026-08-17
- 8.2.2 — 2026-08-17
- 9.0.0-next-9.25 — 2026-08-16
- 9.0.0-next-9.24 — 2026-08-02
- 9.0.0-next-9.23 — 2026-08-02
- … 125 more at https://npm.io/package/@verdaccio/core/versions

## README

# @verdaccio/core - Verdaccio Core Components

[![Verdaccio Home](https://img.shields.io/badge/Homepage-Verdaccio-405236?style=flat)](https://verdaccio.org)
[![MIT License](https://img.shields.io/github/license/verdaccio/verdaccio?label=License&color=405236)](https://github.com/verdaccio/verdaccio/blob/master/LICENSE)
[![Verdaccio Latest](https://img.shields.io/npm/v/verdaccio?label=Latest%20Version&color=405236)](https://github.com/verdaccio/verdaccio)
[![This Package Latest](https://img.shields.io/npm/v/@verdaccio/core?label=@verdaccio/core&color=405236)](https://npmjs.com/package/@verdaccio/core)

[![Documentation](https://img.shields.io/badge/Help-Verdaccio?style=flat&logo=Verdaccio&label=Verdaccio&color=cd4000)](https://verdaccio.org/docs)
[![Discord](https://img.shields.io/badge/Chat-Discord?style=flat&logo=Discord&label=Discord&color=cd4000)](https://discord.com/channels/388674437219745793)
[![Bluesky](https://img.shields.io/badge/Follow-Bluesky?style=flat&logo=Bluesky&label=Bluesky&color=cd4000)](https://bsky.app/profile/verdaccio.org)
[![Backers](https://img.shields.io/opencollective/backers/verdaccio?style=flat&logo=opencollective&label=Join%20Backers&color=cd4000)](https://opencollective.com/verdaccio/contribute)
[![Sponsors](https://img.shields.io/opencollective/sponsors/verdaccio?style=flat&logo=opencollective&label=Sponsor%20Us&color=cd4000)](https://opencollective.com/verdaccio/contribute)

[![Verdaccio Downloads](https://img.shields.io/npm/dm/verdaccio?style=flat&logo=npm&label=Npm%20Downloads&color=lightgrey)](https://www.npmjs.com/package/verdaccio)
[![Docker Pulls](https://img.shields.io/docker/pulls/verdaccio/verdaccio?style=flat&logo=docker&label=Docker%20Pulls&color=lightgrey)](https://hub.docker.com/r/verdaccio/verdaccio)
[![GitHub Stars](https://img.shields.io/github/stars/verdaccio?style=flat&logo=github&label=GitHub%20Stars%20%E2%AD%90&color=lightgrey)](https://github.com/verdaccio/verdaccio/stargazers)

> **Note:** This package is mostly for internal use by Verdaccio and is only intended to be used with Verdaccio 6.x.

## Overview

The `@verdaccio/core` package provides the foundational constants, error utilities, and shared modules used throughout the Verdaccio ecosystem. It serves as the base dependency for most other Verdaccio packages.

## Installation

```bash
npm install @verdaccio/core
```

## Usage

```typescript
import {
  API_ERROR,
  DIST_TAGS,
  HEADERS,
  HTTP_STATUS,
  constants,
  errorUtils,
  validationUtils,
} from '@verdaccio/core';
```

### Constants

- **`HTTP_STATUS`** - HTTP status code constants
- **`API_ERROR`** - API error message constants
- **`API_MESSAGE`** - API response message constants
- **`HEADERS`** - HTTP header constants
- **`DIST_TAGS`** - Distribution tag constants (`latest`, etc.)
- **`TOKEN_BASIC`**, **`TOKEN_BEARER`** - Authentication token types
- **`PLUGIN_CATEGORY`**, **`PLUGIN_PREFIX`** - Plugin system constants
- **`DEFAULT_USER`**, **`ANONYMOUS_USER`** - Default user constants
- **`HtpasswdHashAlgorithm`** - Supported hash algorithms for htpasswd

### Utility Modules

- **`errorUtils`** - Error creation and handling utilities
- **`validationUtils`** - Package name and manifest validation
- **`cryptoUtils`** - Hashing and random generation
- **`fileUtils`** - Temporary folder and storage creation
- **`pkgUtils`** - Package operations
- **`searchUtils`** - Search indexing utilities
- **`streamUtils`** - Stream handling utilities
- **`stringUtils`** - String manipulation utilities
- **`authUtils`** - Package access matching, token creation
- **`pluginUtils`** - Plugin types and interfaces
- **`tarballUtils`** - Tarball operations
- **`warningUtils`** - Warning emission

## Donations

Verdaccio is run by **volunteers**; nobody is working full-time on it. If you find this project to be useful and would like to support its development, consider making a donation - **your logo might end up in this readme.** 😉

**[Donate](https://opencollective.com/verdaccio)** 💵👍🏻 starting from _\$1/month_ or just one single contribution.

## Report a vulnerability

If you want to report a security vulnerability, please follow the steps which we have defined for you in our [security policy](https://github.com/verdaccio/verdaccio/security/policy).

## Open Collective Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/verdaccio/contribute)]

[![sponsor](https://opencollective.com/verdaccio/sponsor/0/avatar.svg)](https://opencollective.com/verdaccio/sponsor/0/website)
[![sponsor](https://opencollective.com/verdaccio/sponsor/1/avatar.svg)](https://opencollective.com/verdaccio/sponsor/1/website)
[![sponsor](https://opencollective.com/verdaccio/sponsor/2/avatar.svg)](https://opencollective.com/verdaccio/sponsor/2/website)
[![sponsor](https://opencollective.com/verdaccio/sponsor/3/avatar.svg)](https://opencollective.com/verdaccio/sponsor/3/website)
[![sponsor](https://opencollective.com/verdaccio/sponsor/4/avatar.svg)](https://opencollective.com/verdaccio/sponsor/4/website)
[![sponsor](https://opencollective.com/verdaccio/sponsor/5/avatar.svg)](https://opencollective.com/verdaccio/sponsor/5/website)
[![sponsor](https://opencollective.com/verdaccio/sponsor/6/avatar.svg)](https://opencollective.com/verdaccio/sponsor/6/website)
[![sponsor](https://opencollective.com/verdaccio/sponsor/7/avatar.svg)](https://opencollective.com/verdaccio/sponsor/7/website)
[![sponsor](https://opencollective.com/verdaccio/sponsor/8/avatar.svg)](https://opencollective.com/verdaccio/sponsor/8/website)
[![sponsor](https://opencollective.com/verdaccio/sponsor/9/avatar.svg)](https://opencollective.com/verdaccio/sponsor/9/website)

## Open Collective Backers

Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/verdaccio/contribute)]

[![backers](https://opencollective.com/verdaccio/backers.svg?width=890)](https://opencollective.com/verdaccio/contributes)

## Special Thanks

Thanks to the following companies to help us to achieve our goals providing free open source licenses.

[![jetbrains](https://github.com/verdaccio/verdaccio/blob/master/assets/thanks/jetbrains/logo.jpg?raw=true)](https://www.jetbrains.com/)
[![crowdin](https://github.com/verdaccio/verdaccio/blob/master/assets/thanks/crowdin/logo.png?raw=true)](https://crowdin.com/)

## Contributors

This project exists thanks to all the people who contribute. [[Contribute](https://github.com/verdaccio/verdaccio/blob/master/CONTRIBUTING.md)].

[![contributors](https://opencollective.com/verdaccio/contributors.svg?width=890&button=true)](https://github.com/verdaccio/verdaccio/graphs/contributors)

## FAQ / Contact / Troubleshoot

If you have any issue you can try the following options. Do not hesitate to ask or check our issues database. Perhaps someone has asked already what you are looking for.

- [Blog](https://verdaccio.org/blog/)
- [Donations](https://opencollective.com/verdaccio)
- [Reporting an issue](https://github.com/verdaccio/verdaccio/blob/master/CONTRIBUTING.md#reporting-a-bug)
- [Running discussions](https://github.com/orgs/verdaccio/discussions)
- [Chat](https://discord.com/channels/388674437219745793)
- [Logos](https://verdaccio.org/docs/logo)
- [Docker Examples](https://github.com/verdaccio/verdaccio/tree/master/docker-examples)
- [FAQ](https://github.com/verdaccio/verdaccio/issues?utf8=%E2%9C%93&q=is%3Aissue%20label%3Aquestion%20)

## License

Verdaccio is [MIT licensed](https://github.com/verdaccio/verdaccio/blob/master/LICENSE)

The Verdaccio documentation and logos (excluding /thanks, e.g., .md, .png, .sketch files within the /assets folder) are
[Creative Commons licensed](https://creativecommons.org/licenses/by/4.0/).

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