tesla-fleet-api 0.4.0 → 0.5.0

package/dist/powerwall/components.cjs

@@ -0,0 +1,188 @@
+// src/powerwall/components.ts
+/** Idle PCH string currents read as float noise around 1e-16 A. */
+const PV_CURRENT_NOISE_FLOOR_A = .001;
+const SERIAL_KINDS = [
+	"hvp",
+	"bms",
+	"pch",
+	"baggr"
+];
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Walk nested objects and lists; `undefined` if a step is missing. */
+function path(data, ...keys) {
+	let value = data;
+	for (const key of keys) if (typeof key === "number") value = Array.isArray(value) ? value[key] : void 0;
+	else value = isRecord(value) ? value[key] : void 0;
+	return value;
+}
+/** The `kind` component at `slot`, or `null`. */
+function component(components, kind, slot = 0) {
+	const item = path(components, "components", kind, slot);
+	return isRecord(item) ? item : null;
+}
+/** One signal of a component: its `value`, else `textValue`, else `boolValue`, or `null` when none is set. */
+function component_signal(components, kind, name, slot = 0) {
+	const signals = component(components, kind, slot)?.signals;
+	const signal = (Array.isArray(signals) ? signals : []).find((item) => isRecord(item) && item.name === name);
+	return signal?.value ?? signal?.textValue ?? signal?.boolValue ?? null;
+}
+/** A numeric signal, or `null` when it is missing or not a number. */
+function component_float(components, kind, name, slot = 0) {
+	const value = component_signal(components, kind, name, slot);
+	return typeof value === "number" ? value : null;
+}
+/** PCH PV string current in amps, for a `string` from `A` to `F`. An idle string's noise reads as 0. */
+function pv_string_current(components, string, slot = 0) {
+	const value = component_float(components, "pch", `PCH_PvCurrent${string}`, slot);
+	return value !== null && Math.abs(value) < PV_CURRENT_NOISE_FLOOR_A ? 0 : value;
+}
+function firstAcrossKinds(components, slot, field) {
+	for (const kind of SERIAL_KINDS) {
+		const value = path(components, "components", kind, slot, field);
+		if (typeof value === "string" && value) return value;
+	}
+	return null;
+}
+/** The first non-empty serial number reported for `slot`. */
+function component_serial(components, slot) {
+	return firstAcrossKinds(components, slot, "serialNumber");
+}
+/** The first non-empty part number reported for `slot`. */
+function component_part_number(components, slot) {
+	return firstAcrossKinds(components, slot, "partNumber");
+}
+function unitDin(item) {
+	for (const key of ["din", "vin"]) {
+		const value = item[key];
+		if (typeof value === "string" && value) return value;
+	}
+	return null;
+}
+function serialFromDin(din) {
+	return din.split("--").at(-1);
+}
+function bmsFull(components, slot) {
+	return component_float(components, "bms", "BMS_nominalFullPackEnergy", slot);
+}
+/** Component slots that look like real BMS modules. */
+function bmsSlots(components) {
+	const items = path(components, "components", "bms");
+	if (!Array.isArray(items)) return [];
+	return items.flatMap((_, slot) => (bmsFull(components, slot) ?? 0) > 0 ? [slot] : []);
+}
+/**
+* BMS slots after dropping phantom expansion rows. A gateway can keep a
+* registered but uninstalled expansion: a plausible capacity, no serial and
+* near-zero energy. Such rows are dropped only when the system aggregate already
+* matches the kept rows, so a real pack with a stale reading stays.
+*/
+function ghostFilteredBmsSlots(components, status) {
+	const slots = bmsSlots(components);
+	const aggregateWh = path(status, "control", "systemStatus", "nominalFullPackEnergyWh");
+	if (slots.length === 0 || typeof aggregateWh !== "number" || aggregateWh <= 0) return slots;
+	const aggregateKwh = aggregateWh / 1e3;
+	const ghosts = slots.filter((slot) => {
+		if (component_serial(components, slot)) return false;
+		const full = bmsFull(components, slot);
+		const remaining = component_float(components, "bms", "BMS_nominalEnergyRemaining", slot);
+		if (full === null || full <= 0 || remaining === null) return false;
+		return remaining < .5 || remaining / full < .05;
+	});
+	if (ghosts.length === 0) return slots;
+	const kept = slots.filter((slot) => !ghosts.includes(slot));
+	const keptKwh = kept.reduce((sum, slot) => sum + (bmsFull(components, slot) ?? 0), 0);
+	return keptKwh > 0 && Math.abs(aggregateKwh - keptKwh) / aggregateKwh < .1 ? kept : slots;
+}
+/**
+* Choose the component slots of follower Powerwalls. A slot matched to a
+* configured expansion is never chosen. Candidates with no serial win when
+* there are enough of them; otherwise the last candidates are taken.
+*/
+function followerSlots(components, powerwallCount, expansionSlots, slots) {
+	const followerCount = Math.max(0, powerwallCount - 1);
+	if (followerCount === 0) return [];
+	if (slots.length === 0) return Array.from({ length: followerCount }, (_, index) => index + 1);
+	const candidates = slots.filter((slot) => slot !== 0 && !expansionSlots.has(slot));
+	const noSerial = candidates.filter((slot) => !component_serial(components, slot));
+	const chosen = (noSerial.length >= followerCount ? noSerial : candidates).slice(-followerCount);
+	for (let fallback = 1; chosen.length < followerCount; fallback++) if (!chosen.includes(fallback) && !expansionSlots.has(fallback)) chosen.push(fallback);
+	return chosen.sort((a, b) => a - b);
+}
+function statusBatteryDins(status) {
+	const blocks = path(status, "control", "batteryBlocks");
+	if (!Array.isArray(blocks)) return [];
+	return blocks.filter(isRecord).flatMap((block) => unitDin(block) ?? []);
+}
+/**
+* Every battery unit of the site with its component slot, by block: each
+* Powerwall, then its expansions.
+*
+* Powerwalls come from `battery_blocks` plus any extra DIN in the status; the
+* first is the leader at slot 0. Expansions come from each block's
+* `battery_expansions` and match a slot by serial number. A configured expansion
+* with no real BMS row is dropped, and a real row no configured unit claims
+* becomes an expansion of the leader with `din: null`.
+*/
+function battery_units(config, status, components) {
+	const configured = config.battery_blocks;
+	const blocks = Array.isArray(configured) ? configured.filter(isRecord) : [];
+	const known = new Set(blocks.map(unitDin));
+	for (const din of statusBatteryDins(status)) if (!known.has(din)) {
+		blocks.push({ din });
+		known.add(din);
+	}
+	if (blocks.length === 0) blocks.push({});
+	const powerwallCount = blocks.length;
+	const expansionDinsByBlock = blocks.map((block) => {
+		const expansions = block.battery_expansions;
+		return Array.isArray(expansions) ? expansions.filter(isRecord).flatMap((item) => unitDin(item) ?? []) : [];
+	});
+	const slots = ghostFilteredBmsSlots(components, status);
+	const serialToDin = /* @__PURE__ */ new Map();
+	for (const din of expansionDinsByBlock.flat()) {
+		const serial = serialFromDin(din);
+		if (serial) serialToDin.set(serial, din);
+	}
+	const matched = /* @__PURE__ */ new Map();
+	for (const slot of slots) {
+		const serial = component_serial(components, slot);
+		const din = serial ? serialToDin.get(serial) : void 0;
+		if (din !== void 0 && !matched.has(din)) matched.set(din, slot);
+	}
+	const followers = followerSlots(components, powerwallCount, new Set(matched.values()), slots);
+	const assigned = /* @__PURE__ */ new Set([
+		0,
+		...followers,
+		...matched.values()
+	]);
+	const unclaimed = slots.filter((slot) => !assigned.has(slot));
+	let nextUnobserved = Math.max(powerwallCount, slots.length);
+	const expansionsByBlock = expansionDinsByBlock.map((dins) => {
+		const expansions = [];
+		for (const din of dins) {
+			const slot = matched.get(din) ?? unclaimed.shift();
+			if (slot !== void 0) expansions.push([din, slot]);
+			else if (slots.length === 0) expansions.push([din, nextUnobserved++]);
+		}
+		return expansions;
+	});
+	expansionsByBlock[0].push(...unclaimed.map((slot) => [null, slot]));
+	const unit = (role, block_index, din, slot) => ({
+		role,
+		block_index,
+		component_slot: slot,
+		din,
+		serial_number: component_serial(components, slot),
+		part_number: component_part_number(components, slot)
+	});
+	return blocks.flatMap((block, index) => [unit(index === 0 ? "leader" : "follower", index, unitDin(block), index === 0 ? 0 : followers[index - 1] ?? index), ...expansionsByBlock[index].map(([din, slot]) => unit("expansion", index, din, slot))]);
+}
+exports.battery_units = battery_units;
+exports.component = component;
+exports.component_float = component_float;
+exports.component_part_number = component_part_number;
+exports.component_serial = component_serial;
+exports.component_signal = component_signal;
+exports.pv_string_current = pv_string_current;

