homebridge-kia 1.0.0

package/README.md

@@ -0,0 +1,108 @@
+# homebridge-kia-connect
+
+Homebridge plugin for Kia Connect vehicles.
+
+This plugin exposes a Kia vehicle to Apple Home through Homebridge, including vehicle status sensors and a small set of remote controls.
+
+## Features
+
+- Vehicle status in HomeKit
+- Door lock / unlock
+- Remote climate start / stop
+- Fuel level
+- 12V battery level
+- Outside temperature
+- Engine running state
+- Door, window, hood, and trunk sensors
+- Tire pressure warning
+- OTP-assisted Kia Connect authentication through the Homebridge UI
+
+## Requirements
+
+- Node.js `20.18.0` or newer
+- Homebridge `1.8.0` or newer
+- A Kia Connect account for a supported US Kia vehicle
+
+## Installation
+
+Install through the Homebridge UI, or with npm:
+
+```bash
+npm install -g homebridge-kia
+```
+
+Then restart Homebridge.
+
+## Configuration
+
+The plugin is a dynamic platform and uses the following settings:
+
+- `username`: Kia Connect email
+- `password`: Kia Connect password
+- `vehicleIndex`: Which vehicle to use if your account has multiple vehicles
+- `pollIntervalMinutes`: Refresh interval, minimum `5`
+- `enableDoorLock`: Show the HomeKit lock service
+- `enableClimateControl`: Show the HomeKit climate switch
+
+Example:
+
+```json
+{
+  "platform": "KiaConnect",
+  "name": "Kia Connect",
+  "username": "you@example.com",
+  "password": "your-password",
+  "vehicleIndex": 0,
+  "pollIntervalMinutes": 30,
+  "enableDoorLock": true,
+  "enableClimateControl": true
+}
+```
+
+## Authentication / OTP
+
+If Kia Connect requires a one-time password:
+
+1. Open the plugin settings in Homebridge.
+2. Enter your Kia Connect email and password if needed.
+3. Click `Login`.
+4. Choose `Email` or `SMS` for the OTP.
+5. Enter the code and verify it.
+6. Restart Homebridge after authentication succeeds.
+
+## HomeKit Services
+
+This plugin creates one accessory for the selected vehicle and can expose:
+
+- `LockMechanism` for door lock control
+- `Switch` for climate control
+- `Battery` for 12V battery level
+- `HumiditySensor` for fuel level
+- `TemperatureSensor` for outside temperature
+- `OccupancySensor` for engine running
+- `ContactSensor` services for doors, windows, hood, and trunk
+- `LeakSensor` for tire pressure warning
+
+## Notes
+
+- This plugin currently targets the US Kia Connect API.
+- Climate control uses a fixed start temperature of `72F`.
+- Polling is periodic and should not be set aggressively.
+
+## Development
+
+```bash
+npm install
+npm run build
+npm run lint
+```
+
+Project layout:
+
+- [src](/Users/jordanfreund/Desktop/homebridge-kia-connect/src)
+- [homebridge-ui](/Users/jordanfreund/Desktop/homebridge-kia-connect/homebridge-ui)
+- [config.schema.json](/Users/jordanfreund/Desktop/homebridge-kia-connect/config.schema.json)
+
+## License
+
+ISC

package/config.schema.json

@@ -0,0 +1,51 @@
+{
+  "pluginAlias": "KiaConnect",
+  "pluginType": "platform",
+  "singular": true,
+  "customUi": true,
+  "customUiPath": "./dist/homebridge-ui",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "title": "Name",
+        "type": "string",
+        "default": "Kia Connect",
+        "required": true
+      },
+      "username": {
+        "title": "Kia Connect Email",
+        "type": "string",
+        "required": true
+      },
+      "password": {
+        "title": "Kia Connect Password",
+        "type": "string",
+        "required": true
+      },
+      "pollIntervalMinutes": {
+        "title": "Poll Interval (minutes)",
+        "type": "integer",
+        "default": 30,
+        "minimum": 5
+      },
+      "enableClimateControl": {
+        "title": "Enable Climate Control",
+        "type": "boolean",
+        "default": true
+      },
+      "enableDoorLock": {
+        "title": "Enable Door Lock",
+        "type": "boolean",
+        "default": true
+      },
+      "vehicleIndex": {
+        "title": "Vehicle Index",
+        "type": "integer",
+        "default": 0,
+        "minimum": 0,
+        "description": "If you have multiple vehicles, specify the index (0 = first vehicle)"
+      }
+    }
+  }
+}

