homebridge-cync-app 0.0.2

package/dist/cync/cync-client.d.ts

@@ -0,0 +1,76 @@
+import { ConfigClient, CyncCloudConfig, CyncLoginSession, CyncLogger } from './config-client.js';
+import { TcpClient } from './tcp-client.js';
+export declare class CyncClient {
+    private readonly log;
+    private readonly configClient;
+    private readonly tcpClient;
+    private readonly tokenStore;
+    private tokenData;
+    private session;
+    private cloudConfig;
+    private readonly loginConfig;
+    constructor(configClient: ConfigClient, tcpClient: TcpClient, loginConfig: {
+        email: string;
+        password: string;
+        twoFactor?: string;
+    }, storagePath: string, logger?: CyncLogger);
+    /**
+         * Ensure we are logged in:
+         * 1) Try stored token.
+         * 2) If none/invalid, run 2FA flow (request or complete).
+         * Returns true on successful login, false if we need user input (2FA).
+         */
+    ensureLoggedIn(): Promise<boolean>;
+    /**
+         * Internal helper: request a 2FA email code using existing authenticate().
+         */
+    private requestTwoFactorCode;
+    /**
+         * Internal helper: complete 2FA login using existing submitTwoFactor().
+         * This converts CyncLoginSession into the richer shape we want for token storage.
+         */
+    private completeTwoFactorLogin;
+    /**
+     * Apply an access token (and associated metadata) to the underlying ConfigClient,
+     * and hydrate our local session snapshot so ensureSession() passes.
+     */
+    private applyAccessToken;
+    /**
+     * Step 1 of 2FA flow:
+     *
+     * Trigger an email with a one-time code to the Cync account email.
+     *
+     * Call sequence:
+     *   await client.authenticate(username, password);  // sends email
+     *   // user reads email, gets code…
+     *   await client.submitTwoFactor(username, password, code); // completes login
+     */
+    authenticate(username: string): Promise<void>;
+    /**
+     * Step 2 of 2FA flow:
+     *
+     * Use the emailed OTP code to complete login.
+     * This method is stateless: it does not rely on prior calls to authenticate()
+     * in the same process, so it works across Homebridge restarts.
+     */
+    submitTwoFactor(email: string, password: string, code: string): Promise<CyncLoginSession>;
+    /**
+     * Fetch and cache the cloud configuration (meshes/devices) for the logged-in user.
+     */
+    loadConfiguration(): Promise<CyncCloudConfig>;
+    /**
+     * Start the LAN/TCP transport (stub for now).
+     */
+    startTransport(config: CyncCloudConfig, loginCode: Uint8Array): Promise<void>;
+    stopTransport(): Promise<void>;
+    /**
+     * High-level helper for toggling a switch/plug.
+     */
+    setSwitchState(deviceId: string, params: {
+        on: boolean;
+        [key: string]: unknown;
+    }): Promise<void>;
+    getSessionSnapshot(): CyncLoginSession | null;
+    getCloudConfigSnapshot(): CyncCloudConfig | null;
+    private ensureSession;
+}

package/dist/cync/cync-client.js

