iotas-ts 0.1.0

package/dist/src/api/iotasClient.d.ts

@@ -0,0 +1,27 @@
+import type { IotasLogger } from '../logger.js';
+import type { Feature, IotasClientOptions, Rooms } from '../types.js';
+/**
+ * High-level IOTAS API client.
+ *
+ * Provides unit resolution, room/device discovery, and feature operations.
+ * Delegates authentication to IotasSession and HTTP to IotasTransport.
+ */
+export declare class IotasClient {
+    private readonly log;
+    private readonly unitName?;
+    private readonly transport;
+    private readonly reliableUpdateAttempts;
+    private readonly reliableUpdateDelayMs;
+    private readonly delay;
+    private unitRequest;
+    private featureIndex;
+    private unit;
+    constructor(options: IotasClientOptions);
+    static withCredentials(log: IotasLogger, email: string, password: string, unitName?: string, options?: Pick<IotasClientOptions, 'fetch' | 'delay'>): IotasClient;
+    initialize(): Promise<void>;
+    getRooms(): Promise<Rooms>;
+    getFeature(featureId: string): Promise<Feature | null>;
+    private buildFeatureIndex;
+    updateFeature(featureId: string, value: number): Promise<void>;
+    updateFeatureReliable(featureId: string, value: number): Promise<void>;
+}

package/dist/src/api/iotasClient.js

@@ -0,0 +1,123 @@
+import { IotasSession } from './session.js';
+import { IotasTransport } from './transport.js';
+const DEFAULT_RELIABLE_UPDATE_ATTEMPTS = 3;
+const DEFAULT_RELIABLE_UPDATE_DELAY_MS = 500;
+const defaultDelay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * High-level IOTAS API client.
+ *
+ * Provides unit resolution, room/device discovery, and feature operations.
+ * Delegates authentication to IotasSession and HTTP to IotasTransport.
+ */
+export class IotasClient {
+    log;
+    unitName;
+    transport;
+    reliableUpdateAttempts;
+    reliableUpdateDelayMs;
+    delay;
+    unitRequest = null;
+    featureIndex = null;
+    unit = 0;
+    constructor(options) {
+        this.log = options.log;
+        this.unitName = options.unitName;
+        this.reliableUpdateAttempts = options.reliableUpdate?.attempts ?? DEFAULT_RELIABLE_UPDATE_ATTEMPTS;
+        this.reliableUpdateDelayMs = options.reliableUpdate?.delayMs ?? DEFAULT_RELIABLE_UPDATE_DELAY_MS;
+        this.delay = options.delay ?? defaultDelay;
+        const session = new IotasSession({
+            log: options.log,
+            email: options.email,
+            authenticate: options.authenticate,
+            onTokensChanged: options.onTokensChanged,
+            initialTokens: options.initialTokens,
+            baseUrl: options.baseUrl,
+            authRetryDelaysMs: options.authRetryDelaysMs,
+            fetch: options.fetch,
+            delay: options.delay,
+        });
+        this.transport = new IotasTransport({
+            session,
+            baseUrl: options.baseUrl,
+            maxRequestAuthRetries: options.maxRequestAuthRetries,
+            fetch: options.fetch,
+        });
+    }
+    static withCredentials(log, email, password, unitName, options) {
+        return new IotasClient({
+            log,
+            email,
+            unitName,
+            authenticate: async () => ({ username: email, password }),
+            ...options,
+        });
+    }
+    async initialize() {
+        if (this.unit !== 0) {
+            return;
+        }
+        const account = await this.transport.request('/account/me');
+        this.log.info('Found account id', account.id);
+        const residencies = await this.transport.request(`/account/${account.id}/residency`);
+        if (residencies.length === 0) {
+            this.log.error('Unable to find any units. Abandoning...');
+            throw new Error('Unable to find any units');
+        }
+        this.log.info('Found unit(s):', residencies.map((r) => r.unitName).join(', '));
+        if (this.unitName) {
+            const customUnit = residencies.find((r) => r.unitName === this.unitName);
+            if (customUnit) {
+                this.unit = customUnit.unit;
+                this.log.info('Using custom unit:', this.unitName);
+                return;
+            }
+            this.log.warn('Could not find unit', this.unitName, ', using default');
+        }
+        this.unit = residencies[0].unit;
+        this.log.info('Using first unit found:', residencies[0].unitName, '. If you would like to use a custom unit, please set the "unitName" property in the config.');
+    }
+    async getRooms() {
+        await this.initialize();
+        if (this.unitRequest !== null) {
+            return this.unitRequest;
+        }
+        this.unitRequest = this.transport.request(`/unit/${this.unit}/rooms`);
+        this.unitRequest.finally(() => {
+            this.unitRequest = null;
+        });
+        const rooms = await this.unitRequest;
+        this.buildFeatureIndex(rooms);
+        return rooms;
+    }
+    async getFeature(featureId) {
+        if (!this.featureIndex) {
+            await this.getRooms();
+        }
+        return this.featureIndex?.get(featureId) ?? null;
+    }
+    buildFeatureIndex(rooms) {
+        this.featureIndex = new Map();
+        for (const room of rooms) {
+            for (const device of room.devices) {
+                for (const feature of device.features) {
+                    this.featureIndex.set(feature.id.toString(), feature);
+                }
+            }
+        }
+    }
+    async updateFeature(featureId, value) {
+        await this.transport.request(`/feature/${encodeURIComponent(featureId)}/value`, {
+            method: 'PUT',
+            body: JSON.stringify({ value }),
+        });
+    }
+    async updateFeatureReliable(featureId, value) {
+        for (let attempt = 0; attempt < this.reliableUpdateAttempts; attempt++) {
+            await this.updateFeature(featureId, value);
+            if (attempt < this.reliableUpdateAttempts - 1) {
+                await this.delay(this.reliableUpdateDelayMs);
+            }
+        }
+    }
+}
+//# sourceMappingURL=iotasClient.js.map

