Tesla Wall Connector API

TypeScript library to interact with the Tesla Wall Connector local API.

Installation

npm install tesla-wall-connector

Usage

import { WallConnector } from "tesla-wall-connector";

// host can be an IPv4, an IPv6, or a local hostname (e.g. "teslawallconnector.local")
const wc = new WallConnector("192.168.0.13");

const vitals = await wc.vitals();
const lifetime = await wc.lifetime();
const version = await wc.version();
const wifi = await wc.wifiStatus();
const ssid = await wc.decodedSSID(); // decoded Wi-Fi SSID, or null

API

new WallConnector(host)

• host: IPv4, IPv6 or local hostname of your Wall Connector.

Methods

| Method | Returns | Description | | --- | --- | --- | | vitals() | Promise<Vitals> | Live electrical & charging metrics | | lifetime() | Promise<Lifetime> | Cumulative lifetime counters | | version() | Promise<Version> | Firmware / hardware info | | wifiStatus() | Promise<WifiStatus> | Wi-Fi connection details | | decodedSSID() | Promise<string \| null> | Wi-Fi SSID decoded from base64 |

All methods reject if the request fails or the device returns a non-OK HTTP status.

Requirements

Node.js ≥ 18 or Bun (uses the global fetch and Buffer). ESM-only.

Development

bun install
bun run build
bun run dev

License

MIT