deepl-node
Version:
deepl-node is the official DeepL Node.js client library
346 lines (266 loc) • 12.9 kB
Markdown
# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [Unreleased]
### Added
<!-- * add to here... -->
### Changed
<!-- * add to here... -->
## [1.17.3] - 2025-03-11
### Changed
- Upgrade axios lib due to https://github.com/advisories/GHSA-jr5f-v2jv-69x6
## [1.17.2] - 2025-03-06
### Added
- Added option to override translate path
## [1.17.1] - 2025-03-04
### Added
- Update list of supported target languages
### Changed
- Adjust environment variable handling to avoid side effects in the published library
## [1.17.0] - 2025-02-25
### Added
* Added document minification as a feature before document translation, to
allow translation of large docx or pptx files. For more info check the README.
* Added .env.example file with `dotenv` library for environment variables management
* Improve unit tests
### Changed
* Upgrade cross-spawn library (see https://github.com/advisories/GHSA-3xgq-45jj-v275)
## [1.16.0] - 2025-01-22
### Added
* Added support for the Write API in the client library, the implementation
can be found in the `DeepLClient` class. Please refer to the README for usage
instructions.
### Changed
* The main functionality of the library is now also exposed via the `DeepLClient`
class. Please change your code to use this over the `Translator` class whenever
convenient.
## [1.15.0] - 2024-11-15
### Added
* Added `modelType` option to `translateText()` to use models with higher
translation quality (available for some language pairs), or better latency.
Options are `'quality_optimized'`, `'latency_optimized'`, and `'prefer_quality_optimized'`
* Added the `modelTypeUsed` field to `translateText()` response, that
indicates the translation model used when the `modelType` option is
specified.
## [1.14.0] - 2024-09-17
### Added
* Added `billedCharacters` field to text translation response.
## [1.13.1] - 2024-08-14
### Added
* Added supported glossary languages: Danish (`'da'`), Norwegian (bokmål)
(`'nb'`), and Swedish (`'sv'`). The corresponding glossary language code
TypeScript types are extended.
Note: older library versions also support the new glossary language pairs,
this update only adds new types.
### Security
* Increase `axios` locked-version due to security
[vulnerability in axios <1.7.3](https://github.com/advisories/GHSA-8hc4-vh64-cxmj)
## [1.13.0] - 2024-04-12
### Added
* Add possibility to add extra parameters to a translation request (both text and document).
DeepL engineers use this to test features in the API before they are released. Library users
who cannot update their DeepL library dependency could use these extra parameters to access
features in the API that are released in the future.
### Security
* Increase `follow-redirects` locked-version due to security
[vulnerability in follow-redirects <1.15.5](https://github.com/advisories/GHSA-cxjh-pqwp-8mfp)
## [1.12.0] - 2024-02-27
### Added
* New language available: Arabic (`'ar'`). Add language code constants and tests.
Arabic is currently supported only for text translation; document translation
support for Arabic is coming soon.
Note: older library versions also support the new language, this update only adds new code constants.
## [1.11.1] - 2024-01-26
### Fixed
* Dependencies: Update `follow-redirects` due to security vulnerability
### Security
* Increase `axios` requirement to `^1.6.4` to avoid
[vulnerability in follow-redirects <1.15.4](https://github.com/advisories/GHSA-jchw-25xp-jwwc)
## [1.11.0] - 2023-11-03
### Added
* Add optional `context` parameter for text translation, that specifies
additional context to influence translations, that is not translated itself.
### Changed
* Added notice in Readme that starting in 2024 the library will drop support for
Node versions that are officially end-of-life.
* Keep-Alive is now used by HTTP(S) agent, to reduce latency for subsequent API requests.
### Fixed
* CI: silence npm audit warnings in non-production dependencies due to
currently-unresolvable [vulnerability in semver <7.5.2](https://github.com/npm/node-semver/pull/564).
* Increase axios dependency to >=1.2.2, due to [bug in axios v1.2.1](https://github.com/axios/axios/issues/5346).
* Added supported glossary languages: Italian (it), Dutch (nl), Polish (pl),
Portuguese (pt), Russian (ru) and Chinese (zh). The corresponding glossary
language code TypeScript types are extended.
Note: older library versions also support the new glossary language pairs,
this update only adds new types.
* Fixed typo in readme: `createGlossaryWithCsv` not `createGlossaryFromCsv`
* Issue [#36](https://github.com/DeepLcom/deepl-node/issues/36) thanks to
[phenomen](https://github.com/phenomen).
## [1.10.2] - 2023-06-02
### Fixed
* Fixed erroneous version bump
## [1.10.1] - 2023-06-02
### Fixed
* Limit example typescript version to 5.0 due to Node 12 incompatibility
## [1.10.0] - 2023-06-01
### Fixed
* Changed document translation to poll the server every 5 seconds. This should greatly reduce observed document translation processing time.
* Fix getUsage request to be a HTTP GET request, not POST.
## [1.9.0] - 2023-03-22
### Added
* Added platform and node version information to the user-agent string that is sent with API calls, along with an opt-out.
* Added method for applications that use this library to identify themselves in API requests they make.
### Fixed
* Fixed proxy example code in README
## [1.8.0] - 2023-01-26
### Added
* New languages available: Korean (`'ko'`) and Norwegian (bokmål) (`'nb'`). Add
language code constants and tests.
Note: older library versions also support the new languages, this update only
adds new code constants.
## [1.7.5] - 2023-01-25
### Fixed
* Also send options in API requests even if they are default values.
## [1.7.4] - 2023-01-09
### Fixed
* Omit undefined `supportsFormality` field for source languages.
## [1.7.3] - 2023-01-04
### Changed
* CI: suppress `npm audit` warnings for dev dependencies, due to CVE in
`eslint-plugin-import > tsconfig-paths > json5`.
### Fixed
* Support `axios` v1.2.1, that resolves the issue in v1.2.0.
## [1.7.2] - 2022-11-24
### Fixed
* Limit `axios` to v1.1.3 or lower due to an issue in v1.2.0.
* This is a temporary workaround until the issue is resolved.
## [1.7.1] - 2022-10-12
### Fixed
* Prefer `for .. of` loops to `for .. in` loops, to handle cases where array
prototype has been modified.
* Issue [#10](https://github.com/DeepLcom/deepl-node/issues/10) thanks to
[LorenzoJokhan](https://github.com/LorenzoJokhan)
* Node 18 is supported, this is now explicitly documented.
## [1.7.0] - 2022-09-30
### Added
* Add formality options `'prefer_less'` and `'prefer_more'`.
### Changed
* Requests resulting in `503 Service Unavailable` errors are now retried.
Attempting to download a document before translation is completed will now
wait and retry (up to 5 times by default), rather than rejecting.
## [1.6.0] - 2022-09-09
### Added
* New language available: Ukrainian (`'uk'`). Add language code constant and
tests.
Note: older library versions also support new languages, this update only
adds new code constant.
## [1.5.0] - 2022-08-19
### Added
* Add proxy support.
## [1.4.0] - 2022-08-09
### Added
* Add `createGlossaryWithCsv()` allowing glossaries downloaded from website to
be easily uploaded to API.
## [1.3.2] - 2022-08-09
### Changed
* Update contributing guidelines, we can now accept Pull Requests.
### Fixed
* Fix GitLab CI config.
* Correct language code case in `getSourceLanguages()` and
`getTargetLanguages()` result.
* Use TypeScript conditional types on `translateText()` to fix TS compiler
errors.
* Issue [#9](https://github.com/DeepLcom/deepl-node/issues/9) thanks to
[Jannis Blossey](https://github.com/jblossey)
## [1.3.1] - 2022-05-18
Replaces version 1.3.0 which was broken due an incorrect package version.
### Added
* New languages available: Indonesian (`'id'`) and Turkish (`'tr'`). Add
language code constants and tests.
Note: older library versions also support the new languages, this update only
adds new code constants.
### Changed
* Change return type of `nonRegionalLanguageCode()` to newly-added type
`NonRegionalLanguageCode`.
## [1.3.0] - 2022-05-18
Due to an incorrect package version, this version was removed.
## [1.2.2] - 2022-04-20
### Added
* Glossaries are now supported for language pairs: English <-> Japanese and
French <-> German. The corresponding glossary language code TypeScript types
are extended.
Note: older library versions also support the new glossary language pairs,
this update only adds new types.
## [1.2.1] - 2022-04-14
### Changed
* Simplify and widen the accepted version range for `node` and `@types/node`.
## [1.2.0] - 2022-04-13
### Added
* Add `errorMessage` property to `DocumentStatus`, describing the error in case
of document translation failure.
## [1.1.1] - 2022-04-12
### Fixed
* Fix some tests that intermittently failed.
* Fix `isDocumentTranslationComplete()` to reject if document translation fails.
## [1.1.0] - 2022-03-22
### Added
- Add support for HTML tag handling.
### Fixed
- Fix spurious test failures.
## [0.1.2] - 2022-03-10
### Changed
- Change TypeScript-example to match other examples.
- Improvements to code style and formatting.
- Increase TypeScript compiler target to `es2019`.
## [0.1.1] - 2022-03-04
### Fixed
- Fix error in package version.
## [0.1.0] - 2022-03-04
Initial release.
## 1.0.0 - 2019-02-04
This version of the package on NPM refers to an earlier unofficial DeepL Node.js
client library, which can be found [here][1.0.0]. The official DeepL Node.js
client library took over this package name. Thanks to
[Tristan De Oliveira](https://github.com/icrotz) for transferring the package
ownership.
<!-- (Unreleased should never be deleted) -->
[Unreleased]: https://github.com/DeepLcom/deepl-node/compare/v1.17.3...HEAD
[1.17.3]: https://github.com/DeepLcom/deepl-node/compare/v1.17.2...v1.17.3
[1.17.2]: https://github.com/DeepLcom/deepl-node/compare/v1.17.1...v1.17.2
[1.17.1]: https://github.com/DeepLcom/deepl-node/compare/v1.17.0...v1.17.1
[1.17.0]: https://github.com/DeepLcom/deepl-node/compare/v1.16.0...v1.17.0
[1.16.0]: https://github.com/DeepLcom/deepl-node/compare/v1.15.0...v1.16.0
[1.15.0]: https://github.com/DeepLcom/deepl-node/compare/v1.14.0...v1.15.0
[1.14.0]: https://github.com/DeepLcom/deepl-node/compare/v1.13.1...v1.14.0
[1.13.1]: https://github.com/DeepLcom/deepl-node/compare/v1.13.0...v1.13.1
[1.13.0]: https://github.com/DeepLcom/deepl-node/compare/v1.12.0...v1.13.0
[1.12.0]: https://github.com/DeepLcom/deepl-node/compare/v1.11.1...v1.12.0
[1.11.1]: https://github.com/DeepLcom/deepl-node/compare/v1.11.0...v1.11.1
[1.11.0]: https://github.com/DeepLcom/deepl-node/compare/v1.10.2...v1.11.0
[1.10.2]: https://github.com/DeepLcom/deepl-node/compare/v1.9.0...v1.10.2
[1.10.1]: https://github.com/DeepLcom/deepl-node/compare/v1.9.0...v1.10.1
[1.10.0]: https://github.com/DeepLcom/deepl-node/compare/v1.9.0...v1.10.0
[1.9.0]: https://github.com/DeepLcom/deepl-node/compare/v1.8.0...v1.9.0
[1.8.0]: https://github.com/DeepLcom/deepl-node/compare/v1.7.5...v1.8.0
[1.7.5]: https://github.com/DeepLcom/deepl-node/compare/v1.7.4...v1.7.5
[1.7.4]: https://github.com/DeepLcom/deepl-node/compare/v1.7.3...v1.7.4
[1.7.3]: https://github.com/DeepLcom/deepl-node/compare/v1.7.2...v1.7.3
[1.7.2]: https://github.com/DeepLcom/deepl-node/compare/v1.7.1...v1.7.2
[1.7.1]: https://github.com/DeepLcom/deepl-node/compare/v1.7.0...v1.7.1
[1.7.0]: https://github.com/DeepLcom/deepl-node/compare/v1.6.0...v1.7.0
[1.6.0]: https://github.com/DeepLcom/deepl-node/compare/v1.5.0...v1.6.0
[1.5.0]: https://github.com/DeepLcom/deepl-node/compare/v1.4.0...v1.5.0
[1.4.0]: https://github.com/DeepLcom/deepl-node/compare/v1.3.2...v1.4.0
[1.3.2]: https://github.com/DeepLcom/deepl-node/compare/v1.3.1...v1.3.2
[1.3.1]: https://github.com/DeepLcom/deepl-node/compare/v1.2.2...v1.3.1
[1.3.0]: https://github.com/DeepLcom/deepl-node/releases/tag/v1.3.0
[1.2.2]: https://github.com/DeepLcom/deepl-node/compare/v1.2.1...v1.2.2
[1.2.1]: https://github.com/DeepLcom/deepl-node/compare/v1.2.0...v1.2.1
[1.2.0]: https://github.com/DeepLcom/deepl-node/compare/v1.1.1...v1.2.0
[1.1.1]: https://github.com/DeepLcom/deepl-node/compare/v1.1.0...v1.1.1
[1.1.0]: https://github.com/DeepLcom/deepl-node/compare/v0.1.2...v1.1.0
[0.1.2]: https://github.com/DeepLcom/deepl-node/compare/v0.1.1...v0.1.2
[0.1.1]: https://github.com/DeepLcom/deepl-node/compare/v0.1.0...v0.1.1
[0.1.0]: https://github.com/DeepLcom/deepl-node/releases/tag/v0.1.0
[1.0.0]: https://github.com/icrotz/deepl