# @amplitude/node > Offical Amplitude SDK for Node.js Latest version **1.10.2** (published 2022-09-08) · MIT license · 0 weekly downloads ## Install ```sh npm install @amplitude/node pnpm add @amplitude/node yarn add @amplitude/node bun add @amplitude/node ``` ## Health **Score 45/100 (D)** — status: abandoned. Positive: has types; esm support; no vulnerabilities; high maintenance score; high quality score. Warnings: low downloads. Negative: abandoned. ## Facts | | | |---|---| | Version | 1.10.2 | | Published | 2022-09-08 | | First published | 2020-05-04 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Node | >=10 | | Dependencies | 4 | | Unpacked size | 226.5 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 73 | | Author | Amplitude Inc | | Maintainers | mae.capozzi, sdk.dev, dnshi, kevinpagtakhan, justin-fiedler, qingzhuo, rctbusk, manthursday, jackmccloy, amp_haoliu, myztiq, curtisbliu, jtran, kelvin-lu, nutwani, hao.yu, kelson.warner, ajhorst_amp, brian.giori | ## Links - npm: https://www.npmjs.com/package/@amplitude/node - Repository: https://github.com/amplitude/Amplitude-Node - Issues: https://github.com/amplitude/Amplitude-Node/issues - npm.io page: https://npm.io/package/@amplitude/node ## Dependencies (4) - [tslib](https://npm.io/package/tslib.md) ^2.0.0 - [@amplitude/types](https://npm.io/package/@amplitude/types.md) ^1.10.2 - [@amplitude/utils](https://npm.io/package/@amplitude/utils.md) ^1.10.2 - [@amplitude/identify](https://npm.io/package/@amplitude/identify.md) ^1.10.2 ## Recent versions - 1.10.2 (latest) — 2022-09-08 - 1.10.1 — 2022-08-29 - 1.10.0 — 2022-03-31 - 1.9.2 — 2022-01-31 - 1.9.1 — 2021-11-11 - 1.9.0 — 2021-10-15 - 1.8.4 — 2021-09-22 - 1.8.3 — 2021-09-01 - 1.8.2 — 2021-08-25 - 1.8.1 — 2021-08-20 - 1.8.0 — 2021-07-27 - 1.7.0 — 2021-06-25 - 1.6.1 — 2021-05-25 - 1.6.0 — 2021-05-20 - 1.5.5 — 2021-05-12 - … 25 more at https://npm.io/package/@amplitude/node/versions ## README


[![npm version](https://badge.fury.io/js/%40amplitude%2Fnode.svg)](https://badge.fury.io/js/%40amplitude%2Fnode) # Official Amplitude SDK for Node.js This is Amplitude Node.js SDK written in Typescript, the 1st backend SDK for Amplitude. Currently, it's in beta version, but we would like to hear your ideas too! At this moment, we keep it minimal and simple because we want to give more thoughts over different customers' needs. Modularization and flexiblity will be the main priorities for this SDK. ## Installation and Quick Start Please visit our :100:[Developer Center](https://developers.amplitude.com/docs/nodejs) for instructions on installing and using our the SDK. ## Node and JS SDK's There might be confusion about the use case and motivations for building the Node SDK when we have a JS SDK. The [Amplitude-Javascript](https://github.com/amplitude/Amplitude-JavaScript) SDK is meant to be run in browser environments and on client devices, resulting in very different designs and assumptions. For example, the Javascript SDK contains functionality that interfaces specifically with Web APIs (e.g. `referrer` and UTM attribution information, `navigator.language`), and that it can store metadata in API's such as cookies and localStorage. It also makes other assumptions, such as that there is only one active "identity" sending events at a time. In contrast, the Node SDK is meant to be run in a Node environment, and kept as flexible and modular as possible as to accommodate the various different use cases it may be used in. It makes fewer assumption on how many users it is processing and what is available. Though we primarily foresee the Node SDK being used in server environments, we would love to hear how you plan to use it! ## Retry Behavior One of the important aspects and functionalities of the Node SDK is its **ability to retry event payloads that fail**. Network requests can fail for a variety of reasons, and it is important that the SDK provides a layer of **robustness** and **correctness** when these failures happen. By default, the Node SDK will retry events on loop after a short pause if it finds that a request has failed; however, this strategy is not ideal for every use case. As such, you can provide your own `retryClass` that implements the exported `Retry` interface (currently a single `sendEventsWithRetry` function). For example, there is a secondary `OfflineRetryHandler` that is meant for a more opinionated use case where network requests may not always be available for long periods of time: ``` import { init, OfflineRetryHandler } from "@amplitude/node" const amplitudeClient = init('YOUR_API_KEY', { retryClass: new OfflineRetryHandler('YOUR_API_KEY') }) ``` As well as a `BaseRetryHandler` that does **no** retrying at all but contains several helper functions to extend from. ## Need Help? If you have any problems or issues over our SDK, feel free to [create a github issue](https://github.com/amplitude/Amplitude-Node/issues/new) or submit a request on [Amplitude Help](https://help.amplitude.com/hc/en-us/requests/new). --- _Source: https://npm.io/package/@amplitude/node · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._