tesla-fleet-api 0.4.0 → 0.5.0

package/dist/vehiclespecific.cjs

@@ -14,8 +14,8 @@ var VehicleSpecific = class {
 	* Controls the front (which_trunk: "front") or rear (which_trunk: "rear") trunk.
 	* @param which_trunk "front" or "rear"
 	*/
-	async actuate_truck(which_trunk) {
-		return this.parent.actuate_truck(this.vin, which_trunk);
+	async actuate_trunk(which_trunk) {
+		return this.parent.actuate_trunk(this.vin, which_trunk);
 	}
 	/**
 	* Adjusts vehicle media playback volume.
@@ -80,9 +80,10 @@ var VehicleSpecific = class {
 	}
 	/**
 	* Deactivates PIN to Drive and resets the associated PIN for vehicles running firmware versions 2023.44+. This command is only accessible to fleet managers or owners.
+	* @param pin Optional four-digit PIN
 	*/
-	async clear_pin_to_drive_admin() {
-		return this.parent.clear_pin_to_drive_admin(this.vin);
+	async clear_pin_to_drive_admin(pin) {
+		return this.parent.clear_pin_to_drive_admin(this.vin, pin);
 	}
 	/**
 	* Locks the vehicle.
@@ -168,12 +169,13 @@ var VehicleSpecific = class {
 	}
 	/**
 	* Sends a location to the in-vehicle navigation system.
+	* @param value Destination text
 	* @param type "share_ext_content_raw"
-	* @param locale ISO locale such as "en-US"
-	* @param timestamp_ms
+	* @param locale ISO locale such as "en-US". Defaults to `DEFAULT_LOCALE`.
+	* @param timestamp_ms Defaults to now
 	*/
-	async navigation_request(value, locale, type = "share_ext_content_raw") {
-		return this.parent.navigation_request(this.vin, value, locale, type);
+	async navigation_request(value, type = "share_ext_content_raw", locale, timestamp_ms) {
+		return this.parent.navigation_request(this.vin, value, type, locale, timestamp_ms);
 	}
 	/**
 	* Start navigation to a supercharger.
@@ -185,6 +187,13 @@ var VehicleSpecific = class {
 		return this.parent.navigation_sc_request(this.vin, id, order);
 	}
 	/**
+	* Sends a list of waypoints to the vehicle's navigation system.
+	* @param waypoints Comma-separated Google Maps place IDs, e.g. `"refId:ChIJ...,refId:ChIJ..."`
+	*/
+	async navigation_waypoints_request(waypoints) {
+		return this.parent.parent._request("POST", `api/1/vehicles/${this.vin}/command/navigation_waypoints_request`, null, { waypoints });
+	}
+	/**
 	* Sets automatic seat heating and cooling.
 	* @param auto_seat_position `AutoSeat` position (1-indexed: front left is 1, front right is 2)
 	* @param auto_climate_on `true` or `false`
@@ -208,7 +217,7 @@ var VehicleSpecific = class {
 	}
 	/**
 	* Sets seat cooling.
-	* @param seat_position Seat position
+	* @param seat_position `AutoSeat` position (1-indexed: front left is 1, front right is 2), unlike seat heating
 	* @param seat_cooler_level Cooling level
 	*/
 	async remote_seat_cooler_request(seat_position, seat_cooler_level) {
@@ -344,6 +353,95 @@ var VehicleSpecific = class {
 		return this.parent.set_scheduled_departure(this.vin, enable, preconditioning_enabled, preconditioning_weekdays_only, departure_time, off_peak_charging_enabled, off_peak_charging_weekdays_only, end_off_peak_time);
 	}
 	/**
+	* Add or modify a charging schedule. At least one of `start_time` or `end_time` is required.
+	* @param days_of_week Comma-joined day names (e.g. `"Mon,Wed"`, `"All"`, `"Weekdays"`) or a day bitmask
+	* @param enabled `true` or `false`
+	* @param lat Latitude of the schedule's location
+	* @param lon Longitude of the schedule's location
+	* @param start_time Minutes after midnight to start charging
+	* @param end_time Minutes after midnight to stop charging
+	* @param one_time Run the schedule only once
+	* @param id Schedule ID to modify an existing schedule
+	* @param _name Only the signed path carries a schedule name; REST accepts it for parity and does not send it
+	*/
+	async add_charge_schedule(days_of_week, enabled, lat, lon, start_time, end_time, one_time, id, _name) {
+		if (start_time == null && end_time == null) throw new Error("Either start_time or end_time or both must be provided");
+		return this.parent.parent._request("POST", `api/1/vehicles/${this.vin}/command/add_charge_schedule`, null, {
+			days_of_week,
+			enabled,
+			end_enabled: end_time != null,
+			lat,
+			lon,
+			start_enabled: start_time != null,
+			start_time,
+			end_time,
+			id,
+			one_time
+		});
+	}
+	/**
+	* Add or modify a preconditioning schedule.
+	* @param days_of_week Comma-joined day names (e.g. `"Mon,Wed"`, `"All"`, `"Weekdays"`) or a day bitmask
+	* @param enabled `true` or `false`
+	* @param lat Latitude of the schedule's location
+	* @param lon Longitude of the schedule's location
+	* @param precondition_time Minutes after midnight to be preconditioned by
+	* @param id Schedule ID to modify an existing schedule
+	* @param one_time Run the schedule only once
+	* @param _name Only the signed path carries a schedule name; REST accepts it for parity and does not send it
+	*/
+	async add_precondition_schedule(days_of_week, enabled, lat, lon, precondition_time, id, one_time, _name) {
+		return this.parent.parent._request("POST", `api/1/vehicles/${this.vin}/command/add_precondition_schedule`, null, {
+			days_of_week,
+			enabled,
+			lat,
+			lon,
+			precondition_time,
+			id,
+			one_time
+		});
+	}
+	/**
+	* Removes a charging schedule.
+	* @param id Schedule ID
+	*/
+	async remove_charge_schedule(id) {
+		return this.parent.parent._request("POST", `api/1/vehicles/${this.vin}/command/remove_charge_schedule`, null, { id });
+	}
+	/**
+	* Removes a preconditioning schedule.
+	* @param id Schedule ID
+	*/
+	async remove_precondition_schedule(id) {
+		return this.parent.parent._request("POST", `api/1/vehicles/${this.vin}/command/remove_precondition_schedule`, null, { id });
+	}
+	/**
+	* Removes charging schedules by location type.
+	* @param home Remove schedules at home
+	* @param work Remove schedules at work
+	* @param other Remove schedules at other locations
+	*/
+	async batch_remove_charge_schedules(home, work, other) {
+		return this.parent.parent._request("POST", `api/1/vehicles/${this.vin}/command/batch_remove_charge_schedules`, null, {
+			home,
+			work,
+			other
+		});
+	}
+	/**
+	* Removes preconditioning schedules by location type.
+	* @param home Remove schedules at home
+	* @param work Remove schedules at work
+	* @param other Remove schedules at other locations
+	*/
+	async batch_remove_precondition_schedules(home, work, other) {
+		return this.parent.parent._request("POST", `api/1/vehicles/${this.vin}/command/batch_remove_precondition_schedules`, null, {
+			home,
+			work,
+			other
+		});
+	}
+	/**
 	* Enables and disables Sentry Mode. Sentry Mode allows customers to watch the vehicle cameras live from the mobile app, as well as record sentry events.
 	* @param on `true` or `false`
 	*/
@@ -427,8 +525,8 @@ var VehicleSpecific = class {
 	* @param lat Latitude
 	* @param lon Longitude
 	*/
-	async trigger_homelink(lat, lon, token) {
-		return this.parent.trigger_homelink(this.vin, lat, lon, token);
+	async trigger_homelink(token, lat, lon) {
+		return this.parent.trigger_homelink(this.vin, token, lat, lon);
 	}
 	/**
 	* Upcoming calendar entries stored on the vehicle.
@@ -486,13 +584,24 @@ var VehicleSpecific = class {
 	* @param config A dictionary description the fleet telemetry configuration
 	* @returns
 	*/
-	async fleet_telemetry_config(config) {
-		return this.parent.fleet_telemetry_config({
+	async fleet_telemetry_config_create(config) {
+		return this.parent.fleet_telemetry_config_create({
 			vins: [this.vin],
 			config
 		});
 	}
 	/**
+	* Configures fleet telemetry with a Tesla.SS256-signed JWS token, signed by the partner's registered command key.
+	* @param vins Vehicle Identification Numbers to configure
+	* @param token JWS token wrapping the fleet telemetry configuration
+	*/
+	async fleet_telemetry_config_jws(vins, token) {
+		return this.parent.parent._request("POST", "api/1/vehicles/fleet_telemetry_config_jws", null, {
+			vins,
+			token
+		});
+	}
+	/**
 	* Disconnects vehicles to stream telemetry data to self hosted fleet-telemetry server.
 	* @returns
 	*/
@@ -589,9 +698,11 @@ var VehicleSpecific = class {
 	}
 	/**
 	* Wakes the vehicle from sleep, which is a state to minimize idle energy consumption.
+	* @param options.wait Poll `vehicle()` until the vehicle reports `online`, raising `VehicleOffline` at the deadline
+	* @param options.timeoutMs Deadline for `wait`, in milliseconds (default 60000)
 	*/
-	async wake_up() {
-		return this.parent.wake_up(this.vin);
+	async wake_up(options) {
+		return this.parent.wake_up(this.vin, options);
 	}
 	/**
 	* Returns warranty details.

package/dist/vehiclespecific.d.cts

@@ -1,7 +1,7 @@
 import { CommandResponse, FleetTelemetryConfig } from "./types/commands.cjs";
 import { AutoSeat, ClimateMode, Level, Seat, Trunk, VehicleDataEndpoint } from "./const.cjs";
-import { OptionsResponse } from "./types/responses.cjs";
-import { VehicleResponse } from "./types/vehicle.cjs";
+import { OptionsResponse, ResponseEnvelope } from "./types/responses.cjs";
+import { VehicleResponse, WakeUpOptions } from "./types/vehicle.cjs";
 import { VehicleDataResponse } from "./types/vehicle_data.cjs";
 import Vehicle from "./vehicle.cjs";
 declare class VehicleSpecific {
@@ -14,7 +14,7 @@ declare class VehicleSpecific {
    * Controls the front (which_trunk: "front") or rear (which_trunk: "rear") trunk.
    * @param which_trunk "front" or "rear"
    */
-  actuate_truck(which_trunk: Trunk): Promise<CommandResponse>;
+  actuate_trunk(which_trunk: Trunk): Promise<CommandResponse>;
   /**
    * Adjusts vehicle media playback volume.
    * @param volume A floating point number from 0.0 to 11.0.
@@ -58,8 +58,9 @@ declare class VehicleSpecific {
   charge_stop(): Promise<CommandResponse>;
   /**
    * Deactivates PIN to Drive and resets the associated PIN for vehicles running firmware versions 2023.44+. This command is only accessible to fleet managers or owners.
+   * @param pin Optional four-digit PIN
    */
-  clear_pin_to_drive_admin(): Promise<CommandResponse>;
+  clear_pin_to_drive_admin(pin?: string | number): Promise<CommandResponse>;
   /**
    * Locks the vehicle.
    */
@@ -118,11 +119,12 @@ declare class VehicleSpecific {
   navigation_gps_request(lat: number, lon: number, order?: number): Promise<CommandResponse>;
   /**
    * Sends a location to the in-vehicle navigation system.
+   * @param value Destination text
    * @param type "share_ext_content_raw"
-   * @param locale ISO locale such as "en-US"
-   * @param timestamp_ms
+   * @param locale ISO locale such as "en-US". Defaults to `DEFAULT_LOCALE`.
+   * @param timestamp_ms Defaults to now
    */
-  navigation_request(value: string, locale: string, type?: string): Promise<CommandResponse>;
+  navigation_request(value: string, type?: string, locale?: string | null, timestamp_ms?: number | null): Promise<CommandResponse>;
   /**
    * Start navigation to a supercharger.
    * @param id Supercharger ID
@@ -130,6 +132,11 @@ declare class VehicleSpecific {
    * @returns
    */
   navigation_sc_request(id: number, order?: number): Promise<CommandResponse>;
+  /**
+   * Sends a list of waypoints to the vehicle's navigation system.
+   * @param waypoints Comma-separated Google Maps place IDs, e.g. `"refId:ChIJ...,refId:ChIJ..."`
+   */
+  navigation_waypoints_request(waypoints: string): Promise<CommandResponse>;
   /**
    * Sets automatic seat heating and cooling.
    * @param auto_seat_position `AutoSeat` position (1-indexed: front left is 1, front right is 2)
@@ -148,10 +155,10 @@ declare class VehicleSpecific {
   remote_boombox(sound?: number): Promise<CommandResponse>;
   /**
    * Sets seat cooling.
-   * @param seat_position Seat position
+   * @param seat_position `AutoSeat` position (1-indexed: front left is 1, front right is 2), unlike seat heating
    * @param seat_cooler_level Cooling level
    */
-  remote_seat_cooler_request(seat_position: Seat | number, seat_cooler_level: Level): Promise<CommandResponse>;
+  remote_seat_cooler_request(seat_position: keyof typeof AutoSeat | number, seat_cooler_level: Level): Promise<CommandResponse>;
   /**
    * Sets seat heating.
    * @param seat_position Seat position
@@ -247,6 +254,55 @@ declare class VehicleSpecific {
    * @param end_off_peak_time Minutes after midnight
    */
   set_scheduled_departure(enable?: boolean, preconditioning_enabled?: boolean, preconditioning_weekdays_only?: boolean, departure_time?: number, off_peak_charging_enabled?: boolean, off_peak_charging_weekdays_only?: boolean, end_off_peak_time?: number): Promise<CommandResponse>;
+  /**
+   * Add or modify a charging schedule. At least one of `start_time` or `end_time` is required.
+   * @param days_of_week Comma-joined day names (e.g. `"Mon,Wed"`, `"All"`, `"Weekdays"`) or a day bitmask
+   * @param enabled `true` or `false`
+   * @param lat Latitude of the schedule's location
+   * @param lon Longitude of the schedule's location
+   * @param start_time Minutes after midnight to start charging
+   * @param end_time Minutes after midnight to stop charging
+   * @param one_time Run the schedule only once
+   * @param id Schedule ID to modify an existing schedule
+   * @param _name Only the signed path carries a schedule name; REST accepts it for parity and does not send it
+   */
+  add_charge_schedule(days_of_week: string | number, enabled: boolean, lat: number, lon: number, start_time?: number, end_time?: number, one_time?: boolean, id?: number, _name?: string): Promise<CommandResponse>;
+  /**
+   * Add or modify a preconditioning schedule.
+   * @param days_of_week Comma-joined day names (e.g. `"Mon,Wed"`, `"All"`, `"Weekdays"`) or a day bitmask
+   * @param enabled `true` or `false`
+   * @param lat Latitude of the schedule's location
+   * @param lon Longitude of the schedule's location
+   * @param precondition_time Minutes after midnight to be preconditioned by
+   * @param id Schedule ID to modify an existing schedule
+   * @param one_time Run the schedule only once
+   * @param _name Only the signed path carries a schedule name; REST accepts it for parity and does not send it
+   */
+  add_precondition_schedule(days_of_week: string | number, enabled: boolean, lat: number, lon: number, precondition_time: number, id?: number, one_time?: boolean, _name?: string): Promise<CommandResponse>;
+  /**
+   * Removes a charging schedule.
+   * @param id Schedule ID
+   */
+  remove_charge_schedule(id: number): Promise<CommandResponse>;
+  /**
+   * Removes a preconditioning schedule.
+   * @param id Schedule ID
+   */
+  remove_precondition_schedule(id: number): Promise<CommandResponse>;
+  /**
+   * Removes charging schedules by location type.
+   * @param home Remove schedules at home
+   * @param work Remove schedules at work
+   * @param other Remove schedules at other locations
+   */
+  batch_remove_charge_schedules(home: boolean, work: boolean, other: boolean): Promise<CommandResponse>;
+  /**
+   * Removes preconditioning schedules by location type.
+   * @param home Remove schedules at home
+   * @param work Remove schedules at work
+   * @param other Remove schedules at other locations
+   */
+  batch_remove_precondition_schedules(home: boolean, work: boolean, other: boolean): Promise<CommandResponse>;
   /**
    * Enables and disables Sentry Mode. Sentry Mode allows customers to watch the vehicle cameras live from the mobile app, as well as record sentry events.
    * @param on `true` or `false`
@@ -263,7 +319,7 @@ declare class VehicleSpecific {
    * @param on `true` or `false`
    * @param password Four-digit passcode
    */
-  set_valet_mode(on: boolean, password: string | number): Promise<CommandResponse>;
+  set_valet_mode(on: boolean, password?: string | number): Promise<CommandResponse>;
   /**
    * Changes the name of a vehicle. This command also requires the Tesla Vehicle Command Protocol - for more information, please see refer to the documentation here.
    * @param vehicle_name New name
@@ -309,7 +365,7 @@ declare class VehicleSpecific {
    * @param lat Latitude
    * @param lon Longitude
    */
-  trigger_homelink(lat: number, lon: number, token?: string): Promise<CommandResponse>;
+  trigger_homelink(token?: string, lat?: number, lon?: number): Promise<CommandResponse>;
   /**
    * Upcoming calendar entries stored on the vehicle.
    * @param calendar_data Calendar data
@@ -321,16 +377,16 @@ declare class VehicleSpecific {
    * @param lat Latitude
    * @param lon Longitude
    */
-  window_control(command: "vent" | "close", lat: number, lon: number): Promise<CommandResponse>;
+  window_control(command: "vent" | "close", lat?: number, lon?: number): Promise<CommandResponse>;
   /**
    * Returns all allowed drivers for a vehicle. This endpoint is only available for the vehicle owner.
    */
-  drivers(): Promise<Record<string, any>>;
+  drivers(): Promise<ResponseEnvelope<Record<string, any>[]>>;
   /**
    * Removes driver access from a vehicle. Share users can only remove their own access. Owners can remove share access or their own.
    * @param share_user_id
    */
-  drivers_remove(share_user_id?: number): Promise<Record<string, any>>;
+  drivers_remove(share_user_id?: string | number): Promise<Record<string, any>>;
   /**
    * Returns eligible vehicle subscriptions.
    * @param vin Vehicle Identification Number
@@ -352,7 +408,13 @@ declare class VehicleSpecific {
    * @param config A dictionary description the fleet telemetry configuration
    * @returns
    */
-  fleet_telemetry_config(config: FleetTelemetryConfig["config"]): Promise<Record<string, any>>;
+  fleet_telemetry_config_create(config: FleetTelemetryConfig["config"]): Promise<Record<string, any>>;
+  /**
+   * Configures fleet telemetry with a Tesla.SS256-signed JWS token, signed by the partner's registered command key.
+   * @param vins Vehicle Identification Numbers to configure
+   * @param token JWS token wrapping the fleet telemetry configuration
+   */
+  fleet_telemetry_config_jws(vins: string[], token: string): Promise<Record<string, any>>;
   /**
    * Disconnects vehicles to stream telemetry data to self hosted fleet-telemetry server.
    * @returns
@@ -414,16 +476,18 @@ declare class VehicleSpecific {
   /**
    * Returns information about a vehicle.
    */
-  vehicle(): Promise<VehicleResponse>;
+  vehicle(): Promise<ResponseEnvelope<VehicleResponse>>;
   /**
    * Makes a live call to the vehicle. This may return cached data if the vehicle is offline. For vehicles running firmware versions 2023.38+, location_data is required to fetch vehicle location. This will result in a location sharing icon to show on the vehicle UI.
    * @param endpoints
    */
-  vehicle_data(endpoints?: VehicleDataEndpoint[] | string): Promise<VehicleDataResponse>;
+  vehicle_data(endpoints?: VehicleDataEndpoint[] | string): Promise<ResponseEnvelope<VehicleDataResponse>>;
   /**
    * Wakes the vehicle from sleep, which is a state to minimize idle energy consumption.
+   * @param options.wait Poll `vehicle()` until the vehicle reports `online`, raising `VehicleOffline` at the deadline
+   * @param options.timeoutMs Deadline for `wait`, in milliseconds (default 60000)
    */
-  wake_up(): Promise<Record<string, any>>;
+  wake_up(options?: WakeUpOptions): Promise<ResponseEnvelope<VehicleResponse>>;
   /**
    * Returns warranty details.
    * @param vin

package/dist/vehiclespecific.d.mts

@@ -1,7 +1,7 @@
 import { CommandResponse, FleetTelemetryConfig } from "./types/commands.mjs";
 import { AutoSeat, ClimateMode, Level, Seat, Trunk, VehicleDataEndpoint } from "./const.mjs";
-import { OptionsResponse } from "./types/responses.mjs";
-import { VehicleResponse } from "./types/vehicle.mjs";
+import { OptionsResponse, ResponseEnvelope } from "./types/responses.mjs";
+import { VehicleResponse, WakeUpOptions } from "./types/vehicle.mjs";
 import { VehicleDataResponse } from "./types/vehicle_data.mjs";
 import Vehicle from "./vehicle.mjs";
 export default class VehicleSpecific {
@@ -14,7 +14,7 @@ export default class VehicleSpecific {
    * Controls the front (which_trunk: "front") or rear (which_trunk: "rear") trunk.
    * @param which_trunk "front" or "rear"
    */
-  actuate_truck(which_trunk: Trunk): Promise<CommandResponse>;
+  actuate_trunk(which_trunk: Trunk): Promise<CommandResponse>;
   /**
    * Adjusts vehicle media playback volume.
    * @param volume A floating point number from 0.0 to 11.0.
@@ -58,8 +58,9 @@ export default class VehicleSpecific {
   charge_stop(): Promise<CommandResponse>;
   /**
    * Deactivates PIN to Drive and resets the associated PIN for vehicles running firmware versions 2023.44+. This command is only accessible to fleet managers or owners.
+   * @param pin Optional four-digit PIN
    */
-  clear_pin_to_drive_admin(): Promise<CommandResponse>;
+  clear_pin_to_drive_admin(pin?: string | number): Promise<CommandResponse>;
   /**
    * Locks the vehicle.
    */
@@ -118,11 +119,12 @@ export default class VehicleSpecific {
   navigation_gps_request(lat: number, lon: number, order?: number): Promise<CommandResponse>;
   /**
    * Sends a location to the in-vehicle navigation system.
+   * @param value Destination text
    * @param type "share_ext_content_raw"
-   * @param locale ISO locale such as "en-US"
-   * @param timestamp_ms
+   * @param locale ISO locale such as "en-US". Defaults to `DEFAULT_LOCALE`.
+   * @param timestamp_ms Defaults to now
    */
-  navigation_request(value: string, locale: string, type?: string): Promise<CommandResponse>;
+  navigation_request(value: string, type?: string, locale?: string | null, timestamp_ms?: number | null): Promise<CommandResponse>;
   /**
    * Start navigation to a supercharger.
    * @param id Supercharger ID
@@ -130,6 +132,11 @@ export default class VehicleSpecific {
    * @returns
    */
   navigation_sc_request(id: number, order?: number): Promise<CommandResponse>;
+  /**
+   * Sends a list of waypoints to the vehicle's navigation system.
+   * @param waypoints Comma-separated Google Maps place IDs, e.g. `"refId:ChIJ...,refId:ChIJ..."`
+   */
+  navigation_waypoints_request(waypoints: string): Promise<CommandResponse>;
   /**
    * Sets automatic seat heating and cooling.
    * @param auto_seat_position `AutoSeat` position (1-indexed: front left is 1, front right is 2)
@@ -148,10 +155,10 @@ export default class VehicleSpecific {
   remote_boombox(sound?: number): Promise<CommandResponse>;
   /**
    * Sets seat cooling.
-   * @param seat_position Seat position
+   * @param seat_position `AutoSeat` position (1-indexed: front left is 1, front right is 2), unlike seat heating
    * @param seat_cooler_level Cooling level
    */
-  remote_seat_cooler_request(seat_position: Seat | number, seat_cooler_level: Level): Promise<CommandResponse>;
+  remote_seat_cooler_request(seat_position: keyof typeof AutoSeat | number, seat_cooler_level: Level): Promise<CommandResponse>;
   /**
    * Sets seat heating.
    * @param seat_position Seat position
@@ -247,6 +254,55 @@ export default class VehicleSpecific {
    * @param end_off_peak_time Minutes after midnight
    */
   set_scheduled_departure(enable?: boolean, preconditioning_enabled?: boolean, preconditioning_weekdays_only?: boolean, departure_time?: number, off_peak_charging_enabled?: boolean, off_peak_charging_weekdays_only?: boolean, end_off_peak_time?: number): Promise<CommandResponse>;
+  /**
+   * Add or modify a charging schedule. At least one of `start_time` or `end_time` is required.
+   * @param days_of_week Comma-joined day names (e.g. `"Mon,Wed"`, `"All"`, `"Weekdays"`) or a day bitmask
+   * @param enabled `true` or `false`
+   * @param lat Latitude of the schedule's location
+   * @param lon Longitude of the schedule's location
+   * @param start_time Minutes after midnight to start charging
+   * @param end_time Minutes after midnight to stop charging
+   * @param one_time Run the schedule only once
+   * @param id Schedule ID to modify an existing schedule
+   * @param _name Only the signed path carries a schedule name; REST accepts it for parity and does not send it
+   */
+  add_charge_schedule(days_of_week: string | number, enabled: boolean, lat: number, lon: number, start_time?: number, end_time?: number, one_time?: boolean, id?: number, _name?: string): Promise<CommandResponse>;
+  /**
+   * Add or modify a preconditioning schedule.
+   * @param days_of_week Comma-joined day names (e.g. `"Mon,Wed"`, `"All"`, `"Weekdays"`) or a day bitmask
+   * @param enabled `true` or `false`
+   * @param lat Latitude of the schedule's location
+   * @param lon Longitude of the schedule's location
+   * @param precondition_time Minutes after midnight to be preconditioned by
+   * @param id Schedule ID to modify an existing schedule
+   * @param one_time Run the schedule only once
+   * @param _name Only the signed path carries a schedule name; REST accepts it for parity and does not send it
+   */
+  add_precondition_schedule(days_of_week: string | number, enabled: boolean, lat: number, lon: number, precondition_time: number, id?: number, one_time?: boolean, _name?: string): Promise<CommandResponse>;
+  /**
+   * Removes a charging schedule.
+   * @param id Schedule ID
+   */
+  remove_charge_schedule(id: number): Promise<CommandResponse>;
+  /**
+   * Removes a preconditioning schedule.
+   * @param id Schedule ID
+   */
+  remove_precondition_schedule(id: number): Promise<CommandResponse>;
+  /**
+   * Removes charging schedules by location type.
+   * @param home Remove schedules at home
+   * @param work Remove schedules at work
+   * @param other Remove schedules at other locations
+   */
+  batch_remove_charge_schedules(home: boolean, work: boolean, other: boolean): Promise<CommandResponse>;
+  /**
+   * Removes preconditioning schedules by location type.
+   * @param home Remove schedules at home
+   * @param work Remove schedules at work
+   * @param other Remove schedules at other locations
+   */
+  batch_remove_precondition_schedules(home: boolean, work: boolean, other: boolean): Promise<CommandResponse>;
   /**
    * Enables and disables Sentry Mode. Sentry Mode allows customers to watch the vehicle cameras live from the mobile app, as well as record sentry events.
    * @param on `true` or `false`
@@ -263,7 +319,7 @@ export default class VehicleSpecific {
    * @param on `true` or `false`
    * @param password Four-digit passcode
    */
-  set_valet_mode(on: boolean, password: string | number): Promise<CommandResponse>;
+  set_valet_mode(on: boolean, password?: string | number): Promise<CommandResponse>;
   /**
    * Changes the name of a vehicle. This command also requires the Tesla Vehicle Command Protocol - for more information, please see refer to the documentation here.
    * @param vehicle_name New name
@@ -309,7 +365,7 @@ export default class VehicleSpecific {
    * @param lat Latitude
    * @param lon Longitude
    */
-  trigger_homelink(lat: number, lon: number, token?: string): Promise<CommandResponse>;
+  trigger_homelink(token?: string, lat?: number, lon?: number): Promise<CommandResponse>;
   /**
    * Upcoming calendar entries stored on the vehicle.
    * @param calendar_data Calendar data
@@ -321,16 +377,16 @@ export default class VehicleSpecific {
    * @param lat Latitude
    * @param lon Longitude
    */
-  window_control(command: "vent" | "close", lat: number, lon: number): Promise<CommandResponse>;
+  window_control(command: "vent" | "close", lat?: number, lon?: number): Promise<CommandResponse>;
   /**
    * Returns all allowed drivers for a vehicle. This endpoint is only available for the vehicle owner.
    */
-  drivers(): Promise<Record<string, any>>;
+  drivers(): Promise<ResponseEnvelope<Record<string, any>[]>>;
   /**
    * Removes driver access from a vehicle. Share users can only remove their own access. Owners can remove share access or their own.
    * @param share_user_id
    */
-  drivers_remove(share_user_id?: number): Promise<Record<string, any>>;
+  drivers_remove(share_user_id?: string | number): Promise<Record<string, any>>;
   /**
    * Returns eligible vehicle subscriptions.
    * @param vin Vehicle Identification Number
@@ -352,7 +408,13 @@ export default class VehicleSpecific {
    * @param config A dictionary description the fleet telemetry configuration
    * @returns
    */
-  fleet_telemetry_config(config: FleetTelemetryConfig["config"]): Promise<Record<string, any>>;
+  fleet_telemetry_config_create(config: FleetTelemetryConfig["config"]): Promise<Record<string, any>>;
+  /**
+   * Configures fleet telemetry with a Tesla.SS256-signed JWS token, signed by the partner's registered command key.
+   * @param vins Vehicle Identification Numbers to configure
+   * @param token JWS token wrapping the fleet telemetry configuration
+   */
+  fleet_telemetry_config_jws(vins: string[], token: string): Promise<Record<string, any>>;
   /**
    * Disconnects vehicles to stream telemetry data to self hosted fleet-telemetry server.
    * @returns
@@ -414,16 +476,18 @@ export default class VehicleSpecific {
   /**
    * Returns information about a vehicle.
    */
-  vehicle(): Promise<VehicleResponse>;
+  vehicle(): Promise<ResponseEnvelope<VehicleResponse>>;
   /**
    * Makes a live call to the vehicle. This may return cached data if the vehicle is offline. For vehicles running firmware versions 2023.38+, location_data is required to fetch vehicle location. This will result in a location sharing icon to show on the vehicle UI.
    * @param endpoints
    */
-  vehicle_data(endpoints?: VehicleDataEndpoint[] | string): Promise<VehicleDataResponse>;
+  vehicle_data(endpoints?: VehicleDataEndpoint[] | string): Promise<ResponseEnvelope<VehicleDataResponse>>;
   /**
    * Wakes the vehicle from sleep, which is a state to minimize idle energy consumption.
+   * @param options.wait Poll `vehicle()` until the vehicle reports `online`, raising `VehicleOffline` at the deadline
+   * @param options.timeoutMs Deadline for `wait`, in milliseconds (default 60000)
    */
-  wake_up(): Promise<Record<string, any>>;
+  wake_up(options?: WakeUpOptions): Promise<ResponseEnvelope<VehicleResponse>>;
   /**
    * Returns warranty details.
    * @param vin