homebridge-tsvesync 1.1.2 → 1.3.3

package/dist/utils/session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../src/utils/session-store.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homebridge-tsvesync",
-  "version": "1.1.2",
+  "version": "1.3.3",
   "description": "Homebridge plugin for VeSync devices including Levoit air purifiers, humidifiers, and Etekcity smart outlets",
   "main": "dist/index.js",
   "scripts": {
@@ -98,7 +98,7 @@
     "axios": "^1.6.5",
     "dotenv": "^16.3.1",
     "js-yaml": "^4.1.0",
-    "tsvesync": "1.1.2"
+    "tsvesync": "1.3.3"
   },
   "devDependencies": {
     "@types/jest": "^29.5.11",

package/src/accessories/air-purifier.accessory.ts

@@ -291,13 +291,20 @@ export class AirPurifierAccessory extends BaseAccessory {
     return 3;
   }
 
+  private isCore200S(): boolean {
+    return (this.device.deviceType || '').toUpperCase().includes('CORE200S');
+  }
+
   /**
    * Calculate the appropriate step size for discrete speed levels
    */
   private calculateRotationSpeedStep(): number {
-    // Expose Sleep as the first notch when supported: 0,25,50,75,100
+    // Expose Sleep as the first notch when supported.
+    // Core 200S uses 3 manual speeds (25% step). 4-speed models use 20% step.
     if (this.hasFeature('sleep_mode')) {
-      return 25;
+      if (this.isCore200S()) return 25;
+      const max = this.getMaxFanSpeed();
+      return max >= 4 ? 20 : 25;
     }
     const maxSpeed = this.getMaxFanSpeed();
     if (maxSpeed === 3) return 33.33;
@@ -309,12 +316,14 @@ export class AirPurifierAccessory extends BaseAccessory {
    * Convert device speed to percentage
    */
   private speedToPercentage(speed: number): number {
-    // Sleep as first notch: show manual 1→50, 2→75, 3+→100
+    // Sleep as first notch: map manual speeds to notches based on model
     if (this.hasFeature('sleep_mode')) {
       if (typeof speed !== 'number' || speed <= 0) return 0;
-      if (speed === 1) return 50;
-      if (speed === 2) return 75;
-      return 100;
+      const step = this.calculateRotationSpeedStep();
+      const max = this.isCore200S() ? 3 : this.getMaxFanSpeed();
+      // Manual speeds occupy notches 2..(max+1)
+      const notch = Math.max(2, Math.min(max + 1, speed + 1));
+      return Math.min(100, notch * step);
     }
 
     const maxSpeed = this.getMaxFanSpeed();
@@ -377,13 +386,15 @@ export class AirPurifierAccessory extends BaseAccessory {
    * Convert percentage to device speed
    */
   private percentageToSpeed(percentage: number): number {
-    // Sleep as first notch: round to nearest 25% and map 50/75/100 → 1/2/3
+    // Sleep as first notch: round to nearest step and map notches → speeds
     if (this.hasFeature('sleep_mode')) {
       if (typeof percentage !== 'number') return 1;
-      const notch = Math.max(0, Math.min(4, Math.round(Math.min(100, Math.max(0, percentage)) / 25)));
-      if (notch <= 2) return 1; // 50%
-      if (notch === 3) return 2; // 75%
-      return 3; // 100%
+      const step = this.calculateRotationSpeedStep();
+      const max = this.isCore200S() ? 3 : this.getMaxFanSpeed();
+      const maxNotch = max + 1; // include Sleep notch
+      const notch = Math.max(0, Math.min(maxNotch, Math.round(Math.min(100, Math.max(0, percentage)) / step)));
+      const manualNotch = Math.max(2, notch);
+      return Math.min(max, manualNotch - 1);
     }
 
     const maxSpeed = this.getMaxFanSpeed();
@@ -642,9 +653,10 @@ export class AirPurifierAccessory extends BaseAccessory {
 
     // Update rotation speed
     if (isOn && this.hasFeature('sleep_mode') && isSleep) {
-      this.service.updateCharacteristic(this.platform.Characteristic.RotationSpeed, 25);
+      const step = this.calculateRotationSpeedStep();
+      this.service.updateCharacteristic(this.platform.Characteristic.RotationSpeed, step);
       this.lastSetSpeed = 0;
-      this.lastSetPercentage = 25;
+      this.lastSetPercentage = step;
     } else if (isOn && details.speed !== undefined && details.speed !== null) {
       // Check if we should skip this update
       if (this.skipNextUpdate) {
@@ -756,7 +768,7 @@ export class AirPurifierAccessory extends BaseAccessory {
       
       // For all other devices, including Core300S, normal mode handling
       const mode = targetState === 1 ? 'auto' : 'manual';
-      this.platform.log.debug(`Setting mode to ${mode} for device: ${this.device.deviceName}`);
+      this.platform.log.info(`Changing mode to ${mode} for device: ${this.device.deviceName}`);
       
       let success = false;
       
@@ -795,7 +807,7 @@ export class AirPurifierAccessory extends BaseAccessory {
       // If in sleep mode, surface the first notch
       const extended = this.device as ExtendedVeSyncAirPurifier;
       if (this.hasFeature('sleep_mode') && (extended.mode || '').toLowerCase() === 'sleep') {
-        return 25;
+        return this.calculateRotationSpeedStep();
       }
       return 0;
     }
@@ -866,10 +878,13 @@ export class AirPurifierAccessory extends BaseAccessory {
       
       // When using sleep-as-first-notch, map slider notches robustly by rounding
       if (this.hasFeature('sleep_mode')) {
-        const notch = Math.max(0, Math.min(4, Math.round(percentage / 25)));
+        const max = this.isCore200S() ? 3 : this.getMaxFanSpeed();
+        const step = this.calculateRotationSpeedStep();
+        const maxNotch = max + 1; // include Sleep notch
+        const notch = Math.max(0, Math.min(maxNotch, Math.round(percentage / step)));
         if (notch <= 1) {
           // Sleep
-          this.platform.log.debug(`Setting sleep mode via slider on ${this.device.deviceName} (notch=${notch})`);
+          this.platform.log.info(`Changing mode to sleep for device: ${this.device.deviceName}`);
           let ok = false;
           if (typeof extendedDevice.sleepMode === 'function') {
             ok = await extendedDevice.sleepMode();
@@ -880,19 +895,20 @@ export class AirPurifierAccessory extends BaseAccessory {
             throw new Error('Failed to set sleep mode');
           }
           // Immediate UI feedback
-          this.service.updateCharacteristic(this.platform.Characteristic.RotationSpeed, 25);
+          this.service.updateCharacteristic(this.platform.Characteristic.RotationSpeed, step);
           this.service.updateCharacteristic(this.platform.Characteristic.Active, 1);
           this.service.updateCharacteristic(this.platform.Characteristic.CurrentAirPurifierState, 2);
           this.lastSetSpeed = 0;
-          this.lastSetPercentage = 25;
+          this.lastSetPercentage = step;
           this.skipNextUpdate = true;
           return;
         } else {
-          // Map notches 2/3/4 to speeds 1/2/3
-          const desiredSpeed = Math.min(3, notch - 1);
+          // Map manual notches (2..maxNotch) to speeds 1..max
+          const desiredSpeed = Math.min(max, notch - 1);
           // Ensure manual mode before speed change if necessary
           const modeNow = (extendedDevice.mode || '').toLowerCase();
           if (modeNow === 'auto' || modeNow === 'sleep') {
+            this.platform.log.info(`Changing mode to manual for device: ${this.device.deviceName}`);
             if (typeof extendedDevice.manualMode === 'function') {
               await extendedDevice.manualMode();
             } else if (typeof extendedDevice.setMode === 'function') {
@@ -900,7 +916,7 @@ export class AirPurifierAccessory extends BaseAccessory {
             }
           }
           // Update UI early
-          const uiPct = desiredSpeed === 1 ? 50 : desiredSpeed === 2 ? 75 : 100;
+          const uiPct = Math.min(100, (desiredSpeed + 1) * step);
           this.service.updateCharacteristic(this.platform.Characteristic.RotationSpeed, uiPct);
           this.lastSetSpeed = desiredSpeed;
           this.lastSetPercentage = uiPct;

package/src/platform.ts

@@ -6,6 +6,7 @@ import { BaseAccessory } from './accessories/base.accessory';
 import { PluginLogger } from './utils/logger';
 import { createRateLimitedVeSync } from './utils/api-proxy';
 import { PlatformConfig as TSVESyncPlatformConfig } from './types/device.types';
+import { FileSessionStore, decodeJwtTimestampsLocal } from './utils/session-store';
 
 /**
  * HomebridgePlatform
@@ -24,6 +25,10 @@ export class TSVESyncPlatform implements DynamicPlatformPlugin {
   
   private client!: VeSync;
   private deviceUpdateInterval?: NodeJS.Timeout;
+  private refreshTimer?: NodeJS.Timeout;
+  private refreshInProgress = false;
+  private scheduledExpMs: number | null = null;
+  private refreshRemainingMs: number | null = null;
   private readonly updateInterval!: number;
   private readonly debug!: boolean;
   private lastLoginAttempt: Date = new Date(0);
@@ -32,6 +37,7 @@ export class TSVESyncPlatform implements DynamicPlatformPlugin {
   private initializationResolver!: () => void;
   private isInitialized = false;
   private readonly logger!: PluginLogger;
+  private readonly sessionStore!: FileSessionStore;
   // VeSync JWT tokens are valid for 30 days (verified by decoding the JWT)
   // We'll refresh at 25 days to ensure we never hit expiration
   private readonly TOKEN_EXPIRY = 25 * 24 * 60 * 60 * 1000; // 25 days in milliseconds
@@ -60,6 +66,9 @@ export class TSVESyncPlatform implements DynamicPlatformPlugin {
       return;
     }
 
+    // Prepare session store
+    this.sessionStore = new FileSessionStore(this.api.user.storagePath(), this.logger);
+
     // Initialize VeSync client with all configuration
     this.client = createRateLimitedVeSync(
       config.username,
@@ -73,6 +82,10 @@ export class TSVESyncPlatform implements DynamicPlatformPlugin {
       { 
         countryCode: config.countryCode,
         quotaManagement: config.quotaManagement || { enabled: true } 
+      },
+      {
+        store: this.sessionStore,
+        onTokenChange: (s) => this.onTokenChange(s)
       }
     );
 
@@ -91,6 +104,29 @@ export class TSVESyncPlatform implements DynamicPlatformPlugin {
       this.logger.debug('Executed didFinishLaunching callback');
 
       try {
+        // Try to hydrate session from disk before any login
+        const session = await this.sessionStore.load();
+        if (session) {
+          try {
+            if ((session as any).username && (session as any).username !== this.config.username) {
+              this.logger.info('Found persisted session for a different account; ignoring persisted session.');
+            } else {
+              this.hydrateSessionCompat(session);
+              const ts = decodeJwtTimestampsLocal(session.token);
+              // Use actual token issuance time if available to avoid overextending lifetime
+              this.lastTokenRefresh = ts?.iat ? new Date(ts.iat * 1000) : new Date();
+              const expStr = ts?.exp ? new Date(ts.exp * 1000).toISOString() : 'unknown';
+              this.logger.info(`Reusing persisted VeSync session. Token exp: ${expStr}`);
+              // Schedule a proactive refresh before expiry
+              this.scheduleProactiveRefreshFromToken(session.token);
+            }
+          } catch (e: any) {
+            this.logger.debug(`Failed to hydrate persisted session, will login fresh: ${e?.message || e}`);
+          }
+        } else {
+          this.logger.debug('No persisted VeSync session available; will authenticate.');
+        }
+
         // Initialize platform
         await this.initializePlatform();
         
@@ -116,6 +152,9 @@ export class TSVESyncPlatform implements DynamicPlatformPlugin {
       if (this.deviceUpdateInterval) {
         clearInterval(this.deviceUpdateInterval);
       }
+      if (this.refreshTimer) {
+        clearTimeout(this.refreshTimer);
+      }
     });
   }
 
@@ -146,12 +185,15 @@ export class TSVESyncPlatform implements DynamicPlatformPlugin {
    */
   private async initializePlatform(): Promise<void> {
     try {
-      // Try to login first
-      if (!await this.ensureLogin()) {
-        throw new Error('Failed to login to VeSync API');
+      // If we don't have a token/account yet, perform a login once. Otherwise,
+      // trust the persisted token and let the library re-login only if the API rejects it.
+      if (!(this.client as any).token || !(this.client as any).accountId) {
+        if (!await this.ensureLogin()) {
+          throw new Error('Failed to login to VeSync API');
+        }
       }
 
-      // Get devices from API
+      // Get devices from API (will re-login on 401/419 only)
       await this.client.update();
 
       // Discover devices
@@ -255,6 +297,26 @@ export class TSVESyncPlatform implements DynamicPlatformPlugin {
         // Reset backoff and update token refresh time on successful login
         this.loginBackoffTime = 10000;
         this.lastTokenRefresh = new Date();
+        // Best-effort: persist the fresh session immediately in case callbacks fail
+        try {
+          const token = (this.client as any).token as string | null;
+          const accountId = (this.client as any).accountId as string | null;
+          const region = (this.client as any).region as string | null;
+          const apiBaseUrl = (this.client as any).apiBaseUrl as string | null;
+          if (token && accountId && region && apiBaseUrl) {
+            const ts = decodeJwtTimestampsLocal(token);
+            await this.sessionStore.save({
+              token,
+              accountId,
+              region,
+              apiBaseUrl,
+              issuedAt: ts?.iat ?? null,
+              expiresAt: ts?.exp ?? null,
+              lastValidatedAt: Date.now(),
+              username: this.config.username,
+            } as any);
+          }
+        } catch {/* ignore */}
         isLoggedIn = true;
         return true;
       } catch (error) {
@@ -285,6 +347,141 @@ export class TSVESyncPlatform implements DynamicPlatformPlugin {
     await this.discoverDevices();
   }
 
+  /**
+   * Handle token updates from the library
+   */
+  private onTokenChange(session: { token: string } | undefined) {
+    if (!session?.token) return;
+    this.scheduleProactiveRefreshFromToken(session.token);
+    // Persist with username to ensure correct account reuse
+    try {
+      void this.sessionStore.save({ ...(session as any), username: this.config.username } as any);
+    } catch { /* noop */ }
+  }
+
+  /**
+   * Backward-compatible session hydration when using older tsvesync versions
+   */
+  private hydrateSessionCompat(session: { token: string; accountId: string; countryCode?: string | null; apiBaseUrl?: string; region?: string }) {
+    const client: any = this.client as any;
+    if (typeof client.hydrateSession === 'function') {
+      client.hydrateSession(session);
+      return;
+    }
+    // Fallback: set core fields directly
+    client.token = session.token;
+    client.accountId = session.accountId;
+    client.countryCode = session.countryCode ?? null;
+    if (session.apiBaseUrl) {
+      client.apiBaseUrl = session.apiBaseUrl;
+    }
+    if (session.region) {
+      try { client.region = session.region; } catch { /* ignore */ }
+    }
+    client.enabled = true;
+  }
+
+  /**
+   * Schedule a proactive token refresh before JWT expiry
+   */
+  private scheduleProactiveRefreshFromToken(token: string) {
+    try {
+      const ts = decodeJwtTimestampsLocal(token);
+      if (!ts?.exp) {
+        return; // Cannot schedule without exp
+      }
+      const now = Date.now();
+      const expMs = ts.exp * 1000;
+      const msToExpiry = expMs - now;
+      
+      // If we already have a timer for this exact token expiration, skip
+      if (this.scheduledExpMs === expMs && this.refreshTimer) {
+        return;
+      }
+      if (msToExpiry <= 0) {
+        // Already expired; trigger immediate login in background
+        void this.ensureLogin(true);
+        return;
+      }
+
+      // Schedule policy to prevent thrash and avoid frequent logins:
+      // - If >7d left: refresh 5d before expiry
+      // - If 1–7d left: refresh 12h before expiry
+      // - If 1–24h left: refresh 1h before expiry
+      // - If <1h left: do not proactively refresh; rely on library's 401-triggered re-login
+      const ONE_HOUR = 60 * 60 * 1000;
+      const TWELVE_HOURS = 12 * ONE_HOUR;
+      const FIVE_DAYS = 5 * 24 * ONE_HOUR;
+      const SEVEN_DAYS = 7 * 24 * ONE_HOUR;
+
+      let refreshIn: number;
+      if (msToExpiry > SEVEN_DAYS) {
+        refreshIn = msToExpiry - FIVE_DAYS;
+      } else if (msToExpiry > 24 * ONE_HOUR) {
+        refreshIn = msToExpiry - TWELVE_HOURS;
+      } else if (msToExpiry > ONE_HOUR) {
+        refreshIn = msToExpiry - ONE_HOUR;
+      } else {
+        // Too close to expiry; avoid hammering login — let 401 path handle it
+        this.logger.debug('Token near expiry (<1h). Skipping proactive refresh; relying on auto re-login.');
+        return;
+      }
+
+      // Safety floor: never schedule earlier than 30 minutes from now
+      refreshIn = Math.max(refreshIn, 30 * 60 * 1000);
+
+      if (this.refreshTimer) {
+        clearTimeout(this.refreshTimer);
+      }
+      this.scheduledExpMs = expMs;
+      // Handle Node.js setTimeout max delay (~24.8 days). Chain timers when needed.
+      const MAX_DELAY = 0x7fffffff; // 2,147,483,647 ms
+      if (refreshIn > MAX_DELAY) {
+        this.refreshRemainingMs = refreshIn - MAX_DELAY;
+        this.logger.debug('Proactive refresh scheduled beyond setTimeout max; chaining timers.');
+        this.refreshTimer = setTimeout(() => this.chainRefreshTimer(), MAX_DELAY);
+      } else {
+        this.refreshRemainingMs = 0;
+        this.refreshTimer = setTimeout(async () => {
+          if (this.refreshInProgress) {
+            this.logger.debug('Proactive refresh already in progress; skipping.');
+            return;
+          }
+          this.refreshInProgress = true;
+          this.logger.debug('Proactively refreshing VeSync session before token expiry');
+          try {
+            await this.ensureLogin(true);
+          } finally {
+            this.refreshInProgress = false;
+          }
+        }, refreshIn);
+      }
+
+      const hours = Math.round(refreshIn / (60 * 60 * 1000));
+      this.logger.debug(`Scheduled proactive token refresh in ~${hours}h`);
+    } catch (e) {
+      // Best-effort scheduling; ignore errors
+    }
+  }
+
+  private chainRefreshTimer() {
+    if (!this.refreshRemainingMs || this.refreshRemainingMs <= 0) {
+      // Final hop: trigger refresh now
+      if (this.refreshInProgress) {
+        this.logger.debug('Proactive refresh already in progress; skipping.');
+        return;
+      }
+      this.refreshInProgress = true;
+      this.logger.debug('Proactively refreshing VeSync session before token expiry');
+      void this.ensureLogin(true).finally(() => { this.refreshInProgress = false; });
+      return;
+    }
+    const MAX_DELAY = 0x7fffffff;
+    const hop = Math.min(this.refreshRemainingMs, MAX_DELAY);
+    this.refreshRemainingMs -= hop;
+    this.refreshTimer = setTimeout(() => this.chainRefreshTimer(), hop);
+  }
+
   /**
    * Check if a device should be excluded based on configuration
    */
@@ -342,10 +539,7 @@ export class TSVESyncPlatform implements DynamicPlatformPlugin {
   async discoverDevices() {
     this.logger.debug('Discovering devices');
     try {
-      // Try to login first
-      if (!await this.ensureLogin()) {
-        return;
-      }
+      // Do not force login; rely on library to re-login only if needed
 
       let retryCount = 0;
       let success = false;

package/src/utils/api-proxy.ts

@@ -200,7 +200,7 @@ const createRateLimitedProxy = (target: any, rateLimiter: RateLimiter, deviceId?
       // Methods that bypass all rate limiting and debouncing
       const bypassMethods = [
         // Getters and internal methods
-        'get', 'getService', 'getCharacteristic',
+        'get', 'getService', 'getCharacteristic', 'hydrateSession',
         // State accessors
         'deviceStatus', 'speed', 'brightness', 'colorTemp',
         'mode', 'filterLife', 'airQuality', 'airQualityValue', 'screenStatus',
@@ -258,6 +258,10 @@ export const createRateLimitedVeSync = (
       bufferPercentage?: number;
       priorityMethods?: string[];
     }
+  },
+  session?: {
+    store?: any;
+    onTokenChange?: (s: any) => void;
   }
 ): VeSync => {
   // Use the new options object pattern for VeSync constructor
@@ -267,7 +271,9 @@ export const createRateLimitedVeSync = (
     apiUrl: apiUrl,
     customLogger: customLogger,
     excludeConfig: exclusions,
-    countryCode: config?.countryCode || 'US'  // Default to US
+    countryCode: config?.countryCode || 'US',  // Default to US
+    sessionStore: session?.store,
+    onTokenChange: session?.onTokenChange
   });
   const logger = customLogger || new PluginLogger(console as any, debug || false);
   

package/src/utils/session-store.ts

@@ -0,0 +1,92 @@
+import fs from 'fs';
+import path from 'path';
+import { PluginLogger } from './logger';
+
+export interface PluginSession {
+  token: string;
+  accountId: string;
+  countryCode?: string | null;
+  region: string;
+  apiBaseUrl: string;
+  authFlowUsed?: 'legacy' | 'new';
+  issuedAt?: number | null;
+  expiresAt?: number | null;
+  lastValidatedAt?: number | null;
+  libraryVersion?: string;
+  // Optional: helps ensure session matches configured Homebridge account
+  username?: string;
+}
+
+export class FileSessionStore {
+  private readonly dir: string;
+  private readonly file: string;
+
+  constructor(basePath: string, private readonly logger: PluginLogger) {
+    this.dir = path.join(basePath, 'tsvesync');
+    this.file = path.join(this.dir, 'session.json');
+  }
+
+  async load(): Promise<PluginSession | null> {
+    try {
+      await fs.promises.mkdir(this.dir, { recursive: true });
+      const data = await fs.promises.readFile(this.file, 'utf8');
+      const session = JSON.parse(data) as PluginSession;
+      if (!session || !session.token || !session.accountId) return null;
+      try {
+        const expSec = session.expiresAt && session.expiresAt > 1e11 ? Math.floor(session.expiresAt / 1000) : session.expiresAt;
+        const exp = expSec ? new Date(expSec * 1000).toISOString() : 'unknown';
+        this.logger.debug(`Loaded persisted session from ${this.file} (exp: ${exp})`);
+      } catch {}
+      return session;
+    } catch (e: any) {
+      if (e?.code === 'ENOENT') {
+        this.logger.debug(`No persisted session found at ${this.file}`);
+      } else {
+        this.logger.debug(`Session load error: ${e?.message || e}`);
+      }
+      return null;
+    }
+  }
+
+  async save(session: PluginSession): Promise<void> {
+    try {
+      await fs.promises.mkdir(this.dir, { recursive: true });
+      const tmp = this.file + '.tmp';
+      await fs.promises.writeFile(tmp, JSON.stringify(session), { encoding: 'utf8', mode: 0o600 });
+      await fs.promises.rename(tmp, this.file);
+      try { await fs.promises.chmod(this.file, 0o600); } catch { /* best effort */ }
+      try {
+        const expSec = session.expiresAt && session.expiresAt > 1e11 ? Math.floor(session.expiresAt / 1000) : session.expiresAt;
+        const exp = expSec ? new Date(expSec * 1000).toISOString() : 'unknown';
+        this.logger.debug(`Persisted session to ${this.file} (exp: ${exp})`);
+      } catch {}
+    } catch (e: any) {
+      this.logger.debug(`Session save error: ${e?.message || e}`);
+    }
+  }
+
+  async clear(): Promise<void> {
+    try {
+      await fs.promises.unlink(this.file);
+    } catch (e: any) {
+      if (e?.code !== 'ENOENT') {
+        this.logger.debug(`Session clear error: ${e?.message || e}`);
+      }
+    }
+  }
+}
+
+export function decodeJwtTimestampsLocal(token: string): { iat?: number; exp?: number } | null {
+  try {
+    const parts = token.split('.');
+    if (parts.length !== 3) return null;
+    const payload = JSON.parse(Buffer.from(parts[1].replace(/-/g, '+').replace(/_/g, '/'), 'base64').toString('utf8'));
+    let iat = typeof payload.iat === 'number' ? payload.iat : undefined;
+    let exp = typeof payload.exp === 'number' ? payload.exp : undefined;
+    if (iat && iat > 1e11) iat = Math.floor(iat / 1000);
+    if (exp && exp > 1e11) exp = Math.floor(exp / 1000);
+    return { iat, exp };
+  } catch {
+    return null;
+  }
+}