@teslemetry/api 0.6.9 → 0.6.10

package/README.md

@@ -101,9 +101,8 @@ vehicle.sse.onSignal("PackCurrent", (val) => console.log("Current:", val));
 vehicle.sse.onSignal("ChargerVoltage", (val) => console.log("Voltage:", val));
 
 // Monitor connection status
-teslemetry.sse.onConnection((isConnected) => {
-  console.log(isConnected ? "Stream Connected" : "Stream Disconnected");
-});
+teslemetry.sse.on("connect", () => console.log("Stream Connected"));
+teslemetry.sse.on("disconnect", () => console.log("Stream Disconnected"));
 
 // Start streaming (connects to the shared Teslemetry stream)
 await teslemetry.sse.connect();

package/dist/index.cjs

@@ -2989,12 +2989,23 @@ const getSseByVin_ = (options) => (options.client ?? client).sse.get({
 
 //#endregion
 //#region src/TeslemetryVehicleStream.ts
+/** Simple deferred promise pattern */
+var Deferred = class {
+	promise;
+	resolve;
+	reject;
+	constructor() {
+		this.promise = new Promise((resolve, reject) => {
+			this.resolve = resolve;
+			this.reject = reject;
+		});
+	}
+};
 var TeslemetryVehicleStream = class extends events.EventEmitter {
 	root;
 	vin;
 	fields = {};
-	_pendingFields = {};
-	_debounceTimeout = null;
+	_fieldUpdateBatch = null;
 	logger;
 	data;
 	constructor(root, vin) {
@@ -3025,25 +3036,45 @@ var TeslemetryVehicleStream = class extends events.EventEmitter {
 			return;
 		} else throw new Error(`Failed to get config: ${response.statusText}`);
 	}
-	/** Safely add field configuration to the vehicle */
-	async updateFields(fields) {
-		this._pendingFields = {
-			...this._pendingFields,
+	/** Safely add field configuration to the vehicle
+	* Returns a promise that resolves when the debounced update completes.
+	* Multiple calls within the debounce window share the same promise.
+	*/
+	updateFields(fields) {
+		if (!this._fieldUpdateBatch) this._fieldUpdateBatch = {
+			fields: {},
+			deferred: new Deferred(),
+			timeout: null
+		};
+		this._fieldUpdateBatch.fields = {
+			...this._fieldUpdateBatch.fields,
 			...fields
 		};
-		if (this._debounceTimeout) clearTimeout(this._debounceTimeout);
-		this._debounceTimeout = setTimeout(async () => {
-			const data = await this.patchConfig(this._pendingFields);
+		clearTimeout(this._fieldUpdateBatch.timeout);
+		this._fieldUpdateBatch.timeout = setTimeout(() => this._flushFieldUpdate(), 1e3);
+		return this._fieldUpdateBatch.deferred.promise;
+	}
+	/** Flush pending field updates to the API */
+	async _flushFieldUpdate() {
+		const batch = this._fieldUpdateBatch;
+		this._fieldUpdateBatch = null;
+		try {
+			const data = await this.patchConfig(batch.fields);
 			if (data?.updated_vehicles) {
-				this.logger.info(`Updated ${Object.keys(this._pendingFields).length} streaming fields for ${this.vin}`);
+				this.logger.info(`Updated ${Object.keys(batch.fields).length} streaming fields for ${this.vin}`);
 				this.fields = {
 					...this.fields,
-					...this._pendingFields
+					...batch.fields
 				};
-				this._pendingFields = {};
-			} else this.logger.error(`Error updating streaming config for ${this.vin}`, data);
-			this._debounceTimeout = null;
-		}, 1e3);
+				batch.deferred.resolve();
+			} else {
+				const error = /* @__PURE__ */ new Error(`Error updating streaming config for ${this.vin}`);
+				this.logger.error(error.message, data);
+				batch.deferred.reject(error);
+			}
+		} catch (error) {
+			batch.deferred.reject(error);
+		}
 	}
 	/** Modify the field configuration of the vehicle */
 	async patchConfig(fields) {
@@ -3067,15 +3098,15 @@ var TeslemetryVehicleStream = class extends events.EventEmitter {
 	* Add a field to the vehicles streaming configuration
 	* @param field Vehicle Signal
 	* @param interval
-	* @returns
+	* @returns Promise that resolves when the field is added
 	*/
-	async addField(field, interval) {
+	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;
+			return Promise.resolve();
 		}
 		const value = interval !== void 0 ? { interval_seconds: interval } : null;
-		this.updateFields({ [field]: value });
+		return this.updateFields({ [field]: value });
 	}
 	/**
 	* Helper to enable and listen for specific field signals
@@ -3084,8 +3115,8 @@ var TeslemetryVehicleStream = class extends events.EventEmitter {
 	* @returns Off function to stop the listener
 	*/
 	onSignal(field, callback) {
-		this.addField(field).catch((error) => {
-			this.logger.error(`Failed to add field ${field}:`, error);
+		this.addField(field).catch(() => {
+			this.logger.error(`Failed to add field ${field}`);
 		});
 		const data = this.root.sse.cache?.[this.vin]?.data?.[field];
 		if (data !== void 0) callback(data);
@@ -3228,6 +3259,7 @@ var TeslemetryStream = class extends events.EventEmitter {
 		else if ("credits" in event) this.emit("credits", event);
 		else if ("vehicle_data" in event) this.emit("vehicle_data", event);
 		else if ("config" in event) this.emit("config", event);
+		this.emit("all", event);
 		const vehicle = this.vehicles.get(event.vin);
 		if (vehicle) {
 			if ("state" in event) vehicle.emit("state", event);
@@ -5220,7 +5252,7 @@ const consoleLogger = {
 
 //#endregion
 //#region package.json
-var version = "0.6.9";
+var version = "0.6.10";
 
 //#endregion
 //#region src/Teslemetry.ts

package/dist/index.d.cts

@@ -14188,6 +14188,7 @@ interface TeslemetryStreamOptions {
   };
 }
 type TeslemetryStreamEventMap$1 = {
+  all: SseEvent;
   state: SseState;
   data: SseData;
   errors: SseErrors;
@@ -14267,16 +14268,20 @@ declare class TeslemetryVehicleStream extends EventEmitter {
   private root;
   vin: string;
   fields: FieldsRequest;
-  private _pendingFields;
-  private _debounceTimeout;
+  private _fieldUpdateBatch;
   logger: Logger;
   data: TeslemetryVehicleStreamData;
   constructor(root: Teslemetry, vin: string);
   get cache(): VehicleCache;
   /** Get the current configuration for the vehicle */
   getConfig(): Promise<void>;
-  /** Safely add field configuration to the vehicle */
+  /** Safely add field configuration to the vehicle
+   * 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>;
+  /** Flush pending field updates to the API */
+  private _flushFieldUpdate;
   /** Modify the field configuration of the vehicle */
   patchConfig(fields: FieldsRequest): Promise<{
     updated_vehicles?: number;
@@ -14293,7 +14298,7 @@ declare class TeslemetryVehicleStream extends EventEmitter {
    * Add a field to the vehicles streaming configuration
    * @param field Vehicle Signal
    * @param interval
-   * @returns
+   * @returns Promise that resolves when the field is added
    */
   addField(field: Signals, interval?: number): Promise<void>;
   /**

package/dist/index.d.mts

@@ -14188,6 +14188,7 @@ interface TeslemetryStreamOptions {
   };
 }
 type TeslemetryStreamEventMap$1 = {
+  all: SseEvent;
   state: SseState;
   data: SseData;
   errors: SseErrors;
@@ -14267,16 +14268,20 @@ declare class TeslemetryVehicleStream extends EventEmitter {
   private root;
   vin: string;
   fields: FieldsRequest;
-  private _pendingFields;
-  private _debounceTimeout;
+  private _fieldUpdateBatch;
   logger: Logger;
   data: TeslemetryVehicleStreamData;
   constructor(root: Teslemetry, vin: string);
   get cache(): VehicleCache;
   /** Get the current configuration for the vehicle */
   getConfig(): Promise<void>;
-  /** Safely add field configuration to the vehicle */
+  /** Safely add field configuration to the vehicle
+   * 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>;
+  /** Flush pending field updates to the API */
+  private _flushFieldUpdate;
   /** Modify the field configuration of the vehicle */
   patchConfig(fields: FieldsRequest): Promise<{
     updated_vehicles?: number;
@@ -14293,7 +14298,7 @@ declare class TeslemetryVehicleStream extends EventEmitter {
    * Add a field to the vehicles streaming configuration
    * @param field Vehicle Signal
    * @param interval
-   * @returns
+   * @returns Promise that resolves when the field is added
    */
   addField(field: Signals, interval?: number): Promise<void>;
   /**

package/dist/index.mjs

@@ -2989,12 +2989,23 @@ const getSseByVin_ = (options) => (options.client ?? client).sse.get({
 
 //#endregion
 //#region src/TeslemetryVehicleStream.ts
+/** Simple deferred promise pattern */
+var Deferred = class {
+	promise;
+	resolve;
+	reject;
+	constructor() {
+		this.promise = new Promise((resolve, reject) => {
+			this.resolve = resolve;
+			this.reject = reject;
+		});
+	}
+};
 var TeslemetryVehicleStream = class extends EventEmitter {
 	root;
 	vin;
 	fields = {};
-	_pendingFields = {};
-	_debounceTimeout = null;
+	_fieldUpdateBatch = null;
 	logger;
 	data;
 	constructor(root, vin) {
@@ -3025,25 +3036,45 @@ var TeslemetryVehicleStream = class extends EventEmitter {
 			return;
 		} else throw new Error(`Failed to get config: ${response.statusText}`);
 	}
-	/** Safely add field configuration to the vehicle */
-	async updateFields(fields) {
-		this._pendingFields = {
-			...this._pendingFields,
+	/** Safely add field configuration to the vehicle
+	* Returns a promise that resolves when the debounced update completes.
+	* Multiple calls within the debounce window share the same promise.
+	*/
+	updateFields(fields) {
+		if (!this._fieldUpdateBatch) this._fieldUpdateBatch = {
+			fields: {},
+			deferred: new Deferred(),
+			timeout: null
+		};
+		this._fieldUpdateBatch.fields = {
+			...this._fieldUpdateBatch.fields,
 			...fields
 		};
-		if (this._debounceTimeout) clearTimeout(this._debounceTimeout);
-		this._debounceTimeout = setTimeout(async () => {
-			const data = await this.patchConfig(this._pendingFields);
+		clearTimeout(this._fieldUpdateBatch.timeout);
+		this._fieldUpdateBatch.timeout = setTimeout(() => this._flushFieldUpdate(), 1e3);
+		return this._fieldUpdateBatch.deferred.promise;
+	}
+	/** Flush pending field updates to the API */
+	async _flushFieldUpdate() {
+		const batch = this._fieldUpdateBatch;
+		this._fieldUpdateBatch = null;
+		try {
+			const data = await this.patchConfig(batch.fields);
 			if (data?.updated_vehicles) {
-				this.logger.info(`Updated ${Object.keys(this._pendingFields).length} streaming fields for ${this.vin}`);
+				this.logger.info(`Updated ${Object.keys(batch.fields).length} streaming fields for ${this.vin}`);
 				this.fields = {
 					...this.fields,
-					...this._pendingFields
+					...batch.fields
 				};
-				this._pendingFields = {};
-			} else this.logger.error(`Error updating streaming config for ${this.vin}`, data);
-			this._debounceTimeout = null;
-		}, 1e3);
+				batch.deferred.resolve();
+			} else {
+				const error = /* @__PURE__ */ new Error(`Error updating streaming config for ${this.vin}`);
+				this.logger.error(error.message, data);
+				batch.deferred.reject(error);
+			}
+		} catch (error) {
+			batch.deferred.reject(error);
+		}
 	}
 	/** Modify the field configuration of the vehicle */
 	async patchConfig(fields) {
@@ -3067,15 +3098,15 @@ var TeslemetryVehicleStream = class extends EventEmitter {
 	* Add a field to the vehicles streaming configuration
 	* @param field Vehicle Signal
 	* @param interval
-	* @returns
+	* @returns Promise that resolves when the field is added
 	*/
-	async addField(field, interval) {
+	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;
+			return Promise.resolve();
 		}
 		const value = interval !== void 0 ? { interval_seconds: interval } : null;
-		this.updateFields({ [field]: value });
+		return this.updateFields({ [field]: value });
 	}
 	/**
 	* Helper to enable and listen for specific field signals
@@ -3084,8 +3115,8 @@ var TeslemetryVehicleStream = class extends EventEmitter {
 	* @returns Off function to stop the listener
 	*/
 	onSignal(field, callback) {
-		this.addField(field).catch((error) => {
-			this.logger.error(`Failed to add field ${field}:`, error);
+		this.addField(field).catch(() => {
+			this.logger.error(`Failed to add field ${field}`);
 		});
 		const data = this.root.sse.cache?.[this.vin]?.data?.[field];
 		if (data !== void 0) callback(data);
@@ -3228,6 +3259,7 @@ var TeslemetryStream = class extends EventEmitter {
 		else if ("credits" in event) this.emit("credits", event);
 		else if ("vehicle_data" in event) this.emit("vehicle_data", event);
 		else if ("config" in event) this.emit("config", event);
+		this.emit("all", event);
 		const vehicle = this.vehicles.get(event.vin);
 		if (vehicle) {
 			if ("state" in event) vehicle.emit("state", event);
@@ -5220,7 +5252,7 @@ const consoleLogger = {
 
 //#endregion
 //#region package.json
-var version = "0.6.9";
+var version = "0.6.10";
 
 //#endregion
 //#region src/Teslemetry.ts

package/package.json

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