package/dist/src/api/iotasClient.js.map

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

package/dist/src/api/jwt.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Check whether a JWT token has expired based on its `exp` claim.
+ *
+ * WARNING: This performs NO signature verification. It must NOT be used
+ * for authentication or authorization decisions.
+ */
+export declare function isTokenExpired(token: string): boolean;

package/dist/src/api/jwt.js

@@ -0,0 +1,13 @@
+/**
+ * Check whether a JWT token has expired based on its `exp` claim.
+ *
+ * WARNING: This performs NO signature verification. It must NOT be used
+ * for authentication or authorization decisions.
+ */
+export function isTokenExpired(token) {
+    const payload = token.split('.')[1];
+    const decoded = JSON.parse(Buffer.from(payload, 'base64url').toString());
+    // Date.now() returns Unix time in milliseconds, while JWT exp is defined in seconds, hence the division by 1000.
+    return decoded.exp < Date.now() / 1000;
+}
+//# sourceMappingURL=jwt.js.map

package/dist/src/api/jwt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.js","sourceRoot":"","sources":["../../../src/api/jwt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAoB,CAAC;IAC5F,iHAAiH;IACjH,OAAO,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AACzC,CAAC"}

package/dist/src/api/session.d.ts

@@ -0,0 +1,43 @@
+import type { IotasLogger } from '../logger.js';
+import type { IotasTokens } from '../types.js';
+export interface IotasSessionOptions {
+    log: IotasLogger;
+    email: string;
+    authenticate: () => Promise<{
+        username: string;
+        password: string;
+    }>;
+    onTokensChanged?: (tokens: IotasTokens) => void;
+    initialTokens?: IotasTokens;
+    baseUrl?: string;
+    authRetryDelaysMs?: number[];
+    /** Injected fetch function for testing. Default: globalThis.fetch */
+    fetch?: typeof fetch;
+    /** Injected delay function for testing. Default: setTimeout-based sleep */
+    delay?: (ms: number) => Promise<void>;
+}
+/**
+ * Manages authentication and token lifecycle for the IOTAS API.
+ *
+ * Handles initial auth, token refresh, JWT expiry checks,
+ * retry with backoff, and request deduplication.
+ */
+export declare class IotasSession {
+    private token;
+    private refreshToken;
+    private authenticateRequest;
+    private readonly log;
+    private readonly email;
+    private readonly authenticateFn;
+    private readonly onTokensChanged?;
+    private readonly baseUrl;
+    private readonly authRetryDelaysMs;
+    private readonly fetch;
+    private readonly delay;
+    constructor(options: IotasSessionOptions);
+    getToken(): Promise<string>;
+    invalidateToken(): void;
+    private authenticate;
+    private authenticateWithRetry;
+    private refreshAccessToken;
+}

package/dist/src/api/session.js

