Class: MonitorManager

Defined in: electron/managers/MonitorManager.ts:120

Main class for orchestrating monitor scheduling, status checks, and event-driven updates.

Remarks

All monitoring operations, including lifecycle management, scheduling, and event emission, are coordinated here. This class is the central entry point for all backend monitoring logic.

Constructors

Constructor

new MonitorManager(dependencies: MonitorManagerDependencies, enhancedServices: EnhancedMonitoringServices): MonitorManager

Defined in: electron/managers/MonitorManager.ts:980

Creates a new manager using the supplied dependencies and enhanced services.

Parameters

dependencies

MonitorManagerDependencies

Data, cache, and event collaborators.

enhancedServices

EnhancedMonitoringServices

Enhanced monitoring orchestrator bundle.

Returns

MonitorManager

Properties

dependencies

private readonly dependencies: MonitorManagerDependencies

Defined in: electron/managers/MonitorManager.ts:122

Injected dependencies for orchestration and data access.

---

enhancedMonitoringServices

private readonly enhancedMonitoringServices: EnhancedMonitoringServices

Defined in: electron/managers/MonitorManager.ts:125

Enhanced monitoring services that coordinate stateful operations.

---

eventEmitter

private readonly eventEmitter: TypedEventBus<UptimeEvents>

Defined in: electron/managers/MonitorManager.ts:128

Typed event bus used for monitor event emission.

---

isMonitoring

private isMonitoring: boolean = false

Defined in: electron/managers/MonitorManager.ts:131

Tracks whether any monitors are currently active.

---

monitorScheduler

private readonly monitorScheduler: MonitorScheduler

Defined in: electron/managers/MonitorManager.ts:134

Schedules monitor checks and lifecycle callbacks.

Methods

checkSiteManually()

checkSiteManually(identifier: string, monitorId?: string): Promise<StatusUpdate | undefined>

Defined in: electron/managers/MonitorManager.ts:144

Triggers an immediate monitor check and emits completion events.

Parameters

identifier

string

Site identifier to inspect.

monitorId?

string

Optional monitor identifier to target.

Returns

Promise<StatusUpdate | undefined>

Latest StatusUpdate when available.

---

setupNewMonitors()

setupNewMonitors(site: Site, newMonitorIds: string[]): Promise<void>

Defined in: electron/managers/MonitorManager.ts:205

Applies default configuration for monitors newly attached to a site.

Parameters

site

Site

Site containing the monitors.

newMonitorIds

string[]

Monitor identifiers to initialize.

Returns

Promise<void>

---

setupSiteForMonitoring()

setupSiteForMonitoring(site: Site): Promise<void>

Defined in: electron/managers/MonitorManager.ts:250

Prepares a site for scheduling by applying default cadence and auto-start rules.

Parameters

site

Site

Site to prime before monitoring begins.

Returns

Promise<void>

---

startMonitoring()

startMonitoring(): Promise<MonitoringStartSummary>

Defined in: electron/managers/MonitorManager.ts:275

Starts monitoring across the full fleet and emits lifecycle events.

Returns

Promise<MonitoringStartSummary>

Summary describing attempted and successful starts.

---

startMonitoringForSite()

startMonitoringForSite(identifier: string, monitorId?: string): Promise<boolean>

Defined in: electron/managers/MonitorManager.ts:335

Starts monitoring for a site or a single monitor and emits lifecycle events.

Parameters

identifier

string

Site identifier being toggled.

monitorId?

string

Optional monitor identifier to scope the request.

Returns

Promise<boolean>

---

stopMonitoring()

stopMonitoring(): Promise<MonitoringStopSummary>

Defined in: electron/managers/MonitorManager.ts:396

Stops monitoring globally and reports the resulting summary.

Returns

Promise<MonitoringStopSummary>

Breakdown of attempted and successful stops.

---

stopMonitoringForSite()

stopMonitoringForSite(identifier: string, monitorId?: string): Promise<boolean>

Defined in: electron/managers/MonitorManager.ts:450

Stops monitoring for a site or individual monitor and emits lifecycle events.

Parameters

identifier

string

Site identifier being toggled.

monitorId?

string

Optional monitor identifier to scope the request.

Returns

Promise<boolean>

---

runSequentially()

private runSequentially<TItem>(items: readonly TItem[], task: (item: TItem) => Promise<void>): Promise<void>

Defined in: electron/managers/MonitorManager.ts:510

Execute asynchronous tasks sequentially while preserving order.

Type Parameters

TItem

TItem

Parameters

items

readonly TItem[]

task

(item: TItem) => Promise<void>

Returns

Promise<void>

---

applyDefaultIntervals()

private applyDefaultIntervals(site: Site): Promise<void>

Defined in: electron/managers/MonitorManager.ts:525

Ensures every monitor in the site respects the shared minimum interval.

Parameters

site

Site

Site whose monitors need remediation.

Returns

Promise<void>

---

startAllMonitoringEnhanced()

private startAllMonitoringEnhanced(config: EnhancedLifecycleConfig, isMonitoring: boolean): Promise<MonitoringStartSummary>

Defined in: electron/managers/MonitorManager.ts:621

Internal

Enhanced start all monitoring - replaces the previous startAllMonitoring implementation function.

Parameters

config

EnhancedLifecycleConfig

Configuration object with required dependencies

isMonitoring

boolean

Current monitoring state

Returns

Promise<MonitoringStartSummary>

Promise - New monitoring state

---

autoStartMonitoringIfAppropriate()

private autoStartMonitoringIfAppropriate(site: Site): Promise<void>

