@teslemetry/api 0.5.1 → 0.5.3

package/dist/index.cjs

@@ -3115,8 +3115,8 @@ var TeslemetryStream = class extends events.EventEmitter {
 			this.cloudCache = options.cache;
 			this.localCache = options.cache;
 		} else {
-			this.cloudCache = options?.cache?.cloud;
-			this.localCache = options?.cache?.local;
+			this.cloudCache = options?.cache?.cloud ?? true;
+			this.localCache = options?.cache?.local ?? true;
 		}
 		this.logger = root.logger;
 		if (this.vin) this.getVehicle(this.vin);
@@ -3341,11 +3341,30 @@ var TeslemetryChargingApi = class {
 	}
 };
 
+//#endregion
+//#region src/reuse.ts
+const reuse = (linger = 0) => {
+	let promise = null;
+	return async (func) => {
+		if (promise) return promise;
+		try {
+			promise = func();
+			return await promise;
+		} finally {
+			setTimeout(() => promise = null, linger);
+		}
+	};
+};
+
 //#endregion
 //#region src/TeslemetryEnergyApi.ts
 var TeslemetryEnergyApi = class extends events.EventEmitter {
 	root;
 	siteId;
+	cache = {
+		siteInfo: null,
+		liveStatus: null
+	};
 	refreshDelay = 3e4;
 	refreshInterval = {
 		siteInfo: null,
@@ -3362,6 +3381,11 @@ var TeslemetryEnergyApi = class extends events.EventEmitter {
 		this.siteId = siteId;
 		root.api.energySites.set(siteId, this);
 	}
+	on(event, listener) {
+		const cached = this.cache[event];
+		if (cached) listener(cached);
+		return super.on(event, listener);
+	}
 	/**
 	* Adjust the site's backup reserve.
 	* @param backup_reserve_percent The backup reserve percentage
@@ -3413,29 +3437,37 @@ var TeslemetryEnergyApi = class extends events.EventEmitter {
 		});
 		return data;
 	}
+	getLiveStatusReuse = reuse(1e3);
 	/**
 	* Returns the live status of the site (power, state of energy, grid status, storm mode).
 	* @return Promise to an object with response containing current live status of the energy site
 	*/
 	async getLiveStatus() {
-		const { data } = await getApi1EnergySitesByIdLiveStatus({
-			path: { id: this.siteId },
-			client: this.root.client
+		return this.getLiveStatusReuse(async () => {
+			const { data } = await getApi1EnergySitesByIdLiveStatus({
+				path: { id: this.siteId },
+				client: this.root.client
+			});
+			this.cache.liveStatus = data;
+			this.emit("liveStatus", data);
+			return data;
 		});
-		this.emit("liveStatus", data);
-		return data;
 	}
+	getSiteInfoReuse = reuse(1e3);
 	/**
 	* Returns information about the site. Things like assets (has solar, etc), settings (backup reserve, etc), and features (storm_mode_capable, etc).
 	* @return Promise to an object with response containing detailed information about the energy site
 	*/
 	async getSiteInfo() {
-		const { data } = await getApi1EnergySitesByIdSiteInfo({
-			path: { id: this.siteId },
-			client: this.root.client
+		return this.getSiteInfoReuse(async () => {
+			const { data } = await getApi1EnergySitesByIdSiteInfo({
+				path: { id: this.siteId },
+				client: this.root.client
+			});
+			this.cache.siteInfo = data;
+			this.emit("siteInfo", data);
+			return data;
 		});
-		this.emit("siteInfo", data);
-		return data;
 	}
 	/**
 	* Adjust the site's off-grid vehicle charging backup reserve.
@@ -5045,7 +5077,7 @@ const consoleLogger = {
 
 //#endregion
 //#region package.json
-var version = "0.5.1";
+var version = "0.5.3";
 
 //#endregion
 //#region src/Teslemetry.ts

package/dist/index.d.cts

@@ -7988,86 +7988,192 @@ type GetApi1EnergySitesByIdSiteInfoResponses = {
    * Default Response
    */
   200: {
-    response?: {
-      id?: string;
+    response: {
+      id: string;
       site_name?: string;
-      site_number?: string;
       backup_reserve_percent?: number;
       default_real_mode?: string;
-      installation_date?: string;
-      user_settings?: {
-        go_off_grid_test_banner_enabled?: null | boolean;
-        storm_mode_enabled?: null | boolean;
-        powerwall_onboarding_settings_set?: null | boolean;
-        powerwall_tesla_electric_interested_in?: null | boolean;
-        vpp_tour_enabled?: null | boolean;
-        off_grid_vehicle_charging_enabled?: null | boolean;
-      };
-      components?: {
-        solar?: boolean;
+      installation_date: string;
+      user_settings: {
+        go_off_grid_test_banner_enabled: null | boolean;
+        storm_mode_enabled: null | boolean;
+        powerwall_onboarding_settings_set: null | boolean;
+        powerwall_tesla_electric_interested_in: null | boolean;
+        vpp_tour_enabled: null | boolean;
+        off_grid_vehicle_charging_enabled: null | boolean;
+      };
+      components: {
+        solar: boolean;
         solar_type?: string;
-        battery?: boolean;
-        grid?: boolean;
-        backup?: boolean;
-        gateway?: string;
-        load_meter?: boolean;
-        tou_capable?: boolean;
-        storm_mode_capable?: boolean;
-        off_grid_vehicle_charging_reserve_supported?: boolean;
-        vehicle_charging_performance_view_enabled?: boolean;
-        vehicle_charging_solar_offset_view_enabled?: boolean;
-        battery_solar_offset_view_enabled?: boolean;
-        energy_service_self_scheduling_enabled?: boolean;
+        battery: boolean;
+        grid: boolean;
+        backup: boolean;
+        gateway: string;
+        load_meter: boolean;
+        tou_capable: boolean;
+        storm_mode_capable: boolean;
+        off_grid_vehicle_charging_reserve_supported: boolean;
+        vehicle_charging_performance_view_enabled: boolean;
+        vehicle_charging_solar_offset_view_enabled: boolean;
+        battery_solar_offset_view_enabled: boolean;
+        solar_value_enabled?: boolean;
+        energy_value_header?: string;
+        energy_value_subheader?: string;
+        energy_service_self_scheduling_enabled: boolean;
+        show_battery_soe_graph?: boolean;
+        show_grid_import_battery_source_cards?: boolean;
+        set_islanding_mode_enabled?: boolean;
+        wifi_commissioning_enabled?: boolean;
+        backup_time_remaining_enabled?: boolean;
+        battery_type?: string;
+        configurable?: boolean;
+        grid_services_enabled?: boolean;
+        gateways?: Array<{
+          device_id: string;
+          din: string;
+          serial_number: string;
+          part_number: string;
+          part_type: number;
+          part_name: string;
+          is_active: boolean;
+          site_id: string;
+          firmware_version: string;
+          updated_datetime: string;
+          leader_device_id?: string;
+        }>;
+        customer_preferred_export_rule?: string;
+        edit_setting_permission_to_export?: boolean;
+        edit_setting_grid_charging?: boolean;
+        edit_setting_energy_exports?: boolean;
+        system_alerts_enabled?: boolean;
+        service_mode_enabled?: boolean;
+        support_manual_backup?: boolean;
+        rate_tariff_service_options: {
+          rate_plan_configured_by_rts: boolean;
+          rate_tariff_service_enabled: boolean;
+          request_export_tariff: boolean;
+          request_network_fees: boolean;
+        };
         wall_connectors?: Array<{
-          device_id?: string;
-          din?: string;
-          serial_number?: string;
-          part_number?: string;
+          device_id: string;
+          din: string;
+          serial_number: string;
+          part_number: string;
+          part_type: number;
+          part_name: string;
+          is_active: boolean;
+        }>;
+        net_meter_mode?: string;
+        batteries?: Array<{
+          device_id: string;
+          din: string;
+          serial_number: string;
+          part_number: string;
           part_type?: number;
           part_name?: string;
-          is_active?: boolean;
+          nameplate_max_charge_power: number;
+          nameplate_max_discharge_power: number;
+          nameplate_energy: number;
+          is_active: boolean;
         }>;
-        nbt_supported?: boolean;
-        system_alerts_enabled?: boolean;
-        rate_tariff_service_options?: {
-          rate_plan_configured_by_rts?: boolean;
-          rate_tariff_service_enabled?: boolean;
-          request_export_tariff?: boolean;
-          request_network_fees?: boolean;
+        non_export_configured?: boolean;
+        disallow_charge_from_grid_with_solar_installed?: boolean;
+        ITC_cliff?: number;
+        sunrun_options?: {
+          my_home_info_deeplink_enabled: boolean;
+          support_screen_deeplink_enabled: boolean;
         };
-        solar_value_enabled?: boolean;
-        set_islanding_mode_enabled?: boolean;
-        battery_type?: string;
-        configurable?: boolean;
+        inverters?: Array<{
+          device_id: string;
+          din: string;
+          serial_number: string;
+          part_number: string;
+          part_type: number;
+          part_name: string;
+          is_active: boolean;
+          site_id: string;
+          firmware_version?: string;
+        }>;
+        nbt_supported?: boolean;
+        local_offline_monitoring_enabled?: boolean;
+        hide_time_of_use_card?: boolean;
       };
       version?: string;
       battery_count?: number;
+      /**
+       * See https://digitalassets-energy.tesla.com/raw/upload/app/fleet-api/example-tariff/PGE-EV2-A.json for example
+       */
+      tariff_content?: {
+        [key: string]: unknown;
+      };
       nameplate_power?: number;
-      nameplate_energy?: number;
       installation_time_zone?: string;
       max_site_meter_power_ac?: number;
       min_site_meter_power_ac?: number;
+      /**
+       * See https://digitalassets-energy.tesla.com/raw/upload/app/fleet-api/example-tariff/PGE-EV2-A.json for example
+       */
       tariff_content_v2?: {
-        name?: string;
-        utility?: string;
-        version?: number;
-        daily_charges?: Array<{
-          name?: string;
+        [key: string]: unknown;
+      };
+      vpp_backup_reserve_percent?: number;
+      utility?: string;
+      island_config?: {
+        low_soe_limit?: number;
+        jump_start_soe_threshold?: number;
+        wait_for_solar_retry_soe?: number;
+        max_frequency_shift_hz?: number;
+        wait_for_solar_soe_threshold?: number;
+        microgrid_not_ok_timeout?: number;
+        manual_backup?: boolean;
+        neutral_balancer_type?: string;
+      };
+      vehicle_charging_settings?: {
+        evses: Array<{
+          din: string;
+          smart_charging?: {
+            enable?: boolean;
+            schedules?: Array<{
+              time: string;
+            }>;
+            min_hours_charging?: number;
+          };
+          modbus_id?: number;
         }>;
-        demand_charges?: {
-          [key: string]: unknown;
-        };
-        energy_charges?: {
-          [key: string]: unknown;
-        };
-        seasons?: {
-          [key: string]: unknown;
-        };
-        sell_tariff?: {
-          [key: string]: unknown;
+      };
+      nameplate_energy?: number;
+      off_grid_vehicle_charging_reserve_percent?: number;
+      tariff_id?: string;
+      site_number?: string;
+      time_zone_offset?: number;
+      app_settings?: {
+        live_status_local_refresh_s: number;
+      };
+      csip?: {
+        dcap_url: string;
+        device_certificate: string;
+        csip_australia: {
+          national_meter_identifier: string;
         };
       };
+      external_switch?: {
+        input_type: string;
+        control_behavior: string;
+      };
+      aggregation_program?: {
+        name: string;
+        description: string;
+        link_name: string;
+        link_url: string;
+      };
+      tesla_electric_billing_periods?: Array<{
+        start_time: string;
+        end_time: string;
+      }>;
     };
+    error?: string;
+    error_description?: string;
+    txid?: string;
   };
 };
 type GetApi1EnergySitesByIdSiteInfoResponse = GetApi1EnergySitesByIdSiteInfoResponses[keyof GetApi1EnergySitesByIdSiteInfoResponses];
@@ -10007,20 +10113,24 @@ type OmitKeys<T, K$1> = Pick<T, Exclude<keyof T, K$1>>;
 type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown, TResponseStyle extends ResponseStyle = 'fields'> = OmitKeys<RequestOptions<TResponse, TResponseStyle, ThrowOnError>, 'body' | 'path' | 'query' | 'url'> & ([TData] extends [never] ? unknown : Omit<TData, 'url'>);
 //#endregion
 //#region src/TeslemetryEnergyApi.d.ts
+type TeslemetryEnergyEventMap = {
+  siteInfo: GetApi1EnergySitesByIdSiteInfoResponse;
+  liveStatus: GetApi1EnergySitesByIdLiveStatusResponse;
+};
 declare interface TeslemetryEnergyApi {
-  on(event: "siteInfo", listener: (data: GetApi1EnergySitesByIdSiteInfoResponse) => void): this;
-  on(event: "liveStatus", listener: (data: GetApi1EnergySitesByIdLiveStatusResponse) => void): this;
-  off(event: "siteInfo", listener: (data: GetApi1EnergySitesByIdSiteInfoResponse) => void): this;
-  off(event: "liveStatus", listener: (data: GetApi1EnergySitesByIdLiveStatusResponse) => void): this;
-  once(event: "siteInfo", listener: (data: GetApi1EnergySitesByIdSiteInfoResponse) => void): this;
-  once(event: "liveStatus", listener: (data: GetApi1EnergySitesByIdLiveStatusResponse) => void): this;
-  emit(event: "siteInfo", data: GetApi1EnergySitesByIdSiteInfoResponse): boolean;
-  emit(event: "liveStatus", data: GetApi1EnergySitesByIdLiveStatusResponse): boolean;
+  on<K$1 extends keyof TeslemetryEnergyEventMap>(event: K$1, listener: (data: TeslemetryEnergyEventMap[K$1]) => void): this;
+  off<K$1 extends keyof TeslemetryEnergyEventMap>(event: K$1, listener: (data: TeslemetryEnergyEventMap[K$1]) => void): this;
+  once<K$1 extends keyof TeslemetryEnergyEventMap>(event: K$1, listener: (data: TeslemetryEnergyEventMap[K$1]) => void): this;
+  emit<K$1 extends keyof TeslemetryEnergyEventMap>(event: K$1, data: TeslemetryEnergyEventMap[K$1]): boolean;
 }
 type PollingEndpoints = "siteInfo" | "liveStatus";
 declare class TeslemetryEnergyApi extends EventEmitter {
   private root;
   siteId: number;
+  cache: {
+    siteInfo: GetApi1EnergySitesByIdSiteInfoResponse | null;
+    liveStatus: GetApi1EnergySitesByIdLiveStatusResponse | null;
+  };
   refreshDelay: number;
   private refreshInterval;
   private refreshClients;
@@ -10080,122 +10190,18 @@ declare class TeslemetryEnergyApi extends EventEmitter {
   gridImportExport(customer_preferred_export_rule: "battery_ok" | "pv_only" | "never", disallow_charge_from_grid_with_solar_installed?: boolean): Promise<{
     response?: string;
   }>;
+  private getLiveStatusReuse;
   /**
    * Returns the live status of the site (power, state of energy, grid status, storm mode).
    * @return Promise to an object with response containing current live status of the energy site
    */
-  getLiveStatus(): Promise<{
-    response?: {
-      solar_power?: number;
-      energy_left?: number;
-      total_pack_energy?: number;
-      percentage_charged?: number;
-      backup_capable?: boolean;
-      battery_power?: number;
-      load_power?: number;
-      grid_status?: string;
-      grid_power?: number;
-      generator_power?: number;
-      island_status?: string;
-      storm_mode_active?: boolean;
-      wall_connectors?: Array<{
-        din: string;
-        vin?: string;
-        wall_connector_state: number;
-        wall_connector_fault_state?: number;
-        wall_connector_power: number;
-        ocpp_status?: number;
-        powershare_session_state?: number;
-      }>;
-      timestamp: string;
-    };
-  }>;
+  getLiveStatus(): Promise<any>;
+  private getSiteInfoReuse;
   /**
    * Returns information about the site. Things like assets (has solar, etc), settings (backup reserve, etc), and features (storm_mode_capable, etc).
    * @return Promise to an object with response containing detailed information about the energy site
    */
-  getSiteInfo(): Promise<{
-    response?: {
-      id?: string;
-      site_name?: string;
-      site_number?: string;
-      backup_reserve_percent?: number;
-      default_real_mode?: string;
-      installation_date?: string;
-      user_settings?: {
-        go_off_grid_test_banner_enabled?: null | boolean;
-        storm_mode_enabled?: null | boolean;
-        powerwall_onboarding_settings_set?: null | boolean;
-        powerwall_tesla_electric_interested_in?: null | boolean;
-        vpp_tour_enabled?: null | boolean;
-        off_grid_vehicle_charging_enabled?: null | boolean;
-      };
-      components?: {
-        solar?: boolean;
-        solar_type?: string;
-        battery?: boolean;
-        grid?: boolean;
-        backup?: boolean;
-        gateway?: string;
-        load_meter?: boolean;
-        tou_capable?: boolean;
-        storm_mode_capable?: boolean;
-        off_grid_vehicle_charging_reserve_supported?: boolean;
-        vehicle_charging_performance_view_enabled?: boolean;
-        vehicle_charging_solar_offset_view_enabled?: boolean;
-        battery_solar_offset_view_enabled?: boolean;
-        energy_service_self_scheduling_enabled?: boolean;
-        wall_connectors?: Array<{
-          device_id?: string;
-          din?: string;
-          serial_number?: string;
-          part_number?: string;
-          part_type?: number;
-          part_name?: string;
-          is_active?: boolean;
-        }>;
-        nbt_supported?: boolean;
-        system_alerts_enabled?: boolean;
-        rate_tariff_service_options?: {
-          rate_plan_configured_by_rts?: boolean;
-          rate_tariff_service_enabled?: boolean;
-          request_export_tariff?: boolean;
-          request_network_fees?: boolean;
-        };
-        solar_value_enabled?: boolean;
-        set_islanding_mode_enabled?: boolean;
-        battery_type?: string;
-        configurable?: boolean;
-      };
-      version?: string;
-      battery_count?: number;
-      nameplate_power?: number;
-      nameplate_energy?: number;
-      installation_time_zone?: string;
-      max_site_meter_power_ac?: number;
-      min_site_meter_power_ac?: number;
-      tariff_content_v2?: {
-        name?: string;
-        utility?: string;
-        version?: number;
-        daily_charges?: Array<{
-          name?: string;
-        }>;
-        demand_charges?: {
-          [key: string]: unknown;
-        };
-        energy_charges?: {
-          [key: string]: unknown;
-        };
-        seasons?: {
-          [key: string]: unknown;
-        };
-        sell_tariff?: {
-          [key: string]: unknown;
-        };
-      };
-    };
-  }>;
+  getSiteInfo(): Promise<any>;
   /**
    * Adjust the site's off-grid vehicle charging backup reserve.
    * @param off_grid_vehicle_charging_reserve_percent The off-grid vehicle charging backup reserve percentage

package/dist/index.d.mts

@@ -7988,86 +7988,192 @@ type GetApi1EnergySitesByIdSiteInfoResponses = {
    * Default Response
    */
   200: {
-    response?: {
-      id?: string;
+    response: {
+      id: string;
       site_name?: string;
-      site_number?: string;
       backup_reserve_percent?: number;
       default_real_mode?: string;
-      installation_date?: string;
-      user_settings?: {
-        go_off_grid_test_banner_enabled?: null | boolean;
-        storm_mode_enabled?: null | boolean;
-        powerwall_onboarding_settings_set?: null | boolean;
-        powerwall_tesla_electric_interested_in?: null | boolean;
-        vpp_tour_enabled?: null | boolean;
-        off_grid_vehicle_charging_enabled?: null | boolean;
-      };
-      components?: {
-        solar?: boolean;
+      installation_date: string;
+      user_settings: {
+        go_off_grid_test_banner_enabled: null | boolean;
+        storm_mode_enabled: null | boolean;
+        powerwall_onboarding_settings_set: null | boolean;
+        powerwall_tesla_electric_interested_in: null | boolean;
+        vpp_tour_enabled: null | boolean;
+        off_grid_vehicle_charging_enabled: null | boolean;
+      };
+      components: {
+        solar: boolean;
         solar_type?: string;
-        battery?: boolean;
-        grid?: boolean;
-        backup?: boolean;
-        gateway?: string;
-        load_meter?: boolean;
-        tou_capable?: boolean;
-        storm_mode_capable?: boolean;
-        off_grid_vehicle_charging_reserve_supported?: boolean;
-        vehicle_charging_performance_view_enabled?: boolean;
-        vehicle_charging_solar_offset_view_enabled?: boolean;
-        battery_solar_offset_view_enabled?: boolean;
-        energy_service_self_scheduling_enabled?: boolean;
+        battery: boolean;
+        grid: boolean;
+        backup: boolean;
+        gateway: string;
+        load_meter: boolean;
+        tou_capable: boolean;
+        storm_mode_capable: boolean;
+        off_grid_vehicle_charging_reserve_supported: boolean;
+        vehicle_charging_performance_view_enabled: boolean;
+        vehicle_charging_solar_offset_view_enabled: boolean;
+        battery_solar_offset_view_enabled: boolean;
+        solar_value_enabled?: boolean;
+        energy_value_header?: string;
+        energy_value_subheader?: string;
+        energy_service_self_scheduling_enabled: boolean;
+        show_battery_soe_graph?: boolean;
+        show_grid_import_battery_source_cards?: boolean;
+        set_islanding_mode_enabled?: boolean;
+        wifi_commissioning_enabled?: boolean;
+        backup_time_remaining_enabled?: boolean;
+        battery_type?: string;
+        configurable?: boolean;
+        grid_services_enabled?: boolean;
+        gateways?: Array<{
+          device_id: string;
+          din: string;
+          serial_number: string;
+          part_number: string;
+          part_type: number;
+          part_name: string;
+          is_active: boolean;
+          site_id: string;
+          firmware_version: string;
+          updated_datetime: string;
+          leader_device_id?: string;
+        }>;
+        customer_preferred_export_rule?: string;
+        edit_setting_permission_to_export?: boolean;
+        edit_setting_grid_charging?: boolean;
+        edit_setting_energy_exports?: boolean;
+        system_alerts_enabled?: boolean;
+        service_mode_enabled?: boolean;
+        support_manual_backup?: boolean;
+        rate_tariff_service_options: {
+          rate_plan_configured_by_rts: boolean;
+          rate_tariff_service_enabled: boolean;
+          request_export_tariff: boolean;
+          request_network_fees: boolean;
+        };
         wall_connectors?: Array<{
-          device_id?: string;
-          din?: string;
-          serial_number?: string;
-          part_number?: string;
+          device_id: string;
+          din: string;
+          serial_number: string;
+          part_number: string;
+          part_type: number;
+          part_name: string;
+          is_active: boolean;
+        }>;
+        net_meter_mode?: string;
+        batteries?: Array<{
+          device_id: string;
+          din: string;
+          serial_number: string;
+          part_number: string;
           part_type?: number;
           part_name?: string;
-          is_active?: boolean;
+          nameplate_max_charge_power: number;
+          nameplate_max_discharge_power: number;
+          nameplate_energy: number;
+          is_active: boolean;
         }>;
-        nbt_supported?: boolean;
-        system_alerts_enabled?: boolean;
-        rate_tariff_service_options?: {
-          rate_plan_configured_by_rts?: boolean;
-          rate_tariff_service_enabled?: boolean;
-          request_export_tariff?: boolean;
-          request_network_fees?: boolean;
+        non_export_configured?: boolean;
+        disallow_charge_from_grid_with_solar_installed?: boolean;
+        ITC_cliff?: number;
+        sunrun_options?: {
+          my_home_info_deeplink_enabled: boolean;
+          support_screen_deeplink_enabled: boolean;
         };
-        solar_value_enabled?: boolean;
-        set_islanding_mode_enabled?: boolean;
-        battery_type?: string;
-        configurable?: boolean;
+        inverters?: Array<{
+          device_id: string;
+          din: string;
+          serial_number: string;
+          part_number: string;
+          part_type: number;
+          part_name: string;
+          is_active: boolean;
+          site_id: string;
+          firmware_version?: string;
+        }>;
+        nbt_supported?: boolean;
+        local_offline_monitoring_enabled?: boolean;
+        hide_time_of_use_card?: boolean;
       };
       version?: string;
       battery_count?: number;
+      /**
+       * See https://digitalassets-energy.tesla.com/raw/upload/app/fleet-api/example-tariff/PGE-EV2-A.json for example
+       */
+      tariff_content?: {
+        [key: string]: unknown;
+      };
       nameplate_power?: number;
-      nameplate_energy?: number;
       installation_time_zone?: string;
       max_site_meter_power_ac?: number;
       min_site_meter_power_ac?: number;
+      /**
+       * See https://digitalassets-energy.tesla.com/raw/upload/app/fleet-api/example-tariff/PGE-EV2-A.json for example
+       */
       tariff_content_v2?: {
-        name?: string;
-        utility?: string;
-        version?: number;
-        daily_charges?: Array<{
-          name?: string;
+        [key: string]: unknown;
+      };
+      vpp_backup_reserve_percent?: number;
+      utility?: string;
+      island_config?: {
+        low_soe_limit?: number;
+        jump_start_soe_threshold?: number;
+        wait_for_solar_retry_soe?: number;
+        max_frequency_shift_hz?: number;
+        wait_for_solar_soe_threshold?: number;
+        microgrid_not_ok_timeout?: number;
+        manual_backup?: boolean;
+        neutral_balancer_type?: string;
+      };
+      vehicle_charging_settings?: {
+        evses: Array<{
+          din: string;
+          smart_charging?: {
+            enable?: boolean;
+            schedules?: Array<{
+              time: string;
+            }>;
+            min_hours_charging?: number;
+          };
+          modbus_id?: number;
         }>;
-        demand_charges?: {
-          [key: string]: unknown;
-        };
-        energy_charges?: {
-          [key: string]: unknown;
-        };
-        seasons?: {
-          [key: string]: unknown;
-        };
-        sell_tariff?: {
-          [key: string]: unknown;
+      };
+      nameplate_energy?: number;
+      off_grid_vehicle_charging_reserve_percent?: number;
+      tariff_id?: string;
+      site_number?: string;
+      time_zone_offset?: number;
+      app_settings?: {
+        live_status_local_refresh_s: number;
+      };
+      csip?: {
+        dcap_url: string;
+        device_certificate: string;
+        csip_australia: {
+          national_meter_identifier: string;
         };
       };
+      external_switch?: {
+        input_type: string;
+        control_behavior: string;
+      };
+      aggregation_program?: {
+        name: string;
+        description: string;
+        link_name: string;
+        link_url: string;
+      };
+      tesla_electric_billing_periods?: Array<{
+        start_time: string;
+        end_time: string;
+      }>;
     };
+    error?: string;
+    error_description?: string;
+    txid?: string;
   };
 };
 type GetApi1EnergySitesByIdSiteInfoResponse = GetApi1EnergySitesByIdSiteInfoResponses[keyof GetApi1EnergySitesByIdSiteInfoResponses];
@@ -10007,20 +10113,24 @@ type OmitKeys<T, K$1> = Pick<T, Exclude<keyof T, K$1>>;
 type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown, TResponseStyle extends ResponseStyle = 'fields'> = OmitKeys<RequestOptions<TResponse, TResponseStyle, ThrowOnError>, 'body' | 'path' | 'query' | 'url'> & ([TData] extends [never] ? unknown : Omit<TData, 'url'>);
 //#endregion
 //#region src/TeslemetryEnergyApi.d.ts
+type TeslemetryEnergyEventMap = {
+  siteInfo: GetApi1EnergySitesByIdSiteInfoResponse;
+  liveStatus: GetApi1EnergySitesByIdLiveStatusResponse;
+};
 declare interface TeslemetryEnergyApi {
-  on(event: "siteInfo", listener: (data: GetApi1EnergySitesByIdSiteInfoResponse) => void): this;
-  on(event: "liveStatus", listener: (data: GetApi1EnergySitesByIdLiveStatusResponse) => void): this;
-  off(event: "siteInfo", listener: (data: GetApi1EnergySitesByIdSiteInfoResponse) => void): this;
-  off(event: "liveStatus", listener: (data: GetApi1EnergySitesByIdLiveStatusResponse) => void): this;
-  once(event: "siteInfo", listener: (data: GetApi1EnergySitesByIdSiteInfoResponse) => void): this;
-  once(event: "liveStatus", listener: (data: GetApi1EnergySitesByIdLiveStatusResponse) => void): this;
-  emit(event: "siteInfo", data: GetApi1EnergySitesByIdSiteInfoResponse): boolean;
-  emit(event: "liveStatus", data: GetApi1EnergySitesByIdLiveStatusResponse): boolean;
+  on<K$1 extends keyof TeslemetryEnergyEventMap>(event: K$1, listener: (data: TeslemetryEnergyEventMap[K$1]) => void): this;
+  off<K$1 extends keyof TeslemetryEnergyEventMap>(event: K$1, listener: (data: TeslemetryEnergyEventMap[K$1]) => void): this;
+  once<K$1 extends keyof TeslemetryEnergyEventMap>(event: K$1, listener: (data: TeslemetryEnergyEventMap[K$1]) => void): this;
+  emit<K$1 extends keyof TeslemetryEnergyEventMap>(event: K$1, data: TeslemetryEnergyEventMap[K$1]): boolean;
 }
 type PollingEndpoints = "siteInfo" | "liveStatus";
 declare class TeslemetryEnergyApi extends EventEmitter {
   private root;
   siteId: number;
+  cache: {
+    siteInfo: GetApi1EnergySitesByIdSiteInfoResponse | null;
+    liveStatus: GetApi1EnergySitesByIdLiveStatusResponse | null;
+  };
   refreshDelay: number;
   private refreshInterval;
   private refreshClients;
@@ -10080,122 +10190,18 @@ declare class TeslemetryEnergyApi extends EventEmitter {
   gridImportExport(customer_preferred_export_rule: "battery_ok" | "pv_only" | "never", disallow_charge_from_grid_with_solar_installed?: boolean): Promise<{
     response?: string;
   }>;
+  private getLiveStatusReuse;
   /**
    * Returns the live status of the site (power, state of energy, grid status, storm mode).
    * @return Promise to an object with response containing current live status of the energy site
    */
-  getLiveStatus(): Promise<{
-    response?: {
-      solar_power?: number;
-      energy_left?: number;
-      total_pack_energy?: number;
-      percentage_charged?: number;
-      backup_capable?: boolean;
-      battery_power?: number;
-      load_power?: number;
-      grid_status?: string;
-      grid_power?: number;
-      generator_power?: number;
-      island_status?: string;
-      storm_mode_active?: boolean;
-      wall_connectors?: Array<{
-        din: string;
-        vin?: string;
-        wall_connector_state: number;
-        wall_connector_fault_state?: number;
-        wall_connector_power: number;
-        ocpp_status?: number;
-        powershare_session_state?: number;
-      }>;
-      timestamp: string;
-    };
-  }>;
+  getLiveStatus(): Promise<any>;
+  private getSiteInfoReuse;
   /**
    * Returns information about the site. Things like assets (has solar, etc), settings (backup reserve, etc), and features (storm_mode_capable, etc).
    * @return Promise to an object with response containing detailed information about the energy site
    */
-  getSiteInfo(): Promise<{
-    response?: {
-      id?: string;
-      site_name?: string;
-      site_number?: string;
-      backup_reserve_percent?: number;
-      default_real_mode?: string;
-      installation_date?: string;
-      user_settings?: {
-        go_off_grid_test_banner_enabled?: null | boolean;
-        storm_mode_enabled?: null | boolean;
-        powerwall_onboarding_settings_set?: null | boolean;
-        powerwall_tesla_electric_interested_in?: null | boolean;
-        vpp_tour_enabled?: null | boolean;
-        off_grid_vehicle_charging_enabled?: null | boolean;
-      };
-      components?: {
-        solar?: boolean;
-        solar_type?: string;
-        battery?: boolean;
-        grid?: boolean;
-        backup?: boolean;
-        gateway?: string;
-        load_meter?: boolean;
-        tou_capable?: boolean;
-        storm_mode_capable?: boolean;
-        off_grid_vehicle_charging_reserve_supported?: boolean;
-        vehicle_charging_performance_view_enabled?: boolean;
-        vehicle_charging_solar_offset_view_enabled?: boolean;
-        battery_solar_offset_view_enabled?: boolean;
-        energy_service_self_scheduling_enabled?: boolean;
-        wall_connectors?: Array<{
-          device_id?: string;
-          din?: string;
-          serial_number?: string;
-          part_number?: string;
-          part_type?: number;
-          part_name?: string;
-          is_active?: boolean;
-        }>;
-        nbt_supported?: boolean;
-        system_alerts_enabled?: boolean;
-        rate_tariff_service_options?: {
-          rate_plan_configured_by_rts?: boolean;
-          rate_tariff_service_enabled?: boolean;
-          request_export_tariff?: boolean;
-          request_network_fees?: boolean;
-        };
-        solar_value_enabled?: boolean;
-        set_islanding_mode_enabled?: boolean;
-        battery_type?: string;
-        configurable?: boolean;
-      };
-      version?: string;
-      battery_count?: number;
-      nameplate_power?: number;
-      nameplate_energy?: number;
-      installation_time_zone?: string;
-      max_site_meter_power_ac?: number;
-      min_site_meter_power_ac?: number;
-      tariff_content_v2?: {
-        name?: string;
-        utility?: string;
-        version?: number;
-        daily_charges?: Array<{
-          name?: string;
-        }>;
-        demand_charges?: {
-          [key: string]: unknown;
-        };
-        energy_charges?: {
-          [key: string]: unknown;
-        };
-        seasons?: {
-          [key: string]: unknown;
-        };
-        sell_tariff?: {
-          [key: string]: unknown;
-        };
-      };
-    };
-  }>;
+  getSiteInfo(): Promise<any>;
   /**
    * Adjust the site's off-grid vehicle charging backup reserve.
    * @param off_grid_vehicle_charging_reserve_percent The off-grid vehicle charging backup reserve percentage

package/dist/index.mjs

@@ -3115,8 +3115,8 @@ var TeslemetryStream = class extends EventEmitter {
 			this.cloudCache = options.cache;
 			this.localCache = options.cache;
 		} else {
-			this.cloudCache = options?.cache?.cloud;
-			this.localCache = options?.cache?.local;
+			this.cloudCache = options?.cache?.cloud ?? true;
+			this.localCache = options?.cache?.local ?? true;
 		}
 		this.logger = root.logger;
 		if (this.vin) this.getVehicle(this.vin);
@@ -3341,11 +3341,30 @@ var TeslemetryChargingApi = class {
 	}
 };
 
+//#endregion
+//#region src/reuse.ts
+const reuse = (linger = 0) => {
+	let promise = null;
+	return async (func) => {
+		if (promise) return promise;
+		try {
+			promise = func();
+			return await promise;
+		} finally {
+			setTimeout(() => promise = null, linger);
+		}
+	};
+};
+
 //#endregion
 //#region src/TeslemetryEnergyApi.ts
 var TeslemetryEnergyApi = class extends EventEmitter {
 	root;
 	siteId;
+	cache = {
+		siteInfo: null,
+		liveStatus: null
+	};
 	refreshDelay = 3e4;
 	refreshInterval = {
 		siteInfo: null,
@@ -3362,6 +3381,11 @@ var TeslemetryEnergyApi = class extends EventEmitter {
 		this.siteId = siteId;
 		root.api.energySites.set(siteId, this);
 	}
+	on(event, listener) {
+		const cached = this.cache[event];
+		if (cached) listener(cached);
+		return super.on(event, listener);
+	}
 	/**
 	* Adjust the site's backup reserve.
 	* @param backup_reserve_percent The backup reserve percentage
@@ -3413,29 +3437,37 @@ var TeslemetryEnergyApi = class extends EventEmitter {
 		});
 		return data;
 	}
+	getLiveStatusReuse = reuse(1e3);
 	/**
 	* Returns the live status of the site (power, state of energy, grid status, storm mode).
 	* @return Promise to an object with response containing current live status of the energy site
 	*/
 	async getLiveStatus() {
-		const { data } = await getApi1EnergySitesByIdLiveStatus({
-			path: { id: this.siteId },
-			client: this.root.client
+		return this.getLiveStatusReuse(async () => {
+			const { data } = await getApi1EnergySitesByIdLiveStatus({
+				path: { id: this.siteId },
+				client: this.root.client
+			});
+			this.cache.liveStatus = data;
+			this.emit("liveStatus", data);
+			return data;
 		});
-		this.emit("liveStatus", data);
-		return data;
 	}
+	getSiteInfoReuse = reuse(1e3);
 	/**
 	* Returns information about the site. Things like assets (has solar, etc), settings (backup reserve, etc), and features (storm_mode_capable, etc).
 	* @return Promise to an object with response containing detailed information about the energy site
 	*/
 	async getSiteInfo() {
-		const { data } = await getApi1EnergySitesByIdSiteInfo({
-			path: { id: this.siteId },
-			client: this.root.client
+		return this.getSiteInfoReuse(async () => {
+			const { data } = await getApi1EnergySitesByIdSiteInfo({
+				path: { id: this.siteId },
+				client: this.root.client
+			});
+			this.cache.siteInfo = data;
+			this.emit("siteInfo", data);
+			return data;
 		});
-		this.emit("siteInfo", data);
-		return data;
 	}
 	/**
 	* Adjust the site's off-grid vehicle charging backup reserve.
@@ -5045,7 +5077,7 @@ const consoleLogger = {
 
 //#endregion
 //#region package.json
-var version = "0.5.1";
+var version = "0.5.3";
 
 //#endregion
 //#region src/Teslemetry.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teslemetry/api",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "API client for Teslemetry",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",