# [2.9.0](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.8.0...@napi-rs/cli@2.9.0) (2022-05-14)


### Features

* **cli:** allow specifying an alternative cargo binary via `CARGO` env var ([#1181](https://github.com/napi-rs/napi-rs/issues/1181)) ([1399288](https://github.com/napi-rs/napi-rs/commit/1399288df5b16fd615b2b0a5a24f72ac602635a4))





@napi-rs/cli@2.9.0

## What's Changed
* fix(napi): type constraint for either types by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1178


**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@2.4.2...napi@2.4.3

napi@2.4.3

## What's Changed
* refactor(napi): remove `thread_local!` usage by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1176
* test(napi): add electron test by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1176
* fix(napi): missing iterator implementation from class factory by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1177

### Experimental

*  feat(napi): add support for weak references by @devongovett in https://github.com/napi-rs/napi-rs/pull/1172


**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@2.4.1...napi@2.4.2

napi@2.4.2

## What's Changed
* fix(napi-sys): don't panic if `napi_*` is failed to load by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1176


**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-sys@2.2.1...napi-sys@2.2.2

napi-sys@2.2.2

## What's Changed
* fix(napi): load Node-API symbols manually on Windows by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1169


**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-sys@2.2.0...napi@2.4.1

napi@2.4.1

## What's Changed
* feat(napi): make Error::from_reason() generic by @bnoordhuis in https://github.com/napi-rs/napi-rs/pull/1159
* fix(napi): crash when process exits due to reference by @devongovett in https://github.com/napi-rs/napi-rs/pull/1161
* feat(napi): `Iterator` Support by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1166
* refactor(napi): use `libloading` on Windows by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1167

## New Contributors
* @bnoordhuis made their first contribution in https://github.com/napi-rs/napi-rs/pull/1159
* @devongovett made their first contribution in https://github.com/napi-rs/napi-rs/pull/1161

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.3.3...napi@2.4.0

napi@2.4.0

## What's Changed
* fix(napi-sys): load Node-API symbols manually on Windows by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1169


**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-sys@2.2.0...napi-sys@2.2.1

napi-sys@2.2.1

## What's Changed

* Use `libloading` on Windows to avoid Windows i686 compiling issues and reduce crate size by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1167

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.3.3...napi-sys@2.2.0

napi-sys@2.2.0

## What's Changed
### **BREAKING**
* Use `libloading` on Windows, remove `node-{arch}.lib` files in `napi-build` by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1167

**You must use `napi 2.4+` with the `napi-build@2`**

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.3.3...napi-build@2.0.0

napi-build@2.0.0

# [2.8.0](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.8.0-alpha.0...@napi-rs/cli@2.8.0) (2022-05-07)

**Note:** Version bump only for package @napi-rs/cli





@napi-rs/cli@2.8.0

# [2.8.0-alpha.0](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.7.0...@napi-rs/cli@2.8.0-alpha.0) (2022-05-06)


### Features

* **cli:** new command upgrade ([652aa3c](https://github.com/napi-rs/napi-rs/commit/652aa3cc57c6f4d5b72491f1ad3fc44ac8ab7780))





@napi-rs/cli@2.8.0-alpha.0

## What's Changed
* fix(napi): use create_buffer/arrary_buffer if provided data is empty by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1147
* chore: upgrade dependencies by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1151
* chore: drop node 17, add node 18 by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1152
* chore(napi): upgrade windows crate by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1153

### Experimental

* feat(napi): support return Reference on class instance by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1150

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@2.3.2...napi@2.3.3

napi@2.3.3

## What's Changed
* fix(napi-derive): invalid TypeScript return type by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1155


**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.3.2...napi-derive@2.3.3

napi-derive@2.3.3

## What's Changed
* fix(napi-derive): should transform struct case on Impl by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1148

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.3.1...napi-derive@2.3.2

napi-derive@2.3.2

# [2.7.0](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.6.2...@napi-rs/cli@2.7.0) (2022-04-27)


### Bug Fixes

* **cli:** generated type def on multi impl blocks ([c3a35a0](https://github.com/napi-rs/napi-rs/commit/c3a35a070440b1253c172a0e5e4be0a018206946))


### Features

* **cli:** add build option to not include the header in dts file ([#1140](https://github.com/napi-rs/napi-rs/issues/1140)) ([c390609](https://github.com/napi-rs/napi-rs/commit/c39060984d4cae560da7c1a7994ba6c1e33fa101))





@napi-rs/cli@2.7.0

## What's Changed

* fix(napi): use null pointer for empty buffers by @mischnic in https://github.com/napi-rs/napi-rs/pull/1144

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@2.3.1...napi@2.3.2

napi@2.3.2

## What's Changed
* Add build option to not include the header in dts file by @ceifa in https://github.com/napi-rs/napi-rs/pull/1140
* Simplify the optional values in generated declaration file by @ceifa in https://github.com/napi-rs/napi-rs/pull/1141
* Add u64 to BigInt conversion through From trait by @ceifa in https://github.com/napi-rs/napi-rs/pull/1143

## New Contributors
* @ceifa made their first contribution in https://github.com/napi-rs/napi-rs/pull/1140

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@2.3.1...napi-derive@2.3.1

napi-derive@2.3.1

## What's Changed
* fix(napi): `cannot find trait ToNapiValue` error by @U-C-S in https://github.com/napi-rs/napi-rs/pull/1136
* ci: check all napi features by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1137

## New Contributors
* @U-C-S made their first contribution in https://github.com/napi-rs/napi-rs/pull/1136

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@2.3.0...napi@2.3.1

napi@2.3.1

## What's Changed

* docs: add return Promise callback function @Brooooooklyn 
* feat(napi): relax the value type on ThreadSafeFunction @Brooooooklyn 
* feat(napi-derive): support generic types on fn @Brooooooklyn 
* fix(napi-derive): JsUnknown should be unknown type @Brooooooklyn 
* feat(napi): add `from_unknown` method on FromNapiValue @Brooooooklyn 
* fix(napi): typo unrwap -> unwrap @waltonseymour
* chore(napi): show tips if create different buffers with same data @Brooooooklyn 
* test(napi): add memory tests for `Reference` @Brooooooklyn 
* fix(napi): make buffer `Send` & `Sync` safe @Brooooooklyn 
* feat(napi): redesign the Reference API (#1118) @Brooooooklyn 
* Revert "chore: unset CARGO_BUILD_TARGET in debian.Dockerfile" @Brooooooklyn 
* chore: unset `CARGO_BUILD_TARGET` in debian.Dockerfile @Brooooooklyn 
* build: migrate debian image to messense/manylinux2014-cross @Brooooooklyn 
* feat(napi): experimental class reference API @Brooooooklyn 
* fix(napi): remove CString::from_vec_with_nul_unchecked @Brooooooklyn 
* feat(napi): allow empty enums @antoniomuso
* ci: add binary build check @messense 
* fix(napi): double allocation in create_buffer @Brooooooklyn 

## Reference API

```rust
use napi::bindgen_prelude::*;

pub struct Repository {
  dir: String,
}

impl Repository {
  fn remote(&self) -> Remote {
    Remote { inner: self }
  }
}

pub struct Remote<'repo> {
  inner: &'repo Repository,
}

impl<'repo> Remote<'repo> {
  fn name(&self) -> String {
    "origin".to_owned()
  }
}

#[napi]
pub struct JsRepo {
  inner: Repository,
}

#[napi]
impl JsRepo {
  #[napi(constructor)]
  pub fn new(dir: String) -> Self {
    JsRepo {
      inner: Repository { dir },
    }
  }

  #[napi]
  pub fn remote(&self, reference: Reference<JsRepo>, env: Env) -> Result<JsRemote> {
    Ok(JsRemote {
      inner: reference.share_with(env, |repo| Ok(repo.inner.remote()))?,
    })
  }
}

#[napi]
pub struct JsRemote {
  inner: SharedReference<JsRepo, Remote<'static>>,
}

#[napi]
impl JsRemote {
  #[napi]
  pub fn name(&self) -> String {
    self.inner.name()
  }
}
```

```js
const repo = new JsRepo('.')
t.is(repo.remote().name(), 'origin')
```

## New Contributors
* @waltonseymour made their first contribution in https://github.com/napi-rs/napi-rs/pull/1133
* @antoniomuso made their first contribution in https://github.com/napi-rs/napi-rs/pull/1089

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.2.0...napi@2.3.0

napi@2.3.0

### Features

- Provide `Reference` API to keep class reference alive with JavaScript instance.
- Allow injecting `Reference` into parameters like `Env`.
- Add tests to ensure no memory leak happened in the new `Reference` API.
- `Buffer` now can be used in struct which is implemented `Task` trait.

```rust
use napi::bindgen_prelude::*;

pub struct Repository {
  dir: String,
}

impl Repository {
  fn remote(&self) -> Remote {
    Remote { inner: self }
  }
}

pub struct Remote<'repo> {
  inner: &'repo Repository,
}

impl<'repo> Remote<'repo> {
  fn name(&self) -> String {
    "origin".to_owned()
  }
}

#[napi]
pub struct JsRepo {
  inner: Repository,
}

#[napi]
impl JsRepo {
  #[napi(constructor)]
  pub fn new(dir: String) -> Self {
    JsRepo {
      inner: Repository { dir },
    }
  }

  #[napi]
  pub fn remote(&self, reference: Reference<JsRepo>, env: Env) -> Result<JsRemote> {
    Ok(JsRemote {
      inner: reference.share_with(env, |repo| Ok(repo.inner.remote()))?,
    })
  }
}

#[napi]
pub struct JsRemote {
  inner: SharedReference<JsRepo, Remote<'static>>,
}

#[napi]
impl JsRemote {
  #[napi]
  pub fn name(&self) -> String {
    self.inner.name()
  }
}
```

```js
const repo = new JsRepo('.')
t.is(repo.remote().name(), 'origin')
```

napi@2.3.0-alpha.1

## [2.6.2](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.6.1...@napi-rs/cli@2.6.2) (2022-04-01)


### Bug Fixes

* cargo metadata with large project ([#1117](https://github.com/napi-rs/napi-rs/issues/1117)) ([6bef28a](https://github.com/napi-rs/napi-rs/commit/6bef28a59bcfe3850f8d31d6eeaffdba5c251050))





@napi-rs/cli@2.6.2

## [2.6.1](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.6.0...@napi-rs/cli@2.6.1) (2022-04-01)


### Bug Fixes

* **cli:** should not throw if cargoName is provided but no package.name ([8700da1](https://github.com/napi-rs/napi-rs/commit/8700da17763ed5c9fd5ddda8f7a8af4d922ecbed))





@napi-rs/cli@2.6.1

# [2.6.0](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.4.5...@napi-rs/cli@2.6.0) (2022-04-01)


### Bug Fixes

* **cli:** prevent crash if GITHUB_REPOSITORY is not specified ([ac8406c](https://github.com/napi-rs/napi-rs/commit/ac8406c8428227a1ee45c2b4606cc09eae6f44c5))
* **cli:** respect CARGO_BUILD_TARGET env variable ([bd08787](https://github.com/napi-rs/napi-rs/commit/bd0878727036678eca984e754a1eeda9915f4042))
* **cli:** use shell file path instead of commands for zig CC and CXX ([09ccfaa](https://github.com/napi-rs/napi-rs/commit/09ccfaad1d3c1fd00784aae4a2206366ea3123e8))


### Features

* **cli:** add libc filed in native package.json ([ee0279e](https://github.com/napi-rs/napi-rs/commit/ee0279e540238683a8f43cb92ef790e10a3591d9))
* **cli:** add support for building binaries ([20b1edc](https://github.com/napi-rs/napi-rs/commit/20b1edc53b38fe3b4cf3c628351fcdfcdeff8037))
* **cli:** upgrade ci.yml templates ([1cac0ac](https://github.com/napi-rs/napi-rs/commit/1cac0ac804d526932ccd1c24602976c7ce564a4e))





@napi-rs/cli@2.6.0

# [2.5.0](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.4.5...@napi-rs/cli@2.5.0) (2022-03-22)


### Bug Fixes

* **cli:** use shell file path instead of commands for zig CC and CXX ([09ccfaa](https://github.com/napi-rs/napi-rs/commit/09ccfaad1d3c1fd00784aae4a2206366ea3123e8))


### Features

* **cli:** add libc filed in native package.json ([ee0279e](https://github.com/napi-rs/napi-rs/commit/ee0279e540238683a8f43cb92ef790e10a3591d9))
* **cli:** upgrade ci.yml templates ([1cac0ac](https://github.com/napi-rs/napi-rs/commit/1cac0ac804d526932ccd1c24602976c7ce564a4e))





@napi-rs/cli@2.5.0

## What's Changed
* feat(napi): Add support for Date <-> chrono::DateTime<Utc> by @simonvandel in https://github.com/napi-rs/napi-rs/pull/1069
* fix(napi): cleanup registered hook upon unloading module with tokio_rt by @martinjlowm in https://github.com/napi-rs/napi-rs/pull/1075
* style(napi): fix `clippy::needless_late_init` lint by @messense in https://github.com/napi-rs/napi-rs/pull/1080
* fix(napi): race issues with Node.js worker_thread by @Brooooooklyn @janpio in https://github.com/napi-rs/napi-rs/pull/1081
* fix(napi): Buffer value lifetime should align the Rust lifetime by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1079
* fix(napi): missing ValidateNapiValue trait for types by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1088

## New Contributors
* @simonvandel made their first contribution in https://github.com/napi-rs/napi-rs/pull/1069
* @martinjlowm made their first contribution in https://github.com/napi-rs/napi-rs/pull/1075
* @stephank made their first contribution in https://github.com/napi-rs/napi-rs/pull/1084
* @janpio made their first contribution in  https://github.com/napi-rs/napi-rs/pull/1081

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@2.1.0...napi@2.2.0

napi@2.2.0

## [2.4.5](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.4.4...@napi-rs/cli@2.4.5) (2022-03-05)


### Bug Fixes

* **cli:** temporary dts path may not be writable ([e69f023](https://github.com/napi-rs/napi-rs/commit/e69f0230c24cb74d55287fe191d05edf53d7830a))
* **napi:** race issues with Node.js worker_thread ([#1081](https://github.com/napi-rs/napi-rs/issues/1081)) ([9f3fbaa](https://github.com/napi-rs/napi-rs/commit/9f3fbaa8e0b6c0bcdd740d39d16de35a4ec18aa8))





@napi-rs/cli@2.4.5

## [2.4.4](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.4.3...@napi-rs/cli@2.4.4) (2022-02-11)


### Bug Fixes

* **cli:** generate ExternalObject type on demand ([f9c618e](https://github.com/napi-rs/napi-rs/commit/f9c618e0462c3f75593b0a980f4babcb265ffc0c))





@napi-rs/cli@2.4.4

## What's Changed

* feat(napi): `get_js_function` by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1048
* feat(napi): re-export tokio and features by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1048
* fix(napi): `String` roundtrip with interior nul bytes by @messense in https://github.com/napi-rs/napi-rs/pull/1056
* fix(napi): `BigInt` issue with zero value by @messense in https://github.com/napi-rs/napi-rs/pull/1058
* style: apply clippy suggestion by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1063
* feat(napi): impl `FromNapiValue` for `serde_json::Number`, fix it for `Null`, throw for impossible types by @AlCalzone in https://github.com/napi-rs/napi-rs/pull/1052
* feat(napi): `with_value` method on `Property` by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1064
* fix(napi): re-export `JsDate` as `Date` in prelude by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1065
* fix(napi): deref from `Uint8ClampedArray` by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1066

## New Contributors
* @JoostK made their first contribution in https://github.com/napi-rs/napi-rs/pull/1043
* @AlCalzone made their first contribution in https://github.com/napi-rs/napi-rs/pull/1052

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@2.0.4...napi@2.1.0

napi@2.1.0

## What's Changed
* feat(napi-derive): add `ts_type` attribute to override typescript type for fields in structs by @jose-acevedoflores in https://github.com/napi-rs/napi-rs/pull/1041
* fix(napi-derive): an `Option` in front of a required parameter is no … by @JoostK in https://github.com/napi-rs/napi-rs/pull/1043
* feat(napi-derive): `get_js_function` by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1048

## New Contributors
* @JoostK made their first contribution in https://github.com/napi-rs/napi-rs/pull/1043
* @AlCalzone made their first contribution in https://github.com/napi-rs/napi-rs/pull/1052

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.0.8...napi-derive@2.1.0

napi-derive@2.1.0

## [2.4.3](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.4.2...@napi-rs/cli@2.4.3) (2022-02-09)


### Bug Fixes

* **cli:** compatible for Node.js 10x ([5f359df](https://github.com/napi-rs/napi-rs/commit/5f359dfaae809a2b97a25b8ed12914152a9696d9))





@napi-rs/cli@2.4.3

## [2.4.2](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.4.1...@napi-rs/cli@2.4.2) (2022-01-19)


### Bug Fixes

* **cli:** js binding template ([25f6754](https://github.com/napi-rs/napi-rs/commit/25f6754a71dfa4736c75eb91bf9f2562543f5d08))





@napi-rs/cli@2.4.2

## What's Changed
* fix(napi): abort threadsafe functions upon env cleanup by @dceddia in https://github.com/napi-rs/napi-rs/pull/1020
* fix(napi): clippy error on 1.58 by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1029
* Add 'coerce_to_object' method to Array by @jose-acevedoflores in https://github.com/napi-rs/napi-rs/pull/1038

## New Contributors
* @dceddia made their first contribution in https://github.com/napi-rs/napi-rs/pull/1020
* @jose-acevedoflores made their first contribution in https://github.com/napi-rs/napi-rs/pull/1038

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@2.0.3...napi@2.0.4

napi@2.0.4

## What's Changed

* Correctly escape backslash in type definition doc comments by @timfish in https://github.com/napi-rs/napi-rs/pull/1034

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.0.7...napi-derive@2.0.8

napi-derive@2.0.8

## [2.4.1](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.4.0...@napi-rs/cli@2.4.1) (2022-01-18)


### Bug Fixes

* **cli:** missing shebang in zig-cross sh file ([63a16d0](https://github.com/napi-rs/napi-rs/commit/63a16d0a27f09766a6dd557691d598758a147882))
* **cli:** properly handle RUSTFLAGS env var ([d84cbe8](https://github.com/napi-rs/napi-rs/commit/d84cbe88bdcaadbc0b57c6b49b9d84e22020cf34))
* **cli:** swap -lgcc_s with -lunwind ([1799aa9](https://github.com/napi-rs/napi-rs/commit/1799aa94e3132c425cfc47413b7c254d7f8f711e))





@napi-rs/cli@2.4.1

## What's Changed
* fix(napi): invalid memory address in FromNapiValue for &str by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1023
* chore: forbid unsafe_op_in_unsafe_fn by @messense in https://github.com/napi-rs/napi-rs/pull/1024

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.0.7...napi@2.0.3

napi@2.0.3

# [2.4.0](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.3.1...@napi-rs/cli@2.4.0) (2022-01-13)


### Bug Fixes

* **cli:** zig abi should pass to linker ([95d49f8](https://github.com/napi-rs/napi-rs/commit/95d49f8cf4485fcf8a882291b9bd64d5667668c6))


### Features

* **cli:** add `--strip` option for removing symbols ([887bdb9](https://github.com/napi-rs/napi-rs/commit/887bdb9d2908576f5d3468cfdcf662538f1fbe8d))





@napi-rs/cli@2.4.0

## [2.3.1](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.3.0...@napi-rs/cli@2.3.1) (2022-01-13)


### Bug Fixes

* **cli:** missing zig-abi-suffix support ([472ac10](https://github.com/napi-rs/napi-rs/commit/472ac10c67b7b239bb9bfcc3a1e897508cfc3314))





@napi-rs/cli@2.3.1

## What's Changed
* fix(napi-derive): BigInt in TypeScript should be bigint by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1015

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.0.6...napi-derive@2.0.7

napi-derive@2.0.7

## What's Changed

* fix(napi-derive): should throw rather than panic if object mismatched by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1010
* fix(napi-derive): implement missing trait for JsClass reference by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1011
* chore(napi-derive): update convert_case by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/1012

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.0.5...napi-derive@2.0.6

napi-derive@2.0.6

# [2.3.0](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.2.1...@napi-rs/cli@2.3.0) (2022-01-06)


### Features

* **cli:** support macOS with --zig flag ([0db94cc](https://github.com/napi-rs/napi-rs/commit/0db94ccd669d095321a544a195f30fde6af71eec))





@napi-rs/cli@2.3.0

## What's Changed

* Unraw rust identifiers before sending it to js. by @fluxxu in https://github.com/napi-rs/napi-rs/pull/987


**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.0.4...napi-derive@2.0.5

napi-derive@2.0.5

## [2.2.1](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.2.0...@napi-rs/cli@2.2.1) (2022-01-04)


### Bug Fixes

* **cli:** fix crate-type hint ([894334e](https://github.com/napi-rs/napi-rs/commit/894334e8f1ba138d029cc861dfc836edc95c17d3))
* **cli:** handle lld not found ([eb79cce](https://github.com/napi-rs/napi-rs/commit/eb79ccebbeb0f9d1a3b4f4eff5e9a7271ff6f431))
* **cli:** shell: true instead of bash ([bc570c2](https://github.com/napi-rs/napi-rs/commit/bc570c29183f20139f8a80aa54d219cc1a590a2b))
* **napi-derive,cli:** export type alias for original name ([556ace8](https://github.com/napi-rs/napi-rs/commit/556ace8f3302d9dd0b5aec237c3aa49caf58d7dd))
* **napi-derive:** return instance from non-default constructor class ([e6a30ff](https://github.com/napi-rs/napi-rs/commit/e6a30ffcca38f1b6d72211931f32675a53f12dcf))





@napi-rs/cli@2.2.1

## What's Changed
* fix(napi-derive): missing wrap in NAPI-RS created class instance by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/967
* fix(napi-derive): ignore warnings on generated fn by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/969


**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.0.3...napi-derive@2.0.4

napi-derive@2.0.4

## What's Changed

* Fix return instance from non-default constructor `Class` by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/966


**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.0.2...napi-derive@2.0.3

napi-derive@2.0.3

## What's Changed

* fix(napi-derive): return `Class instance` in `fn` by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/964


**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.0.1...napi-derive@2.0.2

napi-derive@2.0.2

## What's Changed
* fix(napi): compile issue without compat mode by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/961


**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@2.0.1...napi@2.0.2

napi@2.0.2

# [2.2.0](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.1.0...@napi-rs/cli@2.2.0) (2021-12-22)


### Features

* **cli:** provide a way to override the native package name ([046f75d](https://github.com/napi-rs/napi-rs/commit/046f75dc29f8ea2319311006b2743749427d7ed4))





@napi-rs/cli@2.2.0

## What's Changed
* fix(napi): refine return type by @liulinboyi in https://github.com/napi-rs/napi-rs/pull/938
* fix(napi): impl `From<Buffer>` for `Vec<u8>` by @forehalo in https://github.com/napi-rs/napi-rs/pull/939
* test(napi): add tests for hashmap <-> object by @mischnic in https://github.com/napi-rs/napi-rs/pull/946
* chore(napi): upgrade windows crate to 0.29 by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/950
* fix(napi) undefined module in worker_threads by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/960

## New Contributors
* @liulinboyi made their first contribution in https://github.com/napi-rs/napi-rs/pull/938
* @mischnic made their first contribution in https://github.com/napi-rs/napi-rs/pull/946

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@2.0.0...napi@2.0.1

napi@2.0.1

## What's Changed
* fix(napi-derive-backend): Null and Undefined return type by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/940
* Add `skip_typescript` attribute for macro by @h-a-n-a in https://github.com/napi-rs/napi-rs/pull/947

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.0.0...napi-derive@2.0.1

napi-derive@2.0.1

## What's Changed

* fix: keep `.d.ts` and `.js` untouched if native doesn't change by @forehalo in https://github.com/napi-rs/napi-rs/pull/941

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@2.0.0...napi-build@1.2.1

napi-build@1.2.1

# [2.1.0](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.0.0...@napi-rs/cli@2.1.0) (2021-12-21)


### Bug Fixes

* **cli:** disable js binding generation if no --platform flag ([f577512](https://github.com/napi-rs/napi-rs/commit/f577512952b0409ab76422ce539872af16a98d77))
* keep .d.ts and .js untouched if native doesn't change ([09c7df3](https://github.com/napi-rs/napi-rs/commit/09c7df3c5ce612736011079ddaffa5701522d811))


### Features

* **napi:** add ts typegen skip ([df9dc91](https://github.com/napi-rs/napi-rs/commit/df9dc91562e648b21eaa97bae9f2c9354ed1b976))





@napi-rs/cli@2.1.0

https://napi.rs/blog/announce-v2 @Brooooooklyn 

Special thanks to @forehalo for the initial version of **NAPI-RS v2**

And  @timfish @h-a-n-a @joaomoreno @yisibl @idan-at @sam3d  for contributing.

napi@2.0.0

# [2.0.0](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.0.0-beta.5...@napi-rs/cli@2.0.0) (2021-12-17)

**Note:** Version bump only for package @napi-rs/cli





@napi-rs/cli@2.0.0

## What's Changed

* fix(napi): `ThreadsafeFunction` with `ErrorStrategy::Fatal` should throw fatal exception by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/929

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@2.0.0-beta.6...napi@2.0.0-beta.7

napi@2.0.0-beta.7

## What's Changed

* feat(napi): support external deref by @h-a-n-a in https://github.com/napi-rs/napi-rs/pull/919

## New Contributors
* @h-a-n-a made their first contribution in https://github.com/napi-rs/napi-rs/pull/919

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.0.0-beta.5...napi@2.0.0-beta.6

napi@2.0.0-beta.6

# [2.0.0-beta.5](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.0.0-beta.4...@napi-rs/cli@2.0.0-beta.5) (2021-12-10)


### Bug Fixes

* **cli:** enum TypeScript type should be const enum ([f4b0a2e](https://github.com/napi-rs/napi-rs/commit/f4b0a2e3228eb9d6d2c8f51e31d250930799ce1d))
* **cli:** preserve authors field while creating npm dir ([ecb6522](https://github.com/napi-rs/napi-rs/commit/ecb6522f508688e982d3649218334df4228d6edd))


### Features

* **cli:** provide rename command to rename everything in package-template project ([b977265](https://github.com/napi-rs/napi-rs/commit/b977265cfa06a1e33cca4b2579b561ed73f8a1b1))





@napi-rs/cli@2.0.0-beta.5

### Feature

- throw error on non constructable class https://github.com/napi-rs/napi-rs/commit/74704073065409f0ee91945c50082b00db212867 @Brooooooklyn 

napi@2.0.0-beta.5

### Bugfix

- Missing crate prefix in generated `class` https://github.com/napi-rs/napi-rs/commit/cd7c7a342f1c74f9a31a3499aac98dd8303d6d10 @Brooooooklyn 



napi-derive@2.0.0-beta.5

### Feature

- Add `noop` feature to disable codegen  of `#[napi]` @Brooooooklyn 

This feature is useful for sharing code between Node.js native addon and `wasm `



napi-derive@2.0.0-beta.4

### Feature

- create `Array` from `&Vec<T>` https://github.com/napi-rs/napi-rs/pull/917 @Brooooooklyn 


Full Changelog: https://github.com/napi-rs/napi-rs/compare/napi@2.0.0-beta.3...napi@2.0.0-beta.4

napi@2.0.0-beta.4

## What's Changed
- Impl `FromNapiValue` for `&str` @Brooooooklyn https://github.com/napi-rs/napi-rs/commit/00be6e5e0ceaf9263662363f559feb4302d47ba7

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.0.0-beta.2...napi@2.0.0-beta.3

napi@2.0.0-beta.3

## What's Changed

- Skip set object property if it is `None` https://github.com/napi-rs/napi-rs/pull/917 @Brooooooklyn 

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@2.0.0-beta.3...napi-derive@2.0.0-beta.3

napi-derive@2.0.0-beta.3

# [2.0.0-beta.4](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.0.0-beta.3...@napi-rs/cli@2.0.0-beta.4) (2021-12-07)


### Features

* **cli:** workaround for Windows i686 ICE in dev mode ([11a5a35](https://github.com/napi-rs/napi-rs/commit/11a5a35485853c722d55dca32a6c3175ecdea8fb))


### Reverts

* Revert "build(deps): bump chalk from 4.1.2 to 5.0.0" ([8b362d8](https://github.com/napi-rs/napi-rs/commit/8b362d8eb1fcb3028e6621bf6f889890b97f28a9))





@napi-rs/cli@2.0.0-beta.4

## What's Changed

* fix(napi-derive): disable register logic in rust test by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/906

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.0.0-beta.1...napi-derive@2.0.0-beta.2

napi-derive@2.0.0-beta.2

## What's Changed

* Re-export `ctor` as `module_init` @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/904
* `TypeName` and `ToNapiValue` should apply to any `HashMap` @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/904

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@2.0.0-beta.1...napi@2.0.0-beta.2

napi@2.0.0-beta.2

# [2.0.0-beta.3](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.0.0-beta.2...@napi-rs/cli@2.0.0-beta.3) (2021-12-03)


### Features

* **napi:** add -p flag which will be bypassed to cargo ([8de30a9](https://github.com/napi-rs/napi-rs/commit/8de30a9287b3586efe81edf4f2745032c07b298a))





@napi-rs/cli@2.0.0-beta.3

### Features

* Enable node_api syntax error experimental functions #897  @idan-at 

napi-sys@2.1.0

### Features

* Update Windows x64 and Windows x86 lib file to `Node.js@17.2.0`

⚠️ There is no official Node.js build for **Windows ARM64** for now: https://github.com/nodejs/build/issues/2450

So if you want build library for **Windows ARM64**, you can not use `experimental` features for now.

napi-build@1.2.0

# [1.1.0](https://github.com/napi-rs/napi-rs/compare/@napi-rs/triples@1.0.3...@napi-rs/triples@1.1.0) (2021-12-02)


### Features

* **triples:** support android armv7 ([809350b](https://github.com/napi-rs/napi-rs/commit/809350b42ff4b3abca421c421a4049053d2e60cb))





@napi-rs/triples@1.1.0

### Bugfix

* Return `None` if the return type of `Object.get` is `ValueType::Null` https://github.com/napi-rs/napi-rs/pull/902/commits/6d4b4af36f9c37ed1cff694f2a267668a1b843de @Brooooooklyn 

napi@2.0.0-beta.1

## What's Changed

* TypedArray support by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/899

```rs
#[napi]
fn convert_u32_array(input: Uint32Array) -> Vec<u32> {
  // AsRef<[u32]>, AsMut<[u32]>, Deref<[u32]>, DerefMut<u32>
  input.to_vec()
}
```

↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓

```ts
export function convertU32Array(input: Uint32Array): Array<number>
```

* Android armv7 by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/901
* Enable node_api syntax error experimental functions by @idan-at in https://github.com/napi-rs/napi-rs/pull/897

## New Contributors
* @idan-at made their first contribution in https://github.com/napi-rs/napi-rs/pull/897

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@2.0.0-alpha.8...napi@2.0.0-beta.0

napi@2.0.0-beta.0

### Bugfix

* Correct the aliased type generation https://github.com/napi-rs/napi-rs/pull/902/commits/b2fea4d5b3aef4a4df4ccecca7cf7f5a30659e40 @Brooooooklyn 
* Do not unwrap `Option` value in object getter if the type of field is Option<T> https://github.com/napi-rs/napi-rs/pull/902/commits/6d4b4af36f9c37ed1cff694f2a267668a1b843de @Brooooooklyn 

napi-derive@2.0.0-beta.1

# [2.0.0-beta.2](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.0.0-beta.1...@napi-rs/cli@2.0.0-beta.2) (2021-12-02)


### Bug Fixes

* **cli:** android armv7 CI config in new command ([d495cc1](https://github.com/napi-rs/napi-rs/commit/d495cc11f805e0c85327850f25d91e1d58c48ff2))





@napi-rs/cli@2.0.0-beta.2

# [2.0.0-beta.1](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.0.0-beta.0...@napi-rs/cli@2.0.0-beta.1) (2021-12-02)


### Bug Fixes

* **cli:** missing exported enum ([d58e488](https://github.com/napi-rs/napi-rs/commit/d58e488fa210d83e8cac814ff207403d51a532ab))





@napi-rs/cli@2.0.0-beta.1

# [2.0.0-beta.0](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.0.0-alpha.12...@napi-rs/cli@2.0.0-beta.0) (2021-12-02)


### Features

* **cli:** fail the pipeline if artifacts not been built ([5f22203](https://github.com/napi-rs/napi-rs/commit/5f222038d316b5e5b6ca2a1debd69e7c26843704))
* **cli:** support android armv7 target ([68b0483](https://github.com/napi-rs/napi-rs/commit/68b0483c81c5cbddc7b0294ae36772701549cbe2))
* **napi:** support TypedArray input and output ([d9c53d7](https://github.com/napi-rs/napi-rs/commit/d9c53d728be02b01f0e2ff19845cd652068f9303))





@napi-rs/cli@2.0.0-beta.0

### Features

* Allow create reference with initial ref count https://github.com/napi-rs/napi-rs/commit/12df7e0159c1f8a9d0340ece7299391f71192420 @Brooooooklyn 

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@1.7.11...napi@1.8.0

napi@1.8.0

### Breaking Changes

* Remove rust enum to avoid compatible issue #887 @Brooooooklyn 
* `threadsafe_function` related types now is under the `napi4` feature flag @Brooooooklyn 
* Add `experimental` flag and `node_api_get_module_file_name` function @Brooooooklyn 

napi-sys@2.0.0

### Features

*  Output Rust doc comments in definitions as jsdoc comments #885 @timfish 

```rust
/// `constructor` option for `struct` requires all fields to be public,
/// otherwise tag impl fn as constructor
/// #[napi(constructor)]
#[napi]
pub struct Animal {
  #[napi(readonly)]
  /// Kind of animal
  pub kind: Kind,

  name: String,
}

#[napi]
impl Animal {
  /// This is the constructor
  #[napi(constructor)]
  pub fn new(kind: Kind, name: String) -> Self {
    Animal { kind, name }
  }

  /// This is a factory method
  #[napi(factory)]
  pub fn with_kind(kind: Kind) -> Self {
    Animal {
      kind,
      name: "Default".to_owned(),
    }
  }

  #[napi(getter)]
  pub fn get_name(&self) -> &str {
    self.name.as_str()
  }

  #[napi(setter)]
  pub fn set_name(&mut self, name: String) {
    self.name = name;
  }

  /// This is a
  /// multi-line comment
  /// with an emoji 🚀
  #[napi]
  pub fn whoami(&self) -> String {
    match self.kind {
      Kind::Dog => {
        format!("Dog: {}", self.name)
      }
      Kind::Cat => format!("Cat: {}", self.name),
      Kind::Duck => format!("Duck: {}", self.name),
    }
  }

  #[napi]
  /// This is static...
  pub fn get_dog_kind() -> Kind {
    Kind::Dog
  }
}
```
⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️
```ts
/**
 * `constructor` option for `struct` requires all fields to be public,
 * otherwise tag impl fn as constructor
 * #[napi(constructor)]
 */
export class Animal {
  /** Kind of animal */
  readonly kind: Kind
  /** This is the constructor */
  constructor(kind: Kind, name: string)
  /** This is a factory method */
  static withKind(kind: Kind): Animal
  get name(): string
  set name(name: string)
  /**
   * This is a
   * multi-line comment
   * with an emoji 🚀
   */
  whoami(): string
  /** This is static... */
  static getDogKind(): Kind
}
```

napi-derive@2.0.0-alpha.10

### Features

* Support rename function args and return type #884 @Brooooooklyn 

```rust
use napi::bindgen_prelude::*;
use napi_derive::napi;

#[napi(ts_args_type = "a: { foo: number }", ts_return_type = "string[]")]
fn ts_rename(a: Object) -> Result<Object> {
  a.get_property_names()
}
```

⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️

```ts
export function tsRename(a: { foo: number }): string[]
```

napi-derive@2.0.0-alpha.9

### Bugfix

* Fix cargo:rerun-if commands #871 @sam3d 


napi-build@1.1.2

## What's Changed

### Support export `rust mod` as `JavaScript Object`

```rust
#[napi]
mod xxh3 {
  use napi::bindgen_prelude::{BigInt, Buffer};

  #[napi]
  pub const ALIGNMENT: u32 = 16;

  #[napi(js_name = "xxh3_64")]
  pub fn xxh64(input: Buffer) -> u64 {
    let mut h: u64 = 0;
    for i in input.as_ref() {
      h = h.wrapping_add(*i as u64);
    }
    h
  }
}
```

⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️

```ts
export namespace xxh3 {
  export const ALIGNMENT: number
  export function xxh3_64(input: Buffer): BigInt
  export function xxh128(input: Buffer): BigInt
}
```

### Support return `&Self`  for method chain

```rust
#[napi]
pub struct ClassWithFactory {
  pub name: String,
}

#[napi]
impl ClassWithFactory {
  #[napi(factory)]
  pub fn with_name(name: String) -> Self {
    Self { name }
  }

  #[napi]
  pub fn set_name(&mut self, name: String) -> &Self {
    self.name = name;
    self
  }
}
```

⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️

```ts
export class ClassWithFactory {
  name: string
  static withName(name: string): ClassWithFactory
  setName(name: string): this
}
```

## New Contributors

* @sam3d made their first contribution in https://github.com/napi-rs/napi-rs/pull/871

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@2.0.0-alpha.6...napi@2.0.0-alpha.7

napi@2.0.0-alpha.7

# [2.0.0-alpha.11](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.0.0-alpha.10...@napi-rs/cli@2.0.0-alpha.11) (2021-11-25)


### Features

* **napi:** support export rust mod as ts namespace ([1fe39ff](https://github.com/napi-rs/napi-rs/commit/1fe39ff66dceaacca7b99207e13ae1ab8f7bdf39))





@napi-rs/cli@2.0.0-alpha.11

### Bugfix

* missing coerce_to_bool on JsValue https://github.com/napi-rs/napi-rs/commit/5d32a54d6c2a01d7114f1eafdf86889e15efdb8f @Brooooooklyn 
* freeze and seal should be methods of JsObject https://github.com/napi-rs/napi-rs/commit/bc952929fc7157dbb1c423eb4b636b45cfeba124 @Brooooooklyn 


**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@1.7.10...napi@1.7.11

napi@1.7.11

### Bugfix

* missing coerce_to_bool on JsValue https://github.com/napi-rs/napi-rs/commit/4aa56a148cbbd10169285a39231c35070bcb7db5 @Brooooooklyn 
* freeze and seal should be methods of JsObject https://github.com/napi-rs/napi-rs/commit/e8cfa0b467d71a560c868cdf27f356f77d7cbbb1 @Brooooooklyn 

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.0.0-alpha.10...napi@2.0.0-alpha.6

napi@2.0.0-alpha.6

## Features 🎉

### feat(napi-derive): support const export by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/863

```rust
#[napi]
pub const DEFAULT_COST: u32 = 12;
```

⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️

```ts
export const DEFAULT_COST: number
```

⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️

```ts
import { DEFAULT_COST } from './index.js'

console.log(DEFAULT_COST) // 12
```

### feat(napi): implement external value by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/868

```rust
#[napi]
pub fn create_external(size: u32) -> External<u32> {
  External::new(size)
}

#[napi]
pub fn get_external(external: External<u32>) -> u32 {
  *external.as_ref()
}

#[napi]
pub fn mutate_external(mut external: External<u32>, new_val: u32) {
  *external.as_mut() = new_val;
}

#[napi]
pub fn create_external_string(content: String) -> External<String> {
  External::new(content)
}
```

⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️

```ts
export class ExternalObject<T> {
  private readonly __type: unique symbol;
  [val: unique symbol]: T
}

export function createExternal(size: number): ExternalObject<number>
export function getExternal(external: ExternalObject<number>): number
export function mutateExternal(external: ExternalObject<number>, newVal: number): void
export function createExternalString(content: string): ExternalObject<string>
```


⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️

```ts
import test from 'ava'

import { createExternal, getExternal, mutateExternal } from './index.js'

test('external', (t) => {
  const FX = 42
  const ext = createExternal(FX)
  t.is(getExternal(ext), FX)
  mutateExternal(ext, FX + 1)
  t.is(getExternal(ext), FX + 1)
  // Can not pass non `ExternalObject` type to functions accept `ExternalObject`
  // @ts-expect-error
  t.throws(() => getExternal({}))
  const ext2 = createExternalString('wtf')
  // Can not assign `ExternalObject<string>` to `ExternalObject<number>`
  // @ts-expect-error
  const e = t.throws(() => getExternal(ext2))
  t.is(e.message, 'T on `get_value_external` is not the type of wrapped object')
})

```

## Bugfix 

* fix(napi): allow ErrorStrategy to be specified while creating TSFN by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/867

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi@2.0.0-alpha.4...napi@2.0.0-alpha.5

napi@2.0.0-alpha.5

# [2.0.0-alpha.8](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.0.0-alpha.7...@napi-rs/cli@2.0.0-alpha.8) (2021-11-21)


### Features

* **cli:** export android toolchains to PATH before build ([dca5ada](https://github.com/napi-rs/napi-rs/commit/dca5ada9959adb52db073c89f2823908d57c2a51))





@napi-rs/cli@2.0.0-alpha.8

# [2.0.0-alpha.7](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.0.0-alpha.6...@napi-rs/cli@2.0.0-alpha.7) (2021-11-21)


### Bug Fixes

* **cli:** ExternalObject type decalare ([1f64f9f](https://github.com/napi-rs/napi-rs/commit/1f64f9fbf3c9c36ea0f3a843a4754443d2d37daa))





@napi-rs/cli@2.0.0-alpha.7

# [2.0.0-alpha.6](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.0.0-alpha.5...@napi-rs/cli@2.0.0-alpha.6) (2021-11-21)


### Features

* **cli:** refactor cli build ([4c3fe26](https://github.com/napi-rs/napi-rs/commit/4c3fe2647871ca8eede3097235b8ff9acbe64d17))
* **napi:** implement external value ([bdfb150](https://github.com/napi-rs/napi-rs/commit/bdfb1506a22d67633ef26db49a0e1b683cad9c19))





@napi-rs/cli@2.0.0-alpha.6

# [2.0.0-alpha.10](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.0.0-alpha.9...@napi-rs/cli@2.0.0-alpha.10) (2021-11-21)


### Features

* **cli:** create pre-release if tag includes alpha/beta/rc ([7b797d3](https://github.com/napi-rs/napi-rs/commit/7b797d3caf2d7beaa8d48b73a585e5c4f4400532))





@napi-rs/cli@2.0.0-alpha.10

### Bugfix

* `set_property` on `JsObject` should accept any `JsValue` as key https://github.com/napi-rs/napi-rs/commit/bfbe2c0d915789d986594d9a5a4d4805d0083745 @Brooooooklyn 

napi@1.7.10

## What's Changed

* feat(napi): switch to `windows` crate from `winapi` by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/861

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.0.0-alpha.5...napi@2.0.0-alpha.4

napi@2.0.0-alpha.4

## Breaking changes
* `Bigint` is renamed into `BigInt`
* `ValueType::Bigint` is renamed into `ValueType::BigInt`
* Deprecate creating `Error` from fields, `Error` must be created from `Error::new`/`Error::from`, `Error::from_reason`

## Highlight features 🚀

### `await` JavaScript `Promise` in `Rust`

> This feature requires `napi4` and `tokio_rt` features.

```rust
#[napi]
pub async fn async_plus_100(p: Promise<u32>) -> Result<u32> {
  let v = p.await?;
  Ok(v + 100)
}
```

#### Resolve value

```ts
test('await Promise in rust', async (t) => {
  const fx = 20
  const result = await asyncPlus100(
    new Promise((resolve) => {
      setTimeout(() => resolve(fx), 50)
    }),
  )
  t.is(result, fx + 100)
})
```

#### Reject error

```ts
test('Promise should reject raw error in rust', async (t) => {
  const fxError = new Error('What is Happy Planet')
  const err = await t.throwsAsync(() => asyncPlus100(Promise.reject(fxError)))
  t.is(err, fxError)
})
```

## What's Changed
* feat(napi): BigInt codegen support by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/846
* fix(napi-derive-backend): typegen issue when arg is mut by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/847
* feat(napi): create ThreadsafeFunction from JsFunction by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/848
* Fully qualify all types in generated code by @timfish in https://github.com/napi-rs/napi-rs/pull/851
* feat(napi): await Promise<T> in async fn by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/849
* feat(napi): support JsGlobal in `Env` by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/852
* feat(napi): improve symbol support by @Brooooooklyn in https://github.com/napi-rs/napi-rs/pull/853

## New Contributors

* @timfish made their first contribution in https://github.com/napi-rs/napi-rs/pull/851

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.0.0-alpha.3...napi@2.0.0-alpha.3

napi@2.0.0-alpha.3

## What's Changed

* Generate TypeScript `optional types` from Rust `Option`

```rust
#[napi]
fn map_option(val: Option<u32>) -> Option<u32> {
  val.map(|v| v + 1)
}
```

```ts
export function mapOption(val?: number | undefined | null): number | undefined | null
```

```rust
#[napi]
pub struct Context {
  data: String,
  pub maybe_need: Option<bool>,
}
```

```ts
export class Context {
  maybeNeed?: boolean | undefined | null
}
```

```rust
#[napi]
fn read_file<T: Fn(Result<()>, Option<String>) -> Result<()>>(callback: T) {
  match read_file_content() {
    Ok(s) => callback(Ok(()), Some(s)),
    Err(e) => callback(Err(e), None),
  }
  .unwrap();
}
```

```ts
export function readFile(callback: (arg0: Error | undefined, arg1?: string | undefined | null) => void): void
```

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.0.0-alpha.5...napi-derive@2.0.0-alpha.6

napi-derive@2.0.0-alpha.6

## What's Changed
*  fix(napi-derive-backend): JsBuffer should map to Buffer type https://github.com/napi-rs/napi-rs/commit/b8bcdd9c0459cbaf255387da2c2373216dc8cd87 @Brooooooklyn 

**Full Changelog**: https://github.com/napi-rs/napi-rs/compare/napi-derive@2.0.0-alpha.4...napi-derive@2.0.0-alpha.5

napi-derive@2.0.0-alpha.5

# [2.0.0-alpha.5](https://github.com/napi-rs/napi-rs/compare/@napi-rs/cli@2.0.0-alpha.4...@napi-rs/cli@2.0.0-alpha.5) (2021-11-16)


### Bug Fixes

* always add a newline at the end of the file when generating js-binding.js ([753bb1e](https://github.com/napi-rs/napi-rs/commit/753bb1e31b375bb546523d372bcc0a079bae3ed5))


### Features

* **napi:** add pipe flag to pipe the generated files into custom command ([e37c3fd](https://github.com/napi-rs/napi-rs/commit/e37c3fd9089d13c7ee34109ad779b50c77f1b761))





@napi-rs/cli@2.0.0-alpha.5

### Bugfix

- Wrong `CString` usage #854 @Brooooooklyn 

napi@1.7.9

### Bugfix

- fix(napi-derive-backend): wrong restrict on Result return type [413a555](https://github.com/napi-rs/napi-rs/commit/413a55545fa953ba2754c0493a5fbd4817d0da75)  @Brooooooklyn 

napi-derive@2.0.0-alpha.3

## Generate JavaScript binding file for native addons
### Compatible with both `CommonJS` and `ESM`

ESM and CommonJS are ***both*** supported by the generated JavaScript binding file. Using `const { fastFunction } = require('@awesome/addon')`  or `import { fastFunction } from '@awesome/addon' ` as you need.

### No more need `@node-rs/helper` dependency

The `@node-rs/helper` is convenient to load native binary cross platform and cpu arch. But it's not friendly to [`webpack`](https://github.com/webpack/webpack), [`vercel/nft`](https://github.com/vercel/nft) and [`vercel/ncc`](https://github.com/vercel/ncc) because the logic is too dynamic.

It will close:
- https://github.com/napi-rs/node-rs/issues/316
- https://github.com/napi-rs/node-rs/issues/491

@napi-rs/cli@2.0.0-alpha.4

### Features

*  feat(napi): implement Env::throw to throw any JsValue #839  @Brooooooklyn 

#### Throw `SyntaxError`:

```rs
#[js_function(1)]
pub fn throw_syntax_error(ctx: CallContext) -> Result<JsUndefined> {
  let message: JsString = ctx.get(0)?;
  let syntax_error = ctx
    .env
    .get_global()?
    .get_named_property::<JsFunction>("SyntaxError")?;
  ctx.env.throw(syntax_error.new(&[message])?)?;
  ctx.env.get_undefined()
}
```

napi@1.7.8

## 🚧 Breaking Changes

### `Task`

`resolve` and `reject` now take `&mut self` instead of `self`. Add new `fn finally` to excute after `resolve` or `reject`:

### `Ref`

`unref` now takes `&mut self` instead of `self`.

```diff
struct BufferLength(Ref<JsBufferValue>);

impl Task for BufferLength {
  type Output = usize;
  type JsValue = JsNumber;

  fn compute(&mut self) -> Result<Self::Output> {
    Ok(self.0.len() + 1)
  }

-  fn resolve(self, env: Env, output: Self::Output) -> Result<Self::JsValue> {
-    self.0.unref(env)?;
+  fn resolve(&mut self, env: Env, output: Self::Output) -> Result<Self::JsValue> {
    env.create_uint32(output as u32)
   }

-  fn reject(self, err: Error) -> Result<Self::JsValue> {
-    self.0.unref(env)?;
-    Err(err)
-  }

+  fn finally(&mut self, env: Env) -> Result<()> {
+    self.0.unref(env)?;
+    Ok(())
+  }
}


```

## Features

### `Either` type #823  @Brooooooklyn 

`Either` types could be passed in as arguments or as return types:

```rs
#[napi]
fn either4(input: Either4<String, u32, bool, Obj>) -> u32 {
  match input {
    Either4::A(s) => s.len() as u32,
    Either4::B(n) => n,
    Either4::C(b) => {
      if b {
        1
      } else {
        0
      }
    }
    Either4::D(f) => match f.v {
      Either::A(s) => s.len() as u32,
      Either::B(n) => n,
    },
  }
}
```

⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️


```ts
interface Obj {
  v: string | number
}
export function either4(input: string | number | boolean | Obj): number
```


### `AsyncTask` with `AbortSignal` support #831 @Brooooooklyn 

![carbon(5)](https://user-images.githubusercontent.com/3468483/140470180-ba8d6d7f-48e6-4bde-a337-aada4fb1f0fe.png)

![carbon(3)](https://user-images.githubusercontent.com/3468483/140470212-1e5c6364-eb1e-42be-bcee-e5c65e92f117.png)

### `Static Factory` function for `Class` #834 @Brooooooklyn 

<p align="center">
  <img height="368" src="https://user-images.githubusercontent.com/3468483/140616635-25641568-9822-40cb-aae0-c0baa3ad7022.png" />
  <img width="55%" src="https://user-images.githubusercontent.com/3468483/140616505-f26d4975-344b-4dba-a42c-4289e0342e3b.png">
</p>


### `Env::throw` to throw any JavaScript Value [e0671fe](https://github.com/napi-rs/napi-rs/commit/e0671fe071038beba7ca6b098283433a9c66c07d) @Brooooooklyn 

#### Throw `SyntaxError`:

```rs
#[js_function(1)]
pub fn throw_syntax_error(ctx: CallContext) -> Result<JsUndefined> {
  let message: JsString = ctx.get(0)?;
  let syntax_error = ctx
    .env
    .get_global()?
    .get_named_property::<JsFunction>("SyntaxError")?;
  ctx.env.throw(syntax_error.new(&[message])?)?;
  ctx.env.get_undefined()
}
```
