# nice-grpc-common

> Common stuff for nice-grpc and nice-grpc-web

Latest version **2.0.4** (published 2026-08-04) · MIT license · 0 weekly downloads

## Install

```sh
npm install nice-grpc-common
pnpm add nice-grpc-common
yarn add nice-grpc-common
bun add nice-grpc-common
```

## Health

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

Positive: has types; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 2.0.4 |
| Published | 2026-08-04 |
| First published | 2021-06-29 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 62.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 538 |
| Author | Daniel Lytkin <aikoven@deeplay.io> |
| Maintainers | aikoven |

## Links

- npm: https://www.npmjs.com/package/nice-grpc-common
- Repository: https://github.com/deeplay-io/nice-grpc
- Homepage: https://github.com/deeplay-io/nice-grpc/tree/master/packages/nice-grpc-common#readme
- Issues: https://github.com/deeplay-io/nice-grpc/issues
- npm.io page: https://npm.io/package/nice-grpc-common

## Dependencies (1)

- [ts-error](https://npm.io/package/ts-error.md) ^1.0.6

## Recent versions

- 2.0.4 (latest) — 2026-08-04
- 2.0.3 — 2026-04-12
- 2.0.2 — 2023-03-31
- 2.0.1 — 2023-01-18
- 2.0.0 — 2022-08-11
- 1.1.0 — 2022-04-18
- 1.0.6 — 2022-03-09
- 1.0.5 — 2022-03-05
- 1.0.4 — 2022-01-16
- 1.0.3 — 2021-09-21
- 1.0.2 — 2021-06-30
- 1.0.1 — 2021-06-29
- 1.0.0 — 2021-06-29

## README

# nice-grpc-common [![npm version][npm-image]][npm-url]

Common data structures and types for
[`nice-grpc`](https://github.com/deeplay-io/nice-grpc) and `nice-grpc-web`.

If you are making a middleware library, consider depending on
`nice-grpc-common`, as it is considered more stable in terms of semver. Also,
this allows you to build an isomorphic client middleware (working on both
Node.js and the Browser).

For application code, use `nice-grpc` or `nice-grpc-web` directly. Both
re-export names from `nice-grpc-common`.

## Installation

```
npm install nice-grpc-common
```

## Contents

- [`Metadata`](src/Metadata.ts) — represents
  [gRPC Metadata](https://grpc.io/docs/what-is-grpc/core-concepts/#metadata).
- [`Status`](src/Status.ts) — enum with
  [gRPC status codes](https://grpc.github.io/grpc/core/md_doc_statuscodes.html).
- [`CallContext`](src/server/CallContext.ts) — call context passed to server
  methods.
- [`ServerError`](src/server/ServerError.ts).
- [`ServerMiddleware`](src/server/ServerMiddleware.ts).
- [`composeServerMiddleware`](src/server/composeServerMiddleware.ts).
- [`CallOptions`](src/client/CallOptions.ts) — call options accepted by client
  methods.
- [`ClientError`](src/client/ClientError.ts).
- [`ClientMiddleware`](src/client/ClientMiddleware.ts).
- [`composeClientMiddleware`](src/client/composeClientMiddleware.ts).

[npm-image]: https://badge.fury.io/js/nice-grpc-common.svg
[npm-url]: https://badge.fury.io/js/nice-grpc-common

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