@@ -0,0 +1,236 @@
+import { CyncTokenStore } from './token-store.js';
+const defaultLogger = {
+    debug: (...args) => console.debug('[cync-client]', ...args),
+    info: (...args) => console.info('[cync-client]', ...args),
+    warn: (...args) => console.warn('[cync-client]', ...args),
+    error: (...args) => console.error('[cync-client]', ...args),
+};
+export class CyncClient {
+    log;
+    configClient;
+    tcpClient;
+    tokenStore;
+    tokenData = null;
+    // Populated after successful login.
+    session = null;
+    cloudConfig = null;
+    // Credentials from config.json, used to drive 2FA bootstrap.
+    loginConfig;
+    constructor(configClient, tcpClient, loginConfig, storagePath, logger) {
+        this.configClient = configClient;
+        this.tcpClient = tcpClient;
+        this.log = logger ?? defaultLogger;
+        this.loginConfig = loginConfig;
+        this.tokenStore = new CyncTokenStore(storagePath);
+    }
+    /**
+         * Ensure we are logged in:
+         * 1) Try stored token.
+         * 2) If none/invalid, run 2FA flow (request or complete).
+         * Returns true on successful login, false if we need user input (2FA).
+         */
+    async ensureLoggedIn() {
+        // 1) Try stored token/session
+        const stored = await this.tokenStore.load();
+        if (stored) {
+            this.log.info('CyncClient: using stored token for userId=%s (expiresAt=%s)', stored.userId, stored.expiresAt ? new Date(stored.expiresAt).toISOString() : 'unknown');
+            this.tokenData = stored;
+            // Hydrate ConfigClient + session snapshot.
+            this.applyAccessToken(stored);
+            return true;
+        }
+        // 2) No stored token – run 2FA bootstrap
+        const { email, password, twoFactor } = this.loginConfig;
+        if (!email || !password) {
+            this.log.error('CyncClient: email and password are required to obtain a new token.');
+            return false;
+        }
+        if (!twoFactor || String(twoFactor).trim() === '') {
+            // No 2FA code – request one
+            this.log.info('Cync: starting 2FA handshake for %s', email);
+            await this.requestTwoFactorCode(email);
+            this.log.info('Cync: 2FA code sent to your email. Enter the code as "twoFactor" in the plugin config and restart Homebridge to complete login.');
+            return false;
+        }
+        // We have a 2FA code – complete login and persist token
+        this.log.info('Cync: completing 2FA login for %s', email);
+        const loginResult = await this.completeTwoFactorLogin(email, password, String(twoFactor).trim());
+        const tokenData = {
+            userId: String(loginResult.userId),
+            accessToken: loginResult.accessToken,
+            refreshToken: loginResult.refreshToken,
+            expiresAt: loginResult.expiresAt ?? undefined,
+        };
+        await this.tokenStore.save(tokenData);
+        this.tokenData = tokenData;
+        // Hydrate ConfigClient + session snapshot from the freshly obtained token.
+        this.applyAccessToken(tokenData);
+        this.log.info('Cync login successful; userId=%s (token stored)', tokenData.userId);
+        return true;
+    }
+    /**
+         * Internal helper: request a 2FA email code using existing authenticate().
+         */
+    async requestTwoFactorCode(email) {
+        await this.authenticate(email);
+    }
+    /**
+         * Internal helper: complete 2FA login using existing submitTwoFactor().
+         * This converts CyncLoginSession into the richer shape we want for token storage.
+         */
+    async completeTwoFactorLogin(email, password, code) {
+        const session = await this.submitTwoFactor(email, password, code);
+        const s = session;
+        const access = s.accessToken ?? s.jwt;
+        if (!access) {
+            throw new Error('CyncClient: login session did not return an access token.');
+        }
+        return {
+            ...session,
+            accessToken: access,
+            refreshToken: s.refreshToken ?? s.refreshJwt,
+            expiresAt: s.expiresAt,
+        };
+    }
+    /**
+     * Apply an access token (and associated metadata) to the underlying ConfigClient,
+     * and hydrate our local session snapshot so ensureSession() passes.
+     */
+    applyAccessToken(tokenData) {
+        if (!tokenData.accessToken || !tokenData.userId) {
+            this.log.warn('CyncClient: applyAccessToken called with missing userId or accessToken; tokenData=%o', {
+                userId: tokenData.userId,
+                hasAccessToken: !!tokenData.accessToken,
+                expiresAt: tokenData.expiresAt,
+            });
+            return;
+        }
+        // Push into ConfigClient so cloud calls can use it.
+        this.configClient.restoreSession(tokenData.accessToken, tokenData.userId);
+        // Hydrate our own session snapshot so ensureSession() passes.
+        this.session = {
+            accessToken: tokenData.accessToken,
+            userId: tokenData.userId,
+            raw: {
+                source: 'tokenStore',
+                expiresAt: tokenData.expiresAt,
+            },
+        };
+        this.log.debug('CyncClient: access token applied from %s; userId=%s, expiresAt=%s', 'tokenStore', tokenData.userId, tokenData.expiresAt ? new Date(tokenData.expiresAt).toISOString() : 'unknown');
+    }
+    /**
+     * Step 1 of 2FA flow:
+     *
+     * Trigger an email with a one-time code to the Cync account email.
+     *
+     * Call sequence:
+     *   await client.authenticate(username, password);  // sends email
+     *   // user reads email, gets code…
+     *   await client.submitTwoFactor(username, password, code); // completes login
+     */
+    async authenticate(username) {
+        const email = username.trim();
+        this.log.info('CyncClient: requesting 2FA code for %s', email);
+        await this.configClient.sendTwoFactorCode(email);
+        this.log.info('CyncClient: 2FA email requested; call submitTwoFactor() once the user has the code.');
+    }
+    /**
+     * Step 2 of 2FA flow:
+     *
+     * Use the emailed OTP code to complete login.
+     * This method is stateless: it does not rely on prior calls to authenticate()
+     * in the same process, so it works across Homebridge restarts.
+     */
+    async submitTwoFactor(email, password, code) {
+        const trimmedEmail = email.trim();
+        const trimmedCode = code.trim();
+        this.log.info('CyncClient: completing 2FA login for %s', trimmedEmail);
+        const session = await this.configClient.loginWithTwoFactor(trimmedEmail, password, trimmedCode);
+        this.session = session;
+        this.log.debug('CyncClient: session snapshot after login; hasAccessToken=%s userId=%s', !!session.accessToken, session.userId);
+        this.log.info('CyncClient: login successful; userId=%s', session.userId);
+        return session;
+    }
+    /**
+     * Fetch and cache the cloud configuration (meshes/devices) for the logged-in user.
+     */
+    async loadConfiguration() {
+        this.ensureSession();
+        this.log.info('CyncClient: loading Cync cloud configuration…');
+        const cfg = await this.configClient.getCloudConfig();
+        // Debug: inspect per-mesh properties so we can find the real devices.
+        for (const mesh of cfg.meshes) {
+            const meshName = mesh.name ?? mesh.id;
+            this.log.debug('CyncClient: probing properties for mesh %s (id=%s, product_id=%s)', meshName, mesh.id, mesh.product_id);
+            try {
+                const props = await this.configClient.getDeviceProperties(mesh.product_id, mesh.id);
+                this.log.debug('CyncClient: mesh %s properties keys=%o', meshName, Object.keys(props));
+                const bulbsArray = props.bulbsArray;
+                if (Array.isArray(bulbsArray)) {
+                    this.log.info('CyncClient: mesh %s bulbsArray length=%d; first item keys=%o', meshName, bulbsArray.length, bulbsArray[0] ? Object.keys(bulbsArray[0]) : []);
+                    const rawDevices = bulbsArray;
+                    mesh.devices = rawDevices.map((raw) => {
+                        const d = raw;
+                        const displayName = d.displayName;
+                        const deviceID = (d.deviceID ?? d.deviceId);
+                        const wifiMac = d.wifiMac;
+                        const productId = d.product_id ?? mesh.product_id;
+                        // Use deviceID first, then wifiMac (stripped), then a mesh-based fallback.
+                        const id = deviceID ??
+                            (wifiMac ? wifiMac.replace(/:/g, '') : undefined) ??
+                            `${mesh.id}-${productId ?? 'unknown'}`;
+                        return {
+                            id,
+                            name: displayName ?? undefined,
+                            product_id: productId,
+                            device_id: deviceID,
+                            mac: wifiMac,
+                            raw: d,
+                        };
+                    });
+                }
+                else {
+                    this.log.info('CyncClient: mesh %s has no bulbsArray in properties; props keys=%o', meshName, Object.keys(props));
+                }
+            }
+            catch (err) {
+                this.log.warn('CyncClient: getDeviceProperties failed for mesh %s (%s): %s', meshName, mesh.id, err.message ?? String(err));
+            }
+        }
+        this.cloudConfig = cfg;
+        this.log.info('CyncClient: cloud configuration loaded; meshes=%d', cfg.meshes.length);
+        return cfg;
+    }
+    /**
+     * Start the LAN/TCP transport (stub for now).
+     */
+    async startTransport(config, loginCode) {
+        this.ensureSession();
+        this.log.info('CyncClient: starting TCP transport (stub)…');
+        await this.tcpClient.connect(loginCode, config);
+    }
+    async stopTransport() {
+        this.log.info('CyncClient: stopping TCP transport…');
+        await this.tcpClient.disconnect();
+    }
+    /**
+     * High-level helper for toggling a switch/plug.
+     */
+    async setSwitchState(deviceId, params) {
+        this.ensureSession();
+        this.log.debug('CyncClient: setSwitchState stub; deviceId=%s params=%o', deviceId, params);
+        await this.tcpClient.setSwitchState(deviceId, params);
+    }
+    getSessionSnapshot() {
+        return this.session;
+    }
+    getCloudConfigSnapshot() {
+        return this.cloudConfig;
+    }
+    ensureSession() {
+        if (!this.session) {
+            throw new Error('Cync session not initialised; complete 2FA login first.');
+        }
+    }
+}
+//# sourceMappingURL=cync-client.js.map

