Node.js SDK 3.0: What's New

We're excited to announce version 3.0 of our Node.js SDK — a ground-up rewrite focused on developer experience, type safety, and performance.

TypeScript-First Design

SDK 3.0 is written entirely in TypeScript. Every method, every response, and every error is fully typed:

import { TrafficOrchestrator } from '@traffic-orchestrator/client';

const to = new TrafficOrchestrator({ apiKey: process.env.TO_API_KEY! });

// Full IntelliSense for request and response
const result = await to.validate({
  licenseKey: 'XXXX-YYYY-ZZZZ',
  machineId: getMachineId()
});

if (result.valid) {
  console.log(result.license.plan); // Typed!
}

Improved Error Handling

Errors are now structured and typed, making them easy to handle programmatically:

try {
  await to.validate({ licenseKey });
} catch (error) {
  if (error instanceof TOValidationError) {
    // License-specific errors
  } else if (error instanceof TONetworkError) {
    // Handle connectivity issues
  }
}

Built-in Retry Logic

SDK 3.0 includes automatic retry with exponential backoff for transient failures. Configure it to match your requirements:

const to = new TrafficOrchestrator({
  apiKey: process.env.TO_API_KEY!,
  retries: 3,
  retryDelay: 1000, // Start at 1 second
});

Offline Validation

New in 3.0: cryptographic offline validation using Ed25519 signatures. Validate licenses without network access:

const result = to.verifyOffline(licenseKey, {
  publicKey: process.env.TO_PUBLIC_KEY!
});
// Works without any network call

Upgrading from 2.x

Upgrading is straightforward:

npm install @traffic-orchestrator/client@latest

The API is backward-compatible for core methods. See our full migration guide in the documentation for details on any breaking changes.