tesla-fleet-api 0.4.0 → 0.5.0

package/dist/vehiclespecific.mjs

@@ -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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tesla-fleet-api",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -17,8 +17,10 @@
     "@eslint/js": "^10.0.1",
     "@types/node": "^24.13.3",
     "eslint": "^10.8.0",
+    "homey-apps-sdk-v3-types": "0.3.12",
     "publint": "^0.3.23",
     "tsdown": "^0.23.4",
+    "tsx": "^4.23.15",
     "typescript": "^5.9.2",
     "typescript-eslint": "^8.66.0",
     "vitest": "^4.1.10"
@@ -90,6 +92,56 @@
         "default": "./dist/types.cjs"
       }
     },
+    "./bluetooth": {
+      "import": {
+        "types": "./dist/bluetooth.d.mts",
+        "default": "./dist/bluetooth.mjs"
+      },
+      "require": {
+        "types": "./dist/bluetooth.d.cts",
+        "default": "./dist/bluetooth.cjs"
+      }
+    },
+    "./bluetooth/homey": {
+      "import": {
+        "types": "./dist/bluetooth/homey.d.mts",
+        "default": "./dist/bluetooth/homey.mjs"
+      },
+      "require": {
+        "types": "./dist/bluetooth/homey.d.cts",
+        "default": "./dist/bluetooth/homey.cjs"
+      }
+    },
+    "./bluetooth/noble": {
+      "import": {
+        "types": "./dist/bluetooth/noble.d.mts",
+        "default": "./dist/bluetooth/noble.mjs"
+      },
+      "require": {
+        "types": "./dist/bluetooth/noble.d.cts",
+        "default": "./dist/bluetooth/noble.cjs"
+      }
+    },
+    "./bluetooth/esphome": {
+      "import": {
+        "types": "./dist/bluetooth/esphome.d.mts",
+        "default": "./dist/bluetooth/esphome.mjs"
+      },
+      "require": {
+        "types": "./dist/bluetooth/esphome.d.cts",
+        "default": "./dist/bluetooth/esphome.cjs"
+      }
+    },
+    "./powerwall": {
+      "import": {
+        "types": "./dist/powerwall.d.mts",
+        "default": "./dist/powerwall.mjs"
+      },
+      "require": {
+        "types": "./dist/powerwall.d.cts",
+        "default": "./dist/powerwall.cjs"
+      }
+    },
     "./package.json": "./package.json"
   },
   "sideEffects": false,
@@ -98,7 +150,19 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "@teslemetry/tesla-protocol": "~6.0.0"
+    "@teslemetry/tesla-protocol": "~6.1.0"
+  },
+  "peerDependencies": {
+    "@2colors/esphome-native-api": "^1.3.6",
+    "@stoprocent/noble": "^2.8.0"
+  },
+  "peerDependenciesMeta": {
+    "@2colors/esphome-native-api": {
+      "optional": true
+    },
+    "@stoprocent/noble": {
+      "optional": true
+    }
   },
   "scripts": {
     "watch": "tsdown --watch",
@@ -108,6 +172,9 @@
     "pack:check": "publint && attw --pack . --profile node16",
     "changeset": "changeset",
     "ci:publish": "changeset publish",
-    "build": "tsdown"
+    "build": "tsdown",
+    "powerwall:check": "tsx scripts/powerwall-readonly-check.ts",
+    "ble:live": "tsx scripts/ble-live/run.ts",
+    "parity": "tsx scripts/parity.ts"
   }
 }