tesla-fleet-api 0.3.0 → 0.5.0

package/dist/powerwall/energysite.d.cts

@@ -0,0 +1,104 @@
+import { EnergyIslandMode } from "../const.cjs";
+import { AuthorizedClients } from "../energyparsers.cjs";
+import { LiveStatusResponse } from "../types/live_status.cjs";
+import { PowerwallClient } from "./client.cjs";
+import { AuthorizedClientsPayload, BackupEventsPayload } from "./models.cjs";
+/** The cloud energy command envelope. */
+export type CommandResult = {
+  response: {
+    code: number;
+    message: string;
+    result: boolean;
+  };
+};
+/** The subset of `config.json` with a faithful cloud mapping. A key is omitted when its source is absent. */
+export type LocalConfig = {
+  backup_reserve_percent?: number;
+  default_real_mode?: string;
+};
+/** Grid-connected, the `mode` for `set_island_mode` that reconnects. */
+export declare const ISLAND_MODE_ON_GRID: 1;
+/** Islanded, the `mode` for `set_island_mode` that goes off grid. */
+export declare const ISLAND_MODE_OFF_GRID: 6;
+/**
+ * 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.
+ */
+export declare class PowerwallEnergySite {
+  #private;
+  /** @param client An existing client. This never opens its own transport. */
+  constructor(client: PowerwallClient);
+  /** The wrapped client, for what has no cloud counterpart. */
+  get powerwall(): PowerwallClient;
+  /**
+   * Set the operation mode.
+   * @param default_real_mode `self_consumption`, `autonomous` or `backup`.
+   */
+  operation(default_real_mode: string): Promise<CommandResult>;
+  /**
+   * Set the backup reserve.
+   * @param backup_reserve_percent On the app's 0-100 scale, as the cloud takes it.
+   */
+  backup(backup_reserve_percent: number): Promise<CommandResult>;
+  /** Set the grid-charging flag and export rule. Both in one call means one `config.json` write. */
+  grid_import_export(disallow_charge_from_grid_with_solar_installed?: boolean | null, customer_preferred_export_rule?: string | null): Promise<CommandResult>;
+  /**
+   * 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.
+   */
+  set_island_mode(mode: EnergyIslandMode | number, force?: boolean | null): Promise<CommandResult>;
+  /** Disconnect from the grid. */
+  go_off_grid(): Promise<CommandResult>;
+  /** Reconnect to the grid. */
+  reconnect_grid(): Promise<CommandResult>;
+  /**
+   * 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.
+   */
+  schedule_backup_event(_start_time?: string | null, duration_seconds?: number | null, _priority?: number | string | null): Promise<CommandResult>;
+  /** Cancel the active manual backup event. */
+  cancel_backup_event(): Promise<CommandResult>;
+  /**
+   * Request a timed battery power setpoint.
+   * @param power_watts Positive discharges, negative charges.
+   * @param duration_seconds Whole seconds from 1 to 86400.
+   */
+  dispatch_battery_power(power_watts: number, duration_seconds: number): Promise<CommandResult>;
+  /** Release a `dispatch_battery_power` setpoint. */
+  resume_battery_operation(): Promise<CommandResult>;
+  /** The active manual backup and scheduled events, in the local shape: the cloud's gRPC reply cannot be reproduced. */
+  get_backup_events(): Promise<{
+    response: BackupEventsPayload;
+  }>;
+  /**
+   * 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.
+   */
+  live_status(): Promise<{
+    response: LiveStatusResponse;
+  }>;
+  /** The reserve (on the app's scale) and mode from `config.json`. A bare object, unlike the cloud's reads. */
+  local_config(): Promise<LocalConfig>;
+  /** The paired keys in the gateway's raw form. Prefer `find_authorized_clients`. */
+  list_authorized_clients(): Promise<{
+    response: AuthorizedClientsPayload;
+  }>;
+  /** The paired keys, in the same typed form as `TeslemetryEnergySite.find_authorized_clients`. */
+  find_authorized_clients(): Promise<AuthorizedClients>;
+  /**
+   * 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.
+   */
+  remove_authorized_client(public_key: Uint8Array | string): Promise<CommandResult>;
+}

package/dist/powerwall/energysite.d.mts