package/dist/powerwall/components.d.cts

@@ -0,0 +1,45 @@
+import { ComponentsPayload, ConfigPayload, StatusPayload } from "./models.cjs";
+export type SignalValue = number | string | boolean;
+export type BatteryRole = "leader" | "follower" | "expansion";
+/**
+ * One battery unit: a Powerwall or an expansion.
+ *
+ * `din` comes from `config.json` or the status, and is `null` for an expansion
+ * found only in the components payload. `component_slot` is the index in each
+ * `components[<kind>]` list, which can be past the end of them while the gateway
+ * returns no BMS rows. `block_index` is the owning Powerwall's position in
+ * `battery_blocks`.
+ */
+export type BatteryUnit = {
+  role: BatteryRole;
+  block_index: number;
+  component_slot: number;
+  din: string | null;
+  serial_number: string | null;
+  part_number: string | null;
+};
+type Json = Record<string, any>;
+/** The `kind` component at `slot`, or `null`. */
+export declare function component(components: ComponentsPayload, kind: string, slot?: number): Json | null;
+/** One signal of a component: its `value`, else `textValue`, else `boolValue`, or `null` when none is set. */
+export declare function component_signal(components: ComponentsPayload, kind: string, name: string, slot?: number): SignalValue | null;
+/** A numeric signal, or `null` when it is missing or not a number. */
+export declare function component_float(components: ComponentsPayload, kind: string, name: string, slot?: number): number | null;
+/** PCH PV string current in amps, for a `string` from `A` to `F`. An idle string's noise reads as 0. */
+export declare function pv_string_current(components: ComponentsPayload, string: string, slot?: number): number | null;
+/** The first non-empty serial number reported for `slot`. */
+export declare function component_serial(components: ComponentsPayload, slot: number): string | null;
+/** The first non-empty part number reported for `slot`. */
+export declare function component_part_number(components: ComponentsPayload, slot: number): string | null;
+/**
+ * Every battery unit of the site with its component slot, by block: each
+ * Powerwall, then its expansions.
+ *
+ * Powerwalls come from `battery_blocks` plus any extra DIN in the status; the
+ * first is the leader at slot 0. Expansions come from each block's
+ * `battery_expansions` and match a slot by serial number. A configured expansion
+ * with no real BMS row is dropped, and a real row no configured unit claims
+ * becomes an expansion of the leader with `din: null`.
+ */
+export declare function battery_units(config: ConfigPayload, status: StatusPayload, components: ComponentsPayload): BatteryUnit[];
+export {};

