tesla-fleet-api 0.4.0 → 0.5.0

package/dist/const.cjs

@@ -14,6 +14,8 @@ const TOKEN_URLS = Object.freeze({
 function is_valid_region(value) {
 	return Object.hasOwn(SERVERS, value);
 }
+/** `navigation_request`'s locale when none is given: this process's, as in Python. */
+const DEFAULT_LOCALE = new Intl.DateTimeFormat().resolvedOptions().locale || "en-US";
 /** Model name keyed by the fourth character of the VIN. */
 const Models = Object.freeze({
 	S: "Model S",
@@ -261,6 +263,23 @@ const BluetoothVehicleData = Object.freeze({
 	SUSPENSION_STATE: "GetSuspensionState",
 	CHILD_PRESENCE_DETECTION_STATE: "GetChildPresenceDetectionState"
 });
+/** Telemetry topics in Teslemetry snapshots. */
+const SnapshotTopic = Object.freeze({
+	STATE: "state",
+	DATA: "data",
+	CONNECTIVITY: "connectivity",
+	ALERTS: "alerts",
+	ERRORS: "errors",
+	VEHICLE_DATA: "vehicle_data"
+});
+/** Teslemetry telemetry topics that can be awaited. */
+const WaitTopic = Object.freeze({
+	STATE: "state",
+	DATA: "data",
+	CONNECTIVITY: "connectivity",
+	ALERTS: "alerts",
+	ERRORS: "errors"
+});
 exports.AuthorizationRole = AuthorizationRole;
 exports.AuthorizedClientKeyType = AuthorizedClientKeyType;
 exports.AuthorizedClientState = AuthorizedClientState;
@@ -272,6 +291,7 @@ exports.CabinOverheatProtectionTemp = CabinOverheatProtectionTemp;
 exports.ClimateKeeperMode = ClimateKeeperMode;
 exports.ClimateModes = ClimateModes;
 exports.ClosureState = ClosureState;
+exports.DEFAULT_LOCALE = DEFAULT_LOCALE;
 exports.DeviceType = DeviceType;
 exports.DistanceUnit = DistanceUnit;
 exports.EnergyDeviceIdentifierType = EnergyDeviceIdentifierType;
@@ -287,6 +307,7 @@ exports.SERVERS = SERVERS;
 exports.Scope = Scope;
 exports.SeatHeaterLevel = SeatHeaterLevel;
 exports.Seats = Seats;
+exports.SnapshotTopic = SnapshotTopic;
 exports.SunRoofCommand = SunRoofCommand;
 exports.TOKEN_URLS = TOKEN_URLS;
 exports.TemperatureUnit = TemperatureUnit;
@@ -296,5 +317,6 @@ exports.TirePressureUnit = TirePressureUnit;
 exports.Trunk = Trunk;
 exports.VehicleDataEndpoint = VehicleDataEndpoint;
 exports.VehicleImageType = VehicleImageType;
+exports.WaitTopic = WaitTopic;
 exports.WindowCommand = WindowCommand;
 exports.is_valid_region = is_valid_region;

package/dist/const.d.cts

@@ -11,6 +11,8 @@ export declare const SERVERS: Readonly<Record<Region, string>>;
 export declare const TOKEN_URLS: Readonly<Record<Region, string>>;
 /** Check if a string is a valid region and narrow its type. */
 export declare function is_valid_region(value: string): value is Region;
+/** `navigation_request`'s locale when none is given: this process's, as in Python. */
+export declare const DEFAULT_LOCALE: string;
 /** Model name keyed by the fourth character of the VIN. */
 export declare const Models: Readonly<Record<string, string>>;
 type ValueOf<T> = T[keyof T];
@@ -284,4 +286,23 @@ export declare const BluetoothVehicleData: Readonly<{
   readonly CHILD_PRESENCE_DETECTION_STATE: "GetChildPresenceDetectionState";
 }>;
 export type BluetoothVehicleData = ValueOf<typeof BluetoothVehicleData>;
+/** Telemetry topics in Teslemetry snapshots. */
+export declare const SnapshotTopic: Readonly<{
+  readonly STATE: "state";
+  readonly DATA: "data";
+  readonly CONNECTIVITY: "connectivity";
+  readonly ALERTS: "alerts";
+  readonly ERRORS: "errors";
+  readonly VEHICLE_DATA: "vehicle_data";
+}>;
+export type SnapshotTopic = ValueOf<typeof SnapshotTopic>;
+/** Teslemetry telemetry topics that can be awaited. */
+export declare const WaitTopic: Readonly<{
+  readonly STATE: "state";
+  readonly DATA: "data";
+  readonly CONNECTIVITY: "connectivity";
+  readonly ALERTS: "alerts";
+  readonly ERRORS: "errors";
+}>;
+export type WaitTopic = ValueOf<typeof WaitTopic>;
 export {};

package/dist/const.d.mts

@@ -11,6 +11,8 @@ export declare const SERVERS: Readonly<Record<Region, string>>;
 export declare const TOKEN_URLS: Readonly<Record<Region, string>>;
 /** Check if a string is a valid region and narrow its type. */
 export declare function is_valid_region(value: string): value is Region;
+/** `navigation_request`'s locale when none is given: this process's, as in Python. */
+export declare const DEFAULT_LOCALE: string;
 /** Model name keyed by the fourth character of the VIN. */
 export declare const Models: Readonly<Record<string, string>>;
 type ValueOf<T> = T[keyof T];
@@ -284,4 +286,23 @@ export declare const BluetoothVehicleData: Readonly<{
   readonly CHILD_PRESENCE_DETECTION_STATE: "GetChildPresenceDetectionState";
 }>;
 export type BluetoothVehicleData = ValueOf<typeof BluetoothVehicleData>;
+/** Telemetry topics in Teslemetry snapshots. */
+export declare const SnapshotTopic: Readonly<{
+  readonly STATE: "state";
+  readonly DATA: "data";
+  readonly CONNECTIVITY: "connectivity";
+  readonly ALERTS: "alerts";
+  readonly ERRORS: "errors";
+  readonly VEHICLE_DATA: "vehicle_data";
+}>;
+export type SnapshotTopic = ValueOf<typeof SnapshotTopic>;
+/** Teslemetry telemetry topics that can be awaited. */
+export declare const WaitTopic: Readonly<{
+  readonly STATE: "state";
+  readonly DATA: "data";
+  readonly CONNECTIVITY: "connectivity";
+  readonly ALERTS: "alerts";
+  readonly ERRORS: "errors";
+}>;
+export type WaitTopic = ValueOf<typeof WaitTopic>;
 export {};

package/dist/const.mjs

@@ -13,6 +13,8 @@ const TOKEN_URLS = Object.freeze({
 function is_valid_region(value) {
 	return Object.hasOwn(SERVERS, value);
 }
+/** `navigation_request`'s locale when none is given: this process's, as in Python. */
+const DEFAULT_LOCALE = new Intl.DateTimeFormat().resolvedOptions().locale || "en-US";
 /** Model name keyed by the fourth character of the VIN. */
 const Models = Object.freeze({
 	S: "Model S",
@@ -260,4 +262,21 @@ const BluetoothVehicleData = Object.freeze({
 	SUSPENSION_STATE: "GetSuspensionState",
 	CHILD_PRESENCE_DETECTION_STATE: "GetChildPresenceDetectionState"
 });
-export { AuthorizationRole, AuthorizedClientKeyType, AuthorizedClientState, AuthorizedClientType, AuthorizedVerificationType, AutoSeat, BluetoothVehicleData, CabinOverheatProtectionTemp, ClimateKeeperMode, ClimateModes, ClosureState, DeviceType, DistanceUnit, EnergyDeviceIdentifierType, EnergyDisplayFormat, EnergyExportMode, EnergyIslandMode, EnergyOperationMode, Level, Method, Models, PhoneFontSize, SERVERS, Scope, SeatHeaterLevel, Seats, SunRoofCommand, TOKEN_URLS, TemperatureUnit, TeslaEnergyPeriod, TimeDisplayFormat, TirePressureUnit, Trunk, VehicleDataEndpoint, VehicleImageType, WindowCommand, is_valid_region };
+/** Telemetry topics in Teslemetry snapshots. */
+const SnapshotTopic = Object.freeze({
+	STATE: "state",
+	DATA: "data",
+	CONNECTIVITY: "connectivity",
+	ALERTS: "alerts",
+	ERRORS: "errors",
+	VEHICLE_DATA: "vehicle_data"
+});
+/** Teslemetry telemetry topics that can be awaited. */
+const WaitTopic = Object.freeze({
+	STATE: "state",
+	DATA: "data",
+	CONNECTIVITY: "connectivity",
+	ALERTS: "alerts",
+	ERRORS: "errors"
+});
+export { AuthorizationRole, AuthorizedClientKeyType, AuthorizedClientState, AuthorizedClientType, AuthorizedVerificationType, AutoSeat, BluetoothVehicleData, CabinOverheatProtectionTemp, ClimateKeeperMode, ClimateModes, ClosureState, DEFAULT_LOCALE, DeviceType, DistanceUnit, EnergyDeviceIdentifierType, EnergyDisplayFormat, EnergyExportMode, EnergyIslandMode, EnergyOperationMode, Level, Method, Models, PhoneFontSize, SERVERS, Scope, SeatHeaterLevel, Seats, SnapshotTopic, SunRoofCommand, TOKEN_URLS, TemperatureUnit, TeslaEnergyPeriod, TimeDisplayFormat, TirePressureUnit, Trunk, VehicleDataEndpoint, VehicleImageType, WaitTopic, WindowCommand, is_valid_region };

package/dist/energy.cjs

@@ -1,17 +1,25 @@
 const require_energyspecific = require("./energyspecific.cjs");
 // src/energy.ts
 var Energy = class {
+	/** Class `create` instantiates; a subclass overrides it to supply its own site type. */
+	static Site = require_energyspecific.default;
 	parent;
+	/** Every site created by this factory, keyed by `energy_site_id`; the latest `create` call wins. */
+	byId = /* @__PURE__ */ new Map();
 	constructor(parent) {
 		this.parent = parent;
 	}
 	/**
 	* Create an Energy class for a specific site.
 	* @param energy_site_id ID field of an energy site from /api/1/products endpoint.
+	* @param private_key RSA key `VERIFIED` on this gateway, for client-signed device commands. Requires `din`. Without one the site is unsigned: unlike vehicles, there is no fallback to the parent's key.
+	* @param din Gateway DIN (the energy site's `gateway_id` in `products`).
 	* @returns `EnergySpecific` class
 	*/
-	specific(energy_site_id) {
-		return new require_energyspecific.default(this, energy_site_id);
+	create(energy_site_id, private_key, din) {
+		const site = new this.constructor.Site(this, energy_site_id, private_key, din);
+		this.byId.set(energy_site_id, site);
+		return site;
 	}
 	/**
 	* Adjust the site's backup reserve.
@@ -25,16 +33,15 @@ var Energy = class {
 	/**
 	* Returns the backup (off-grid) event history of the site in duration of seconds.
 	* @param energy_site_id ID field of an energy site from /api/1/products endpoint.
-	* @param kind The kind of history to be requested. 'backup', 'charge', 'energy' are all supported.
+	* @param period Period of the window to retrieve backup events. This can be day, week, month, year, lifetime and should align with the window requested.
 	* @param start_date Start date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
 	* @param end_date End date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
-	* @param period Period of the window to retrieve backup events. This can be day, week, month, year, lifetime and should align with the window requested.
 	* @param time_zone Timezone of the requested window in IANA name format. i.e. 'America/Los_Angeles'
 	* @returns
 	*/
-	async backup_history(energy_site_id, kind, start_date, end_date, period, time_zone) {
+	async backup_history(energy_site_id, period, start_date, end_date, time_zone) {
 		return this.parent._request("GET", `api/1/energy_sites/${energy_site_id}/calendar_history`, {
-			kind,
+			kind: "backup",
 			start_date,
 			end_date,
 			period,
@@ -44,15 +51,14 @@ var Energy = class {
 	/**
 	* Returns the charging history of a wall connector.
 	* @param energy_site_id ID field of an energy site from /api/1/products endpoint.
-	* @param kind The kind of history to be requested. 'backup', 'charge', 'energy' are all supported.
-	* @param start_date Start date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
-	* @param end_date End date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
+	* @param start_date Start date of the window to retrieve charging events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
+	* @param end_date End date of the window to retrieve charging events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
 	* @param time_zone Timezone of the requested window in IANA name format. i.e. 'America/Los_Angeles'
 	* @returns
 	*/
-	async charge_history(energy_site_id, kind, start_date, end_date, time_zone) {
+	async charge_history(energy_site_id, start_date, end_date, time_zone) {
 		return this.parent._request("GET", `api/1/energy_sites/${energy_site_id}/telemetry_history`, {
-			kind,
+			kind: "charge",
 			start_date,
 			end_date,
 			time_zone
@@ -61,16 +67,15 @@ var Energy = class {
 	/**
 	* Returns the energy measurements of the site, aggregated to the requested period.
 	* @param energy_site_id ID field of an energy site from /api/1/products endpoint.
-	* @param kind The kind of history to be requested. 'backup', 'charge', 'energy' are all supported.
-	* @param start_dateStart date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
-	* @param end_date End date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
-	* @param period Period of the window to retrieve backup events. This can be day, week, month, year, lifetime and should align with the window requested.
+	* @param period Period of the window to retrieve energy measurements. This can be day, week, month, year, lifetime and should align with the window requested.
+	* @param start_date Start date of the window to retrieve energy measurements in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
+	* @param end_date End date of the window to retrieve energy measurements in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
 	* @param time_zone Timezone of the requested window in IANA name format. i.e. 'America/Los_Angeles'
 	* @returns
 	*/
-	async energy_history(energy_site_id, kind, start_date, end_date, period, time_zone) {
+	async energy_history(energy_site_id, period, start_date, end_date, time_zone) {
 		return this.parent._request("GET", `api/1/energy_sites/${energy_site_id}/calendar_history`, {
-			kind,
+			kind: "energy",
 			start_date,
 			end_date,
 			period,
@@ -96,7 +101,7 @@ var Energy = class {
 	* @returns
 	*/
 	async live_status(energy_site_id) {
-		return this.parent._request("GET", `api/1/energy_sites/${energy_site_id}/live_status`).then(({ response }) => response);
+		return this.parent._request("GET", `api/1/energy_sites/${energy_site_id}/live_status`);
 	}
 	/**
 	* Adjust the site's off-grid vehicle charging backup reserve.
@@ -122,7 +127,7 @@ var Energy = class {
 	* @returns
 	*/
 	async site_info(energy_site_id) {
-		return this.parent._request("GET", `api/1/energy_sites/${energy_site_id}/site_info`).then(({ response }) => response);
+		return this.parent._request("GET", `api/1/energy_sites/${energy_site_id}/site_info`);
 	}
 	/**
 	* Update storm watch participation.

package/dist/energy.d.cts

@@ -1,16 +1,25 @@
+import { TeslaEnergyPeriod } from "./const.cjs";
 import EnergySpecific from "./energyspecific.cjs";
 import TeslaFleetApi from "./teslafleetapi.cjs";
 import { LiveStatusResponse } from "./types/live_status.cjs";
+import { ResponseEnvelope } from "./types/responses.cjs";
 import { SiteInfoResponse } from "./types/site_info.cjs";
+import { KeyObject } from "crypto";
 declare class Energy {
+  /** Class `create` instantiates; a subclass overrides it to supply its own site type. */
+  static Site: new (parent: Energy, energy_site_id: number, private_key?: KeyObject, din?: string) => EnergySpecific;
   parent: TeslaFleetApi;
+  /** Every site created by this factory, keyed by `energy_site_id`; the latest `create` call wins. */
+  byId: Map<number, EnergySpecific>;
   constructor(parent: TeslaFleetApi);
   /**
    * Create an Energy class for a specific site.
    * @param energy_site_id ID field of an energy site from /api/1/products endpoint.
+   * @param private_key RSA key `VERIFIED` on this gateway, for client-signed device commands. Requires `din`. Without one the site is unsigned: unlike vehicles, there is no fallback to the parent's key.
+   * @param din Gateway DIN (the energy site's `gateway_id` in `products`).
    * @returns `EnergySpecific` class
    */
-  specific(energy_site_id: number): EnergySpecific;
+  create(energy_site_id: number, private_key?: KeyObject, din?: string): EnergySpecific;
   /**
    * Adjust the site's backup reserve.
    * @param energy_site_id ID field of an energy site from /api/1/products endpoint.ID field of an energy site from /api/1/products endpoint.
@@ -21,35 +30,32 @@ declare class Energy {
   /**
    * Returns the backup (off-grid) event history of the site in duration of seconds.
    * @param energy_site_id ID field of an energy site from /api/1/products endpoint.
-   * @param kind The kind of history to be requested. 'backup', 'charge', 'energy' are all supported.
+   * @param period Period of the window to retrieve backup events. This can be day, week, month, year, lifetime and should align with the window requested.
    * @param start_date Start date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
    * @param end_date End date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
-   * @param period Period of the window to retrieve backup events. This can be day, week, month, year, lifetime and should align with the window requested.
    * @param time_zone Timezone of the requested window in IANA name format. i.e. 'America/Los_Angeles'
    * @returns
    */
-  backup_history(energy_site_id: number, kind: string, start_date: string, end_date: string, period: string, time_zone: string): Promise<Record<string, any>>;
+  backup_history(energy_site_id: number, period: TeslaEnergyPeriod | string | null, start_date?: string | null, end_date?: string | null, time_zone?: string | null): Promise<Record<string, any>>;
   /**
    * Returns the charging history of a wall connector.
    * @param energy_site_id ID field of an energy site from /api/1/products endpoint.
-   * @param kind The kind of history to be requested. 'backup', 'charge', 'energy' are all supported.
-   * @param start_date Start date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
-   * @param end_date End date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
+   * @param start_date Start date of the window to retrieve charging events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
+   * @param end_date End date of the window to retrieve charging events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
    * @param time_zone Timezone of the requested window in IANA name format. i.e. 'America/Los_Angeles'
    * @returns
    */
-  charge_history(energy_site_id: number, kind: string, start_date: string, end_date: string, time_zone: string): Promise<Record<string, any>>;
+  charge_history(energy_site_id: number, start_date: string, end_date: string, time_zone?: string | null): Promise<Record<string, any>>;
   /**
    * Returns the energy measurements of the site, aggregated to the requested period.
    * @param energy_site_id ID field of an energy site from /api/1/products endpoint.
-   * @param kind The kind of history to be requested. 'backup', 'charge', 'energy' are all supported.
-   * @param start_dateStart date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
-   * @param end_date End date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
-   * @param period Period of the window to retrieve backup events. This can be day, week, month, year, lifetime and should align with the window requested.
+   * @param period Period of the window to retrieve energy measurements. This can be day, week, month, year, lifetime and should align with the window requested.
+   * @param start_date Start date of the window to retrieve energy measurements in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
+   * @param end_date End date of the window to retrieve energy measurements in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
    * @param time_zone Timezone of the requested window in IANA name format. i.e. 'America/Los_Angeles'
    * @returns
    */
-  energy_history(energy_site_id: number, kind: string, start_date: string, end_date: string, period: string, time_zone: string): Promise<Record<string, any>>;
+  energy_history(energy_site_id: number, period: TeslaEnergyPeriod | string | null, start_date?: string | null, end_date?: string | null, time_zone?: string | null): Promise<Record<string, any>>;
   /**
    * Allow/disallow charging from the grid and exporting energy to the grid.
    * @param energy_site_id
@@ -63,7 +69,7 @@ declare class Energy {
    * @param energy_site_id
    * @returns
    */
-  live_status(energy_site_id: number): Promise<LiveStatusResponse>;
+  live_status(energy_site_id: number): Promise<ResponseEnvelope<LiveStatusResponse>>;
   /**
    * Adjust the site's off-grid vehicle charging backup reserve.
    * @param energy_site_id ID field of an energy site from /api/1/products endpoint.
@@ -83,7 +89,7 @@ declare class Energy {
    * @param energy_site_id ID field of an energy site from /api/1/products endpoint.
    * @returns
    */
-  site_info(energy_site_id: number): Promise<SiteInfoResponse>;
+  site_info(energy_site_id: number): Promise<ResponseEnvelope<SiteInfoResponse>>;
   /**
    * Update storm watch participation.
    * @param energy_site_id ID field of an energy site from /api/1/products endpoint.

package/dist/energy.d.mts

@@ -1,16 +1,25 @@
+import { TeslaEnergyPeriod } from "./const.mjs";
 import EnergySpecific from "./energyspecific.mjs";
 import TeslaFleetApi from "./teslafleetapi.mjs";
 import { LiveStatusResponse } from "./types/live_status.mjs";
+import { ResponseEnvelope } from "./types/responses.mjs";
 import { SiteInfoResponse } from "./types/site_info.mjs";
+import { KeyObject } from "crypto";
 export default class Energy {
+  /** Class `create` instantiates; a subclass overrides it to supply its own site type. */
+  static Site: new (parent: Energy, energy_site_id: number, private_key?: KeyObject, din?: string) => EnergySpecific;
   parent: TeslaFleetApi;
+  /** Every site created by this factory, keyed by `energy_site_id`; the latest `create` call wins. */
+  byId: Map<number, EnergySpecific>;
   constructor(parent: TeslaFleetApi);
   /**
    * Create an Energy class for a specific site.
    * @param energy_site_id ID field of an energy site from /api/1/products endpoint.
+   * @param private_key RSA key `VERIFIED` on this gateway, for client-signed device commands. Requires `din`. Without one the site is unsigned: unlike vehicles, there is no fallback to the parent's key.
+   * @param din Gateway DIN (the energy site's `gateway_id` in `products`).
    * @returns `EnergySpecific` class
    */
-  specific(energy_site_id: number): EnergySpecific;
+  create(energy_site_id: number, private_key?: KeyObject, din?: string): EnergySpecific;
   /**
    * Adjust the site's backup reserve.
    * @param energy_site_id ID field of an energy site from /api/1/products endpoint.ID field of an energy site from /api/1/products endpoint.
@@ -21,35 +30,32 @@ export default class Energy {
   /**
    * Returns the backup (off-grid) event history of the site in duration of seconds.
    * @param energy_site_id ID field of an energy site from /api/1/products endpoint.
-   * @param kind The kind of history to be requested. 'backup', 'charge', 'energy' are all supported.
+   * @param period Period of the window to retrieve backup events. This can be day, week, month, year, lifetime and should align with the window requested.
    * @param start_date Start date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
    * @param end_date End date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
-   * @param period Period of the window to retrieve backup events. This can be day, week, month, year, lifetime and should align with the window requested.
    * @param time_zone Timezone of the requested window in IANA name format. i.e. 'America/Los_Angeles'
    * @returns
    */
-  backup_history(energy_site_id: number, kind: string, start_date: string, end_date: string, period: string, time_zone: string): Promise<Record<string, any>>;
+  backup_history(energy_site_id: number, period: TeslaEnergyPeriod | string | null, start_date?: string | null, end_date?: string | null, time_zone?: string | null): Promise<Record<string, any>>;
   /**
    * Returns the charging history of a wall connector.
    * @param energy_site_id ID field of an energy site from /api/1/products endpoint.
-   * @param kind The kind of history to be requested. 'backup', 'charge', 'energy' are all supported.
-   * @param start_date Start date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
-   * @param end_date End date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
+   * @param start_date Start date of the window to retrieve charging events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
+   * @param end_date End date of the window to retrieve charging events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
    * @param time_zone Timezone of the requested window in IANA name format. i.e. 'America/Los_Angeles'
    * @returns
    */
-  charge_history(energy_site_id: number, kind: string, start_date: string, end_date: string, time_zone: string): Promise<Record<string, any>>;
+  charge_history(energy_site_id: number, start_date: string, end_date: string, time_zone?: string | null): Promise<Record<string, any>>;
   /**
    * Returns the energy measurements of the site, aggregated to the requested period.
    * @param energy_site_id ID field of an energy site from /api/1/products endpoint.
-   * @param kind The kind of history to be requested. 'backup', 'charge', 'energy' are all supported.
-   * @param start_dateStart date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
-   * @param end_date End date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
-   * @param period Period of the window to retrieve backup events. This can be day, week, month, year, lifetime and should align with the window requested.
+   * @param period Period of the window to retrieve energy measurements. This can be day, week, month, year, lifetime and should align with the window requested.
+   * @param start_date Start date of the window to retrieve energy measurements in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
+   * @param end_date End date of the window to retrieve energy measurements in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
    * @param time_zone Timezone of the requested window in IANA name format. i.e. 'America/Los_Angeles'
    * @returns
    */
-  energy_history(energy_site_id: number, kind: string, start_date: string, end_date: string, period: string, time_zone: string): Promise<Record<string, any>>;
+  energy_history(energy_site_id: number, period: TeslaEnergyPeriod | string | null, start_date?: string | null, end_date?: string | null, time_zone?: string | null): Promise<Record<string, any>>;
   /**
    * Allow/disallow charging from the grid and exporting energy to the grid.
    * @param energy_site_id
@@ -63,7 +69,7 @@ export default class Energy {
    * @param energy_site_id
    * @returns
    */
-  live_status(energy_site_id: number): Promise<LiveStatusResponse>;
+  live_status(energy_site_id: number): Promise<ResponseEnvelope<LiveStatusResponse>>;
   /**
    * Adjust the site's off-grid vehicle charging backup reserve.
    * @param energy_site_id ID field of an energy site from /api/1/products endpoint.
@@ -83,7 +89,7 @@ export default class Energy {
    * @param energy_site_id ID field of an energy site from /api/1/products endpoint.
    * @returns
    */
-  site_info(energy_site_id: number): Promise<SiteInfoResponse>;
+  site_info(energy_site_id: number): Promise<ResponseEnvelope<SiteInfoResponse>>;
   /**
    * Update storm watch participation.
    * @param energy_site_id ID field of an energy site from /api/1/products endpoint.

package/dist/energy.mjs

@@ -1,17 +1,25 @@
 import EnergySpecific from "./energyspecific.mjs";
 // src/energy.ts
 var Energy = class {
+	/** Class `create` instantiates; a subclass overrides it to supply its own site type. */
+	static Site = EnergySpecific;
 	parent;
+	/** Every site created by this factory, keyed by `energy_site_id`; the latest `create` call wins. */
+	byId = /* @__PURE__ */ new Map();
 	constructor(parent) {
 		this.parent = parent;
 	}
 	/**
 	* Create an Energy class for a specific site.
 	* @param energy_site_id ID field of an energy site from /api/1/products endpoint.
+	* @param private_key RSA key `VERIFIED` on this gateway, for client-signed device commands. Requires `din`. Without one the site is unsigned: unlike vehicles, there is no fallback to the parent's key.
+	* @param din Gateway DIN (the energy site's `gateway_id` in `products`).
 	* @returns `EnergySpecific` class
 	*/
-	specific(energy_site_id) {
-		return new EnergySpecific(this, energy_site_id);
+	create(energy_site_id, private_key, din) {
+		const site = new this.constructor.Site(this, energy_site_id, private_key, din);
+		this.byId.set(energy_site_id, site);
+		return site;
 	}
 	/**
 	* Adjust the site's backup reserve.
@@ -25,16 +33,15 @@ var Energy = class {
 	/**
 	* Returns the backup (off-grid) event history of the site in duration of seconds.
 	* @param energy_site_id ID field of an energy site from /api/1/products endpoint.
-	* @param kind The kind of history to be requested. 'backup', 'charge', 'energy' are all supported.
+	* @param period Period of the window to retrieve backup events. This can be day, week, month, year, lifetime and should align with the window requested.
 	* @param start_date Start date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
 	* @param end_date End date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
-	* @param period Period of the window to retrieve backup events. This can be day, week, month, year, lifetime and should align with the window requested.
 	* @param time_zone Timezone of the requested window in IANA name format. i.e. 'America/Los_Angeles'
 	* @returns
 	*/
-	async backup_history(energy_site_id, kind, start_date, end_date, period, time_zone) {
+	async backup_history(energy_site_id, period, start_date, end_date, time_zone) {
 		return this.parent._request("GET", `api/1/energy_sites/${energy_site_id}/calendar_history`, {
-			kind,
+			kind: "backup",
 			start_date,
 			end_date,
 			period,
@@ -44,15 +51,14 @@ var Energy = class {
 	/**
 	* Returns the charging history of a wall connector.
 	* @param energy_site_id ID field of an energy site from /api/1/products endpoint.
-	* @param kind The kind of history to be requested. 'backup', 'charge', 'energy' are all supported.
-	* @param start_date Start date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
-	* @param end_date End date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
+	* @param start_date Start date of the window to retrieve charging events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
+	* @param end_date End date of the window to retrieve charging events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
 	* @param time_zone Timezone of the requested window in IANA name format. i.e. 'America/Los_Angeles'
 	* @returns
 	*/
-	async charge_history(energy_site_id, kind, start_date, end_date, time_zone) {
+	async charge_history(energy_site_id, start_date, end_date, time_zone) {
 		return this.parent._request("GET", `api/1/energy_sites/${energy_site_id}/telemetry_history`, {
-			kind,
+			kind: "charge",
 			start_date,
 			end_date,
 			time_zone
@@ -61,16 +67,15 @@ var Energy = class {
 	/**
 	* Returns the energy measurements of the site, aggregated to the requested period.
 	* @param energy_site_id ID field of an energy site from /api/1/products endpoint.
-	* @param kind The kind of history to be requested. 'backup', 'charge', 'energy' are all supported.
-	* @param start_dateStart date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
-	* @param end_date End date of the window to retrieve backup events in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
-	* @param period Period of the window to retrieve backup events. This can be day, week, month, year, lifetime and should align with the window requested.
+	* @param period Period of the window to retrieve energy measurements. This can be day, week, month, year, lifetime and should align with the window requested.
+	* @param start_date Start date of the window to retrieve energy measurements in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
+	* @param end_date End date of the window to retrieve energy measurements in RFC3339 format. i.e. 2023-01-01T00:00:00-08:00
 	* @param time_zone Timezone of the requested window in IANA name format. i.e. 'America/Los_Angeles'
 	* @returns
 	*/
-	async energy_history(energy_site_id, kind, start_date, end_date, period, time_zone) {
+	async energy_history(energy_site_id, period, start_date, end_date, time_zone) {
 		return this.parent._request("GET", `api/1/energy_sites/${energy_site_id}/calendar_history`, {
-			kind,
+			kind: "energy",
 			start_date,
 			end_date,
 			period,
@@ -96,7 +101,7 @@ var Energy = class {
 	* @returns
 	*/
 	async live_status(energy_site_id) {
-		return this.parent._request("GET", `api/1/energy_sites/${energy_site_id}/live_status`).then(({ response }) => response);
+		return this.parent._request("GET", `api/1/energy_sites/${energy_site_id}/live_status`);
 	}
 	/**
 	* Adjust the site's off-grid vehicle charging backup reserve.
@@ -122,7 +127,7 @@ var Energy = class {
 	* @returns
 	*/
 	async site_info(energy_site_id) {
-		return this.parent._request("GET", `api/1/energy_sites/${energy_site_id}/site_info`).then(({ response }) => response);
+		return this.parent._request("GET", `api/1/energy_sites/${energy_site_id}/site_info`);
 	}
 	/**
 	* Update storm watch participation.

package/dist/energyisland.cjs

@@ -0,0 +1,38 @@
+const require_const = require("./const.cjs");
+let _teslemetry_tesla_protocol_energy_device_teg_api = require("@teslemetry/tesla-protocol/energy_device/teg_api");
+// src/energyisland.ts
+/** The `TEGSetIslandModeResult` values that mean the gateway refused. */
+const REJECTIONS = [
+	_teslemetry_tesla_protocol_energy_device_teg_api.TEGSetIslandModeResult.TEG_SET_ISLAND_MODE_RESULT_REJECTED_NOT_READY_FOR_ISLANDING,
+	_teslemetry_tesla_protocol_energy_device_teg_api.TEGSetIslandModeResult.TEG_SET_ISLAND_MODE_RESULT_REJECTED_LOAD_DROP_EXPECTED,
+	_teslemetry_tesla_protocol_energy_device_teg_api.TEGSetIslandModeResult.TEG_SET_ISLAND_MODE_RESULT_REJECTED_LOW_ENERGY,
+	_teslemetry_tesla_protocol_energy_device_teg_api.TEGSetIslandModeResult.TEG_SET_ISLAND_MODE_RESULT_REJECTED_EXCESSIVE_SOLAR
+];
+/**
+* The refusal a `setIslandModeResponse.result` reports, or `null` for anything
+* else, which is not guessed at. Takes the enum's number or its name, because a
+* JSON route may carry either.
+*/
+function island_mode_rejection(result) {
+	for (const code of REJECTIONS) {
+		const name = (0, _teslemetry_tesla_protocol_energy_device_teg_api.tEGSetIslandModeResultToJSON)(code);
+		if (result === code || result === name) return {
+			code,
+			name
+		};
+	}
+	return null;
+}
+/**
+* Check an island command before it is signed. A contactor command takes only the
+* two modes Python's `go_off_grid` and `reconnect_grid` use: `ON_GRID` (1) and
+* `OFF_GRID` (6). There is no coercion and no default, because `"6"` or a missing
+* mode could otherwise close the contactor when the caller meant to open it.
+* @throws TypeError on any other mode, or a `force` that is not a boolean.
+*/
+function validate_island_mode(mode, force) {
+	if (mode !== require_const.EnergyIslandMode.ON_GRID && mode !== require_const.EnergyIslandMode.OFF_GRID) throw new TypeError("mode must be EnergyIslandMode.ON_GRID (1) or EnergyIslandMode.OFF_GRID (6)");
+	if (force !== void 0 && force !== null && typeof force !== "boolean") throw new TypeError("force must be a boolean");
+}
+exports.island_mode_rejection = island_mode_rejection;
+exports.validate_island_mode = validate_island_mode;

package/dist/energyisland.mjs

@@ -0,0 +1,37 @@
+import { EnergyIslandMode } from "./const.mjs";
+import { TEGSetIslandModeResult, tEGSetIslandModeResultToJSON } from "@teslemetry/tesla-protocol/energy_device/teg_api";
+// src/energyisland.ts
+/** The `TEGSetIslandModeResult` values that mean the gateway refused. */
+const REJECTIONS = [
+	TEGSetIslandModeResult.TEG_SET_ISLAND_MODE_RESULT_REJECTED_NOT_READY_FOR_ISLANDING,
+	TEGSetIslandModeResult.TEG_SET_ISLAND_MODE_RESULT_REJECTED_LOAD_DROP_EXPECTED,
+	TEGSetIslandModeResult.TEG_SET_ISLAND_MODE_RESULT_REJECTED_LOW_ENERGY,
+	TEGSetIslandModeResult.TEG_SET_ISLAND_MODE_RESULT_REJECTED_EXCESSIVE_SOLAR
+];
+/**
+* The refusal a `setIslandModeResponse.result` reports, or `null` for anything
+* else, which is not guessed at. Takes the enum's number or its name, because a
+* JSON route may carry either.
+*/
+function island_mode_rejection(result) {
+	for (const code of REJECTIONS) {
+		const name = tEGSetIslandModeResultToJSON(code);
+		if (result === code || result === name) return {
+			code,
+			name
+		};
+	}
+	return null;
+}
+/**
+* Check an island command before it is signed. A contactor command takes only the
+* two modes Python's `go_off_grid` and `reconnect_grid` use: `ON_GRID` (1) and
+* `OFF_GRID` (6). There is no coercion and no default, because `"6"` or a missing
+* mode could otherwise close the contactor when the caller meant to open it.
+* @throws TypeError on any other mode, or a `force` that is not a boolean.
+*/
+function validate_island_mode(mode, force) {
+	if (mode !== EnergyIslandMode.ON_GRID && mode !== EnergyIslandMode.OFF_GRID) throw new TypeError("mode must be EnergyIslandMode.ON_GRID (1) or EnergyIslandMode.OFF_GRID (6)");
+	if (force !== void 0 && force !== null && typeof force !== "boolean") throw new TypeError("force must be a boolean");
+}
+export { island_mode_rejection, validate_island_mode };