# @hey-api/shared

> Temporary home for cross-package utilities. Contents will migrate to proper packages as architecture stabilizes.

Latest version **0.5.0** (published 2026-06-22) · MIT license · 0 weekly downloads

## Install

```sh
npm install @hey-api/shared
pnpm add @hey-api/shared
yarn add @hey-api/shared
bun add @hey-api/shared
```

## Health

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

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

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.5.0 |
| Published | 2026-06-22 |
| First published | 2026-01-28 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=22.18.0 |
| Dependencies | 8 |
| Unpacked size | 1.1 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 5439 |
| Author | Hey API |
| Maintainers | mrlubos |

## Links

- npm: https://www.npmjs.com/package/@hey-api/shared
- Repository: https://github.com/hey-api/hey-api
- Homepage: https://heyapi.dev/
- Issues: https://github.com/hey-api/hey-api/issues
- Funding: https://github.com/sponsors/hey-api
- npm.io page: https://npm.io/package/@hey-api/shared

## Dependencies (8)

- [open](https://npm.io/package/open.md) 11.0.0
- [semver](https://npm.io/package/semver.md) 7.8.4
- [ansi-colors](https://npm.io/package/ansi-colors.md) 4.1.3
- [cross-spawn](https://npm.io/package/cross-spawn.md) 7.0.6
- [@hey-api/types](https://npm.io/package/@hey-api/types.md) 0.1.4
- [@hey-api/spec-types](https://npm.io/package/@hey-api/spec-types.md) 0.2.0
- [@hey-api/codegen-core](https://npm.io/package/@hey-api/codegen-core.md) 0.9.1
- [@hey-api/json-schema-ref-parser](https://npm.io/package/@hey-api/json-schema-ref-parser.md) 1.4.4

## Recent versions

- 0.5.0 (latest) — 2026-06-22
- 0.0.0-next-20260824173136 (next) — 2026-08-24
- 0.0.0-next-20260819153534 — 2026-08-19
- 0.0.0-next-20260813201118 — 2026-08-13
- 0.0.0-next-20260811214609 — 2026-08-11
- 0.0.0-next-20260804175203 — 2026-08-04
- 0.0.0-next-20260803133142 — 2026-08-03
- 0.0.0-next-20260803131638 — 2026-08-03
- 0.0.0-next-20260803105733 — 2026-08-03
- 0.0.0-next-20260803085119 — 2026-08-03
- 0.0.0-next-20260729142554 — 2026-07-29
- 0.0.0-next-20260728215008 — 2026-07-28
- 0.0.0-next-20260724070045 — 2026-07-24
- 0.0.0-next-20260723124023 — 2026-07-23
- 0.0.0-next-20260722143429 — 2026-07-22
- … 441 more at https://npm.io/package/@hey-api/shared/versions

## README

<div align="center">
  <img alt="Hey API" height="214" src="https://heyapi.dev/assets/.gen/hey-api-hero-640w.png" width="438">
  <h1><b>Hey API</b></h1>
  <p><em>"OpenAPI codegen that just works."</em><br/><sub>— Guillermo Rauch, CEO of Vercel</sub></p>
</div>

<p align="center">
  <a href="https://www.devtrends.dev/trends?c=v1.kZIBIg"><img src="https://api.devtrends.dev/badge/npm/%40hey-api%2Fopenapi-ts?period=month&style=flat&view=value" alt="DevTrends badge for @hey-api/openapi-ts" /></a>
  <a href="https://www.devtrends.dev/trends?c=v1.kZIBIg&v=change"><img src="https://api.devtrends.dev/badge/npm/%40hey-api%2Fopenapi-ts?period=year&style=flat&view=change" alt="DevTrends badge for @hey-api/openapi-ts" /></a>
  <a href="https://github.com/hey-api/hey-api/actions?query=branch%3Amain"><img src="https://github.com/hey-api/hey-api/actions/workflows/ci.yml/badge.svg?event=push&branch=main" alt="CI status" /></a>
  <a href="https://github.com/hey-api/hey-api"><img src="https://img.shields.io/github/stars/hey-api/hey-api?style=flat&logo=github&label=GitHub&color=54C82D" alt="GitHub stars" /></a>
  <a href="https://github.com/hey-api/hey-api/blob/main/LICENSE"><img src="https://img.shields.io/github/license/hey-api/hey-api" alt="MIT License"></a>
</p>

<p align="center">
  <a href="https://heyapi.dev/docs/openapi/typescript/get-started">Manual</a>
  <span>&nbsp;•&nbsp;</span>
  <a href="https://github.com/hey-api/hey-api/issues">Issues</a>
  <span>&nbsp;•&nbsp;</span>
  <a href="https://heyapi.dev/docs/openapi/typescript/community/contributing">Contribute</a>
</p>

## About

Hey API is an ecosystem for turning API specifications into production-ready code. It's trusted by thousands of companies – from YC startups to Fortune 500 enterprises – and powers products used by millions worldwide.

This is the monorepo containing all open source Hey API packages. For package-specific documentation and quick start guides, see the individual repositories below.

## Packages

<table>
  <tr>
    <th width="30%">Package</th>
    <th>Description</th>
  </tr>
  <tr>
    <td>
      <a href="packages/openapi-ts"><code>openapi-ts</code></a>
    </td>
    <td>
      TypeScript code generator with 20+ plugins for SDKs, Zod schemas, TanStack Query hooks, and more.
      <br/>
      <a href="https://heyapi.dev/docs/openapi/typescript/get-started">Manual</a>
      <span>&nbsp;•&nbsp;</span>
      <a href="https://npmjs.com/package/@hey-api/openapi-ts">npm</a>
    </td>
  </tr>
  <tr>
    <td>
      <a href="packages/openapi-python"><code>openapi-python</code></a>
    </td>
    <td>
      Python code generator for SDKs and Pydantic models.
      <br/>
      <a href="https://heyapi.dev/docs/openapi/python/get-started">Manual</a>
      <span>&nbsp;•&nbsp;</span>
      <a href="https://npmjs.com/package/@hey-api/openapi-python">npm</a>
    </td>
  </tr>
</table>

## Highlights

- production-grade code that compiles
- runs in any Node.js 22+ environment
- accepts any OpenAPI specification
- core plugins for SDKs
- HTTP clients for Fetch API, Axios, Angular, Next.js, Nuxt, HTTPX, and more
- Zod schemas, TanStack Query hooks, Pydantic models, and 20+ plugins to reduce third-party boilerplate
- highly customizable via plugins

## Libraries

<table>
  <tr>
    <th width="30%">Package</th>
    <th>Description</th>
  </tr>
  <tr>
    <td>
      <a href="packages/spec-types"><code>spec-types</code></a>
    </td>
    <td>
      TypeScript definitions for OpenAPI and JSON Schema specifications with complete inline documentation.
      <br/>
      <a href="https://npmjs.com/package/@hey-api/spec-types">npm</a>
    </td>
  </tr>
</table>

<!-- template-contributing-start -->

## Contributing

Want to see your code in products used by millions?

Start with our [Contributing](https://heyapi.dev/docs/openapi/typescript/community/contributing) guide and release your first feature.

<!-- template-contributing-end -->

<!-- template-sponsors-start -->

## Sponsors

Partners behind the future of API tooling. [Become a sponsor](https://heyapi.dev/sponsors).

<h3 align="center">Gold</h3>

<table align="center">
  <tbody>
      <td align="center" width="50%">
        <p></p>
        <p>
          <a href="https://kutt.to/QM9Q2N" target="_blank">
            <picture height="50px">
              <source media="(prefers-color-scheme: dark)" srcset="https://heyapi.dev/assets/opencode/logo-light.svg">
              <img alt="Opencode logo" height="50px" src="https://heyapi.dev/assets/opencode/logo-dark.svg">
            </picture>
          </a>
          <br/>
          The open source coding agent.
          <br/>
          <a href="https://kutt.to/QM9Q2N" style="text-decoration:none;" target="_blank">
            opencode.ai
          </a>
        </p>
        <p></p>
      </td>
    </tr>
  </tbody>
</table>

<h3 align="center">Silver</h3>

<table align="center">
  <tbody>
    <tr>
      <td align="center" width="33.333%">
        <a href="https://kutt.to/Dr9GuW" target="_blank">
          <picture height="40px">
            <source media="(prefers-color-scheme: dark)" srcset="https://heyapi.dev/assets/fastapi/logo-light.svg">
            <img alt="FastAPI logo" height="40px" src="https://heyapi.dev/assets/fastapi/logo-dark.svg">
          </picture>
        </a>
        <br/>
        <a href="https://kutt.to/Dr9GuW" style="text-decoration:none;" target="_blank">
          fastapi.tiangolo.com
        </a>
      </td>
      <td align="center" width="33.333%">
        <a href="https://kutt.to/yZVkdV" target="_blank">
          <picture height="40px">
            <source media="(prefers-color-scheme: dark)" srcset="https://heyapi.dev/assets/brands/unblocked/logo-light.svg">
            <img alt="Unblocked logo" height="40px" src="https://heyapi.dev/assets/brands/unblocked/logo-dark.svg">
          </picture>
        </a>
        <br/>
        <a href="https://kutt.to/yZVkdV" style="text-decoration:none;" target="_blank">
          getunblocked.com
        </a>
      </td>
    </tr>
  </tbody>
</table>

<h3 align="center">Bronze</h3>

<table align="center">
  <tbody>
    <tr>
      <td align="center" width="33.333%">
        <a href="https://kutt.to/YpaKsX" target="_blank">
          <picture height="34px">
            <source media="(prefers-color-scheme: dark)" srcset="https://heyapi.dev/assets/.gen/kinde-logo-wordmark-dark-480w.webp">
            <img alt="Kinde logo" height="34px" src="https://heyapi.dev/assets/.gen/kinde-logo-wordmark-480w.jpeg">
          </picture>
        </a>
      </td>
      <td align="center" width="33.333%">
        <a href="https://kutt.to/HW4GYR" target="_blank">
          <picture height="34px">
            <source media="(prefers-color-scheme: dark)" srcset="https://heyapi.dev/assets/photon/logo-light.svg">
            <img alt="Photon logo" height="34px" src="https://heyapi.dev/assets/photon/logo-dark.svg">
          </picture>
        </a>
      </td>
    </tr>
  </tbody>
</table>
<!-- template-sponsors-end -->

<!-- template-license-start -->

## License

Released under the [MIT License](https://github.com/hey-api/hey-api/blob/main/LICENSE).

<!-- template-license-end -->

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