@@ -0,0 +1,104 @@
+import { EnergyIslandMode } from "../const.mjs";
+import { AuthorizedClients } from "../energyparsers.mjs";
+import { LiveStatusResponse } from "../types/live_status.mjs";
+import { PowerwallClient } from "./client.mjs";
+import { AuthorizedClientsPayload, BackupEventsPayload } from "./models.mjs";
+/** The cloud energy command envelope. */
+export type CommandResult = {
+  response: {
+    code: number;
+    message: string;
+    result: boolean;
+  };
+};
+/** The subset of `config.json` with a faithful cloud mapping. A key is omitted when its source is absent. */
+export type LocalConfig = {
+  backup_reserve_percent?: number;
+  default_real_mode?: string;
+};
+/** Grid-connected, the `mode` for `set_island_mode` that reconnects. */
+export declare const ISLAND_MODE_ON_GRID: 1;
+/** Islanded, the `mode` for `set_island_mode` that goes off grid. */
+export declare const ISLAND_MODE_OFF_GRID: 6;
+/**
+ * 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.
+ */
+export declare class PowerwallEnergySite {
+  #private;
+  /** @param client An existing client. This never opens its own transport. */
+  constructor(client: PowerwallClient);
+  /** The wrapped client, for what has no cloud counterpart. */
+  get powerwall(): PowerwallClient;
+  /**
+   * Set the operation mode.
+   * @param default_real_mode `self_consumption`, `autonomous` or `backup`.
+   */
+  operation(default_real_mode: string): Promise<CommandResult>;
+  /**
+   * Set the backup reserve.
+   * @param backup_reserve_percent On the app's 0-100 scale, as the cloud takes it.
+   */
+  backup(backup_reserve_percent: number): Promise<CommandResult>;
+  /** Set the grid-charging flag and export rule. Both in one call means one `config.json` write. */
+  grid_import_export(disallow_charge_from_grid_with_solar_installed?: boolean | null, customer_preferred_export_rule?: string | null): Promise<CommandResult>;
+  /**
+   * 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.
+   */
+  set_island_mode(mode: EnergyIslandMode | number, force?: boolean | null): Promise<CommandResult>;
+  /** Disconnect from the grid. */
+  go_off_grid(): Promise<CommandResult>;
+  /** Reconnect to the grid. */
+  reconnect_grid(): Promise<CommandResult>;
+  /**
+   * 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.
+   */
+  schedule_backup_event(_start_time?: string | null, duration_seconds?: number | null, _priority?: number | string | null): Promise<CommandResult>;
+  /** Cancel the active manual backup event. */
+  cancel_backup_event(): Promise<CommandResult>;
+  /**
+   * Request a timed battery power setpoint.
+   * @param power_watts Positive discharges, negative charges.
+   * @param duration_seconds Whole seconds from 1 to 86400.
+   */
+  dispatch_battery_power(power_watts: number, duration_seconds: number): Promise<CommandResult>;
+  /** Release a `dispatch_battery_power` setpoint. */
+  resume_battery_operation(): Promise<CommandResult>;
+  /** The active manual backup and scheduled events, in the local shape: the cloud's gRPC reply cannot be reproduced. */
+  get_backup_events(): Promise<{
+    response: BackupEventsPayload;
+  }>;
+  /**
+   * 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.
+   */
+  live_status(): Promise<{
+    response: LiveStatusResponse;
+  }>;
+  /** The reserve (on the app's scale) and mode from `config.json`. A bare object, unlike the cloud's reads. */
+  local_config(): Promise<LocalConfig>;
+  /** The paired keys in the gateway's raw form. Prefer `find_authorized_clients`. */
+  list_authorized_clients(): Promise<{
+    response: AuthorizedClientsPayload;
+  }>;
+  /** The paired keys, in the same typed form as `TeslemetryEnergySite.find_authorized_clients`. */
+  find_authorized_clients(): Promise<AuthorizedClients>;
+  /**
+   * 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.
+   */
+  remove_authorized_client(public_key: Uint8Array | string): Promise<CommandResult>;
+}

package/dist/powerwall/energysite.mjs

@@ -0,0 +1,214 @@
+import { EnergyIslandMode } from "../const.mjs";
+import { validate_island_mode } from "../energyisland.mjs";
+import { parse_authorized_clients } from "../energyparsers.mjs";
+import { battery_level, raw_to_scaled_reserve } from "./client.mjs";
+// 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 = EnergyIslandMode.ON_GRID;
+/** Islanded, the `mode` for `set_island_mode` that goes off grid. */
+const ISLAND_MODE_OFF_GRID = 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) {
+		validate_island_mode(mode, force);
+		const off_grid = mode === 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: 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 = 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 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();
+	}
+};
+export { ISLAND_MODE_OFF_GRID, ISLAND_MODE_ON_GRID, PowerwallEnergySite };