package/dist/homebridge-ui/config.d.ts

@@ -0,0 +1,5 @@
+export type SavedCredentials = {
+    username: string;
+    password: string;
+};
+export declare function readSavedCredentials(homebridgeConfigPath?: string): SavedCredentials | undefined;

package/dist/homebridge-ui/config.js

@@ -0,0 +1,23 @@
+import { readFileSync } from 'node:fs';
+export function readSavedCredentials(homebridgeConfigPath) {
+    if (!homebridgeConfigPath) {
+        return undefined;
+    }
+    try {
+        const config = JSON.parse(readFileSync(homebridgeConfigPath, 'utf-8'));
+        const pluginConfig = config.platforms?.find(platform => (platform.platform === 'KiaConnect'
+            && typeof platform.username === 'string'
+            && typeof platform.password === 'string'));
+        if (!pluginConfig) {
+            return undefined;
+        }
+        return {
+            username: pluginConfig.username,
+            password: pluginConfig.password,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/homebridge-ui/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../homebridge-ui/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAIvC,MAAM,UAAU,oBAAoB,CAAC,oBAA6B;IAChE,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAEpE,CAAC;QAEF,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CACtD,QAAQ,CAAC,QAAQ,KAAK,YAAY;eAC/B,OAAO,QAAQ,CAAC,QAAQ,KAAK,QAAQ;eACrC,OAAO,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CACzC,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,YAAY,CAAC,QAAkB;YACzC,QAAQ,EAAE,YAAY,CAAC,QAAkB;SAC1C,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/homebridge-ui/public/index.html

@@ -0,0 +1,196 @@
+<style>
+  .status-card { margin-bottom: 1rem; }
+  .otp-section { display: none; }
+  .success-section { display: none; }
+  .btn-group { margin-bottom: 0.5rem; }
+  #status-message { font-weight: bold; }
+</style>
+
+  <!-- Status -->
+  <div class="card status-card">
+    <div class="card-body">
+      <h5 class="card-title">Kia Connect Authentication</h5>
+      <div class="form-group">
+        <label for="username">Kia Connect Email</label>
+        <input type="email" id="username" class="form-control" autocomplete="username">
+      </div>
+      <div class="form-group">
+        <label for="password">Kia Connect Password</label>
+        <input type="password" id="password" class="form-control" autocomplete="current-password">
+      </div>
+      <p id="status-message">Checking authentication status...</p>
+      <button id="login-btn" class="btn btn-primary" style="display:none" onclick="doLogin()">Login</button>
+    </div>
+  </div>
+
+  <!-- OTP Section -->
+  <div id="otp-section" class="card otp-section">
+    <div class="card-body">
+      <h5 class="card-title">One-Time Password Required</h5>
+      <p id="otp-info"></p>
+      <div class="btn-group">
+        <button class="btn btn-outline-primary btn-sm" onclick="sendOtp('EMAIL')">Send via Email</button>
+        <button class="btn btn-outline-secondary btn-sm" onclick="sendOtp('SMS')">Send via SMS</button>
+      </div>
+      <div class="input-group mt-3">
+        <input type="text" id="otp-code" class="form-control" placeholder="Enter OTP code" maxlength="6">
+        <button class="btn btn-success" onclick="verifyOtp()">Verify</button>
+      </div>
+      <p id="otp-status" class="mt-2 text-muted"></p>
+    </div>
+  </div>
+
+  <!-- Success -->
+  <div id="success-section" class="card success-section">
+    <div class="card-body">
+      <h5 class="card-title text-success">Authenticated</h5>
+      <p>Kia Connect is authenticated. Your vehicle will be loaded automatically within a few seconds.</p>
+    </div>
+  </div>
+
+  <script>
+    let currentConfig = {};
+    let pluginAlias = 'KiaConnect';
+    let pendingOtpCredentials = null;
+
+    async function loadConfig() {
+      const pluginConfig = await homebridge.getPluginConfig();
+      const schema = await homebridge.getPluginConfigSchema();
+      pluginAlias = schema.pluginAlias || pluginAlias;
+      currentConfig = (pluginConfig && pluginConfig[0]) || {};
+      document.getElementById('username').value = currentConfig.username || '';
+      document.getElementById('password').value = currentConfig.password || '';
+    }
+
+    async function persistCredentials(username, password) {
+      const nextConfig = {
+        platform: currentConfig.platform || pluginAlias,
+        name: currentConfig.name || 'Kia Connect',
+        ...currentConfig,
+        username,
+        password,
+      };
+
+      await homebridge.updatePluginConfig([nextConfig]);
+      await homebridge.savePluginConfig();
+      currentConfig = nextConfig;
+    }
+
+    function setCredentialInputsDisabled(disabled) {
+      document.getElementById('username').disabled = disabled;
+      document.getElementById('password').disabled = disabled;
+    }
+
+    (async function checkStatus() {
+      try {
+        await loadConfig();
+        const res = await homebridge.request('/auth/status');
+        if (res.authenticated) {
+          document.getElementById('status-message').textContent = 'Authenticated';
+          document.getElementById('status-message').className = 'text-success';
+          document.getElementById('success-section').style.display = 'block';
+        } else {
+          document.getElementById('status-message').textContent = 'Not authenticated';
+          document.getElementById('login-btn').style.display = 'inline-block';
+        }
+      } catch (e) {
+        document.getElementById('status-message').textContent = 'Not authenticated';
+        document.getElementById('login-btn').style.display = 'inline-block';
+      }
+    })();
+
+    async function doLogin() {
+      const btn = document.getElementById('login-btn');
+      const username = document.getElementById('username').value.trim();
+      const password = document.getElementById('password').value;
+      if (!username || !password) {
+        homebridge.toast.error('Enter your Kia Connect email and password first.');
+        return;
+      }
+
+      btn.disabled = true;
+      btn.textContent = 'Logging in...';
+
+      try {
+        const res = await homebridge.request('/auth/login', {
+          username,
+          password,
+        });
+        if (res.success) {
+          pendingOtpCredentials = null;
+          await persistCredentials(username, password);
+          document.getElementById('status-message').textContent = 'Authenticated!';
+          document.getElementById('status-message').className = 'text-success';
+          btn.style.display = 'none';
+          document.getElementById('success-section').style.display = 'block';
+          homebridge.toast.success('Login successful!');
+        } else if (res.otpRequired) {
+          pendingOtpCredentials = { username, password };
+          setCredentialInputsDisabled(true);
+          btn.style.display = 'none';
+          document.getElementById('status-message').textContent = 'OTP verification required';
+          document.getElementById('otp-section').style.display = 'block';
+          let info = 'A one-time password is required.';
+          if (res.email) info += ' Email: ' + res.email;
+          if (res.sms) info += ' SMS: ' + res.sms;
+          document.getElementById('otp-info').textContent = info;
+        } else {
+          pendingOtpCredentials = null;
+          setCredentialInputsDisabled(false);
+          homebridge.toast.error('Login failed. Check your credentials.');
+          btn.disabled = false;
+          btn.textContent = 'Login';
+        }
+      } catch (e) {
+        pendingOtpCredentials = null;
+        setCredentialInputsDisabled(false);
+        homebridge.toast.error('Login failed: ' + (e.message || e));
+        btn.disabled = false;
+        btn.textContent = 'Login';
+      }
+    }
+
+    async function sendOtp(method) {
+      const statusEl = document.getElementById('otp-status');
+      statusEl.textContent = 'Sending OTP via ' + method + '...';
+      try {
+        await homebridge.request('/auth/send-otp', { method });
+        statusEl.textContent = 'OTP sent via ' + method + '. Check your ' + (method === 'EMAIL' ? 'email' : 'phone') + '.';
+        statusEl.className = 'mt-2 text-success';
+        homebridge.toast.success('OTP sent!');
+      } catch (e) {
+        statusEl.textContent = 'Failed to send OTP: ' + (e.message || e);
+        statusEl.className = 'mt-2 text-danger';
+      }
+    }
+
+    async function verifyOtp() {
+      const code = document.getElementById('otp-code').value.trim();
+      if (!code) {
+        homebridge.toast.error('Please enter the OTP code');
+        return;
+      }
+
+      const statusEl = document.getElementById('otp-status');
+      statusEl.textContent = 'Verifying...';
+
+      try {
+        const res = await homebridge.request('/auth/verify-otp', { code });
+        if (res.success) {
+          if (pendingOtpCredentials) {
+            await persistCredentials(pendingOtpCredentials.username, pendingOtpCredentials.password);
+          }
+          pendingOtpCredentials = null;
+          document.getElementById('otp-section').style.display = 'none';
+          document.getElementById('success-section').style.display = 'block';
+          document.getElementById('status-message').textContent = 'Authenticated!';
+          document.getElementById('status-message').className = 'text-success';
+          homebridge.toast.success('Authentication successful! Restart Homebridge to load your vehicle.');
+        }
+      } catch (e) {
+        statusEl.textContent = 'Verification failed: ' + (e.message || e);
+        statusEl.className = 'mt-2 text-danger';
+        homebridge.toast.error('OTP verification failed');
+      }
+    }
+  </script>

package/dist/homebridge-ui/server.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/homebridge-ui/server.js

@@ -0,0 +1,126 @@
+import { HomebridgePluginUiServer, RequestError } from '@homebridge/plugin-ui-utils/dist/server.js';
+import { KiaAuthManager } from '../src/kia/auth.js';
+import { KiaApiClient } from '../src/kia/client.js';
+import { AuthenticationError } from '../src/kia/types.js';
+import { readSavedCredentials } from './config.js';
+function createConsoleLogger(prefix) {
+    return {
+        info: (...args) => console.log(`[${prefix}]`, ...args),
+        warn: (...args) => console.warn(`[${prefix}]`, ...args),
+        error: (...args) => console.error(`[${prefix}]`, ...args),
+        debug: (...args) => console.debug(`[${prefix}]`, ...args),
+        log: (...args) => console.log(`[${prefix}]`, ...args),
+        success: (...args) => console.log(`[${prefix}]`, ...args),
+        prefix,
+    };
+}
+class KiaConnectUiServer extends HomebridgePluginUiServer {
+    authManager;
+    apiClient;
+    otpState;
+    pendingCredentials;
+    constructor() {
+        super();
+        this.onRequest('/auth/status', this.handleAuthStatus.bind(this));
+        this.onRequest('/auth/login', this.handleLogin.bind(this));
+        this.onRequest('/auth/send-otp', this.handleSendOtp.bind(this));
+        this.onRequest('/auth/verify-otp', this.handleVerifyOtp.bind(this));
+        this.ready();
+    }
+    getClients() {
+        if (!this.authManager) {
+            const storagePath = this.homebridgeStoragePath ?? '/tmp';
+            const log = createConsoleLogger('KiaConnect');
+            const savedCredentials = readSavedCredentials(this.homebridgeConfigPath);
+            this.authManager = new KiaAuthManager(storagePath, log);
+            const username = this.pendingCredentials?.username ?? savedCredentials?.username ?? '';
+            const password = this.pendingCredentials?.password ?? savedCredentials?.password ?? '';
+            this.apiClient = new KiaApiClient(this.authManager, log, username, password);
+        }
+        return { authManager: this.authManager, apiClient: this.apiClient };
+    }
+    async handleAuthStatus() {
+        const { authManager, apiClient } = this.getClients();
+        authManager.reloadToken();
+        const isValid = authManager.isTokenValid();
+        if (!isValid) {
+            return { authenticated: false };
+        }
+        try {
+            await apiClient.getVehicles();
+            return { authenticated: true };
+        }
+        catch (e) {
+            if (e instanceof AuthenticationError) {
+                authManager.clearToken();
+            }
+            return { authenticated: false };
+        }
+    }
+    async handleLogin(payload) {
+        // Re-create clients with credentials if provided
+        if (payload?.username && payload?.password) {
+            this.authManager = undefined;
+            this.apiClient = undefined;
+            this.pendingCredentials = { username: payload.username, password: payload.password };
+        }
+        const { apiClient } = this.getClients();
+        try {
+            const result = await apiClient.login();
+            if (result.success) {
+                return { success: true };
+            }
+            if (result.otpRequired && result.otpState) {
+                this.otpState = result.otpState;
+                return {
+                    success: false,
+                    otpRequired: true,
+                    email: result.otpState.email,
+                    sms: result.otpState.sms,
+                };
+            }
+            return { success: false };
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : 'Login failed';
+            throw new RequestError(message, { status: 500 });
+        }
+    }
+    async handleSendOtp(payload) {
+        if (!this.otpState) {
+            throw new RequestError('No OTP session in progress. Login first.', { status: 400 });
+        }
+        const { apiClient } = this.getClients();
+        try {
+            await apiClient.sendOtp(this.otpState, payload.method ?? 'EMAIL');
+            return { success: true };
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : 'Failed to send OTP';
+            throw new RequestError(message, { status: 500 });
+        }
+    }
+    async handleVerifyOtp(payload) {
+        if (!this.otpState) {
+            throw new RequestError('No OTP session in progress. Login first.', { status: 400 });
+        }
+        const { apiClient } = this.getClients();
+        try {
+            const success = await apiClient.verifyOtp(this.otpState, payload.code);
+            if (success) {
+                this.otpState = undefined;
+                return { success: true };
+            }
+            throw new RequestError('OTP verification failed', { status: 400 });
+        }
+        catch (e) {
+            if (e instanceof RequestError) {
+                throw e;
+            }
+            const message = e instanceof Error ? e.message : 'OTP verification failed';
+            throw new RequestError(message, { status: 500 });
+        }
+    }
+}
+(() => new KiaConnectUiServer())();
+//# sourceMappingURL=server.js.map

package/dist/homebridge-ui/server.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+import type { API } from 'homebridge';
+declare const _default: (api: API) => void;
+export default _default;

package/dist/src/index.js

@@ -0,0 +1,6 @@
+import { KiaConnectPlatform } from './platform.js';
+import { PLATFORM_NAME } from './settings.js';
+export default (api) => {
+    api.registerPlatform(PLATFORM_NAME, KiaConnectPlatform);
+};
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,eAAe,CAAC,GAAQ,EAAE,EAAE;IAC1B,GAAG,CAAC,gBAAgB,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;AAC1D,CAAC,CAAC"}

package/dist/src/kia/auth.d.ts

@@ -0,0 +1,21 @@
+import type { Logger } from 'homebridge';
+import type { PersistedToken } from './types.js';
+export declare class KiaAuthManager {
+    private readonly storagePath;
+    private readonly log;
+    private readonly tokenPath;
+    private token;
+    private cachedDeviceId;
+    constructor(storagePath: string, log: Logger);
+    loadToken(): PersistedToken | null;
+    saveToken(token: PersistedToken): void;
+    isTokenValid(): boolean;
+    getAccessToken(): string | null;
+    getRefreshToken(): string | null;
+    getDeviceId(): string;
+    getVehicleKey(): string | null;
+    reloadToken(): void;
+    updateToken(accessToken: string, refreshToken: string, deviceId?: string): void;
+    setVehicleKey(vehicleKey: string): void;
+    clearToken(): void;
+}

package/dist/src/kia/auth.js

@@ -0,0 +1,106 @@
+import { readFileSync, writeFileSync, renameSync, existsSync, mkdirSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { generateDeviceId } from './crypto.js';
+import { SESSION_LIFETIME_MS } from '../settings.js';
+export class KiaAuthManager {
+    storagePath;
+    log;
+    tokenPath;
+    token = null;
+    cachedDeviceId = null;
+    constructor(storagePath, log) {
+        this.storagePath = storagePath;
+        this.log = log;
+        this.tokenPath = join(storagePath, 'kia-connect-token.json');
+        this.token = this.loadToken();
+    }
+    loadToken() {
+        try {
+            if (!existsSync(this.tokenPath)) {
+                return null;
+            }
+            const data = readFileSync(this.tokenPath, 'utf-8');
+            const parsed = JSON.parse(data);
+            if (parsed.accessToken && parsed.refreshToken && parsed.deviceId) {
+                this.log.debug('Loaded persisted token');
+                return parsed;
+            }
+            return null;
+        }
+        catch (e) {
+            this.log.warn('Could not load persisted token:', e);
+            return null;
+        }
+    }
+    saveToken(token) {
+        try {
+            if (!existsSync(this.storagePath)) {
+                mkdirSync(this.storagePath, { recursive: true });
+            }
+            const tmpPath = this.tokenPath + '.tmp';
+            writeFileSync(tmpPath, JSON.stringify(token, null, 2), 'utf-8');
+            renameSync(tmpPath, this.tokenPath);
+            this.token = token;
+            this.log.debug('Token persisted to disk');
+        }
+        catch (e) {
+            this.log.error('Failed to save token:', e);
+        }
+    }
+    isTokenValid() {
+        return this.token !== null && Date.now() < this.token.validUntil;
+    }
+    getAccessToken() {
+        return this.token?.accessToken ?? null;
+    }
+    getRefreshToken() {
+        return this.token?.refreshToken ?? null;
+    }
+    getDeviceId() {
+        if (this.token?.deviceId) {
+            return this.token.deviceId;
+        }
+        // Cache in memory so all requests in a session use the same device ID
+        // (critical for OTP flow where multiple requests must share identity)
+        if (this.cachedDeviceId) {
+            return this.cachedDeviceId;
+        }
+        this.cachedDeviceId = generateDeviceId();
+        this.log.debug('Generated new device ID:', this.cachedDeviceId);
+        return this.cachedDeviceId;
+    }
+    getVehicleKey() {
+        return this.token?.vehicleKey ?? null;
+    }
+    reloadToken() {
+        this.token = this.loadToken();
+    }
+    updateToken(accessToken, refreshToken, deviceId) {
+        const token = {
+            accessToken,
+            refreshToken,
+            deviceId: deviceId ?? this.getDeviceId(),
+            vehicleKey: this.token?.vehicleKey,
+            validUntil: Date.now() + SESSION_LIFETIME_MS,
+        };
+        this.saveToken(token);
+    }
+    setVehicleKey(vehicleKey) {
+        if (this.token) {
+            this.token.vehicleKey = vehicleKey;
+            this.saveToken(this.token);
+        }
+    }
+    clearToken() {
+        this.token = null;
+        try {
+            if (existsSync(this.tokenPath)) {
+                unlinkSync(this.tokenPath);
+            }
+        }
+        catch (e) {
+            this.log.warn('Failed to clear token file:', e);
+        }
+    }
+}
+//# sourceMappingURL=auth.js.map