package/dist/cync/cync-client.js.map

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

package/dist/cync/tcp-client.d.ts

@@ -0,0 +1,33 @@
+import { CyncCloudConfig, CyncLogger } from './config-client.js';
+export type DeviceUpdateCallback = (payload: unknown) => void;
+export declare class TcpClient {
+    private readonly log;
+    private deviceUpdateCb;
+    private roomUpdateCb;
+    private motionUpdateCb;
+    private ambientUpdateCb;
+    constructor(logger?: CyncLogger);
+    /**
+     * Establish a TCP session to one or more Cync devices.
+     *
+     * In the full implementation, loginCode will be the authentication blob used
+     * by the LAN devices, and config will contain the mesh/network information
+     * needed to discover and connect to the correct hosts.
+     *
+     * For now this is a no-op that simply logs the request.
+     */
+    connect(loginCode: Uint8Array, config: CyncCloudConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    onDeviceUpdate(cb: DeviceUpdateCallback): void;
+    onRoomUpdate(cb: DeviceUpdateCallback): void;
+    onMotionUpdate(cb: DeviceUpdateCallback): void;
+    onAmbientUpdate(cb: DeviceUpdateCallback): void;
+    /**
+     * High-level API to change switch state. The actual encoding and TCP send
+     * will be filled in once the LAN protocol is implemented.
+     */
+    setSwitchState(deviceId: string, params: {
+        on: boolean;
+        [key: string]: unknown;
+    }): Promise<void>;
+}

package/dist/cync/tcp-client.js

@@ -0,0 +1,59 @@
+// src/cync/tcp-client.ts
+// Thin TCP client stub for talking to Cync WiFi devices.
+// The binary protocol is non-trivial; for now this class only logs calls so
+// that higher layers can be wired up and tested without crashing.
+const defaultLogger = {
+    debug: (...args) => console.debug('[cync-tcp]', ...args),
+    info: (...args) => console.info('[cync-tcp]', ...args),
+    warn: (...args) => console.warn('[cync-tcp]', ...args),
+    error: (...args) => console.error('[cync-tcp]', ...args),
+};
+export class TcpClient {
+    log;
+    deviceUpdateCb = null;
+    roomUpdateCb = null;
+    motionUpdateCb = null;
+    ambientUpdateCb = null;
+    constructor(logger) {
+        this.log = logger ?? defaultLogger;
+    }
+    /**
+     * Establish a TCP session to one or more Cync devices.
+     *
+     * In the full implementation, loginCode will be the authentication blob used
+     * by the LAN devices, and config will contain the mesh/network information
+     * needed to discover and connect to the correct hosts.
+     *
+     * For now this is a no-op that simply logs the request.
+     */
+    async connect(loginCode, config) {
+        this.log.info('TcpClient.connect() stub called with loginCode length=%d meshes=%d', loginCode.length, config.meshes.length);
+    }
+    async disconnect() {
+        this.log.info('TcpClient.disconnect() stub called.');
+    }
+    onDeviceUpdate(cb) {
+        this.deviceUpdateCb = cb;
+    }
+    onRoomUpdate(cb) {
+        this.roomUpdateCb = cb;
+    }
+    onMotionUpdate(cb) {
+        this.motionUpdateCb = cb;
+    }
+    onAmbientUpdate(cb) {
+        this.ambientUpdateCb = cb;
+    }
+    /**
+     * High-level API to change switch state. The actual encoding and TCP send
+     * will be filled in once the LAN protocol is implemented.
+     */
+    async setSwitchState(deviceId, params) {
+        this.log.info('TcpClient.setSwitchState() stub: deviceId=%s params=%o', deviceId, params);
+        // In a future implementation, this is where we would:
+        // 1. Look up the device in the current CyncCloudConfig.
+        // 2. Construct the appropriate binary payload.
+        // 3. Send via a net.Socket and handle the response.
+    }
+}
+//# sourceMappingURL=tcp-client.js.map

package/dist/cync/tcp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tcp-client.js","sourceRoot":"","sources":["../../src/cync/tcp-client.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,yDAAyD;AACzD,4EAA4E;AAC5E,kEAAkE;AAIlE,MAAM,aAAa,GAAe;IACjC,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC;IACnE,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC;IACjE,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC;IACjE,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC;CACnE,CAAC;AAIF,MAAM,OAAO,SAAS;IACJ,GAAG,CAAa;IAEzB,cAAc,GAAgC,IAAI,CAAC;IACnD,YAAY,GAAgC,IAAI,CAAC;IACjD,cAAc,GAAgC,IAAI,CAAC;IACnD,eAAe,GAAgC,IAAI,CAAC;IAE5D,YAAY,MAAmB;QAC9B,IAAI,CAAC,GAAG,GAAG,MAAM,IAAI,aAAa,CAAC;IACpC,CAAC;IAED;;;;;;;;OAQG;IACI,KAAK,CAAC,OAAO,CACnB,SAAqB,EACrB,MAAuB;QAEvB,IAAI,CAAC,GAAG,CAAC,IAAI,CACZ,oEAAoE,EACpE,SAAS,CAAC,MAAM,EAChB,MAAM,CAAC,MAAM,CAAC,MAAM,CACpB,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,UAAU;QACtB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IACtD,CAAC;IAEM,cAAc,CAAC,EAAwB;QAC7C,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;IAC1B,CAAC;IAEM,YAAY,CAAC,EAAwB;QAC3C,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;IACxB,CAAC;IAEM,cAAc,CAAC,EAAwB;QAC7C,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;IAC1B,CAAC;IAEM,eAAe,CAAC,EAAwB;QAC9C,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,cAAc,CAC1B,QAAgB,EAChB,MAA+C;QAE/C,IAAI,CAAC,GAAG,CAAC,IAAI,CACZ,wDAAwD,EACxD,QAAQ,EACR,MAAM,CACN,CAAC;QAEF,sDAAsD;QACtD,wDAAwD;QACxD,+CAA+C;QAC/C,oDAAoD;IACrD,CAAC;CACD"}

package/dist/cync/token-store.d.ts

@@ -0,0 +1,16 @@
+export interface CyncTokenData {
+    userId: string;
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt?: number;
+}
+/**
+ * Simple JSON token store under the Homebridge storage path.
+ */
+export declare class CyncTokenStore {
+    private readonly filePath;
+    constructor(storagePath: string);
+    load(): Promise<CyncTokenData | null>;
+    save(data: CyncTokenData): Promise<void>;
+    clear(): Promise<void>;
+}

package/dist/cync/token-store.js

@@ -0,0 +1,39 @@
+// src/cync/token-store.ts
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Simple JSON token store under the Homebridge storage path.
+ */
+export class CyncTokenStore {
+    filePath;
+    constructor(storagePath) {
+        this.filePath = path.join(storagePath, 'cync-tokens.json');
+    }
+    async load() {
+        try {
+            const raw = await fs.readFile(this.filePath, 'utf8');
+            const data = JSON.parse(raw);
+            // If expiresAt is set and in the past, treat as invalid
+            if (data.expiresAt && data.expiresAt <= Date.now()) {
+                return null;
+            }
+            return data;
+        }
+        catch {
+            return null;
+        }
+    }
+    async save(data) {
+        const json = JSON.stringify(data, null, 2);
+        await fs.writeFile(this.filePath, json, 'utf8');
+    }
+    async clear() {
+        try {
+            await fs.unlink(this.filePath);
+        }
+        catch {
+            // ignore if missing
+        }
+    }
+}
+//# sourceMappingURL=token-store.js.map

package/dist/cync/token-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-store.js","sourceRoot":"","sources":["../../src/cync/token-store.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AASlC;;GAEG;AACH,MAAM,OAAO,cAAc;IACT,QAAQ,CAAS;IAElC,YAAmB,WAAmB;QACrC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;IAC5D,CAAC;IAEM,KAAK,CAAC,IAAI;QAChB,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;YAE9C,wDAAwD;YACxD,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBACpD,OAAO,IAAI,CAAC;YACb,CAAC;YAED,OAAO,IAAI,CAAC;QACb,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,IAAmB;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3C,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;IAEM,KAAK,CAAC,KAAK;QACjB,IAAI,CAAC;YACJ,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACR,oBAAoB;QACrB,CAAC;IACF,CAAC;CACD"}

package/dist/cync/types.d.ts

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

package/dist/cync/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cync/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cync/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import type { API } from 'homebridge';
+/**
+ * Homebridge entry point.
+ * Registers the CyncAppPlatform with Homebridge under PLATFORM_NAME.
+ */
+declare const _default: (api: API) => void;
+export default _default;

package/dist/index.js

@@ -0,0 +1,10 @@
+import { CyncAppPlatform } from './platform.js';
+import { PLATFORM_NAME } from './settings.js';
+/**
+ * Homebridge entry point.
+ * Registers the CyncAppPlatform with Homebridge under PLATFORM_NAME.
+ */
+export default (api) => {
+    api.registerPlatform(PLATFORM_NAME, CyncAppPlatform);
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;;GAGG;AACH,eAAe,CAAC,GAAQ,EAAE,EAAE;IAC3B,GAAG,CAAC,gBAAgB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;AACtD,CAAC,CAAC"}

package/dist/platform.d.ts

@@ -0,0 +1,29 @@
+import type { API, DynamicPlatformPlugin, Logger, PlatformAccessory, PlatformConfig } from 'homebridge';
+/**
+ * CyncAppPlatform
+ *
+ * Homebridge platform class responsible for:
+ * - Initializing the Cync client
+ * - Managing cached accessories
+ * - Kicking off device discovery from Cync cloud
+ */
+export declare class CyncAppPlatform implements DynamicPlatformPlugin {
+    readonly accessories: PlatformAccessory[];
+    private readonly log;
+    private readonly api;
+    private readonly config;
+    private readonly client;
+    private cloudConfig;
+    constructor(log: Logger, config: PlatformConfig, api: API);
+    /**
+     * Called when cached accessories are restored from disk.
+     */
+    configureAccessory(accessory: PlatformAccessory): void;
+    private loadCync;
+    /**
+     * Discover devices from the Cync cloud config and register them as
+     * Homebridge accessories. For now, each device is exposed as a simple
+     * dummy Switch that logs state changes.
+     */
+    private discoverDevices;
+}