package/dist/powerwall/exceptions.cjs

@@ -0,0 +1,59 @@
+// src/powerwall/exceptions.ts
+/** Base class of every local Powerwall error. */
+var PowerwallError = class extends Error {
+	constructor(message, options) {
+		super(message, options);
+		this.name = new.target.name;
+	}
+};
+/** The gateway could not be reached, or the request timed out. */
+var PowerwallConnectionError = class extends PowerwallError {
+	failover_safe = true;
+};
+/** The gateway refused the password, or the RSA key is unusable, unregistered or not verified. */
+var PowerwallAuthenticationError = class extends PowerwallError {
+	failover_safe = true;
+};
+/**
+* The gateway password was accepted but the RSA key was not. Lets a repair flow
+* tell a rejected key from a wrong password. Python has no counterpart.
+*/
+var PowerwallKeyRejectedError = class extends PowerwallAuthenticationError {};
+/** The gateway answered 429 or 503. Back off before retrying. */
+var PowerwallRateLimitError = class extends PowerwallError {
+	failover_safe = true;
+};
+/** The gateway answered with something unexpected, such as a bad protobuf or JSON body. */
+var PowerwallProtocolError = class extends PowerwallError {};
+/** A signed request came back with a non-zero `message_fault`. */
+var PowerwallFaultError = class extends PowerwallError {
+	/** The fault's enum name. */
+	fault;
+	constructor(fault, message, options) {
+		super(message ?? `Powerwall returned message fault: ${fault}`, options);
+		this.fault = fault;
+	}
+};
+/** The gateway answered a command with `common.error_response`, or refused it with a result code. */
+var PowerwallCommandError = class extends PowerwallProtocolError {
+	command;
+	code;
+	status_message;
+	constructor(command, code, status_message) {
+		super(`Powerwall rejected ${command}: ${status_message || "no message"} (status code ${code})`);
+		this.command = command;
+		this.code = code;
+		this.status_message = status_message;
+	}
+};
+/** The gateway firmware does not implement the command: status code 12, `UNIMPLEMENTED`. */
+var PowerwallNotSupportedError = class extends PowerwallCommandError {};
+exports.PowerwallAuthenticationError = PowerwallAuthenticationError;
+exports.PowerwallCommandError = PowerwallCommandError;
+exports.PowerwallConnectionError = PowerwallConnectionError;
+exports.PowerwallError = PowerwallError;
+exports.PowerwallFaultError = PowerwallFaultError;
+exports.PowerwallKeyRejectedError = PowerwallKeyRejectedError;
+exports.PowerwallNotSupportedError = PowerwallNotSupportedError;
+exports.PowerwallProtocolError = PowerwallProtocolError;
+exports.PowerwallRateLimitError = PowerwallRateLimitError;

package/dist/powerwall/exceptions.d.cts

@@ -0,0 +1,38 @@
+/** Base class of every local Powerwall error. */
+export declare class PowerwallError extends Error {
+  constructor(message?: string, options?: ErrorOptions);
+}
+/** The gateway could not be reached, or the request timed out. */
+export declare class PowerwallConnectionError extends PowerwallError {
+  readonly failover_safe = true;
+}
+/** The gateway refused the password, or the RSA key is unusable, unregistered or not verified. */
+export declare class PowerwallAuthenticationError extends PowerwallError {
+  readonly failover_safe = true;
+}
+/**
+ * The gateway password was accepted but the RSA key was not. Lets a repair flow
+ * tell a rejected key from a wrong password. Python has no counterpart.
+ */
+export declare class PowerwallKeyRejectedError extends PowerwallAuthenticationError {}
+/** The gateway answered 429 or 503. Back off before retrying. */
+export declare class PowerwallRateLimitError extends PowerwallError {
+  readonly failover_safe = true;
+}
+/** The gateway answered with something unexpected, such as a bad protobuf or JSON body. */
+export declare class PowerwallProtocolError extends PowerwallError {}
+/** A signed request came back with a non-zero `message_fault`. */
+export declare class PowerwallFaultError extends PowerwallError {
+  /** The fault's enum name. */
+  readonly fault: string;
+  constructor(fault: string, message?: string, options?: ErrorOptions);
+}
+/** The gateway answered a command with `common.error_response`, or refused it with a result code. */
+export declare class PowerwallCommandError extends PowerwallProtocolError {
+  readonly command: string;
+  readonly code: number;
+  readonly status_message: string;
+  constructor(command: string, code: number, status_message: string);
+}
+/** The gateway firmware does not implement the command: status code 12, `UNIMPLEMENTED`. */
+export declare class PowerwallNotSupportedError extends PowerwallCommandError {}

