Class HomeBaseDeviceFacade<TData>Abstract

Readonlytype

exists

• get exists(): boolean

  Whether the underlying device still exists in the registry. Non-throwing introspection mirroring the Classic facades' exists: a consumer holding a cached facade can detect staleness without a try/catch.

  Returns boolean

  true while the registry still resolves the id.

frostProtection

• get frostProtection(): ProtectionState | null

  Current frost-protection settings, or null when not configured.

  Returns ProtectionState | null

  The cross-dialect protection state from /context.

holidayMode

• get holidayMode(): HolidayModeState | null

  Current holiday-mode window, or null when not configured.

  Returns HolidayModeState | null

  The cross-dialect holiday-mode state from /context.

id

• get id(): string

  Unique device identifier as assigned by MELCloud Home.

  Returns string

  The GUID string assigned by MELCloud Home.

isAvailable

• get isAvailable(): boolean

  Whether MELCloud can still deliver writes to the unit. false means the wifi adapter lost its link to the cloud: writes are accepted but never delivered, and readings go stale. The /context isConnected flag only counts once it has read false for a full day: its negative side is unproven, and the persistence window makes a Classic-Offline-style tight-threshold boolean harmless (such a flag never stays false through a report cycle).

  Returns boolean

  false after a day of continuous disconnection.

isOwner

• get isOwner(): boolean

  Whether the current account owns this device rather than being a guest of it. Reports the structural origin only: false does not by itself prove a guest is barred from control (the BFF accepts guest writes on shared units).

  Returns boolean

  true when owned, false when shared with this account.

name

• get name(): string

  User-facing display name set in the MELCloud Home app.

  Returns string

  The device's display name.

rssi

• get rssi(): number

  Last-reported Wi-Fi signal strength of the device adapter, in dBm.

  Returns number

  The RSSI value.

getSignal

• getSignal(params: { from: string; to: string }): Promise<Result<HomeEnergyData>>

  Fetches RSSI telemetry for this device over the given time window.

  Parameters

  • params: { from: string; to: string }

    Query window.

    • from: string

      ISO start timestamp (inclusive).

    • to: string

      ISO end timestamp (exclusive).

  Returns Promise<Result<HomeEnergyData>>

  The telemetry bundle, or a typed failure.

getSignalStrength

• getSignalStrength(hour?: Hour): Promise<Result<ReportChartLineOptions>>

  Fetches the Wi-Fi signal chart — the whole of today on a five-minute grid, or one specific hour on a minute grid. The Home counterpart of the Classic getSignalStrength contract.

  Parameters

  • Optionalhour: Hour

    Optional hour of today (0-23); omitted covers today.

  Returns Promise<Result<ReportChartLineOptions>>

  Structured line chart options (dBm), or a typed failure.

updatePower

• updatePower(isOn?: boolean): Promise<void>

  Powers the unit on or off. This is the unit-level master power (the Power setting, shown as the system on/off toggle in the app), defined at the base like the Classic side's updatePower — the contracts differ: this one resolves void and throws the typed transport error. Convenience wrapper over updateValues.

  Parameters

  • isOn: boolean = true

    true to power on, false to power off.

  Returns Promise<void>

AbstractupdateValues

• updateValues(values: { power?: boolean | null }): Promise<void>

  Pushes a partial update to the device. Each subclass narrows the payload to its device-type shape; both shapes share the power field this base's updatePower relies on.

  Parameters

  • values: { power?: boolean | null }

    Partial update payload.

  Returns Promise<void>