package/dist/powerwall/components.d.mts

@@ -0,0 +1,45 @@
+import { ComponentsPayload, ConfigPayload, StatusPayload } from "./models.mjs";
+export type SignalValue = number | string | boolean;
+export type BatteryRole = "leader" | "follower" | "expansion";
+/**
+ * One battery unit: a Powerwall or an expansion.
+ *
+ * `din` comes from `config.json` or the status, and is `null` for an expansion
+ * found only in the components payload. `component_slot` is the index in each
+ * `components[<kind>]` list, which can be past the end of them while the gateway
+ * returns no BMS rows. `block_index` is the owning Powerwall's position in
+ * `battery_blocks`.
+ */
+export type BatteryUnit = {
+  role: BatteryRole;
+  block_index: number;
+  component_slot: number;
+  din: string | null;
+  serial_number: string | null;
+  part_number: string | null;
+};
+type Json = Record<string, any>;
+/** The `kind` component at `slot`, or `null`. */
+export declare function component(components: ComponentsPayload, kind: string, slot?: number): Json | null;
+/** One signal of a component: its `value`, else `textValue`, else `boolValue`, or `null` when none is set. */
+export declare function component_signal(components: ComponentsPayload, kind: string, name: string, slot?: number): SignalValue | null;
+/** A numeric signal, or `null` when it is missing or not a number. */
+export declare function component_float(components: ComponentsPayload, kind: string, name: string, slot?: number): number | null;
+/** PCH PV string current in amps, for a `string` from `A` to `F`. An idle string's noise reads as 0. */
+export declare function pv_string_current(components: ComponentsPayload, string: string, slot?: number): number | null;
+/** The first non-empty serial number reported for `slot`. */
+export declare function component_serial(components: ComponentsPayload, slot: number): string | null;
+/** The first non-empty part number reported for `slot`. */
+export declare function component_part_number(components: ComponentsPayload, slot: number): string | null;
+/**
+ * Every battery unit of the site with its component slot, by block: each
+ * Powerwall, then its expansions.
+ *
+ * Powerwalls come from `battery_blocks` plus any extra DIN in the status; the
+ * first is the leader at slot 0. Expansions come from each block's
+ * `battery_expansions` and match a slot by serial number. A configured expansion
+ * with no real BMS row is dropped, and a real row no configured unit claims
+ * becomes an expansion of the leader with `din: null`.
+ */
+export declare function battery_units(config: ConfigPayload, status: StatusPayload, components: ComponentsPayload): BatteryUnit[];
+export {};