Defined in: electron/managers/MonitorManager.ts:633

Applies auto-start rules for a site that has newly loaded monitors.

Parameters

site

Site

Returns

Promise<void>

---

stopAllMonitoringEnhanced()

private stopAllMonitoringEnhanced(config: EnhancedLifecycleConfig): Promise<MonitoringStopSummary>

Defined in: electron/managers/MonitorManager.ts:718

Internal

Enhanced stop all monitoring - replaces the previous stopAllMonitoring implementation function.

Parameters

config

EnhancedLifecycleConfig

Configuration object with required dependencies

Returns

Promise<MonitoringStopSummary>

Promise - Always false (monitoring stopped)

---

autoStartNewMonitors()

private autoStartNewMonitors(site: Site, newMonitors: Monitor[]): Promise<void>

Defined in: electron/managers/MonitorManager.ts:728

Auto-starts eligible monitors that have just been added to a site.

Parameters

site

Site

newMonitors

Monitor[]

Returns

Promise<void>

---

startMonitoringForSiteEnhanced()

private startMonitoringForSiteEnhanced(config: EnhancedLifecycleConfig, identifier: string, monitorId?: string, monitorAction?: MonitorActionDelegate): Promise<boolean>

Defined in: electron/managers/MonitorManager.ts:770

Internal

Enhanced start monitoring for site - replaces the earlier implementation startMonitoringForSite function.

Parameters

config

EnhancedLifecycleConfig

Configuration object with required dependencies

identifier

string

Site identifier

monitorId?

string

Optional monitor ID

monitorAction?

MonitorActionDelegate

Optional recursive handler for nested starts

Returns

Promise<boolean>

Promise - True if operation succeeded

---

handleScheduledCheck()

private handleScheduledCheck(siteIdentifier: string, monitorId: string): Promise<void>

Defined in: electron/managers/MonitorManager.ts:799

Internal

Handles scheduled monitor checks from the MonitorScheduler.

Parameters

siteIdentifier

string

The identifier of the site.

monitorId

string

The monitor ID to check.

Returns

Promise<void>

A promise that resolves when the scheduled check is complete.

Remarks

Invoked by the scheduler to perform a check on a specific monitor at the scheduled interval.

---

stopMonitoringForSiteEnhanced()

private stopMonitoringForSiteEnhanced(config: EnhancedLifecycleConfig, identifier: string, monitorId?: string, monitorAction?: MonitorActionDelegate): Promise<boolean>

Defined in: electron/managers/MonitorManager.ts:845

Internal

Enhanced stop monitoring for site - replaces the previous stopMonitoringForSite implementation function.

Parameters

config

EnhancedLifecycleConfig

Configuration object with required dependencies

identifier

string

Site identifier

monitorId?

string

Optional monitor ID

monitorAction?

MonitorActionDelegate

Optional recursive handler for nested stops

Returns

Promise<boolean>

Promise - True if operation succeeded

---

setupIndividualNewMonitors()

private setupIndividualNewMonitors(site: Site, newMonitors: Monitor[]): Promise<void>

Defined in: electron/managers/MonitorManager.ts:861

Applies default intervals and optional auto-start for new monitors.

Parameters

site

Site

newMonitors

Monitor[]

Returns

Promise<void>

---

applyMonitorState()

private applyMonitorState(site: Site, monitor: Monitor, changes: Partial<Monitor>, newStatus: "degraded" | "down" | "paused" | "pending" | "up"): Promise<void>

Defined in: electron/managers/MonitorManager.ts:903

Applies state changes, writes them to the database, and emits events.

Parameters

site

Site

Site containing the monitor.

monitor

Monitor

Monitor to update.

changes

Partial<Monitor>

Partial mutations to persist.

newStatus

Status used for downstream notifications.

"degraded" | "down" | "paused" | "pending" | "up"

Returns

Promise<void>

---

createEnhancedLifecycleHost()

private createEnhancedLifecycleHost(): EnhancedLifecycleHost

Defined in: electron/managers/MonitorManager.ts:965

Builds the lifecycle context consumed by enhanced monitoring helpers.

Returns

EnhancedLifecycleHost

Bound callbacks and services required for helper execution.

---

getActiveMonitorCount()

getActiveMonitorCount(): number

Defined in: electron/managers/MonitorManager.ts:994

Returns the number of monitors currently scheduled for checks.

Returns

number

---

isMonitorActiveInScheduler()

isMonitorActiveInScheduler(siteIdentifier: string, monitorId: string): boolean

Defined in: electron/managers/MonitorManager.ts:1004

Checks whether a specific monitor currently has a scheduled job.

Parameters

siteIdentifier

string

Site containing the monitor.

monitorId

string

Monitor identifier under inspection.

Returns

boolean

---

isMonitoringActive()

isMonitoringActive(): boolean

Defined in: electron/managers/MonitorManager.ts:1012

Reports whether any monitors are currently active.

Returns

boolean

---

restartMonitorWithNewConfig()

restartMonitorWithNewConfig(siteIdentifier: string, monitor: Monitor): boolean

Defined in: electron/managers/MonitorManager.ts:1022

Restarts a monitor after its configuration changes.

Parameters

siteIdentifier

string

Site containing the monitor.

monitor

Monitor

Updated monitor definition.

Returns

boolean

---

shouldApplyDefaultInterval()

private shouldApplyDefaultInterval(monitor: Monitor): boolean

Defined in: electron/managers/MonitorManager.ts:1034

Determines whether the default interval should be applied to a monitor.

Parameters

monitor

Monitor

Monitor candidate for remediation.

Returns

boolean