Node.js SDK Stable

The official @aevum-zenth/sdk package provides type-safe, async/await support, and unified access to all 400+ Aevum Zenth divisions. Build integrations with Energy, Aerospace, Finance, and more from a single client instance.

bash

npm install @aevum-zenth/sdk

⚡ Requires Node.js 18+

The SDK utilizes modern JavaScript features including top-level await and native fetch polyfills. Ensure your runtime is updated.

Quickstart

Initialize the client with your API credentials and start interacting with division endpoints immediately.

JavaScript (ESM)

import { AevumClient } from '@aevum-zenth/sdk';

// Initialize client
const client = new AevumClient({
  apiKey: process.env.AEVUM_API_KEY,
  organization: process.env.AEVUM_ORG_ID,
});

// Access division modules
const gridStatus = await client.energy.getGridStatus('sector-7');
console.log(gridStatus);

// Cross-divisional query
const report = await client.reporting.generate({
  divisions: ['energy', 'aerospace', 'finance'],
  dateRange: 'last-30-days',
});

Key Features

🌐

Unified API

Access all 400+ subsidiaries through a single consistent interface with shared error handling and retry logic.

🔒

Enterprise Auth

Built-in support for OAuth2, API keys, and ZenthCorp SSO with automatic token rotation.

⚡

Streaming Support

Real-time streaming for market data, grid telemetry, and flight tracking via Server-Sent Events.

🧪

Type Safety

Full TypeScript definitions included. Auto-generated types from division schemas.

Division Modules

The SDK exposes modular namespaces for each operational division. Modules are lazily loaded to optimize bundle size.

Namespace	Division	Endpoints
`client.energy`	Aevum Energy & Power	Grid status, fusion metrics, solar arrays
`client.aerospace`	Aevum Aerospace	Flight paths, orbital data, satellite telemetry
`client.finance`	Aevum Capital Group	Trading, risk models, portfolio analytics
`client.health`	Zenth Health Sciences	Clinical trials, genomic data, supply chain
`client.logistics`	Aevum Global Logistics	Freight tracking, warehouse automation

Error Handling

All SDK methods throw typed errors. Use try/catch blocks or async/await error handling patterns.

JavaScript

try {
  const data = await client.finance.executeTrade(order);
} catch (err) {
  if (err instanceof AevumError) {
    console.error(`Division Error: ${err.code}`);
    console.error(err.message);
  }
}

Pagination

Large datasets support cursor-based pagination. Use the .autoPaginate() helper to iterate seamlessly.

JavaScript

const allAssets = await client.energy.autoPaginate('listSolarArrays', {
  region: 'EMEA',
  status: 'active',
});

console.log(`Found ${allAssets.length} solar arrays`);