Class: MonitorManager

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

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:587

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:138

Injected dependencies for orchestration and data access.

---

enhancedMonitoringServices

private readonly enhancedMonitoringServices: EnhancedMonitoringServices

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

Enhanced monitoring services that coordinate stateful operations.

---

eventEmitter

private readonly eventEmitter: TypedEventBus<UptimeEvents>

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

Typed event bus used for monitor event emission.

---

isMonitoring

private isMonitoring: boolean = false

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

Tracks whether any monitors are currently active.

---

monitorScheduler

private readonly monitorScheduler: MonitorScheduler

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

Schedules monitor checks and lifecycle callbacks.

Methods

checkSiteManually()

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

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

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:187

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:205

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:221

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:242

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:275

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:295

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:327

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:342

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:368

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:380

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:399

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:409

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:435

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, signal: AbortSignal): Promise<void>

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

Internal

Handles scheduled monitor checks from the MonitorScheduler.

Parameters

siteIdentifier

string

The identifier of the site.

monitorId

string

The monitor ID to check.

signal

AbortSignal

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:492

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:508

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" | "up" | "paused" | "pending"): Promise<void>

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

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" | "up" | "paused" | "pending"

Returns

Promise<void>

---

createEnhancedLifecycleConfig()

private createEnhancedLifecycleConfig(): EnhancedLifecycleConfig

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

Builds the enhanced lifecycle configuration used by monitoring helpers.

Returns

EnhancedLifecycleConfig

Immutable configuration snapshot for lifecycle flows.

---

createEnhancedLifecycleHost()

private createEnhancedLifecycleHost(): EnhancedLifecycleHost

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

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:601

Returns the number of monitors currently scheduled for checks.

Returns

number

---

isMonitorActiveInScheduler()

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

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

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:619

Reports whether any monitors are currently active.

Returns

boolean

---

restartMonitorWithNewConfig()

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

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

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:641

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

Parameters

monitor

Monitor

Monitor candidate for remediation.

Returns

boolean