@signalwire/compatibility-api

SignalWire Compatibility SDK

The SignalWire Compatibility SDK is designed to make migrating your existing phone or messaging application easy and quick, while giving you access to our next generation APIs and endpoints to help you take your application to the next level.

Getting Started

Read the implementation documentation, guides and API Reference at the official SignalWire Compatibility SDK Documentation site.

Node.js Version Support

As of version 3.2.0, this library requires Node.js 16 or higher. Support for Node.js 14 (which reached end-of-life in April 2023) has been dropped.

Using with Node.js 14

If you need to use this library with Node.js 14, you have two options:

Option 1: Install the last compatible version (recommended)

npm install @signalwire/compatibility-api@3.1.4

Option 2: Override dependencies (advanced, not recommended)

If you absolutely must use the latest version with Node.js 14, you can attempt to override the engine check and axios version, though this is not tested or supported:

{
  "dependencies": {
    "@signalwire/compatibility-api": "^3.2.0"
  },
  "overrides": {
    "@signalwire/compatibility-api": {
      "axios": "^1.6.2"
    }
  },
  "engines": {
    "node": ">=14"
  }
}

Note: This override approach may result in security vulnerabilities or unexpected behavior. We strongly recommend upgrading to Node.js 16 or higher.

Contributing

SignalWire Compatibility SDK is open source and maintained by the SignalWire team, but we are very grateful for everyone who has contributed and assisted so far.

If you'd like to contribute, feel free to visit our Slack channel and read our developer section to get the code running in your local environment.

Developers

The Compatibility SDK is a package inside the compatibility-api-js repository. To setup the dev environment follow these steps:

• Download the installer for the LTS version of Node.js. This is the best way to also install npm.
• Fork the compatibility-api-js repository and clone it.
• Create a new branch from main for your change.
• Run npm install to install global dependencies.
• Make changes!

Versioning

SignalWire Compatibility SDK follows Semantic Versioning 2.0 as defined at http://semver.org.

License

@signalwire/compatibility-api-js is copyright © 2018-2023 SignalWire. It is free software, and may be redistributed under the terms specified in the MIT-LICENSE file.

Changelog

[3.2.0] - 2025-09-30

Changed

• Update axios dependency to 1.12.2 to address security vulnerability (CVE-2024-39338).
• Drop support for Node.js 14 (EOL) - minimum supported version is now Node.js 16.
• Update CI testing to Node.js 16, 18, and 20.

Fixed

• Add mdurl type override to resolve dependency conflicts.