The LicenseSpring Node.js SDK lets you implement license activation, entitlement enforcement, and usage tracking directly inside your JavaScript or TypeScript application with no external licensing infrastructure to build or maintain.
Built for modern Node.js environments, the SDK covers backend APIs, SaaS platforms, developer tooling, automation pipelines, and Electron desktop applications from a single integration.
ISO 27001 Certified
ISO 9001 Certified
Trusted by Software Vendors WorldwideThe Node.js SDK provides a set of classes that connect your JavaScript or TypeScript application directly to LicenseSpring's licensing platform. Once installed, you have full access to LicenseSpring's licensing infrastructure.
With the SDK, you can:
Activate and validate licenses at runtime: online, offline, or in air-gapped environments
Enforce node-locked, floating, subscription, and consumption-based licensing: using the model that fits your product
Gate features by entitlement: control access to functionality at the SDK level, across any Node.js application type
Run local license checks with configurable grace periods: define how long the SDK honors a cached license before requiring revalidation, so connectivity loss never interrupts active users
Bind licenses to hardware: generate persistent hardware IDs using multiple device fingerprinting algorithms suited to the deployment environment, or supply your own fingerprinting logic
Store and validate local license files: track licensing state locally to support offline and cached validation flows
Track usage and activations: feed license telemetry back to the LicenseSpring platform in real time
The Node.js SDK is designed for developers building and distributing commercial software in JavaScript and TypeScript.
| Use Case | Description |
|---|---|
Backend Services | Implement license validation in Node.js APIs and services |
SaaS Platforms | Manage licensing workflows for server-side applications |
Developer Tools | License CLI tools or developer utilities written in Node.js |
Automation Platforms | Protect proprietary automation or scripting tools |
Desktop Apps | License Electron-based applications |
The Node.js SDK is published on npm and can be installed using standard Node package management.
Install the package with:
npm i --save @licensespring/node-sdk
Once installed, developers can import the SDK into JavaScript or TypeScript applications and begin interacting with LicenseSpring APIs.
The Node.js SDK includes several classes designed to simplify interactions with LicenseSpring services and manage licensing workflows.
The LicenseAPI class provides a wrapper for interacting directly with the LicenseSpring License API.
Input validation
Response signature verification
Secure API communication
License activation
License validation
Feature entitlement checks
Consumption tracking
Device variable tracking
The LicenseManager class extends the functionality of LicenseAPI and provides higher-level license management features.
Manage license activation and validation
Read and write local license files
Automatically generate hardware IDs
Track consumption and feature usage locally
The BundleManager class is used to manage license bundles, allowing applications to work with bundled licenses instead of individual license keys.
BundleManager behaves similarly to LicenseManager but is designed specifically for applications that require bundle-based licensing structures.
The LicenseFile class represents the local license file created by LicenseManager or BundleManager.
This file is used by client applications to track licensing state locally and support offline or cached license validation.
Load license data from local storage
Perform local license validation
Track local consumption usage
The Node.js SDK supports two approaches to hardware fingerprinting for device-bound licensing: use the built-in hardware ID generator included in the SDK, or supply your own fingerprinting logic. Both approaches produce a hardware identifier that can be used to bind a license to a specific device or environment.
Multiple fingerprinting algorithms are available, allowing you to select the approach appropriate for the target deployment, whether a physical server, a developer workstation, or an Electron desktop environment.
Generated hardware IDs are used for:
Node-locked license binding
Device identification and activation tracking
Consistent hardware fingerprinting across multi-SDK product deployments
Products that pair a Node.js component with other parts of their stack, whether that’s a C++ core engine, a Python data layer, a Java backend, or a Go service, can use multiple LicenseSpring SDKs simultaneously.
All LicenseSpring SDKs share a common license file format and compute hardware identifiers using the same underlying logic. A license issued to a device is recognized consistently across every component of your product, regardless of which SDK each part uses.
The Node.js SDK fully supports deployments with limited or no internet connectivity with two distinct activation paths:
Offline activation: uses a file-exchange flow for environments with occasional or restricted connectivity
Air-gapped activation: uses a code-exchange flow for environments where no external data transfer is permitted
Our developer support team can help you implement licensing quickly and correctly.