@teslemetry/api 0.5.0 → 0.5.1

package/dist/index.cjs

@@ -3009,6 +3009,10 @@ var TeslemetryVehicleStream = class extends events.EventEmitter {
 			this.fields = event.config.fields;
 		});
 	}
+	on(event, listener) {
+		this.root.sse.sendCache(this.vin, event, listener);
+		return super.on(event, listener);
+	}
 	/** Get the current configuration for the vehicle */
 	async getConfig() {
 		const { data, response } = await getApiConfigByVin({ path: { vin: this.vin } });
@@ -3080,6 +3084,8 @@ var TeslemetryVehicleStream = class extends events.EventEmitter {
 		this.addField(field).catch((error) => {
 			this.logger.error(`Failed to add field ${field}:`, error);
 		});
+		const data = this.root.sse.cache?.[this.vin]?.data?.[field];
+		if (data !== void 0) callback(data);
 		this.data.on(field, callback);
 		return () => this.data.off(field, callback);
 	}
@@ -3096,16 +3102,69 @@ var TeslemetryStream = class extends events.EventEmitter {
 	active = false;
 	connected = false;
 	vin;
-	cache;
+	cache = {};
+	cloudCache;
+	localCache;
 	logger;
 	vehicles = /* @__PURE__ */ new Map();
 	constructor(root, options) {
 		super();
 		this.root = root;
 		this.vin = options?.vin;
-		this.cache = options?.cache;
+		if (typeof options?.cache === "boolean") {
+			this.cloudCache = options.cache;
+			this.localCache = options.cache;
+		} else {
+			this.cloudCache = options?.cache?.cloud;
+			this.localCache = options?.cache?.local;
+		}
 		this.logger = root.logger;
 		if (this.vin) this.getVehicle(this.vin);
+		if (this.localCache) this.startLocalCache();
+	}
+	sendCache(vin, event, listener) {
+		if (this.cache) {
+			const vehicleCache = this.cache[vin];
+			if (event === "connectivity" && vehicleCache.connectivity) for (const networkInterface in vehicleCache.connectivity) {
+				const typedNetworkInterface = networkInterface;
+				const status = vehicleCache.connectivity[typedNetworkInterface];
+				if (status !== void 0) listener({
+					createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+					vin,
+					networkInterface: typedNetworkInterface,
+					status,
+					isCache: true
+				});
+			}
+			else if (event === "state" && vehicleCache.state) listener({
+				createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+				vin,
+				state: vehicleCache.state,
+				isCache: true
+			});
+			else if (event === "data" && vehicleCache.data) listener({
+				createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+				vin,
+				data: vehicleCache.data,
+				isCache: true
+			});
+			else if (event === "errors" && vehicleCache.errors) listener({
+				createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+				vin,
+				errors: vehicleCache.errors,
+				isCache: true
+			});
+			else if (event === "alerts" && vehicleCache.alerts) listener({
+				createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+				vin,
+				alerts: vehicleCache.alerts,
+				isCache: true
+			});
+		}
+	}
+	on(event, listener) {
+		for (const vin in this.cache) this.sendCache(vin, event, listener);
+		return super.on(event, listener);
 	}
 	getVehicle(vin) {
 		if (!this.vehicles.has(vin)) new TeslemetryVehicleStream(this.root, vin);
@@ -3122,7 +3181,7 @@ var TeslemetryStream = class extends events.EventEmitter {
 			const sse = await getSseByVin_({
 				client: this.root.client,
 				path: { vin: this.vin || "" },
-				query: { cache: this.cache }
+				query: { cache: this.cloudCache }
 			});
 			this.logger.info(`Connected to stream`);
 			retries = 0;
@@ -3181,6 +3240,48 @@ var TeslemetryStream = class extends events.EventEmitter {
 			else if ("config" in event) vehicle.emit("config", event);
 		}
 	}
+	cacheState(event) {
+		this.cache[event.vin] ??= {};
+		this.cache[event.vin].state = event.state;
+	}
+	cacheData(event) {
+		this.cache[event.vin] ??= { data: {} };
+		this.cache[event.vin].data = {
+			...this.cache[event.vin].data,
+			...event.data
+		};
+	}
+	cacheErrors(event) {
+		this.cache[event.vin] ??= {};
+		this.cache[event.vin].errors = event.errors;
+	}
+	cacheAlerts(event) {
+		this.cache[event.vin] ??= {};
+		this.cache[event.vin].alerts = event.alerts;
+	}
+	cacheConnectivity(event) {
+		this.cache[event.vin] ??= {};
+		this.cache[event.vin].connectivity ??= {};
+		this.cache[event.vin].connectivity[event.networkInterface] = event.status;
+	}
+	startLocalCache() {
+		this.localCache = true;
+		this.on("state", this.cacheState);
+		this.on("data", this.cacheData);
+		this.on("errors", this.cacheErrors);
+		this.on("alerts", this.cacheAlerts);
+		this.on("connectivity", this.cacheConnectivity);
+		this.logger.info(`Started local cache`);
+	}
+	stopLocalCache() {
+		this.localCache = false;
+		this.off("state", this.cacheState);
+		this.off("data", this.cacheData);
+		this.off("errors", this.cacheErrors);
+		this.off("alerts", this.cacheAlerts);
+		this.off("connectivity", this.cacheConnectivity);
+		this.logger.info(`Stopped local cache`);
+	}
 };
 
 //#endregion
@@ -4944,7 +5045,7 @@ const consoleLogger = {
 
 //#endregion
 //#region package.json
-var version = "0.5.0";
+var version = "0.5.1";
 
 //#endregion
 //#region src/Teslemetry.ts

package/dist/index.d.cts

@@ -13909,7 +13909,10 @@ declare class TeslemetryVehicleStream extends EventEmitter {
 //#region src/TeslemetryStream.d.ts
 interface TeslemetryStreamOptions {
   vin?: string;
-  cache?: boolean;
+  cache?: boolean | {
+    cloud: boolean;
+    local: boolean;
+  };
 }
 type TeslemetryStreamEventMap = {
   state: SseState;
@@ -13929,15 +13932,26 @@ declare interface TeslemetryStream {
   off<K$1 extends keyof TeslemetryStreamEventMap>(event: K$1, listener: (data: TeslemetryStreamEventMap[K$1]) => void): this;
   emit<K$1 extends keyof TeslemetryStreamEventMap>(event: K$1, ...args: TeslemetryStreamEventMap[K$1] extends void ? [] : [TeslemetryStreamEventMap[K$1]]): boolean;
 }
+interface VehicleCache {
+  state?: SseState["state"];
+  data?: SseData["data"];
+  alerts?: SseAlerts["alerts"];
+  errors?: SseErrors["errors"];
+  connectivity?: Partial<Record<SseConnectivity["networkInterface"], SseConnectivity["status"]>>;
+}
+type Cache = Record<string, VehicleCache>;
 declare class TeslemetryStream extends EventEmitter {
   private root;
   active: boolean;
   connected: boolean;
   private vin;
-  private cache;
+  cache: Cache;
+  private cloudCache;
+  private localCache;
   logger: Logger;
   vehicles: Map<string, TeslemetryVehicleStream>;
   constructor(root: Teslemetry, options?: TeslemetryStreamOptions);
+  sendCache<K$1 extends keyof TeslemetryStreamEventMap>(vin: string, event: K$1, listener: (data: any) => void): void;
   getVehicle(vin: string): TeslemetryVehicleStream;
   connect(): Promise<void>;
   private _connectLoop;
@@ -13945,6 +13959,13 @@ declare class TeslemetryStream extends EventEmitter {
   close(): void;
   parseCreatedAt(event: SseEvent): Date;
   private _dispatch;
+  private cacheState;
+  private cacheData;
+  private cacheErrors;
+  private cacheAlerts;
+  private cacheConnectivity;
+  startLocalCache(): void;
+  stopLocalCache(): void;
 }
 //#endregion
 //#region src/TeslemetryChargingApi.d.ts

package/dist/index.d.mts

@@ -13909,7 +13909,10 @@ declare class TeslemetryVehicleStream extends EventEmitter {
 //#region src/TeslemetryStream.d.ts
 interface TeslemetryStreamOptions {
   vin?: string;
-  cache?: boolean;
+  cache?: boolean | {
+    cloud: boolean;
+    local: boolean;
+  };
 }
 type TeslemetryStreamEventMap = {
   state: SseState;
@@ -13929,15 +13932,26 @@ declare interface TeslemetryStream {
   off<K$1 extends keyof TeslemetryStreamEventMap>(event: K$1, listener: (data: TeslemetryStreamEventMap[K$1]) => void): this;
   emit<K$1 extends keyof TeslemetryStreamEventMap>(event: K$1, ...args: TeslemetryStreamEventMap[K$1] extends void ? [] : [TeslemetryStreamEventMap[K$1]]): boolean;
 }
+interface VehicleCache {
+  state?: SseState["state"];
+  data?: SseData["data"];
+  alerts?: SseAlerts["alerts"];
+  errors?: SseErrors["errors"];
+  connectivity?: Partial<Record<SseConnectivity["networkInterface"], SseConnectivity["status"]>>;
+}
+type Cache = Record<string, VehicleCache>;
 declare class TeslemetryStream extends EventEmitter {
   private root;
   active: boolean;
   connected: boolean;
   private vin;
-  private cache;
+  cache: Cache;
+  private cloudCache;
+  private localCache;
   logger: Logger;
   vehicles: Map<string, TeslemetryVehicleStream>;
   constructor(root: Teslemetry, options?: TeslemetryStreamOptions);
+  sendCache<K$1 extends keyof TeslemetryStreamEventMap>(vin: string, event: K$1, listener: (data: any) => void): void;
   getVehicle(vin: string): TeslemetryVehicleStream;
   connect(): Promise<void>;
   private _connectLoop;
@@ -13945,6 +13959,13 @@ declare class TeslemetryStream extends EventEmitter {
   close(): void;
   parseCreatedAt(event: SseEvent): Date;
   private _dispatch;
+  private cacheState;
+  private cacheData;
+  private cacheErrors;
+  private cacheAlerts;
+  private cacheConnectivity;
+  startLocalCache(): void;
+  stopLocalCache(): void;
 }
 //#endregion
 //#region src/TeslemetryChargingApi.d.ts

package/dist/index.mjs

@@ -3009,6 +3009,10 @@ var TeslemetryVehicleStream = class extends EventEmitter {
 			this.fields = event.config.fields;
 		});
 	}
+	on(event, listener) {
+		this.root.sse.sendCache(this.vin, event, listener);
+		return super.on(event, listener);
+	}
 	/** Get the current configuration for the vehicle */
 	async getConfig() {
 		const { data, response } = await getApiConfigByVin({ path: { vin: this.vin } });
@@ -3080,6 +3084,8 @@ var TeslemetryVehicleStream = class extends EventEmitter {
 		this.addField(field).catch((error) => {
 			this.logger.error(`Failed to add field ${field}:`, error);
 		});
+		const data = this.root.sse.cache?.[this.vin]?.data?.[field];
+		if (data !== void 0) callback(data);
 		this.data.on(field, callback);
 		return () => this.data.off(field, callback);
 	}
@@ -3096,16 +3102,69 @@ var TeslemetryStream = class extends EventEmitter {
 	active = false;
 	connected = false;
 	vin;
-	cache;
+	cache = {};
+	cloudCache;
+	localCache;
 	logger;
 	vehicles = /* @__PURE__ */ new Map();
 	constructor(root, options) {
 		super();
 		this.root = root;
 		this.vin = options?.vin;
-		this.cache = options?.cache;
+		if (typeof options?.cache === "boolean") {
+			this.cloudCache = options.cache;
+			this.localCache = options.cache;
+		} else {
+			this.cloudCache = options?.cache?.cloud;
+			this.localCache = options?.cache?.local;
+		}
 		this.logger = root.logger;
 		if (this.vin) this.getVehicle(this.vin);
+		if (this.localCache) this.startLocalCache();
+	}
+	sendCache(vin, event, listener) {
+		if (this.cache) {
+			const vehicleCache = this.cache[vin];
+			if (event === "connectivity" && vehicleCache.connectivity) for (const networkInterface in vehicleCache.connectivity) {
+				const typedNetworkInterface = networkInterface;
+				const status = vehicleCache.connectivity[typedNetworkInterface];
+				if (status !== void 0) listener({
+					createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+					vin,
+					networkInterface: typedNetworkInterface,
+					status,
+					isCache: true
+				});
+			}
+			else if (event === "state" && vehicleCache.state) listener({
+				createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+				vin,
+				state: vehicleCache.state,
+				isCache: true
+			});
+			else if (event === "data" && vehicleCache.data) listener({
+				createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+				vin,
+				data: vehicleCache.data,
+				isCache: true
+			});
+			else if (event === "errors" && vehicleCache.errors) listener({
+				createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+				vin,
+				errors: vehicleCache.errors,
+				isCache: true
+			});
+			else if (event === "alerts" && vehicleCache.alerts) listener({
+				createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+				vin,
+				alerts: vehicleCache.alerts,
+				isCache: true
+			});
+		}
+	}
+	on(event, listener) {
+		for (const vin in this.cache) this.sendCache(vin, event, listener);
+		return super.on(event, listener);
 	}
 	getVehicle(vin) {
 		if (!this.vehicles.has(vin)) new TeslemetryVehicleStream(this.root, vin);
@@ -3122,7 +3181,7 @@ var TeslemetryStream = class extends EventEmitter {
 			const sse = await getSseByVin_({
 				client: this.root.client,
 				path: { vin: this.vin || "" },
-				query: { cache: this.cache }
+				query: { cache: this.cloudCache }
 			});
 			this.logger.info(`Connected to stream`);
 			retries = 0;
@@ -3181,6 +3240,48 @@ var TeslemetryStream = class extends EventEmitter {
 			else if ("config" in event) vehicle.emit("config", event);
 		}
 	}
+	cacheState(event) {
+		this.cache[event.vin] ??= {};
+		this.cache[event.vin].state = event.state;
+	}
+	cacheData(event) {
+		this.cache[event.vin] ??= { data: {} };
+		this.cache[event.vin].data = {
+			...this.cache[event.vin].data,
+			...event.data
+		};
+	}
+	cacheErrors(event) {
+		this.cache[event.vin] ??= {};
+		this.cache[event.vin].errors = event.errors;
+	}
+	cacheAlerts(event) {
+		this.cache[event.vin] ??= {};
+		this.cache[event.vin].alerts = event.alerts;
+	}
+	cacheConnectivity(event) {
+		this.cache[event.vin] ??= {};
+		this.cache[event.vin].connectivity ??= {};
+		this.cache[event.vin].connectivity[event.networkInterface] = event.status;
+	}
+	startLocalCache() {
+		this.localCache = true;
+		this.on("state", this.cacheState);
+		this.on("data", this.cacheData);
+		this.on("errors", this.cacheErrors);
+		this.on("alerts", this.cacheAlerts);
+		this.on("connectivity", this.cacheConnectivity);
+		this.logger.info(`Started local cache`);
+	}
+	stopLocalCache() {
+		this.localCache = false;
+		this.off("state", this.cacheState);
+		this.off("data", this.cacheData);
+		this.off("errors", this.cacheErrors);
+		this.off("alerts", this.cacheAlerts);
+		this.off("connectivity", this.cacheConnectivity);
+		this.logger.info(`Stopped local cache`);
+	}
 };
 
 //#endregion
@@ -4944,7 +5045,7 @@ const consoleLogger = {
 
 //#endregion
 //#region package.json
-var version = "0.5.0";
+var version = "0.5.1";
 
 //#endregion
 //#region src/Teslemetry.ts

package/package.json

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