package/dist/powerwall/components.mjs

@@ -0,0 +1,182 @@
+// src/powerwall/components.ts
+/** Idle PCH string currents read as float noise around 1e-16 A. */
+const PV_CURRENT_NOISE_FLOOR_A = .001;
+const SERIAL_KINDS = [
+	"hvp",
+	"bms",
+	"pch",
+	"baggr"
+];
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Walk nested objects and lists; `undefined` if a step is missing. */
+function path(data, ...keys) {
+	let value = data;
+	for (const key of keys) if (typeof key === "number") value = Array.isArray(value) ? value[key] : void 0;
+	else value = isRecord(value) ? value[key] : void 0;
+	return value;
+}
+/** The `kind` component at `slot`, or `null`. */
+function component(components, kind, slot = 0) {
+	const item = path(components, "components", kind, slot);
+	return isRecord(item) ? item : null;
+}
+/** One signal of a component: its `value`, else `textValue`, else `boolValue`, or `null` when none is set. */
+function component_signal(components, kind, name, slot = 0) {
+	const signals = component(components, kind, slot)?.signals;
+	const signal = (Array.isArray(signals) ? signals : []).find((item) => isRecord(item) && item.name === name);
+	return signal?.value ?? signal?.textValue ?? signal?.boolValue ?? null;
+}
+/** A numeric signal, or `null` when it is missing or not a number. */
+function component_float(components, kind, name, slot = 0) {
+	const value = component_signal(components, kind, name, slot);
+	return typeof value === "number" ? value : null;
+}
+/** PCH PV string current in amps, for a `string` from `A` to `F`. An idle string's noise reads as 0. */
+function pv_string_current(components, string, slot = 0) {
+	const value = component_float(components, "pch", `PCH_PvCurrent${string}`, slot);
+	return value !== null && Math.abs(value) < PV_CURRENT_NOISE_FLOOR_A ? 0 : value;
+}
+function firstAcrossKinds(components, slot, field) {
+	for (const kind of SERIAL_KINDS) {
+		const value = path(components, "components", kind, slot, field);
+		if (typeof value === "string" && value) return value;
+	}
+	return null;
+}
+/** The first non-empty serial number reported for `slot`. */
+function component_serial(components, slot) {
+	return firstAcrossKinds(components, slot, "serialNumber");
+}
+/** The first non-empty part number reported for `slot`. */
+function component_part_number(components, slot) {
+	return firstAcrossKinds(components, slot, "partNumber");
+}
+function unitDin(item) {
+	for (const key of ["din", "vin"]) {
+		const value = item[key];
+		if (typeof value === "string" && value) return value;
+	}
+	return null;
+}
+function serialFromDin(din) {
+	return din.split("--").at(-1);
+}
+function bmsFull(components, slot) {
+	return component_float(components, "bms", "BMS_nominalFullPackEnergy", slot);
+}
+/** Component slots that look like real BMS modules. */
+function bmsSlots(components) {
+	const items = path(components, "components", "bms");
+	if (!Array.isArray(items)) return [];
+	return items.flatMap((_, slot) => (bmsFull(components, slot) ?? 0) > 0 ? [slot] : []);
+}
+/**
+* BMS slots after dropping phantom expansion rows. A gateway can keep a
+* registered but uninstalled expansion: a plausible capacity, no serial and
+* near-zero energy. Such rows are dropped only when the system aggregate already
+* matches the kept rows, so a real pack with a stale reading stays.
+*/
+function ghostFilteredBmsSlots(components, status) {
+	const slots = bmsSlots(components);
+	const aggregateWh = path(status, "control", "systemStatus", "nominalFullPackEnergyWh");
+	if (slots.length === 0 || typeof aggregateWh !== "number" || aggregateWh <= 0) return slots;
+	const aggregateKwh = aggregateWh / 1e3;
+	const ghosts = slots.filter((slot) => {
+		if (component_serial(components, slot)) return false;
+		const full = bmsFull(components, slot);
+		const remaining = component_float(components, "bms", "BMS_nominalEnergyRemaining", slot);
+		if (full === null || full <= 0 || remaining === null) return false;
+		return remaining < .5 || remaining / full < .05;
+	});
+	if (ghosts.length === 0) return slots;
+	const kept = slots.filter((slot) => !ghosts.includes(slot));
+	const keptKwh = kept.reduce((sum, slot) => sum + (bmsFull(components, slot) ?? 0), 0);
+	return keptKwh > 0 && Math.abs(aggregateKwh - keptKwh) / aggregateKwh < .1 ? kept : slots;
+}
+/**
+* Choose the component slots of follower Powerwalls. A slot matched to a
+* configured expansion is never chosen. Candidates with no serial win when
+* there are enough of them; otherwise the last candidates are taken.
+*/
+function followerSlots(components, powerwallCount, expansionSlots, slots) {
+	const followerCount = Math.max(0, powerwallCount - 1);
+	if (followerCount === 0) return [];
+	if (slots.length === 0) return Array.from({ length: followerCount }, (_, index) => index + 1);
+	const candidates = slots.filter((slot) => slot !== 0 && !expansionSlots.has(slot));
+	const noSerial = candidates.filter((slot) => !component_serial(components, slot));
+	const chosen = (noSerial.length >= followerCount ? noSerial : candidates).slice(-followerCount);
+	for (let fallback = 1; chosen.length < followerCount; fallback++) if (!chosen.includes(fallback) && !expansionSlots.has(fallback)) chosen.push(fallback);
+	return chosen.sort((a, b) => a - b);
+}
+function statusBatteryDins(status) {
+	const blocks = path(status, "control", "batteryBlocks");
+	if (!Array.isArray(blocks)) return [];
+	return blocks.filter(isRecord).flatMap((block) => unitDin(block) ?? []);
+}
+/**
+* Every battery unit of the site with its component slot, by block: each
+* Powerwall, then its expansions.
+*
+* Powerwalls come from `battery_blocks` plus any extra DIN in the status; the
+* first is the leader at slot 0. Expansions come from each block's
+* `battery_expansions` and match a slot by serial number. A configured expansion
+* with no real BMS row is dropped, and a real row no configured unit claims
+* becomes an expansion of the leader with `din: null`.
+*/
+function battery_units(config, status, components) {
+	const configured = config.battery_blocks;
+	const blocks = Array.isArray(configured) ? configured.filter(isRecord) : [];
+	const known = new Set(blocks.map(unitDin));
+	for (const din of statusBatteryDins(status)) if (!known.has(din)) {
+		blocks.push({ din });
+		known.add(din);
+	}
+	if (blocks.length === 0) blocks.push({});
+	const powerwallCount = blocks.length;
+	const expansionDinsByBlock = blocks.map((block) => {
+		const expansions = block.battery_expansions;
+		return Array.isArray(expansions) ? expansions.filter(isRecord).flatMap((item) => unitDin(item) ?? []) : [];
+	});
+	const slots = ghostFilteredBmsSlots(components, status);
+	const serialToDin = /* @__PURE__ */ new Map();
+	for (const din of expansionDinsByBlock.flat()) {
+		const serial = serialFromDin(din);
+		if (serial) serialToDin.set(serial, din);
+	}
+	const matched = /* @__PURE__ */ new Map();
+	for (const slot of slots) {
+		const serial = component_serial(components, slot);
+		const din = serial ? serialToDin.get(serial) : void 0;
+		if (din !== void 0 && !matched.has(din)) matched.set(din, slot);
+	}
+	const followers = followerSlots(components, powerwallCount, new Set(matched.values()), slots);
+	const assigned = /* @__PURE__ */ new Set([
+		0,
+		...followers,
+		...matched.values()
+	]);
+	const unclaimed = slots.filter((slot) => !assigned.has(slot));
+	let nextUnobserved = Math.max(powerwallCount, slots.length);
+	const expansionsByBlock = expansionDinsByBlock.map((dins) => {
+		const expansions = [];
+		for (const din of dins) {
+			const slot = matched.get(din) ?? unclaimed.shift();
+			if (slot !== void 0) expansions.push([din, slot]);
+			else if (slots.length === 0) expansions.push([din, nextUnobserved++]);
+		}
+		return expansions;
+	});
+	expansionsByBlock[0].push(...unclaimed.map((slot) => [null, slot]));
+	const unit = (role, block_index, din, slot) => ({
+		role,
+		block_index,
+		component_slot: slot,
+		din,
+		serial_number: component_serial(components, slot),
+		part_number: component_part_number(components, slot)
+	});
+	return blocks.flatMap((block, index) => [unit(index === 0 ? "leader" : "follower", index, unitDin(block), index === 0 ? 0 : followers[index - 1] ?? index), ...expansionsByBlock[index].map(([din, slot]) => unit("expansion", index, din, slot))]);
+}
+export { battery_units, component, component_float, component_part_number, component_serial, component_signal, pv_string_current };