package/dist/powerwall/exceptions.d.mts

@@ -0,0 +1,38 @@
+/** Base class of every local Powerwall error. */
+export declare class PowerwallError extends Error {
+  constructor(message?: string, options?: ErrorOptions);
+}
+/** The gateway could not be reached, or the request timed out. */
+export declare class PowerwallConnectionError extends PowerwallError {
+  readonly failover_safe = true;
+}
+/** The gateway refused the password, or the RSA key is unusable, unregistered or not verified. */
+export declare class PowerwallAuthenticationError extends PowerwallError {
+  readonly failover_safe = true;
+}
+/**
+ * The gateway password was accepted but the RSA key was not. Lets a repair flow
+ * tell a rejected key from a wrong password. Python has no counterpart.
+ */
+export declare class PowerwallKeyRejectedError extends PowerwallAuthenticationError {}
+/** The gateway answered 429 or 503. Back off before retrying. */
+export declare class PowerwallRateLimitError extends PowerwallError {
+  readonly failover_safe = true;
+}
+/** The gateway answered with something unexpected, such as a bad protobuf or JSON body. */
+export declare class PowerwallProtocolError extends PowerwallError {}
+/** A signed request came back with a non-zero `message_fault`. */
+export declare class PowerwallFaultError extends PowerwallError {
+  /** The fault's enum name. */
+  readonly fault: string;
+  constructor(fault: string, message?: string, options?: ErrorOptions);
+}
+/** The gateway answered a command with `common.error_response`, or refused it with a result code. */
+export declare class PowerwallCommandError extends PowerwallProtocolError {
+  readonly command: string;
+  readonly code: number;
+  readonly status_message: string;
+  constructor(command: string, code: number, status_message: string);
+}
+/** The gateway firmware does not implement the command: status code 12, `UNIMPLEMENTED`. */
+export declare class PowerwallNotSupportedError extends PowerwallCommandError {}

package/dist/powerwall/exceptions.mjs

@@ -0,0 +1,51 @@
+// src/powerwall/exceptions.ts
+/** Base class of every local Powerwall error. */
+var PowerwallError = class extends Error {
+	constructor(message, options) {
+		super(message, options);
+		this.name = new.target.name;
+	}
+};
+/** The gateway could not be reached, or the request timed out. */
+var PowerwallConnectionError = class extends PowerwallError {
+	failover_safe = true;
+};
+/** The gateway refused the password, or the RSA key is unusable, unregistered or not verified. */
+var PowerwallAuthenticationError = class extends PowerwallError {
+	failover_safe = true;
+};
+/**
+* The gateway password was accepted but the RSA key was not. Lets a repair flow
+* tell a rejected key from a wrong password. Python has no counterpart.
+*/
+var PowerwallKeyRejectedError = class extends PowerwallAuthenticationError {};
+/** The gateway answered 429 or 503. Back off before retrying. */
+var PowerwallRateLimitError = class extends PowerwallError {
+	failover_safe = true;
+};
+/** The gateway answered with something unexpected, such as a bad protobuf or JSON body. */
+var PowerwallProtocolError = class extends PowerwallError {};
+/** A signed request came back with a non-zero `message_fault`. */
+var PowerwallFaultError = class extends PowerwallError {
+	/** The fault's enum name. */
+	fault;
+	constructor(fault, message, options) {
+		super(message ?? `Powerwall returned message fault: ${fault}`, options);
+		this.fault = fault;
+	}
+};
+/** The gateway answered a command with `common.error_response`, or refused it with a result code. */
+var PowerwallCommandError = class extends PowerwallProtocolError {
+	command;
+	code;
+	status_message;
+	constructor(command, code, status_message) {
+		super(`Powerwall rejected ${command}: ${status_message || "no message"} (status code ${code})`);
+		this.command = command;
+		this.code = code;
+		this.status_message = status_message;
+	}
+};
+/** The gateway firmware does not implement the command: status code 12, `UNIMPLEMENTED`. */
+var PowerwallNotSupportedError = class extends PowerwallCommandError {};
+export { PowerwallAuthenticationError, PowerwallCommandError, PowerwallConnectionError, PowerwallError, PowerwallFaultError, PowerwallKeyRejectedError, PowerwallNotSupportedError, PowerwallProtocolError, PowerwallRateLimitError };