tesla-fleet-api 0.4.0 → 0.5.0

package/dist/vehicle.d.mts

@@ -1,31 +1,43 @@
 import TeslaFleetApi from "./teslafleetapi.mjs";
 import { CommandResponse, FleetTelemetryConfig } from "./types/commands.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 { AutoSeat, ClimateMode, Level, Seat, Trunk, VehicleDataEndpoint } from "./const.mjs";
 import { VehicleDataResponse } from "./types/vehicle_data.mjs";
 import VehicleSpecific from "./vehiclespecific.mjs";
 import VehicleSigned from "./vehiclesigned.mjs";
 export default class Vehicle {
+  #private;
+  /** Class `createFleet` instantiates; a subclass overrides it to supply its own vehicle type. */
+  static Fleet: new (parent: Vehicle, vin: string) => VehicleSpecific;
+  /** Class `createSigned` instantiates; a subclass overrides it to supply its own signed vehicle type. */
+  static Signed: new (parent: Vehicle, vin: string, private_key?: Buffer | false, public_key?: Buffer) => VehicleSigned;
   parent: TeslaFleetApi;
-  /** Fallback private key for `signed()` when a call site doesn't pass one explicitly. */
-  private_key?: Buffer;
+  /** Every vehicle created by this factory, keyed by VIN; the latest `create*` call for a VIN wins. */
+  byVin: Map<string, VehicleSpecific>;
   constructor(parent: TeslaFleetApi);
+  /** Fallback private key for `createSigned()` when a call site doesn't pass one explicitly. */
+  get private_key(): Buffer | undefined;
+  set private_key(key: Buffer | undefined);
   /**
-   * Returns a class for a single vehicle.
+   * Creates a Fleet API vehicle that sends plaintext REST commands.
    * @param vin
    * @returns
    */
-  specific(vin: string): VehicleSpecific;
+  createFleet(vin: string): VehicleSpecific;
   /**
-   * Returns a class for a single vehicle that signs commands with the
-   * Tesla Vehicle Command Protocol and dispatches them through the Fleet
-   * API `/signed_command` endpoint, instead of the plaintext REST commands.
+   * Creates a Fleet API vehicle that signs commands with the Tesla Vehicle
+   * Command Protocol and dispatches them through the `/signed_command`
+   * endpoint, instead of the plaintext REST commands.
    * @param vin
-   * @param private_key Raw 32-byte P-256 private key scalar. Falls back to `this.private_key`.
+   * @param private_key Raw 32-byte P-256 private key scalar. Falls back to `this.private_key`, then the client's `private_key`. `false` disables signing.
    * @param public_key Uncompressed P-256 public key point. Derived from `private_key` if omitted.
    */
-  signed(vin: string, private_key?: Buffer, public_key?: Buffer): VehicleSigned;
+  createSigned(vin: string, private_key?: Buffer | false, public_key?: Buffer): VehicleSigned;
+  /** Legacy name for `createFleet`. */
+  specific(vin: string): VehicleSpecific;
+  /** Legacy name for `createSigned`. */
+  specificSigned(vin: string, private_key?: Buffer | false, public_key?: Buffer): VehicleSigned;
   /**
    * Return the vehicle model name
    * @param vin
@@ -43,7 +55,7 @@ export default class Vehicle {
    * @param vehicle_tag VIN or id field of a vehicle
    * @param which_trunk "front" or "rear"
    */
-  actuate_truck(vehicle_tag: string | number, which_trunk: Trunk): Promise<CommandResponse>;
+  actuate_trunk(vehicle_tag: string | number, which_trunk: Trunk): Promise<CommandResponse>;
   /**
    * Adjusts vehicle media playback volume.
    * @param vehicle_tag VIN or id field of a vehicle
@@ -98,8 +110,9 @@ export default class Vehicle {
   /**
    * 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 vehicle_tag VIN or id field of a vehicle
+   * @param pin Optional four-digit PIN
    */
-  clear_pin_to_drive_admin(vehicle_tag: string | number): Promise<CommandResponse>;
+  clear_pin_to_drive_admin(vehicle_tag: string | number, pin?: string | number): Promise<CommandResponse>;
   /**
    * Locks the vehicle.
    * @param vehicle_tag VIN or id field of a vehicle
@@ -172,11 +185,12 @@ export default class Vehicle {
   /**
    * Sends a location to the in-vehicle navigation system.
    * @param vehicle_tag VIN or id field of a vehicle
+   * @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(vehicle_tag: string | number, value: string, locale: string, type?: string): Promise<CommandResponse>;
+  navigation_request(vehicle_tag: string | number, value: string, type?: string, locale?: string | null, timestamp_ms?: number | null): Promise<CommandResponse>;
   /**
    * Start navigation to a supercharger.
    * @param vehicle_tag VIN or id field of a vehicle
@@ -210,7 +224,7 @@ export default class Vehicle {
    * @param seat_position Seat position
    * @param seat_cooler_level Cooling level
    */
-  remote_seat_cooler_request(vehicle_tag: string | number, seat_position: Seat | number, seat_cooler_level: Level): Promise<CommandResponse>;
+  remote_seat_cooler_request(vehicle_tag: string | number, seat_position: keyof typeof AutoSeat | number, seat_cooler_level: Level): Promise<CommandResponse>;
   /**
    * Sets seat heating.
    * @param vehicle_tag VIN or id field of a vehicle
@@ -342,7 +356,7 @@ export default class Vehicle {
    * @param on `true` or `false`
    * @param password Four-digit passcode
    */
-  set_valet_mode(vehicle_tag: string | number, on: boolean, password: string | number): Promise<CommandResponse>;
+  set_valet_mode(vehicle_tag: string | number, 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_tag VIN or id field of a vehicle
@@ -397,7 +411,7 @@ export default class Vehicle {
    * @param lat Latitude
    * @param lon Longitude
    */
-  trigger_homelink(vehicle_tag: string | number, lat: number, lon: number, token?: string): Promise<CommandResponse>;
+  trigger_homelink(vehicle_tag: string | number, token?: string, lat?: number, lon?: number): Promise<CommandResponse>;
   /**
    * Upcoming calendar entries stored on the vehicle.
    * @param vehicle_tag VIN or id field of a vehicle
@@ -411,18 +425,18 @@ export default class Vehicle {
    * @param lat Latitude
    * @param lon Longitude
    */
-  window_control(vehicle_tag: string | number, command: "vent" | "close", lat: number, lon: number): Promise<CommandResponse>;
+  window_control(vehicle_tag: string | number, 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.
    * @param vehicle_tag VIN or id field of a vehicle
    */
-  drivers(vehicle_tag: string | number): Promise<Record<string, any>[]>;
+  drivers(vehicle_tag: string | number): 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 vehicle_tag VIN or id field of a vehicle
    * @param share_user_id
    */
-  drivers_remove(vehicle_tag: string | number, share_user_id?: number): Promise<Record<string, any>>;
+  drivers_remove(vehicle_tag: string | number, share_user_id?: string | number): Promise<Record<string, any>>;
   /**
    * Returns eligible vehicle subscriptions.
    * @param vin Vehicle Identification Number
@@ -444,7 +458,7 @@ export default class Vehicle {
    * @param config A dictionary description the fleet telemetry configuration
    * @returns
    */
-  fleet_telemetry_config(config: FleetTelemetryConfig): Promise<Record<string, any>>;
+  fleet_telemetry_config_create(config: FleetTelemetryConfig): Promise<Record<string, any>>;
   /**
    * Disconnects vehicles to stream telemetry data to self hosted fleet-telemetry server.
    * @param vehicle_tag VIN or id field of a vehicle
@@ -529,18 +543,20 @@ export default class Vehicle {
    * Returns information about a vehicle.
    * @param vehicle_tag VIN or id field of a vehicle
    */
-  vehicle(vehicle_tag: string | number): Promise<VehicleResponse>;
+  vehicle(vehicle_tag: string | number): 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 vehicle_tag VIN or id field of a vehicle
    * @param endpoints
    */
-  vehicle_data(vehicle_tag: string | number, endpoints?: VehicleDataEndpoint[] | string): Promise<VehicleDataResponse>;
+  vehicle_data(vehicle_tag: string | number, endpoints?: VehicleDataEndpoint[] | string): Promise<ResponseEnvelope<VehicleDataResponse>>;
   /**
    * Wakes the vehicle from sleep, which is a state to minimize idle energy consumption.
    * @param vehicle_tag VIN or id field of a vehicle
+   * @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(vehicle_tag: string | number): Promise<Record<string, any>>;
+  wake_up(vehicle_tag: string | number, { wait, timeoutMs }?: WakeUpOptions): Promise<ResponseEnvelope<VehicleResponse>>;
   /**
    * Returns warranty details.
    * @param vin

package/dist/vehicle.mjs

@@ -1,32 +1,59 @@
-import { AutoSeat, ClimateModes, Models, Seats } from "./const.mjs";
+import { AutoSeat, ClimateModes, DEFAULT_LOCALE, Models, Seats } from "./const.mjs";
+import { VehicleOffline } from "./exceptions.mjs";
 import VehicleSpecific from "./vehiclespecific.mjs";
 import VehicleSigned from "./vehiclesigned.mjs";
 // src/vehicle.ts
+const WAKE_TIMEOUT_MS = 6e4;
+const WAKE_POLL_MS = 5e3;
 var Vehicle = class {
+	/** Class `createFleet` instantiates; a subclass overrides it to supply its own vehicle type. */
+	static Fleet = VehicleSpecific;
+	/** Class `createSigned` instantiates; a subclass overrides it to supply its own signed vehicle type. */
+	static Signed = VehicleSigned;
 	parent;
-	/** Fallback private key for `signed()` when a call site doesn't pass one explicitly. */
-	private_key;
+	#privateKey;
+	/** Every vehicle created by this factory, keyed by VIN; the latest `create*` call for a VIN wins. */
+	byVin = /* @__PURE__ */ new Map();
 	constructor(parent) {
 		this.parent = parent;
 	}
+	/** Fallback private key for `createSigned()` when a call site doesn't pass one explicitly. */
+	get private_key() {
+		return this.#privateKey;
+	}
+	set private_key(key) {
+		this.#privateKey = key;
+	}
 	/**
-	* Returns a class for a single vehicle.
+	* Creates a Fleet API vehicle that sends plaintext REST commands.
 	* @param vin
 	* @returns
 	*/
-	specific(vin) {
-		return new VehicleSpecific(this, vin);
+	createFleet(vin) {
+		const vehicle = new this.constructor.Fleet(this, vin);
+		this.byVin.set(vin, vehicle);
+		return vehicle;
 	}
 	/**
-	* Returns a class for a single vehicle that signs commands with the
-	* Tesla Vehicle Command Protocol and dispatches them through the Fleet
-	* API `/signed_command` endpoint, instead of the plaintext REST commands.
+	* Creates a Fleet API vehicle that signs commands with the Tesla Vehicle
+	* Command Protocol and dispatches them through the `/signed_command`
+	* endpoint, instead of the plaintext REST commands.
 	* @param vin
-	* @param private_key Raw 32-byte P-256 private key scalar. Falls back to `this.private_key`.
+	* @param private_key Raw 32-byte P-256 private key scalar. Falls back to `this.private_key`, then the client's `private_key`. `false` disables signing.
 	* @param public_key Uncompressed P-256 public key point. Derived from `private_key` if omitted.
 	*/
-	signed(vin, private_key, public_key) {
-		return new VehicleSigned(this, vin, private_key, public_key);
+	createSigned(vin, private_key, public_key) {
+		const vehicle = new this.constructor.Signed(this, vin, private_key, public_key);
+		this.byVin.set(vin, vehicle);
+		return vehicle;
+	}
+	/** Legacy name for `createFleet`. */
+	specific(vin) {
+		return this.createFleet(vin);
+	}
+	/** Legacy name for `createSigned`. */
+	specificSigned(vin, private_key, public_key) {
+		return this.createSigned(vin, private_key, public_key);
 	}
 	/**
 	* Return the vehicle model name
@@ -49,7 +76,7 @@ var Vehicle = class {
 	* @param vehicle_tag VIN or id field of a vehicle
 	* @param which_trunk "front" or "rear"
 	*/
-	async actuate_truck(vehicle_tag, which_trunk) {
+	async actuate_trunk(vehicle_tag, which_trunk) {
 		return this.parent._request("POST", `api/1/vehicles/${vehicle_tag}/command/actuate_trunk`, null, { which_trunk });
 	}
 	/**
@@ -127,9 +154,10 @@ var Vehicle = 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 vehicle_tag VIN or id field of a vehicle
+	* @param pin Optional four-digit PIN
 	*/
-	async clear_pin_to_drive_admin(vehicle_tag) {
-		return this.parent._request("POST", `api/1/vehicles/${vehicle_tag}/command/clear_pin_to_drive_admin`);
+	async clear_pin_to_drive_admin(vehicle_tag, pin) {
+		return this.parent._request("POST", `api/1/vehicles/${vehicle_tag}/command/clear_pin_to_drive_admin`, null, { pin: pin == null ? void 0 : String(pin) });
 	}
 	/**
 	* Locks the vehicle.
@@ -223,7 +251,7 @@ var Vehicle = class {
 	* @param lon Longitude
 	* @param order Order of multiple stops
 	*/
-	async navigation_gps_request(vehicle_tag, lat, lon, order) {
+	async navigation_gps_request(vehicle_tag, lat, lon, order = 0) {
 		return this.parent._request("POST", `api/1/vehicles/${vehicle_tag}/command/navigation_gps_request`, null, {
 			lat,
 			lon,
@@ -233,16 +261,17 @@ var Vehicle = class {
 	/**
 	* Sends a location to the in-vehicle navigation system.
 	* @param vehicle_tag VIN or id field of a vehicle
+	* @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(vehicle_tag, value, locale, type = "share_ext_content_raw") {
+	async navigation_request(vehicle_tag, value, type = "share_ext_content_raw", locale, timestamp_ms) {
 		return this.parent._request("POST", `api/1/vehicles/${vehicle_tag}/command/navigation_request`, null, {
+			value: { "android.intent.extra.TEXT": value },
 			type,
-			locale,
-			timestamp_ms: String(Date.now()),
-			value: { "android.intent.extra.TEXT": value }
+			locale: locale || DEFAULT_LOCALE,
+			timestamp_ms: timestamp_ms || Date.now()
 		});
 	}
 	/**
@@ -294,7 +323,7 @@ var Vehicle = class {
 	* @param seat_cooler_level Cooling level
 	*/
 	async remote_seat_cooler_request(vehicle_tag, seat_position, seat_cooler_level) {
-		if (typeof seat_position === "string") seat_position = Seats[seat_position];
+		if (typeof seat_position === "string") seat_position = AutoSeat[seat_position];
 		return this.parent._request("POST", `api/1/vehicles/${vehicle_tag}/command/remote_seat_cooler_request`, null, {
 			seat_position,
 			seat_cooler_level
@@ -309,8 +338,8 @@ var Vehicle = class {
 	async remote_seat_heater_request(vehicle_tag, seat_position, seat_heater_level) {
 		if (typeof seat_position === "string") seat_position = Seats[seat_position];
 		return this.parent._request("POST", `api/1/vehicles/${vehicle_tag}/command/remote_seat_heater_request`, null, {
-			seat_position,
-			seat_heater_level
+			heater: seat_position,
+			level: seat_heater_level
 		});
 	}
 	/**
@@ -505,7 +534,7 @@ var Vehicle = class {
 	async set_valet_mode(vehicle_tag, on, password) {
 		return this.parent._request("POST", `api/1/vehicles/${vehicle_tag}/command/set_valet_mode`, null, {
 			on,
-			password: String(password)
+			password: password == null ? void 0 : String(password)
 		});
 	}
 	/**
@@ -578,11 +607,14 @@ var Vehicle = class {
 	* @param lat Latitude
 	* @param lon Longitude
 	*/
-	async trigger_homelink(vehicle_tag, lat, lon, token) {
-		return this.parent._request("POST", `api/1/vehicles/${vehicle_tag}/command/trigger_homelink`, null, {
-			token,
+	async trigger_homelink(vehicle_tag, token, lat, lon) {
+		const location = lat != null && lon != null ? {
 			lat,
 			lon
+		} : {};
+		return this.parent._request("POST", `api/1/vehicles/${vehicle_tag}/command/trigger_homelink`, null, {
+			token: token || void 0,
+			...location
 		});
 	}
 	/**
@@ -612,7 +644,7 @@ var Vehicle = class {
 	* @param vehicle_tag VIN or id field of a vehicle
 	*/
 	async drivers(vehicle_tag) {
-		return this.parent._request("GET", `api/1/vehicles/${vehicle_tag}/drivers`).then(({ response }) => response);
+		return this.parent._request("GET", `api/1/vehicles/${vehicle_tag}/drivers`);
 	}
 	/**
 	* Removes driver access from a vehicle. Share users can only remove their own access. Owners can remove share access or their own.
@@ -620,7 +652,7 @@ var Vehicle = class {
 	* @param share_user_id
 	*/
 	async drivers_remove(vehicle_tag, share_user_id) {
-		return this.parent._request("DELETE", `api/1/vehicles/${vehicle_tag}/drivers`, null, { share_user_id });
+		return this.parent._request("DELETE", `api/1/vehicles/${vehicle_tag}/drivers`, { share_user_id });
 	}
 	/**
 	* Returns eligible vehicle subscriptions.
@@ -649,7 +681,7 @@ var Vehicle = class {
 	* @param config A dictionary description the fleet telemetry configuration
 	* @returns
 	*/
-	async fleet_telemetry_config(config) {
+	async fleet_telemetry_config_create(config) {
 		return this.parent._request("POST", "api/1/vehicles/fleet_telemetry_config", null, config);
 	}
 	/**
@@ -775,7 +807,7 @@ var Vehicle = class {
 	* @param vehicle_tag VIN or id field of a vehicle
 	*/
 	async vehicle(vehicle_tag) {
-		return this.parent._request("GET", `api/1/vehicles/${vehicle_tag}`).then(({ response }) => response);
+		return this.parent._request("GET", `api/1/vehicles/${vehicle_tag}`);
 	}
 	/**
 	* 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.
@@ -784,14 +816,25 @@ var Vehicle = class {
 	*/
 	async vehicle_data(vehicle_tag, endpoints) {
 		if (typeof endpoints === "object") endpoints = endpoints.join(";");
-		return this.parent._request("GET", `api/1/vehicles/${vehicle_tag}/vehicle_data`, { endpoints }).then(({ response }) => response);
+		return this.parent._request("GET", `api/1/vehicles/${vehicle_tag}/vehicle_data`, { endpoints });
 	}
 	/**
 	* Wakes the vehicle from sleep, which is a state to minimize idle energy consumption.
 	* @param vehicle_tag VIN or id field of a vehicle
-	*/
-	async wake_up(vehicle_tag) {
-		return this.parent._request("POST", `api/1/vehicles/${vehicle_tag}/wake_up`);
+	* @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(vehicle_tag, { wait = false, timeoutMs = WAKE_TIMEOUT_MS } = {}) {
+		const deadline = Date.now() + timeoutMs;
+		let result = await this.parent._request("POST", `api/1/vehicles/${vehicle_tag}/wake_up`);
+		if (!wait) return result;
+		while (result.response?.state !== "online") {
+			const remaining = deadline - Date.now();
+			if (remaining <= 0) throw new VehicleOffline(result);
+			await new Promise((resolve) => setTimeout(resolve, Math.min(WAKE_POLL_MS, remaining)));
+			result = await this.vehicle(vehicle_tag);
+		}
+		return result;
 	}
 	/**
 	* Returns warranty details.

package/dist/vehiclesigned.cjs

@@ -4,16 +4,31 @@ let _teslemetry_tesla_protocol_command_universal_message = require("@teslemetry/
 /**
 * The Fleet API `/signed_command` transport: fills `Commands`'s abstract
 * `_send` seam by base64-encoding the signed `RoutableMessage`, POSTing it to
-* the cloud `signed_command` endpoint, and decoding the reply. A future BLE
-* transport (Story 3) fills the same seam over a GATT link instead - nothing
-* else in `Commands` needs to change for that to work.
+* the cloud `signed_command` endpoint, and decoding the reply. Replies here are
+* singular and delivered whole, with no broadcast side channel, so `_send`
+* has no use for `requires` or its options.
 */
 var VehicleSigned = class extends require_commands.default {
-	async _send(msg, _requires, _expectsData, _confirmBroadcast) {
+	_transport_name = "fleet";
+	/**
+	* Configures fleet telemetry via `fleet_telemetry_config_jws`, signing
+	* `config` as a Tesla.SS256 JWS with this vehicle's command key, as Tesla's
+	* vehicle-command proxy does. Any `iss` or `aud` in `config` is overwritten.
+	* @param config The config for this vehicle, or `{ vins, config }` as in Python.
+	* @throws SigningDisabled when this vehicle has no key.
+	*/
+	async fleet_telemetry_config_create(config) {
+		const { vins, config: claims } = "vins" in config ? config : {
+			vins: [this.vin],
+			config
+		};
+		return this.fleet_telemetry_config_jws(vins, this.signFleetTelemetryConfig(claims));
+	}
+	async _send(msg) {
 		const encoded = Buffer.from(_teslemetry_tesla_protocol_command_universal_message.RoutableMessage.encode(msg).finish()).toString("base64");
 		const json = await this.parent.signed_command(this.vin, encoded);
 		const resp = _teslemetry_tesla_protocol_command_universal_message.RoutableMessage.decode(Buffer.from(json.response, "base64"));
-		this.validateAndUpdateSession(resp, Buffer.from(msg.uuid));
+		this.validate_msg(resp, Buffer.from(msg.uuid), msg.toDestination?.domain);
 		return resp;
 	}
 };

package/dist/vehiclesigned.d.cts

@@ -1,14 +1,23 @@
 import Commands from "./commands.cjs";
+import { FleetTelemetryConfig } from "./types/commands.cjs";
 import { RoutableMessage } from "@teslemetry/tesla-protocol/command/universal_message";
-import { VehicleStatus } from "@teslemetry/tesla-protocol/command/vcsec";
 /**
  * The Fleet API `/signed_command` transport: fills `Commands`'s abstract
  * `_send` seam by base64-encoding the signed `RoutableMessage`, POSTing it to
- * the cloud `signed_command` endpoint, and decoding the reply. A future BLE
- * transport (Story 3) fills the same seam over a GATT link instead - nothing
- * else in `Commands` needs to change for that to work.
+ * the cloud `signed_command` endpoint, and decoding the reply. Replies here are
+ * singular and delivered whole, with no broadcast side channel, so `_send`
+ * has no use for `requires` or its options.
  */
 declare class VehicleSigned extends Commands {
-  protected _send(msg: RoutableMessage, _requires: string, _expectsData?: boolean, _confirmBroadcast?: (status: VehicleStatus) => boolean): Promise<RoutableMessage>;
+  readonly _transport_name: string;
+  /**
+   * Configures fleet telemetry via `fleet_telemetry_config_jws`, signing
+   * `config` as a Tesla.SS256 JWS with this vehicle's command key, as Tesla's
+   * vehicle-command proxy does. Any `iss` or `aud` in `config` is overwritten.
+   * @param config The config for this vehicle, or `{ vins, config }` as in Python.
+   * @throws SigningDisabled when this vehicle has no key.
+   */
+  fleet_telemetry_config_create(config: FleetTelemetryConfig | FleetTelemetryConfig["config"]): Promise<Record<string, any>>;
+  protected _send(msg: RoutableMessage): Promise<RoutableMessage>;
 }
 export = VehicleSigned;

package/dist/vehiclesigned.d.mts

@@ -1,13 +1,22 @@
 import Commands from "./commands.mjs";
+import { FleetTelemetryConfig } from "./types/commands.mjs";
 import { RoutableMessage } from "@teslemetry/tesla-protocol/command/universal_message";
-import { VehicleStatus } from "@teslemetry/tesla-protocol/command/vcsec";
 /**
  * The Fleet API `/signed_command` transport: fills `Commands`'s abstract
  * `_send` seam by base64-encoding the signed `RoutableMessage`, POSTing it to
- * the cloud `signed_command` endpoint, and decoding the reply. A future BLE
- * transport (Story 3) fills the same seam over a GATT link instead - nothing
- * else in `Commands` needs to change for that to work.
+ * the cloud `signed_command` endpoint, and decoding the reply. Replies here are
+ * singular and delivered whole, with no broadcast side channel, so `_send`
+ * has no use for `requires` or its options.
  */
 export default class VehicleSigned extends Commands {
-  protected _send(msg: RoutableMessage, _requires: string, _expectsData?: boolean, _confirmBroadcast?: (status: VehicleStatus) => boolean): Promise<RoutableMessage>;
+  readonly _transport_name: string;
+  /**
+   * Configures fleet telemetry via `fleet_telemetry_config_jws`, signing
+   * `config` as a Tesla.SS256 JWS with this vehicle's command key, as Tesla's
+   * vehicle-command proxy does. Any `iss` or `aud` in `config` is overwritten.
+   * @param config The config for this vehicle, or `{ vins, config }` as in Python.
+   * @throws SigningDisabled when this vehicle has no key.
+   */
+  fleet_telemetry_config_create(config: FleetTelemetryConfig | FleetTelemetryConfig["config"]): Promise<Record<string, any>>;
+  protected _send(msg: RoutableMessage): Promise<RoutableMessage>;
 }

package/dist/vehiclesigned.mjs

@@ -4,16 +4,31 @@ import { RoutableMessage } from "@teslemetry/tesla-protocol/command/universal_me
 /**
 * The Fleet API `/signed_command` transport: fills `Commands`'s abstract
 * `_send` seam by base64-encoding the signed `RoutableMessage`, POSTing it to
-* the cloud `signed_command` endpoint, and decoding the reply. A future BLE
-* transport (Story 3) fills the same seam over a GATT link instead - nothing
-* else in `Commands` needs to change for that to work.
+* the cloud `signed_command` endpoint, and decoding the reply. Replies here are
+* singular and delivered whole, with no broadcast side channel, so `_send`
+* has no use for `requires` or its options.
 */
 var VehicleSigned = class extends Commands {
-	async _send(msg, _requires, _expectsData, _confirmBroadcast) {
+	_transport_name = "fleet";
+	/**
+	* Configures fleet telemetry via `fleet_telemetry_config_jws`, signing
+	* `config` as a Tesla.SS256 JWS with this vehicle's command key, as Tesla's
+	* vehicle-command proxy does. Any `iss` or `aud` in `config` is overwritten.
+	* @param config The config for this vehicle, or `{ vins, config }` as in Python.
+	* @throws SigningDisabled when this vehicle has no key.
+	*/
+	async fleet_telemetry_config_create(config) {
+		const { vins, config: claims } = "vins" in config ? config : {
+			vins: [this.vin],
+			config
+		};
+		return this.fleet_telemetry_config_jws(vins, this.signFleetTelemetryConfig(claims));
+	}
+	async _send(msg) {
 		const encoded = Buffer.from(RoutableMessage.encode(msg).finish()).toString("base64");
 		const json = await this.parent.signed_command(this.vin, encoded);
 		const resp = RoutableMessage.decode(Buffer.from(json.response, "base64"));
-		this.validateAndUpdateSession(resp, Buffer.from(msg.uuid));
+		this.validate_msg(resp, Buffer.from(msg.uuid), msg.toDestination?.domain);
 		return resp;
 	}
 };