Optional ReadonlyabortOptional shutdown signal applied to every outgoing request.
When the signal fires, all in-flight HTTP requests abort with a
DOMException of name AbortError. Subsequent calls from the same
client instance will also abort immediately. Use this to tie the
SDK lifetime to a host process lifetime — e.g. pass the Homey
app's shutdown signal so outstanding requests don't dangle across
a reload.
Optional ReadonlybaseBase URL of the MELCloud Home BFF server.
Optional ReadonlyeventsStructured-events callbacks invoked around SDK lifecycle moments. Useful to plug the SDK into a host observability stack (pino / winston / OpenTelemetry / custom metrics).
Optional ReadonlylocaleBCP-47 locale tag for report chart labels (dates, times). Defaults to the runtime locale when unset.
Optional ReadonlyloggerCustom logger. Defaults to console.
Optional ReadonlypasswordOptional ReadonlysettingExternal setting manager for persisting credentials and session data.
Optional ReadonlyshouldRestore the persisted session in the background instead of awaiting
it inside create(). Session probing and full logins can take tens
of seconds on slow networks, which blows a host app's init budget
(e.g. Homey's 30 s ready timeout). The lifecycle contract is
unchanged — auto-sync arming, onAuthenticationLost, login
backoff — it just runs off the critical path; isAuthenticated()
may report false until the background restore lands.
Optional ReadonlysyncAuto-sync timer in minutes. false disables the timer entirely
(manual list() / fetch() only). Omit to use the subclass
default (1 for Home, 5 for Classic).
Optional ReadonlytimezoneIANA timezone identifier (e.g. 'Europe/Paris') used to render
chart labels and resolve day/hour windows. The Home wire speaks
UTC wall-clock (live-probed 2026-07-18); this timezone only
affects local presentation. Defaults to UTC when unset.
Optional ReadonlytransportHTTP transport: pre-built HttpClient or build options.
Optional Readonlyusername
Configuration options for the MELCloud Home API.