# napi-build-utils

> A set of utilities to assist developers of tools that build N-API native add-ons

Latest version **2.0.0** (published 2025-01-17) · MIT license · 0 weekly downloads

## Install

```sh
npm install napi-build-utils
pnpm add napi-build-utils
yarn add napi-build-utils
bun add napi-build-utils
```

## Health

**Score 25/100 (F)** — status: maintenance-mode.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.0.0 |
| Published | 2025-01-17 |
| First published | 2018-09-12 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 12.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | Jim Schlight |
| Maintainers | inspiredware |
| Keywords | n-api, prebuild, prebuild-install |

## Links

- npm: https://www.npmjs.com/package/napi-build-utils
- Repository: https://github.com/inspiredware/napi-build-utils
- Homepage: https://github.com/inspiredware/napi-build-utils#readme
- Issues: https://github.com/inspiredware/napi-build-utils/issues
- npm.io page: https://npm.io/package/napi-build-utils

## Recent versions

- 2.0.0 (latest) — 2025-01-17
- 1.0.2 — 2020-03-05
- 1.0.1 — 2018-09-12
- 1.0.0 — 2018-09-12

## README

# napi-build-utils

[![npm](https://img.shields.io/npm/v/napi-build-utils.svg)](https://www.npmjs.com/package/napi-build-utils)
![Node version](https://img.shields.io/node/v/prebuild.svg)
![Build Status](https://github.com/inspiredware/napi-build-utils/actions/workflows/run-npm-tests.yml/badge.svg)
[![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg)](http://standardjs.com/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

A set of utilities to assist developers of tools that build [Node-API](https://nodejs.org/api/n-api.html#n_api_n_api) native add-ons.

## Background

This module is targeted to developers creating tools that build Node-API native add-ons.

It implements a set of functions that aid in determining the Node-API version supported by the currently running Node instance and the set of Node-API versions against which the Node-API native add-on is designed to be built. Other functions determine whether a particular Node-API version can be built and can issue console warnings for unsupported Node-API versions.

Unlike the modules this code is designed to facilitate building, this module is written entirely in JavaScript.

## Quick start

```bash
npm install napi-build-utils
```

The module exports a set of functions documented [here](./index.md). For example:

```javascript
var napiBuildUtils = require('napi-build-utils');
var napiVersion = napiBuildUtils.getNapiVersion(); // Node-API version supported by Node, or undefined.
```

## Declaring supported Node-API versions

Native modules that are designed to work with [Node-API](https://nodejs.org/api/n-api.html#n_api_n_api) must explicitly declare the Node-API version(s) against which they are coded to build. This is accomplished by including a `binary.napi_versions` property in the module's `package.json` file. For example:

```json
"binary": {
  "napi_versions": [2,3]
}
```

In the absence of a need to compile against a specific Node-API version, the value `3` is a good choice as this is the Node-API version that was supported when Node-API left experimental status.

Modules that are built against a specific Node-API version will continue to operate indefinitely, even as later versions of Node-API are introduced.

## History

**v2.0.0** This version was introduced to address a limitation when the Node-API version reached `10` in NodeJS `v23.6.0`. There was no change in the API, but a SemVer bump to `2.0.0` was made out of an abundance of caution.

## Support

If you run into problems or limitations, please file an issue and we'll take a look. Pull requests are also welcome.

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