Developers · Charge Signals
Build on the post-connect event and policy layer.
Vehicle APIs connect the car. Nerava Charge Signals turns those signals into verified events, campaign-rule decisions, and actions your application can consume — via partner-scoped APIs, webhooks, and a TypeScript SDK.
npm install @nerava/sdkWhat you integrate against
The Partner API exposes the same primitives as the platform — not a separate product surface.
Verified sessions
Submit or receive canonical charging sessions built from Tesla Fleet, Smartcar, and partner evidence — with confidence and source metadata.
Campaign rules
List eligible campaigns and let Nerava evaluate consent, location, time, budget, and frequency before an action fires.
Outcome delivery
Subscribe to signed webhooks for rule decisions and program actions. Idempotent by default so retries stay safe.
Partner isolation
Partner API keys are scoped and hashed. Workspaces stay isolated; trust tiers inform session quality scoring.
TypeScript SDK
Typed modules over the Partner API — sessions, campaigns, grants, and wallet helpers where your program uses Nerava-managed rewards.
Quick start
import { Nerava, usd, latLng } from "@nerava/sdk";
const nerava = new Nerava({
apiKey: "nrv_pk_your_partner_key"
});
// Submit a charging session
const session = await nerava.sessions.submit({
vehicleId: "v_abc",
chargerId: "c_heights",
...latLng(31.0824, -97.6492),
});
// List campaigns eligible for this context
const campaigns = await nerava.campaigns.list({
lat: 31.0824, lng: -97.6492,
});
// Credit a driver wallet when your program uses Nerava rewards
await nerava.wallet.credit({
driverId: "drv_1",
amount: usd(500),
campaignId: "camp_1",
});Built for production delivery
TypeScript-first SDK
Full type definitions for requests and responses. One NeravaError model discriminated by code.
Zero runtime dependencies
Uses native fetch on Node 18.17+. No axios, no node-fetch, no runtime bloat.
Idempotent mutations
Every mutating endpoint accepts idempotency keys. Safe to retry without creating duplicates.
Cent-integer money
Where wallets apply, amounts are integers in cents — no floating-point dollars at the API boundary.
Trust tiers
Hardware-verified (Tesla / Smartcar), API-verified, and app-reported tiers inform quality scoring.
Local mock server
Exercise SDK methods locally without production credentials before you request a partner key.
Partner APIs are live. Docs portal is expanding.
You can request a partner key and integrate sessions, grants, and webhooks today. Interactive docs, usage dashboards, and self-serve key management are still rolling out.
Talk to Nerava