package/dist/powerwall/energysite.cjs

@@ -0,0 +1,216 @@
+const require_const = require("../const.cjs");
+const require_energyisland = require("../energyisland.cjs");
+const require_energyparsers = require("../energyparsers.cjs");
+const require_client = require("./client.cjs");
+// src/powerwall/energysite.ts
+/** Best-effort cloud `grid_status` and `island_status` for each gateway grid string. */
+const GRID_STATUS = {
+	SystemGridConnected: {
+		grid_status: "Active",
+		island_status: "on_grid"
+	},
+	SystemIslandedActive: {
+		grid_status: "Inactive",
+		island_status: "off_grid"
+	},
+	SystemIslandedReady: {
+		grid_status: "Inactive",
+		island_status: "off_grid"
+	},
+	SystemTransitionToGrid: {
+		grid_status: "Active",
+		island_status: "on_grid"
+	},
+	SystemTransitionToIsland: {
+		grid_status: "Inactive",
+		island_status: "off_grid"
+	},
+	SystemMicroGridFaulted: {
+		grid_status: "Inactive",
+		island_status: "off_grid"
+	},
+	SystemWaitForUser: {
+		grid_status: "Inactive",
+		island_status: "island_status_unknown"
+	}
+};
+const GRID_STATUS_UNKNOWN = {
+	grid_status: "Unknown",
+	island_status: "island_status_unknown"
+};
+/** Grid-connected, the `mode` for `set_island_mode` that reconnects. */
+const ISLAND_MODE_ON_GRID = require_const.EnergyIslandMode.ON_GRID;
+/** Islanded, the `mode` for `set_island_mode` that goes off grid. */
+const ISLAND_MODE_OFF_GRID = require_const.EnergyIslandMode.OFF_GRID;
+function ok() {
+	return { response: {
+		code: 201,
+		message: "",
+		result: true
+	} };
+}
+function numberOrNull(value) {
+	return typeof value === "number" ? value : null;
+}
+/**
+* The cloud energy site's surface over a local `PowerwallClient`: the same method
+* names, arguments and reply shapes, so a router can prefer the LAN and fall back
+* to the cloud. It imports nothing from the router.
+*
+* What has no local mapping is absent rather than stubbed, so a router routes it
+* to the cloud: `site_info`, `storm_mode`, the histories and the rest of Python's
+* `NotImplementedError` group. `add_authorized_client` is one of those, because
+* registration goes through the cloud.
+*/
+var PowerwallEnergySite = class {
+	#client;
+	/** @param client An existing client. This never opens its own transport. */
+	constructor(client) {
+		this.#client = client;
+	}
+	/** The wrapped client, for what has no cloud counterpart. */
+	get powerwall() {
+		return this.#client;
+	}
+	/**
+	* Set the operation mode.
+	* @param default_real_mode `self_consumption`, `autonomous` or `backup`.
+	*/
+	async operation(default_real_mode) {
+		await this.#client.set_operation_mode(default_real_mode);
+		return ok();
+	}
+	/**
+	* Set the backup reserve.
+	* @param backup_reserve_percent On the app's 0-100 scale, as the cloud takes it.
+	*/
+	async backup(backup_reserve_percent) {
+		await this.#client.set_backup_reserve(backup_reserve_percent);
+		return ok();
+	}
+	/** Set the grid-charging flag and export rule. Both in one call means one `config.json` write. */
+	async grid_import_export(disallow_charge_from_grid_with_solar_installed = null, customer_preferred_export_rule = null) {
+		await this.#client.set_grid_import_export({
+			customer_preferred_export_rule,
+			disallow_charge_from_grid_with_solar_installed
+		});
+		return ok();
+	}
+	/**
+	* Open or close the grid contactor. See `PowerwallClient.set_island_mode`:
+	* read `islanding.contactorClosed` afterwards.
+	* @param mode 6 islands and 1 reconnects. Anything else raises `TypeError`.
+	* @param force Defaults to true off grid and false otherwise, like the cloud.
+	*/
+	async set_island_mode(mode, force) {
+		require_energyisland.validate_island_mode(mode, force);
+		const off_grid = mode === require_const.EnergyIslandMode.OFF_GRID;
+		await this.#client.set_island_mode({
+			off_grid,
+			force: force ?? off_grid,
+			mode_override: mode
+		});
+		return ok();
+	}
+	/** Disconnect from the grid. */
+	async go_off_grid() {
+		await this.#client.go_off_grid();
+		return ok();
+	}
+	/** Reconnect to the grid. */
+	async reconnect_grid() {
+		await this.#client.reconnect_grid();
+		return ok();
+	}
+	/**
+	* Schedule a manual backup event. `start_time` and `priority` exist for
+	* signature parity and are not honoured: the event always starts now at
+	* maximum priority.
+	* @param duration_seconds Defaults to 7200.
+	*/
+	async schedule_backup_event(_start_time, duration_seconds, _priority) {
+		await this.#client.schedule_max_backup(duration_seconds ?? void 0);
+		return ok();
+	}
+	/** Cancel the active manual backup event. */
+	async cancel_backup_event() {
+		await this.#client.cancel_max_backup();
+		return ok();
+	}
+	/**
+	* Request a timed battery power setpoint.
+	* @param power_watts Positive discharges, negative charges.
+	* @param duration_seconds Whole seconds from 1 to 86400.
+	*/
+	async dispatch_battery_power(power_watts, duration_seconds) {
+		await this.#client.dispatch_battery_power(power_watts, duration_seconds);
+		return ok();
+	}
+	/** Release a `dispatch_battery_power` setpoint. */
+	async resume_battery_operation() {
+		await this.#client.resume_battery_operation();
+		return ok();
+	}
+	/** The active manual backup and scheduled events, in the local shape: the cloud's gRPC reply cannot be reproduced. */
+	async get_backup_events() {
+		return { response: await this.#client.get_backup_events() };
+	}
+	/**
+	* A cloud-shaped `live_status`, from three sequential reads. Keys with no local
+	* source are `null`, never guessed. A merge with the cloud fills them in.
+	*/
+	async live_status() {
+		const meters = await this.#client.get_meters_aggregates();
+		const status = await this.#client.get_status();
+		const gridStatus = await this.#client.get_grid_status();
+		const power = (location) => numberOrNull(meters[location]?.instant_power);
+		const systemStatus = status.control?.systemStatus;
+		return { response: {
+			solar_power: power("solar"),
+			energy_left: numberOrNull(systemStatus?.nominalEnergyRemainingWh),
+			total_pack_energy: numberOrNull(systemStatus?.nominalFullPackEnergyWh),
+			percentage_charged: require_client.battery_level(status),
+			backup_capable: null,
+			battery_power: power("battery"),
+			load_power: power("load"),
+			grid_power: power("site"),
+			grid_services_power: null,
+			generator_power: power("generator"),
+			...Object.hasOwn(GRID_STATUS, gridStatus) ? GRID_STATUS[gridStatus] : GRID_STATUS_UNKNOWN,
+			grid_services_active: null,
+			storm_mode_active: null,
+			timestamp: null,
+			wall_connectors: null
+		} };
+	}
+	/** The reserve (on the app's scale) and mode from `config.json`. A bare object, unlike the cloud's reads. */
+	async local_config() {
+		const config = await this.#client.get_config();
+		const result = {};
+		const reserve = config.site_info?.backup_reserve_percent;
+		if (typeof reserve === "number") result.backup_reserve_percent = require_client.raw_to_scaled_reserve(reserve);
+		if (config.default_real_mode !== void 0) result.default_real_mode = config.default_real_mode;
+		return result;
+	}
+	/** The paired keys in the gateway's raw form. Prefer `find_authorized_clients`. */
+	async list_authorized_clients() {
+		return { response: await this.#client.list_authorized_clients() };
+	}
+	/** The paired keys, in the same typed form as `TeslemetryEnergySite.find_authorized_clients`. */
+	async find_authorized_clients() {
+		const { response } = await this.list_authorized_clients();
+		return require_energyparsers.parse_authorized_clients(response);
+	}
+	/**
+	* Revoke a paired key. Any paired key can remove any other, and removing the
+	* signing key locks this client out.
+	* @param public_key Raw DER bytes, or base64 as `list_authorized_clients` reports it.
+	*/
+	async remove_authorized_client(public_key) {
+		await this.#client.remove_authorized_client(public_key);
+		return ok();
+	}
+};
+exports.ISLAND_MODE_OFF_GRID = ISLAND_MODE_OFF_GRID;
+exports.ISLAND_MODE_ON_GRID = ISLAND_MODE_ON_GRID;
+exports.PowerwallEnergySite = PowerwallEnergySite;