@teslemetry/api 0.6.11 → 0.6.13

package/dist/index.cjs

@@ -3060,19 +3060,20 @@ var TeslemetryVehicleStream = class extends events.EventEmitter {
 		this._fieldUpdateBatch = null;
 		try {
 			const data = await this.patchConfig(batch.fields);
-			if (data?.updated_vehicles) {
-				this.logger.info(`Updated ${Object.keys(batch.fields).length} streaming fields for ${this.vin}`);
-				this.fields = {
-					...this.fields,
-					...batch.fields
-				};
-				batch.deferred.resolve();
+			if (data?.updated_vehicles === void 0) throw new Error(`Error updating streaming config for ${this.vin}`);
+			this.fields = {
+				...this.fields,
+				...batch.fields
+			};
+			if (data.updated_vehicles === 0) {
+				this.logger.debug(`No update required for ${this.vin}`);
+				batch.deferred.resolve(false);
 			} else {
-				const error = /* @__PURE__ */ new Error(`Error updating streaming config for ${this.vin}`);
-				this.logger.error(error.message, data);
-				batch.deferred.reject(error);
+				this.logger.info(`Updated ${Object.keys(batch.fields).length} streaming fields for ${this.vin}`);
+				batch.deferred.resolve(true);
 			}
 		} catch (error) {
+			this.logger.error(error.message);
 			batch.deferred.reject(error);
 		}
 	}
@@ -3098,12 +3099,12 @@ var TeslemetryVehicleStream = class extends events.EventEmitter {
 	* Add a field to the vehicles streaming configuration
 	* @param field Vehicle Signal
 	* @param interval
-	* @returns Promise that resolves when the field is added
+	* @returns Promise that resolves to whether the field configuration changed
 	*/
 	addField(field, interval) {
 		if (this.fields && this.fields[field] && (interval === void 0 || this.fields[field].interval_seconds === interval)) {
 			this.logger.debug(`Streaming field ${field} already enabled @ ${this.fields[field]?.interval_seconds || "default"}s`);
-			return Promise.resolve();
+			return Promise.resolve(false);
 		}
 		const value = interval !== void 0 ? { interval_seconds: interval } : null;
 		return this.updateFields({ [field]: value });
@@ -3384,12 +3385,20 @@ var TeslemetryChargingApi = class extends events.EventEmitter {
 //#endregion
 //#region src/dateHelper.ts
 /**
-* Converts a Date object to ISO string format without milliseconds
+* Converts a Date object to RFC3339 format with local timezone offset
 * @param date The Date object to convert
-* @returns ISO string with milliseconds removed (e.g., "2024-01-15T00:00:00Z")
+* @returns RFC3339 string with timezone offset (e.g., "2024-01-15T00:00:00+11:00")
 */
 function formatDate(date) {
-	return date.toISOString().replace(/\.\d{3}Z$/, "Z");
+	const pad = (n, digits = 2) => String(n).padStart(digits, "0");
+	const year = date.getFullYear();
+	const month = pad(date.getMonth() + 1);
+	const day = pad(date.getDate());
+	const hours = pad(date.getHours());
+	const minutes = pad(date.getMinutes());
+	const seconds = pad(date.getSeconds());
+	const tzOffset = -date.getTimezoneOffset();
+	return `${year}-${month}-${day}T${hours}:${minutes}:${seconds}${tzOffset >= 0 ? "+" : "-"}${pad(Math.floor(Math.abs(tzOffset) / 60))}:${pad(Math.abs(tzOffset) % 60)}`;
 }
 /**
 * Gets the start of today (midnight) in local timezone
@@ -3639,7 +3648,7 @@ var TeslemetryEnergyApi = class extends events.EventEmitter {
 	* Returns the charging history of a wall connector.
 	* @param start_date Start date for the telemetry data (string, Date, or undefined - defaults to start of today)
 	* @param end_date End date for the telemetry data (string, Date, or undefined - defaults to end of today)
-	* @param time_zone Optional timezone for the data
+	* @param time_zone IANA timezone for the data (e.g., 'America/Los_Angeles') - defaults to local timezone
 	* @return Promise to an object with response containing charging history data from wall connectors
 	*/
 	async getTelemetryHistory(start_date, end_date, time_zone) {
@@ -3647,7 +3656,7 @@ var TeslemetryEnergyApi = class extends events.EventEmitter {
 			query: {
 				kind: "charge",
 				...processDateRange(start_date ?? getStartOfToday(), end_date ?? getEndOfToday()),
-				time_zone
+				time_zone: time_zone ?? Intl.DateTimeFormat().resolvedOptions().timeZone
 			},
 			path: { id: this.siteId },
 			client: this.root.client
@@ -5253,7 +5262,7 @@ const consoleLogger = {
 
 //#endregion
 //#region package.json
-var version = "0.6.11";
+var version = "0.6.13";
 
 //#endregion
 //#region src/Teslemetry.ts

package/dist/index.d.cts

@@ -3794,7 +3794,12 @@ type PatchApiConfigByVinData = {
      */
     vin: string;
   };
-  query?: never;
+  query?: {
+    /**
+     * Use minimum values instead of defaults. 'true' applies minimums to new fields only, 'force' overrides all fields with minimum values.
+     */
+    min?: 'true' | 'force';
+  };
   url: '/api/config/{vin}';
 };
 type PostApiConfigByVinData = {
@@ -5618,7 +5623,12 @@ type PostApiConfigByVinData = {
      */
     vin: string;
   };
-  query?: never;
+  query?: {
+    /**
+     * Use minimum values instead of defaults. 'true' applies minimums to new fields only, 'force' overrides all fields with minimum values.
+     */
+    min?: 'true' | 'force';
+  };
   url: '/api/config/{vin}';
 };
 type GetApi1VehiclesByVinVehicleDataResponses = {
@@ -8037,32 +8047,107 @@ type GetApi1EnergySitesByIdLiveStatusResponses = {
    */
   200: {
     response: {
+      /**
+       * Power currently being generated by solar panels in watts. Always zero or positive.
+       */
       solar_power?: number;
+      /**
+       * Powerwall battery state of charge as a percentage (0-100).
+       */
       percentage_charged?: number;
+      /**
+       * Power flowing to/from the Powerwall battery in watts. Positive = discharging (powering home/grid), negative = charging.
+       */
       battery_power?: number;
+      /**
+       * Total power consumption of the home in watts. Always zero or positive.
+       */
       load_power?: number;
+      /**
+       * Current status of the utility grid connection.
+       */
       grid_status?: 'Active' | 'Inactive' | 'Unknown';
+      /**
+       * Power flowing to/from the utility grid in watts. Positive = importing (buying from grid), negative = exporting (selling to grid).
+       */
       grid_power?: number;
+      /**
+       * Power from a backup generator in watts, if present. Always zero or positive.
+       */
       generator_power?: number;
+      /**
+       * Array of Tesla Wall Connectors at the energy site.
+       */
       wall_connectors?: Array<{
+        /**
+         * Device Identification Number, a unique identifier for the Wall Connector.
+         */
         din: string;
+        /**
+         * Vehicle Identification Number of the connected vehicle, if any.
+         */
         vin?: string;
+        /**
+         * Operational state: 1 = charging, 2 = not plugged in, 3 = plugged in (not charging), 4 = plugged in (paused).
+         */
         wall_connector_state: number;
+        /**
+         * Fault condition code. 0 indicates no fault.
+         */
         wall_connector_fault_state?: number;
+        /**
+         * Power being delivered to the vehicle in watts.
+         */
         wall_connector_power: number;
+        /**
+         * Open Charge Point Protocol status code.
+         */
         ocpp_status?: number;
+        /**
+         * Powershare (vehicle-to-home) session state code.
+         */
         powershare_session_state?: number;
       }>;
+      /**
+       * Whether the site is islanded (operating independently from the grid). off_grid_intentional = user-initiated (e.g., Go Off-Grid test), off_grid_unintentional = grid outage.
+       */
       island_status?: 'on_grid' | 'island_status_unknown' | 'off_grid_intentional' | 'off_grid_unintentional';
+      /**
+       * Whether Storm Watch is currently active, charging the battery to 100% in preparation for a potential outage.
+       */
       storm_mode_active?: boolean;
+      /**
+       * ISO 8601 timestamp when this data was captured.
+       */
       timestamp: string;
+      /**
+       * Active Storm Watch events with timing and storm type information.
+       */
       storm_mode_states?: Array<{
+        /**
+         * Unique identifier for the storm watch event.
+         */
         watch_event_id: string;
+        /**
+         * ISO 8601 timestamp when the storm watch begins.
+         */
         start_time: string;
+        /**
+         * ISO 8601 timestamp when the storm watch ends.
+         */
         end_time: string;
+        /**
+         * Type of storm (e.g., winter storm, hurricane, thunderstorm).
+         */
         storm_type: string;
+        /**
+         * Whether the user has opted out of this storm watch event.
+         */
         opted_out?: boolean;
       }>;
+      /**
+       * Whether the battery breaker is open, meaning the Powerwall is electrically disconnected from the system.
+       */
       battery_breaker_open?: boolean;
     };
   };
@@ -8074,44 +8159,158 @@ type GetApi1EnergySitesByIdSiteInfoResponses = {
    */
   200: {
     response: {
+      /**
+       * Unique identifier for the energy site.
+       */
       id: string;
+      /**
+       * User-defined name for the energy site.
+       */
       site_name?: string;
+      /**
+       * Minimum battery level (0-80% or 100%) to reserve for backup power during grid outages.
+       */
       backup_reserve_percent?: number;
+      /**
+       * Operating mode: 'autonomous' (time-based control), 'self_consumption' (self-powered), or 'backup' (backup only).
+       */
       default_real_mode?: string;
+      /**
+       * Date when the energy system was installed, in ISO 8601 format.
+       */
       installation_date: string;
+      /**
+       * User-configurable settings for the energy site.
+       */
       user_settings: {
+        /**
+         * Whether the Go Off-Grid test banner is shown in the app.
+         */
         go_off_grid_test_banner_enabled: null | boolean;
+        /**
+         * Whether Storm Watch is enabled to automatically charge battery before severe weather.
+         */
         storm_mode_enabled: null | boolean;
+        /**
+         * Whether the user has completed Powerwall onboarding setup.
+         */
         powerwall_onboarding_settings_set: null | boolean;
+        /**
+         * Whether the user has expressed interest in Tesla Electric utility service.
+         */
         powerwall_tesla_electric_interested_in: null | boolean;
+        /**
+         * Whether the Virtual Power Plant tour/introduction is enabled.
+         */
         vpp_tour_enabled: null | boolean;
+        /**
+         * Whether vehicle charging is allowed when the site is off-grid (islanded).
+         */
         off_grid_vehicle_charging_enabled: null | boolean;
       };
+      /**
+       * Hardware components and feature capabilities of the energy site.
+       */
       components: {
+        /**
+         * Whether solar panels are installed at the site.
+         */
         solar: boolean;
+        /**
+         * Type of solar installation (e.g., 'pv_panel', 'roof').
+         */
         solar_type?: string;
+        /**
+         * Whether a Powerwall battery is installed at the site.
+         */
         battery: boolean;
+        /**
+         * Whether the site has a grid connection.
+         */
         grid: boolean;
+        /**
+         * Whether backup power functionality is available.
+         */
         backup: boolean;
+        /**
+         * Type of Tesla gateway device (e.g., 'teg' for Tesla Energy Gateway).
+         */
         gateway: string;
+        /**
+         * Whether a load meter is installed to measure home consumption.
+         */
         load_meter: boolean;
+        /**
+         * Whether the system supports Time-of-Use rate optimization.
+         */
         tou_capable: boolean;
+        /**
+         * Whether Storm Watch functionality is available.
+         */
         storm_mode_capable: boolean;
+        /**
+         * Whether the system supports reserving battery capacity for vehicle charging during off-grid operation.
+         */
         off_grid_vehicle_charging_reserve_supported: boolean;
+        /**
+         * Whether vehicle charging performance metrics are available in the app.
+         */
         vehicle_charging_performance_view_enabled: boolean;
+        /**
+         * Whether solar offset metrics for vehicle charging are available in the app.
+         */
         vehicle_charging_solar_offset_view_enabled: boolean;
+        /**
+         * Whether solar offset metrics for battery charging are available in the app.
+         */
         battery_solar_offset_view_enabled: boolean;
+        /**
+         * Whether solar value calculations are enabled.
+         */
         solar_value_enabled?: boolean;
+        /**
+         * Header text displayed for energy value in the app.
+         */
         energy_value_header?: string;
+        /**
+         * Subheader text displayed for energy value in the app.
+         */
         energy_value_subheader?: string;
+        /**
+         * Whether the system can self-schedule for grid services events.
+         */
         energy_service_self_scheduling_enabled: boolean;
+        /**
+         * Whether to display the battery state of energy graph in the app.
+         */
         show_battery_soe_graph?: boolean;
+        /**
+         * Whether to show grid import and battery source cards in the app.
+         */
         show_grid_import_battery_source_cards?: boolean;
+        /**
+         * Whether the user can manually trigger off-grid (island) mode.
+         */
         set_islanding_mode_enabled?: boolean;
+        /**
+         * Whether WiFi commissioning is enabled for the gateway.
+         */
         wifi_commissioning_enabled?: boolean;
+        /**
+         * Whether backup time remaining estimates are available.
+         */
         backup_time_remaining_enabled?: boolean;
+        /**
+         * Type of battery installed (e.g., 'ac_powerwall' for Powerwall 2/+, 'dc_powerwall' for Powerwall 3).
+         */
         battery_type?: string;
+        /**
+         * Whether the system settings can be modified via the API.
+         */
         configurable?: boolean;
+        /**
+         * Whether the site is enrolled in grid services (Virtual Power Plant).
+         */
         grid_services_enabled?: boolean;
         gateways?: Array<{
           device_id: string;
@@ -10599,7 +10798,7 @@ declare class TeslemetryEnergyApi extends EventEmitter {
    * Returns the charging history of a wall connector.
    * @param start_date Start date for the telemetry data (string, Date, or undefined - defaults to start of today)
    * @param end_date End date for the telemetry data (string, Date, or undefined - defaults to end of today)
-   * @param time_zone Optional timezone for the data
+   * @param time_zone IANA timezone for the data (e.g., 'America/Los_Angeles') - defaults to local timezone
    * @return Promise to an object with response containing charging history data from wall connectors
    */
   getTelemetryHistory(start_date?: DateInput, end_date?: DateInput, time_zone?: string): Promise<{
@@ -14279,7 +14478,7 @@ declare class TeslemetryVehicleStream extends EventEmitter {
    * Returns a promise that resolves when the debounced update completes.
    * Multiple calls within the debounce window share the same promise.
    */
-  updateFields(fields: FieldsRequest): Promise<void>;
+  updateFields(fields: FieldsRequest): Promise<boolean>;
   /** Flush pending field updates to the API */
   private _flushFieldUpdate;
   /** Modify the field configuration of the vehicle */
@@ -14298,9 +14497,9 @@ declare class TeslemetryVehicleStream extends EventEmitter {
    * Add a field to the vehicles streaming configuration
    * @param field Vehicle Signal
    * @param interval
-   * @returns Promise that resolves when the field is added
+   * @returns Promise that resolves to whether the field configuration changed
    */
-  addField(field: Signals, interval?: number): Promise<void>;
+  addField(field: Signals, interval?: number): Promise<boolean>;
   /**
    * Helper to enable and listen for specific field signals
    * @param field Vehicle field to listen for

package/dist/index.d.mts

@@ -3794,7 +3794,12 @@ type PatchApiConfigByVinData = {
      */
     vin: string;
   };
-  query?: never;
+  query?: {
+    /**
+     * Use minimum values instead of defaults. 'true' applies minimums to new fields only, 'force' overrides all fields with minimum values.
+     */
+    min?: 'true' | 'force';
+  };
   url: '/api/config/{vin}';
 };
 type PostApiConfigByVinData = {
@@ -5618,7 +5623,12 @@ type PostApiConfigByVinData = {
      */
     vin: string;
   };
-  query?: never;
+  query?: {
+    /**
+     * Use minimum values instead of defaults. 'true' applies minimums to new fields only, 'force' overrides all fields with minimum values.
+     */
+    min?: 'true' | 'force';
+  };
   url: '/api/config/{vin}';
 };
 type GetApi1VehiclesByVinVehicleDataResponses = {
@@ -8037,32 +8047,107 @@ type GetApi1EnergySitesByIdLiveStatusResponses = {
    */
   200: {
     response: {
+      /**
+       * Power currently being generated by solar panels in watts. Always zero or positive.
+       */
       solar_power?: number;
+      /**
+       * Powerwall battery state of charge as a percentage (0-100).
+       */
       percentage_charged?: number;
+      /**
+       * Power flowing to/from the Powerwall battery in watts. Positive = discharging (powering home/grid), negative = charging.
+       */
       battery_power?: number;
+      /**
+       * Total power consumption of the home in watts. Always zero or positive.
+       */
       load_power?: number;
+      /**
+       * Current status of the utility grid connection.
+       */
       grid_status?: 'Active' | 'Inactive' | 'Unknown';
+      /**
+       * Power flowing to/from the utility grid in watts. Positive = importing (buying from grid), negative = exporting (selling to grid).
+       */
       grid_power?: number;
+      /**
+       * Power from a backup generator in watts, if present. Always zero or positive.
+       */
       generator_power?: number;
+      /**
+       * Array of Tesla Wall Connectors at the energy site.
+       */
       wall_connectors?: Array<{
+        /**
+         * Device Identification Number, a unique identifier for the Wall Connector.
+         */
         din: string;
+        /**
+         * Vehicle Identification Number of the connected vehicle, if any.
+         */
         vin?: string;
+        /**
+         * Operational state: 1 = charging, 2 = not plugged in, 3 = plugged in (not charging), 4 = plugged in (paused).
+         */
         wall_connector_state: number;
+        /**
+         * Fault condition code. 0 indicates no fault.
+         */
         wall_connector_fault_state?: number;
+        /**
+         * Power being delivered to the vehicle in watts.
+         */
         wall_connector_power: number;
+        /**
+         * Open Charge Point Protocol status code.
+         */
         ocpp_status?: number;
+        /**
+         * Powershare (vehicle-to-home) session state code.
+         */
         powershare_session_state?: number;
       }>;
+      /**
+       * Whether the site is islanded (operating independently from the grid). off_grid_intentional = user-initiated (e.g., Go Off-Grid test), off_grid_unintentional = grid outage.
+       */
       island_status?: 'on_grid' | 'island_status_unknown' | 'off_grid_intentional' | 'off_grid_unintentional';
+      /**
+       * Whether Storm Watch is currently active, charging the battery to 100% in preparation for a potential outage.
+       */
       storm_mode_active?: boolean;
+      /**
+       * ISO 8601 timestamp when this data was captured.
+       */
       timestamp: string;
+      /**
+       * Active Storm Watch events with timing and storm type information.
+       */
       storm_mode_states?: Array<{
+        /**
+         * Unique identifier for the storm watch event.
+         */
         watch_event_id: string;
+        /**
+         * ISO 8601 timestamp when the storm watch begins.
+         */
         start_time: string;
+        /**
+         * ISO 8601 timestamp when the storm watch ends.
+         */
         end_time: string;
+        /**
+         * Type of storm (e.g., winter storm, hurricane, thunderstorm).
+         */
         storm_type: string;
+        /**
+         * Whether the user has opted out of this storm watch event.
+         */
         opted_out?: boolean;
       }>;
+      /**
+       * Whether the battery breaker is open, meaning the Powerwall is electrically disconnected from the system.
+       */
       battery_breaker_open?: boolean;
     };
   };
@@ -8074,44 +8159,158 @@ type GetApi1EnergySitesByIdSiteInfoResponses = {
    */
   200: {
     response: {
+      /**
+       * Unique identifier for the energy site.
+       */
       id: string;
+      /**
+       * User-defined name for the energy site.
+       */
       site_name?: string;
+      /**
+       * Minimum battery level (0-80% or 100%) to reserve for backup power during grid outages.
+       */
       backup_reserve_percent?: number;
+      /**
+       * Operating mode: 'autonomous' (time-based control), 'self_consumption' (self-powered), or 'backup' (backup only).
+       */
       default_real_mode?: string;
+      /**
+       * Date when the energy system was installed, in ISO 8601 format.
+       */
       installation_date: string;
+      /**
+       * User-configurable settings for the energy site.
+       */
       user_settings: {
+        /**
+         * Whether the Go Off-Grid test banner is shown in the app.
+         */
         go_off_grid_test_banner_enabled: null | boolean;
+        /**
+         * Whether Storm Watch is enabled to automatically charge battery before severe weather.
+         */
         storm_mode_enabled: null | boolean;
+        /**
+         * Whether the user has completed Powerwall onboarding setup.
+         */
         powerwall_onboarding_settings_set: null | boolean;
+        /**
+         * Whether the user has expressed interest in Tesla Electric utility service.
+         */
         powerwall_tesla_electric_interested_in: null | boolean;
+        /**
+         * Whether the Virtual Power Plant tour/introduction is enabled.
+         */
         vpp_tour_enabled: null | boolean;
+        /**
+         * Whether vehicle charging is allowed when the site is off-grid (islanded).
+         */
         off_grid_vehicle_charging_enabled: null | boolean;
       };
+      /**
+       * Hardware components and feature capabilities of the energy site.
+       */
       components: {
+        /**
+         * Whether solar panels are installed at the site.
+         */
         solar: boolean;
+        /**
+         * Type of solar installation (e.g., 'pv_panel', 'roof').
+         */
         solar_type?: string;
+        /**
+         * Whether a Powerwall battery is installed at the site.
+         */
         battery: boolean;
+        /**
+         * Whether the site has a grid connection.
+         */
         grid: boolean;
+        /**
+         * Whether backup power functionality is available.
+         */
         backup: boolean;
+        /**
+         * Type of Tesla gateway device (e.g., 'teg' for Tesla Energy Gateway).
+         */
         gateway: string;
+        /**
+         * Whether a load meter is installed to measure home consumption.
+         */
         load_meter: boolean;
+        /**
+         * Whether the system supports Time-of-Use rate optimization.
+         */
         tou_capable: boolean;
+        /**
+         * Whether Storm Watch functionality is available.
+         */
         storm_mode_capable: boolean;
+        /**
+         * Whether the system supports reserving battery capacity for vehicle charging during off-grid operation.
+         */
         off_grid_vehicle_charging_reserve_supported: boolean;
+        /**
+         * Whether vehicle charging performance metrics are available in the app.
+         */
         vehicle_charging_performance_view_enabled: boolean;
+        /**
+         * Whether solar offset metrics for vehicle charging are available in the app.
+         */
         vehicle_charging_solar_offset_view_enabled: boolean;
+        /**
+         * Whether solar offset metrics for battery charging are available in the app.
+         */
         battery_solar_offset_view_enabled: boolean;
+        /**
+         * Whether solar value calculations are enabled.
+         */
         solar_value_enabled?: boolean;
+        /**
+         * Header text displayed for energy value in the app.
+         */
         energy_value_header?: string;
+        /**
+         * Subheader text displayed for energy value in the app.
+         */
         energy_value_subheader?: string;
+        /**
+         * Whether the system can self-schedule for grid services events.
+         */
         energy_service_self_scheduling_enabled: boolean;
+        /**
+         * Whether to display the battery state of energy graph in the app.
+         */
         show_battery_soe_graph?: boolean;
+        /**
+         * Whether to show grid import and battery source cards in the app.
+         */
         show_grid_import_battery_source_cards?: boolean;
+        /**
+         * Whether the user can manually trigger off-grid (island) mode.
+         */
         set_islanding_mode_enabled?: boolean;
+        /**
+         * Whether WiFi commissioning is enabled for the gateway.
+         */
         wifi_commissioning_enabled?: boolean;
+        /**
+         * Whether backup time remaining estimates are available.
+         */
         backup_time_remaining_enabled?: boolean;
+        /**
+         * Type of battery installed (e.g., 'ac_powerwall' for Powerwall 2/+, 'dc_powerwall' for Powerwall 3).
+         */
         battery_type?: string;
+        /**
+         * Whether the system settings can be modified via the API.
+         */
         configurable?: boolean;
+        /**
+         * Whether the site is enrolled in grid services (Virtual Power Plant).
+         */
         grid_services_enabled?: boolean;
         gateways?: Array<{
           device_id: string;
@@ -10599,7 +10798,7 @@ declare class TeslemetryEnergyApi extends EventEmitter {
    * Returns the charging history of a wall connector.
    * @param start_date Start date for the telemetry data (string, Date, or undefined - defaults to start of today)
    * @param end_date End date for the telemetry data (string, Date, or undefined - defaults to end of today)
-   * @param time_zone Optional timezone for the data
+   * @param time_zone IANA timezone for the data (e.g., 'America/Los_Angeles') - defaults to local timezone
    * @return Promise to an object with response containing charging history data from wall connectors
    */
   getTelemetryHistory(start_date?: DateInput, end_date?: DateInput, time_zone?: string): Promise<{
@@ -14279,7 +14478,7 @@ declare class TeslemetryVehicleStream extends EventEmitter {
    * Returns a promise that resolves when the debounced update completes.
    * Multiple calls within the debounce window share the same promise.
    */
-  updateFields(fields: FieldsRequest): Promise<void>;
+  updateFields(fields: FieldsRequest): Promise<boolean>;
   /** Flush pending field updates to the API */
   private _flushFieldUpdate;
   /** Modify the field configuration of the vehicle */
@@ -14298,9 +14497,9 @@ declare class TeslemetryVehicleStream extends EventEmitter {
    * Add a field to the vehicles streaming configuration
    * @param field Vehicle Signal
    * @param interval
-   * @returns Promise that resolves when the field is added
+   * @returns Promise that resolves to whether the field configuration changed
    */
-  addField(field: Signals, interval?: number): Promise<void>;
+  addField(field: Signals, interval?: number): Promise<boolean>;
   /**
    * Helper to enable and listen for specific field signals
    * @param field Vehicle field to listen for

package/dist/index.mjs

@@ -3060,19 +3060,20 @@ var TeslemetryVehicleStream = class extends EventEmitter {
 		this._fieldUpdateBatch = null;
 		try {
 			const data = await this.patchConfig(batch.fields);
-			if (data?.updated_vehicles) {
-				this.logger.info(`Updated ${Object.keys(batch.fields).length} streaming fields for ${this.vin}`);
-				this.fields = {
-					...this.fields,
-					...batch.fields
-				};
-				batch.deferred.resolve();
+			if (data?.updated_vehicles === void 0) throw new Error(`Error updating streaming config for ${this.vin}`);
+			this.fields = {
+				...this.fields,
+				...batch.fields
+			};
+			if (data.updated_vehicles === 0) {
+				this.logger.debug(`No update required for ${this.vin}`);
+				batch.deferred.resolve(false);
 			} else {
-				const error = /* @__PURE__ */ new Error(`Error updating streaming config for ${this.vin}`);
-				this.logger.error(error.message, data);
-				batch.deferred.reject(error);
+				this.logger.info(`Updated ${Object.keys(batch.fields).length} streaming fields for ${this.vin}`);
+				batch.deferred.resolve(true);
 			}
 		} catch (error) {
+			this.logger.error(error.message);
 			batch.deferred.reject(error);
 		}
 	}
@@ -3098,12 +3099,12 @@ var TeslemetryVehicleStream = class extends EventEmitter {
 	* Add a field to the vehicles streaming configuration
 	* @param field Vehicle Signal
 	* @param interval
-	* @returns Promise that resolves when the field is added
+	* @returns Promise that resolves to whether the field configuration changed
 	*/
 	addField(field, interval) {
 		if (this.fields && this.fields[field] && (interval === void 0 || this.fields[field].interval_seconds === interval)) {
 			this.logger.debug(`Streaming field ${field} already enabled @ ${this.fields[field]?.interval_seconds || "default"}s`);
-			return Promise.resolve();
+			return Promise.resolve(false);
 		}
 		const value = interval !== void 0 ? { interval_seconds: interval } : null;
 		return this.updateFields({ [field]: value });
@@ -3384,12 +3385,20 @@ var TeslemetryChargingApi = class extends EventEmitter {
 //#endregion
 //#region src/dateHelper.ts
 /**
-* Converts a Date object to ISO string format without milliseconds
+* Converts a Date object to RFC3339 format with local timezone offset
 * @param date The Date object to convert
-* @returns ISO string with milliseconds removed (e.g., "2024-01-15T00:00:00Z")
+* @returns RFC3339 string with timezone offset (e.g., "2024-01-15T00:00:00+11:00")
 */
 function formatDate(date) {
-	return date.toISOString().replace(/\.\d{3}Z$/, "Z");
+	const pad = (n, digits = 2) => String(n).padStart(digits, "0");
+	const year = date.getFullYear();
+	const month = pad(date.getMonth() + 1);
+	const day = pad(date.getDate());
+	const hours = pad(date.getHours());
+	const minutes = pad(date.getMinutes());
+	const seconds = pad(date.getSeconds());
+	const tzOffset = -date.getTimezoneOffset();
+	return `${year}-${month}-${day}T${hours}:${minutes}:${seconds}${tzOffset >= 0 ? "+" : "-"}${pad(Math.floor(Math.abs(tzOffset) / 60))}:${pad(Math.abs(tzOffset) % 60)}`;
 }
 /**
 * Gets the start of today (midnight) in local timezone
@@ -3639,7 +3648,7 @@ var TeslemetryEnergyApi = class extends EventEmitter {
 	* Returns the charging history of a wall connector.
 	* @param start_date Start date for the telemetry data (string, Date, or undefined - defaults to start of today)
 	* @param end_date End date for the telemetry data (string, Date, or undefined - defaults to end of today)
-	* @param time_zone Optional timezone for the data
+	* @param time_zone IANA timezone for the data (e.g., 'America/Los_Angeles') - defaults to local timezone
 	* @return Promise to an object with response containing charging history data from wall connectors
 	*/
 	async getTelemetryHistory(start_date, end_date, time_zone) {
@@ -3647,7 +3656,7 @@ var TeslemetryEnergyApi = class extends EventEmitter {
 			query: {
 				kind: "charge",
 				...processDateRange(start_date ?? getStartOfToday(), end_date ?? getEndOfToday()),
-				time_zone
+				time_zone: time_zone ?? Intl.DateTimeFormat().resolvedOptions().timeZone
 			},
 			path: { id: this.siteId },
 			client: this.root.client
@@ -5253,7 +5262,7 @@ const consoleLogger = {
 
 //#endregion
 //#region package.json
-var version = "0.6.11";
+var version = "0.6.13";
 
 //#endregion
 //#region src/Teslemetry.ts

package/package.json

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