@@ -0,0 +1,137 @@
+import { isTokenExpired } from './jwt.js';
+const DEFAULT_BASE_URL = 'https://api.iotashome.com/api/v1';
+const DEFAULT_AUTH_RETRY_DELAYS_MS = [60_000, 300_000, 600_000];
+const defaultDelay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * Manages authentication and token lifecycle for the IOTAS API.
+ *
+ * Handles initial auth, token refresh, JWT expiry checks,
+ * retry with backoff, and request deduplication.
+ */
+export class IotasSession {
+    token = null;
+    refreshToken = '';
+    authenticateRequest = null;
+    log;
+    email;
+    authenticateFn;
+    onTokensChanged;
+    baseUrl;
+    authRetryDelaysMs;
+    fetch;
+    delay;
+    constructor(options) {
+        this.log = options.log;
+        this.email = options.email;
+        this.authenticateFn = options.authenticate;
+        this.onTokensChanged = options.onTokensChanged;
+        this.baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+        this.authRetryDelaysMs = options.authRetryDelaysMs ?? DEFAULT_AUTH_RETRY_DELAYS_MS;
+        this.fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.delay = options.delay ?? defaultDelay;
+        if (options.initialTokens) {
+            this.token = options.initialTokens.jwt;
+            this.refreshToken = options.initialTokens.refresh;
+        }
+    }
+    async getToken() {
+        if (this.token === null) {
+            return this.authenticate();
+        }
+        try {
+            if (isTokenExpired(this.token)) {
+                return this.refreshAccessToken();
+            }
+            return this.token;
+        }
+        catch {
+            return this.authenticate();
+        }
+    }
+    invalidateToken() {
+        this.token = null;
+    }
+    async authenticate() {
+        if (this.authenticateRequest !== null) {
+            return this.authenticateRequest;
+        }
+        this.authenticateRequest = this.authenticateWithRetry();
+        this.authenticateRequest.finally(() => {
+            this.authenticateRequest = null;
+        });
+        return this.authenticateRequest;
+    }
+    async authenticateWithRetry() {
+        let lastError;
+        const maxRetries = this.authRetryDelaysMs.length;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                const { username, password } = await this.authenticateFn();
+                const credentials = Buffer.from(`${username}:${password}`).toString('base64');
+                const response = await this.fetch(`${this.baseUrl}/auth/tokenwithrefresh`, {
+                    method: 'POST',
+                    headers: {
+                        Authorization: `Basic ${credentials}`,
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify({}),
+                });
+                if (!response.ok) {
+                    throw new Error(`Authentication failed: ${response.status} ${response.statusText}`);
+                }
+                const data = (await response.json());
+                this.refreshToken = data.refresh;
+                this.token = data.jwt;
+                this.onTokensChanged?.({ jwt: this.token, refresh: this.refreshToken });
+                return this.token;
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt >= maxRetries) {
+                    break;
+                }
+                const delayMs = this.authRetryDelaysMs[attempt];
+                this.log.error('Authentication error:', error instanceof Error ? error.message : String(error));
+                this.log.warn(`Authentication retry ${attempt + 1}/${maxRetries} scheduled in ${Math.round(delayMs / 1000)} seconds.`);
+                await this.delay(delayMs);
+            }
+        }
+        throw new Error(`Authentication failed after ${maxRetries + 1} attempts: ${String(lastError)}`);
+    }
+    async refreshAccessToken() {
+        if (this.authenticateRequest !== null) {
+            return this.authenticateRequest;
+        }
+        this.authenticateRequest = (async () => {
+            try {
+                const response = await this.fetch(`${this.baseUrl}/auth/refresh`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify({
+                        refresh: this.refreshToken,
+                        email: this.email,
+                    }),
+                });
+                if (!response.ok) {
+                    throw new Error(`Token refresh failed: ${response.status}`);
+                }
+                const data = (await response.json());
+                this.token = data.jwt;
+                this.onTokensChanged?.({ jwt: this.token, refresh: this.refreshToken });
+                return this.token;
+            }
+            catch (error) {
+                this.log.error('Token refresh error:', error instanceof Error ? error.message : String(error));
+                this.authenticateRequest = null;
+                return this.authenticateWithRetry();
+            }
+        })();
+        this.authenticateRequest.finally(() => {
+            this.authenticateRequest = null;
+        });
+        return this.authenticateRequest;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/src/api/session.js.map

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

package/dist/src/api/transport.d.ts

@@ -0,0 +1,21 @@
+import type { IotasSession } from './session.js';
+export interface IotasTransportOptions {
+    session: IotasSession;
+    baseUrl?: string;
+    maxRequestAuthRetries?: number;
+    fetch?: typeof fetch;
+}
+/**
+ * Authenticated HTTP transport for the IOTAS API.
+ *
+ * Handles bearer token injection, 401 retry with token invalidation,
+ * and empty response body parsing.
+ */
+export declare class IotasTransport {
+    private readonly session;
+    private readonly baseUrl;
+    private readonly maxRequestAuthRetries;
+    private readonly fetch;
+    constructor(options: IotasTransportOptions);
+    request<T>(path: string, options?: RequestInit, authRetryCount?: number): Promise<T>;
+}

package/dist/src/api/transport.js

@@ -0,0 +1,49 @@
+const DEFAULT_BASE_URL = 'https://api.iotashome.com/api/v1';
+const DEFAULT_MAX_REQUEST_AUTH_RETRIES = 1;
+/**
+ * Authenticated HTTP transport for the IOTAS API.
+ *
+ * Handles bearer token injection, 401 retry with token invalidation,
+ * and empty response body parsing.
+ */
+export class IotasTransport {
+    session;
+    baseUrl;
+    maxRequestAuthRetries;
+    fetch;
+    constructor(options) {
+        this.session = options.session;
+        this.baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+        this.maxRequestAuthRetries = options.maxRequestAuthRetries ?? DEFAULT_MAX_REQUEST_AUTH_RETRIES;
+        this.fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+    }
+    async request(path, options = {}, authRetryCount = 0) {
+        const token = await this.session.getToken();
+        const headers = new Headers(options.headers);
+        headers.set('Authorization', `Bearer ${token}`);
+        if (!headers.has('Content-Type')) {
+            headers.set('Content-Type', 'application/json');
+        }
+        const response = await this.fetch(`${this.baseUrl}${path}`, {
+            ...options,
+            headers,
+        });
+        if (response.status === 401) {
+            if (authRetryCount >= this.maxRequestAuthRetries) {
+                throw new Error('API request failed: unauthorized after token refresh retry');
+            }
+            this.session.invalidateToken();
+            return this.request(path, options, authRetryCount + 1);
+        }
+        if (!response.ok) {
+            throw new Error(`API request failed: ${response.status} ${response.statusText}`);
+        }
+        // Handle empty responses (e.g., from PUT/DELETE requests)
+        const text = await response.text();
+        if (!text) {
+            return undefined;
+        }
+        return JSON.parse(text);
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/src/api/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/api/transport.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GAAG,kCAAkC,CAAC;AAC5D,MAAM,gCAAgC,GAAG,CAAC,CAAC;AAS3C;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IACR,OAAO,CAAe;IACtB,OAAO,CAAS;IAChB,qBAAqB,CAAS;IAC9B,KAAK,CAA0B;IAEhD,YAAY,OAA8B;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC;QACnD,IAAI,CAAC,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,IAAI,gCAAgC,CAAC;QAC/F,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,OAAO,CAAI,IAAY,EAAE,UAAuB,EAAE,EAAE,cAAc,GAAG,CAAC;QAC1E,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QAE5C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,KAAK,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;YAC1D,GAAG,OAAO;YACV,OAAO;SACR,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,IAAI,cAAc,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBACjD,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;YAChF,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,cAAc,GAAG,CAAC,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACnF,CAAC;QAED,0DAA0D;QAC1D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,SAAc,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;IAC/B,CAAC;CACF"}

package/dist/src/cache/featureCache.d.ts

@@ -0,0 +1,55 @@
+import type { IotasLogger } from '../logger.js';
+import type { IotasClient } from '../api/iotasClient.js';
+import type { FeatureCacheOptions, Rooms } from '../types.js';
+export type FeatureChangeCallback = (changed: Map<string, number>) => void;
+/**
+ * FeatureCache provides cached feature values with background polling.
+ *
+ * - Seeded from discovery snapshot (no cold-start defaults)
+ * - Single getRooms() call per poll cycle
+ * - Write barrier prevents stale poll data overwriting recent onSet
+ * - Subscription model for pushing updates via updateValue
+ */
+export declare class FeatureCache {
+    private readonly log;
+    private readonly client;
+    private readonly values;
+    private readonly writeTimestamps;
+    private readonly subscriptions;
+    private pollTimer;
+    private consecutiveFailures;
+    private stopped;
+    private readonly pollIntervalMs;
+    private readonly writeBarrierMs;
+    private readonly pollBackoffBaseMs;
+    private readonly pollBackoffMaxMs;
+    constructor(log: IotasLogger, client: IotasClient, options?: FeatureCacheOptions);
+    seed(rooms: Rooms): void;
+    get(featureId: string): number | undefined;
+    set(featureId: string, value: number): void;
+    /**
+     * Subscribe to feature changes. Callback is invoked when any of the
+     * specified features are updated by the poller.
+     * Returns a dispose function to unsubscribe.
+     */
+    subscribe(featureIds: string[], callback: FeatureChangeCallback): () => void;
+    start(): void;
+    stop(): void;
+    /**
+     * Reset for a fresh start (used when re-discovering devices).
+     *
+     * This clears all cached values, write timestamps, and subscriptions.
+     * Callers must re-register subscriptions after calling reset().
+     *
+     * Expected call order:
+     * 1) reset()
+     * 2) seed(rooms)
+     * 3) recreate accessory runtimes (which re-subscribe)
+     * 4) start()
+     */
+    reset(): void;
+    private schedulePoll;
+    private poll;
+    private updateFromSnapshot;
+    private notifySubscribers;
+}