Skip to main content

Interface: UptimeEvents

Defined in: electron/events/eventTypes.ts:60

Comprehensive event map for the Uptime Watcher application.

Remarks​

Defines all events that can be emitted throughout the application lifecycle, organized by functional domains. Each event includes strongly typed data for compile-time safety and comprehensive metadata for debugging, auditing, and event-driven workflows.

See​

Extends​

Indexable​

[key: string]: EventPayloadValue

Properties​

cache:invalidated​

cache:invalidated: UptimeEventPayload<CacheInvalidatedEventData>

Defined in: electron/events/eventTypes.ts:71

Emitted when a cache entry is invalidated for a site or monitor.

Remarks​

Used to trigger cache refreshes or notify listeners of data changes.

See​

CacheInvalidatedEventData for payload structure.

config:changed​

config:changed: { newValue: JsonValue | undefined; oldValue: JsonValue | undefined; setting: string; source: "migration" | "user" | "system"; timestamp: number; }

Defined in: electron/events/eventTypes.ts:86

Emitted when a configuration setting is changed.

newValue​

newValue: JsonValue | undefined

The new value of the setting.

oldValue​

oldValue: JsonValue | undefined

The previous value of the setting.

setting​

setting: string

The configuration key that changed.

source​

source: "migration" | "user" | "system"

Origin of the change (user, system, migration).

timestamp​

timestamp: number

Unix timestamp (ms) when the change occurred.

Remarks​

Used to propagate configuration changes throughout the application.

Param​

The new value of the setting.

Param​

The previous value of the setting.

Param​

The name of the setting that changed.

Param​

The origin of the change ("migration", "system", or "user").

Param​

Unix timestamp (ms) when the change occurred.

database:backup-created​

database:backup-created: { fileName: string; size: number; timestamp: number; triggerType: "manual" | "scheduled" | "shutdown"; }

Defined in: electron/events/eventTypes.ts:111

Emitted when a database backup is created.

fileName​

fileName: string

Name of the backup file.

Remarks​

The filename of the created backup file, typically including timestamp information for identification purposes.

size​

size: number

Size of the backup file in bytes.

Remarks​

The total size of the backup file in bytes, useful for monitoring backup size trends and storage management.

timestamp​

timestamp: number

Unix timestamp (ms) when backup was created.

Remarks​

Precise timing of backup creation for audit trails and backup scheduling verification.

triggerType​

triggerType: "manual" | "scheduled" | "shutdown"

What triggered the backup.

Remarks​

Indicates the source of the backup operation: "manual" for user-initiated backups, "scheduled" for automatic backups, or "shutdown" for application shutdown backups.

Remarks​

Used for backup tracking and notification.

Param​

Name of the backup file.

Param​

Size of the backup file in bytes.

Param​

Unix timestamp (ms) when backup was created.

Param​

What triggered the backup ("manual", "scheduled", or "shutdown").

database:backup-restored​

database:backup-restored: { checksum: string; fileName: string; schemaVersion: number; size: number; timestamp: number; triggerType: "manual" | "scheduled" | "shutdown"; }

Defined in: electron/events/eventTypes.ts:153

Emitted when a database backup is restored.

checksum​

checksum: string

fileName​

fileName: string

schemaVersion​

schemaVersion: number

size​

size: number

timestamp​

timestamp: number

triggerType​

triggerType: "manual" | "scheduled" | "shutdown"

database:error​

database:error: {[key: string]: EventPayloadValue; error: SerializedError; operation: string; timestamp: number; }

Defined in: electron/events/eventTypes.ts:172

Emitted when a database error occurs.

Index Signature​

[key: string]: EventPayloadValue

error​

error: SerializedError

The error object that caused the database operation to fail.

Remarks​

Contains the specific error information including message, stack trace, and any additional error details for debugging purposes.

operation​

operation: string

The database operation that failed.

Remarks​

Identifies which specific database operation encountered the error, such as "insert", "update", "delete", or "select".

timestamp​

timestamp: number

Unix timestamp (ms) when the error occurred.

Remarks​

Provides precise timing of when the database error was encountered for debugging and audit trail purposes.

Remarks​

Additional properties may be present for context.

Param​

The error object.

Param​

The database operation that failed.

Param​

Unix timestamp (ms) when the error occurred.

database:retry​

database:retry: {[key: string]: EventPayloadValue; attempt: number; operation: string; timestamp: number; }

Defined in: electron/events/eventTypes.ts:213

Emitted when a database operation is retried after failure.

Index Signature​

[key: string]: EventPayloadValue

attempt​

attempt: number

The retry attempt number.

Remarks​

Indicates which retry attempt this is, starting from 1 for the first retry after the initial failure. Used for tracking retry patterns.

operation​

operation: string

The database operation being retried.

Remarks​

Identifies which specific database operation is being retried after a previous failure, such as "insert", "update", "delete", or "select".

timestamp​

timestamp: number

Unix timestamp (ms) when the retry occurred.

Remarks​

Provides precise timing of when the retry was attempted for debugging and performance analysis purposes.

Remarks​

Additional properties may be present for context.

Param​

The retry attempt number.

Param​

The database operation being retried.

Param​

Unix timestamp (ms) when the retry occurred.

database:success​

database:success: {[key: string]: EventPayloadValue; duration?: number; operation: string; timestamp: number; }

Defined in: electron/events/eventTypes.ts:254

Emitted when a database operation succeeds.

Index Signature​

[key: string]: EventPayloadValue

duration?​

optional duration: number

Optional duration (ms) of the operation.

Remarks​

When available, provides the time in milliseconds that the database operation took to complete. Used for performance monitoring and optimization.

operation​

operation: string

The database operation that succeeded.

Remarks​

Identifies which specific database operation completed successfully, such as "insert", "update", "delete", or "select".

timestamp​

timestamp: number

Unix timestamp (ms) when the operation succeeded.

Remarks​

Provides precise timing of when the database operation completed successfully for audit trails and performance tracking.

Remarks​

Additional properties may be present for context.

Param​

Optional duration (ms) of the operation.

Param​

The database operation that succeeded.

Param​

Unix timestamp (ms) when the operation succeeded.

database:transaction-completed​

database:transaction-completed: { duration: number; lifecycleStage?: "success" | "failure" | "start"; operation: string; recordsAffected?: number; success: boolean; timestamp: number; }

Defined in: electron/events/eventTypes.ts:295

Emitted when a database transaction completes.

duration​

duration: number

Duration (ms) of the transaction.

Remarks​

The total time in milliseconds that the database transaction took to complete, including all operations within the transaction.

lifecycleStage?​

optional lifecycleStage: "success" | "failure" | "start"

Optional lifecycle tagging for instrumentation consumers.

Remarks​

When present, indicates whether the emission represents the "start", "success", or "failure" stage of a tracked operation.

operation​

operation: string

The database operation performed in the transaction.

Remarks​

Describes the type of operation that was performed within the transaction, such as "bulk-insert", "migration", or "backup".

recordsAffected?​

optional recordsAffected: number

Optional number of records affected.

Remarks​

When available, indicates how many database records were affected by the transaction operations.

success​

success: boolean

Whether the transaction was successful.

Remarks​

Indicates if the transaction completed successfully (true) or was rolled back due to an error (false).

timestamp​

timestamp: number

Unix timestamp (ms) when the transaction completed.

Remarks​

Provides precise timing of when the transaction finished, regardless of success or failure status.

Param​

Duration (ms) of the transaction.

Param​

The database operation performed in the transaction.

Param​

Optional number of records affected.

Param​

Whether the transaction was successful.

Param​

Unix timestamp (ms) when the transaction completed.

diagnostics:report-created​

diagnostics:report-created: { channel: string; correlationId: string; guard: string; metadataTruncated: boolean; payloadPreviewLength: number; payloadPreviewTruncated: boolean; reason?: string; timestamp: number; }

Defined in: electron/events/eventTypes.ts:354

Emitted whenever a diagnostics report is captured from preload.

channel​

channel: string

The sanitized channel associated with the diagnostics payload.

correlationId​

correlationId: string

Correlation identifier shared with structured logs.

guard​

guard: string

Name of the guard that produced the diagnostics payload.

metadataTruncated​

metadataTruncated: boolean

True when metadata was omitted due to byte limits.

payloadPreviewLength​

payloadPreviewLength: number

Length of the sanitized payload preview string.

payloadPreviewTruncated​

payloadPreviewTruncated: boolean

True when the payload preview was truncated due to byte limits.

reason?​

optional reason: string

Optional rejection reason reported by the guard.

timestamp​

timestamp: number

Timestamp supplied by the preload report.

internal:cache:all-invalidated​

internal:cache:all-invalidated: { cacheName: string; itemCount: number; timestamp: number; }

Defined in: electron/events/eventTypes.ts:376

Emitted when every cache entry is invalidated.

cacheName​

cacheName: string

Name of the cache instance emitting the event.

itemCount​

itemCount: number

Number of entries invalidated.

timestamp​

timestamp: number

Unix timestamp (ms) when invalidation occurred.

internal:cache:bulk-updated​

internal:cache:bulk-updated: { cacheName: string; itemCount: number; timestamp: number; }

Defined in: electron/events/eventTypes.ts:388

Emitted when multiple cache entries are updated in a batch operation.

cacheName​

cacheName: string

Name of the cache instance emitting the event.

itemCount​

itemCount: number

Number of items affected by the bulk update.

timestamp​

timestamp: number

Unix timestamp (ms) when the bulk update completed.

internal:cache:cleanup-completed​

internal:cache:cleanup-completed: { cacheName: string; itemCount: number; timestamp: number; }

Defined in: electron/events/eventTypes.ts:400

Emitted after expired cache entries have been cleaned up.

cacheName​

cacheName: string

Name of the cache instance emitting the event.

itemCount​

itemCount: number

Number of entries removed during cleanup.

timestamp​

timestamp: number

Unix timestamp (ms) when cleanup finished.

internal:cache:cleared​

internal:cache:cleared: { cacheName: string; itemCount: number; timestamp: number; }

Defined in: electron/events/eventTypes.ts:412

Emitted when the entire cache is cleared.

cacheName​

cacheName: string

Name of the cache instance emitting the event.

itemCount​

itemCount: number

Number of entries removed.

timestamp​

timestamp: number

Unix timestamp (ms) when the clear action occurred.

internal:cache:item-cached​

internal:cache:item-cached: { cacheName: string; key: string; timestamp: number; ttl?: number; }

Defined in: electron/events/eventTypes.ts:426

Emitted when a cache entry is cached or updated.

cacheName​

cacheName: string

Name of the cache instance emitting the event.

key​

key: string

Cache key that was stored.

timestamp​

timestamp: number

Unix timestamp (ms) when the item was cached.

ttl?​

optional ttl: number

Optional TTL for the cached entry in milliseconds.

internal:cache:item-deleted​

internal:cache:item-deleted: { cacheName: string; key: string; timestamp: number; }

Defined in: electron/events/eventTypes.ts:440

Emitted when a cache entry is explicitly deleted.

cacheName​

cacheName: string

Name of the cache instance emitting the event.

key​

key: string

Cache key that was deleted.

timestamp​

timestamp: number

Unix timestamp (ms) when the item was deleted.

internal:cache:item-evicted​

internal:cache:item-evicted: { cacheName: string; key: string; reason: "manual" | "lru"; timestamp: number; }

Defined in: electron/events/eventTypes.ts:452

Emitted when a cache entry is evicted, typically due to LRU strategy.

cacheName​

cacheName: string

Name of the cache instance emitting the event.

key​

key: string

Cache key that was evicted.

reason​

reason: "manual" | "lru"

Reason the entry was evicted ("lru" for least-recently-used).

timestamp​

timestamp: number

Unix timestamp (ms) when the eviction occurred.

internal:cache:item-expired​

internal:cache:item-expired: { cacheName: string; key: string; timestamp: number; }

Defined in: electron/events/eventTypes.ts:466

Emitted when a cache entry expires.

cacheName​

cacheName: string

Name of the cache instance emitting the event.

key​

key: string

Cache key that expired.

timestamp​

timestamp: number

Unix timestamp (ms) when the item expired.

internal:cache:item-invalidated​

internal:cache:item-invalidated: { cacheName: string; key: string; timestamp: number; }

Defined in: electron/events/eventTypes.ts:478

Emitted when a cache entry is invalidated.

cacheName​

cacheName: string

Name of the cache instance emitting the event.

key​

key: string

Cache key that was invalidated.

timestamp​

timestamp: number

Unix timestamp (ms) when the item was invalidated.

internal:database:backup-downloaded​

internal:database:backup-downloaded: { fileName?: string; operation: "backup-downloaded"; success: boolean; timestamp: number; }

Defined in: electron/events/eventTypes.ts:495

Emitted when a database backup is downloaded.

fileName?​

optional fileName: string

Optional name of the backup file.

Remarks​

When available, specifies the filename of the downloaded backup. May be undefined if the backup download operation failed.

operation​

operation: "backup-downloaded"

The operation type (always "backup-downloaded").

Remarks​

Constant value identifying this specific database operation type for event filtering and routing purposes.

success​

success: boolean

Whether the download was successful.

Remarks​

Indicates if the backup download completed successfully (true) or encountered an error (false).

timestamp​

timestamp: number

Unix timestamp (ms) when the download completed.

Remarks​

Provides precise timing of when the backup download operation finished, regardless of success or failure status.

Param​

Optional name of the backup file.

Param​

The operation type (always "backup-downloaded").

Param​

Whether the download was successful.

Param​

Unix timestamp (ms) when the download completed.

internal:database:backup-restored​

internal:database:backup-restored: { fileName: string; operation: "backup-restored"; schemaVersion: number; sizeBytes: number; success: boolean; timestamp: number; }

Defined in: electron/events/eventTypes.ts:536

Emitted when a database backup restore completes.

fileName​

fileName: string

operation​

operation: "backup-restored"

schemaVersion​

schemaVersion: number

sizeBytes​

sizeBytes: number

success​

success: boolean

timestamp​

timestamp: number

internal:database:data-exported​

internal:database:data-exported: { fileName?: string; operation: "data-exported"; success: boolean; timestamp: number; }

Defined in: electron/events/eventTypes.ts:553

Emitted when database data is exported.

fileName?​

optional fileName: string

Optional name of the exported file.

Remarks​

When available, specifies the filename of the exported data file. May be undefined if the export operation failed.

operation​

operation: "data-exported"

The operation type (always "data-exported").

Remarks​

Constant value identifying this specific database operation type for event filtering and routing purposes.

success​

success: boolean

Whether the export was successful.

Remarks​

Indicates if the data export completed successfully (true) or encountered an error (false).

timestamp​

timestamp: number

Unix timestamp (ms) when the export completed.

Remarks​

Provides precise timing of when the data export operation finished, regardless of success or failure status.

Param​

Optional name of the exported file.

Param​

The operation type (always "data-exported").

Param​

Whether the export was successful.

Param​

Unix timestamp (ms) when the export completed.

internal:database:data-imported​

internal:database:data-imported: { operation: "data-imported"; recordCount?: number; success: boolean; timestamp: number; }

Defined in: electron/events/eventTypes.ts:599

Emitted when database data is imported.

operation​

operation: "data-imported"

The operation type (always "data-imported").

Remarks​

Constant identifier for this specific internal database operation.

recordCount?​

optional recordCount: number

Optional number of records imported.

Remarks​

Provides count of successfully imported records for tracking and reporting purposes. May be undefined if count is not available.

success​

success: boolean

Whether the import was successful.

Remarks​

Indicates overall success status of the import operation. False indicates the operation failed or was aborted.

timestamp​

timestamp: number

Unix timestamp (ms) when the import completed.

Remarks​

Precise timing of when the import operation finished for audit trails and performance monitoring.

Param​

The operation type (always "data-imported").

Param​

Optional number of records imported.

Param​

Whether the import was successful.

Param​

Unix timestamp (ms) when the import completed.

internal:database:get-sites-from-cache-requested​

internal:database:get-sites-from-cache-requested: { operation: "get-sites-from-cache-requested"; timestamp: number; }

Defined in: electron/events/eventTypes.ts:643

Emitted when a request is made to get sites from the cache.

operation​

operation: "get-sites-from-cache-requested"

The operation type (always "get-sites-from-cache-requested").

Remarks​

Constant identifier for this specific internal database operation.

timestamp​

timestamp: number

Unix timestamp (ms) when the request was made.

Remarks​

Precise timing of when the cache request was initiated for performance monitoring and debugging.

Param​

The operation type (always "get-sites-from-cache-requested").

Param​

Unix timestamp (ms) when the request was made.

internal:database:get-sites-from-cache-response​

internal:database:get-sites-from-cache-response: { operation: "get-sites-from-cache-response"; sites: Site[]; timestamp: number; }

Defined in: electron/events/eventTypes.ts:670

Emitted in response to a get-sites-from-cache request.

operation​

operation: "get-sites-from-cache-response"

The operation type (always "get-sites-from-cache-response").

Remarks​

Constant identifier for this specific internal database operation.

sites​

sites: Site[]

The list of sites returned from the cache.

Remarks​

Array of site objects retrieved from the cache in response to a get-sites-from-cache request.

timestamp​

timestamp: number

Unix timestamp (ms) when the response was sent.

Remarks​

Precise timing of when the cache response was generated for performance monitoring and request tracking.

Param​

The operation type (always "get-sites-from-cache-response").

Param​

The list of sites returned from the cache.

Param​

Unix timestamp (ms) when the response was sent.

internal:database:history-limit-updated​

internal:database:history-limit-updated: { limit: number; operation: "history-limit-updated"; timestamp: number; }

Defined in: electron/events/eventTypes.ts:705

Emitted when the history limit for the database is updated.

limit​

limit: number

The new history limit value.

Remarks​

Property value for this event data structure.

operation​

operation: "history-limit-updated"

The operation type (always "history-limit-updated").

timestamp​

timestamp: number

Unix timestamp (ms) when the update occurred.

Param​

The new history limit value.

Param​

The operation type (always "history-limit-updated").

Param​

Unix timestamp (ms) when the update occurred.

internal:database:initialized​

internal:database:initialized: { operation: "initialized"; success: boolean; timestamp: number; }

Defined in: electron/events/eventTypes.ts:730

Emitted when the database is initialized.

operation​

operation: "initialized"

The operation type (always "initialized").

success​

success: boolean

Whether initialization was successful.

Remarks​

Boolean flag indicating the outcome of the operation.

timestamp​

timestamp: number

Unix timestamp (ms) when initialization completed.

Param​

The operation type (always "initialized").

Param​

Whether initialization was successful.

Param​

Unix timestamp (ms) when initialization completed.

internal:database:sites-refreshed​

internal:database:sites-refreshed: { operation: "sites-refreshed"; siteCount: number; timestamp: number; }

Defined in: electron/events/eventTypes.ts:755

Emitted when the sites cache is refreshed in the database.

operation​

operation: "sites-refreshed"

The operation type (always "sites-refreshed").

siteCount​

siteCount: number

The number of sites refreshed.

Remarks​

Numerical value for tracking and reporting purposes.

timestamp​

timestamp: number

Unix timestamp (ms) when the refresh completed.

Param​

The operation type (always "sites-refreshed").

Param​

The number of sites refreshed.

Param​

Unix timestamp (ms) when the refresh completed.

internal:database:update-sites-cache-requested​

internal:database:update-sites-cache-requested: { operation: "update-sites-cache-requested"; sites?: Site[]; timestamp: number; }

Defined in: electron/events/eventTypes.ts:781

Emitted when a request is made to update the sites cache.

operation​

operation: "update-sites-cache-requested"

The operation type (always "update-sites-cache-requested").

sites?​

optional sites: Site[]

Optional list of sites to update in the cache.

Remarks​

Cache-related data for performance optimization.

timestamp​

timestamp: number

Unix timestamp (ms) when the request was made.

Param​

The operation type (always "update-sites-cache-requested").

Param​

Optional list of sites to update in the cache.

Param​

Unix timestamp (ms) when the request was made.

internal:monitor:all-started​

internal:monitor:all-started: { monitorCount: number; operation: "all-started"; siteCount: number; timestamp: number; }

Defined in: electron/events/eventTypes.ts:809

Emitted when all monitors are started.

monitorCount​

monitorCount: number

The number of monitors started.

Remarks​

Numerical value for tracking and reporting purposes.

operation​

operation: "all-started"

The operation type (always "all-started").

siteCount​

siteCount: number

The number of sites involved.

Remarks​

Numerical value for tracking and reporting purposes.

timestamp​

timestamp: number

Unix timestamp (ms) when the operation completed.

Param​

The number of monitors started.

Param​

The operation type (always "all-started").

Param​

The number of sites involved.

Param​

Unix timestamp (ms) when the operation completed.

internal:monitor:all-stopped​

internal:monitor:all-stopped: { activeMonitors: number; operation: "all-stopped"; reason: EventReason; timestamp: number; }

Defined in: electron/events/eventTypes.ts:842

Emitted when all monitors are stopped.

activeMonitors​

activeMonitors: number

The number of monitors that were active.

Remarks​

Numerical value for tracking and reporting purposes.

operation​

operation: "all-stopped"

The operation type (always "all-stopped").

reason​

reason: EventReason

The reason for stopping.

Remarks​

Indicates the cause or trigger for this operation.

timestamp​

timestamp: number

Unix timestamp (ms) when the operation completed.

Param​

The number of monitors that were active.

Param​

The operation type (always "all-stopped").

Param​

The reason for stopping.

Param​

Unix timestamp (ms) when the operation completed.

internal:monitor:manual-check-completed​

internal:monitor:manual-check-completed: { identifier: string; monitorId?: string; operation: "manual-check-completed"; result: StatusUpdate; timestamp: number; }

Defined in: electron/events/eventTypes.ts:876

Emitted when a manual monitor check is completed.

identifier​

identifier: string

Unique identifier for tracking this manual check operation.

monitorId?​

optional monitorId: string

Optional monitor ID that was checked.

operation​

operation: "manual-check-completed"

Operation type constant for this event.

result​

result: StatusUpdate

Status update result from the manual check operation.

timestamp​

timestamp: number

Unix timestamp (ms) when the manual check completed.

Param​

The unique identifier for the monitor or site.

Param​

Optional monitor ID.

Param​

The operation type (always "manual-check-completed").

Param​

The status update result.

Param​

Unix timestamp (ms) when the check completed.

internal:monitor:site-setup-completed​

internal:monitor:site-setup-completed: { identifier: string; operation: "site-setup-completed"; timestamp: number; }

Defined in: electron/events/eventTypes.ts:910

Emitted when site setup for monitoring is completed.

identifier​

identifier: string

Unique identifier for the site that had setup completed.

operation​

operation: "site-setup-completed"

Operation type constant for this event.

timestamp​

timestamp: number

Unix timestamp (ms) when setup completed.

Param​

The unique identifier for the site.

Param​

The operation type (always "site-setup-completed").

Param​

Unix timestamp (ms) when setup completed.

internal:monitor:started​

internal:monitor:started: { identifier: string; monitorId?: string; operation: "started"; summary?: MonitoringStartSummary; timestamp: number; }

Defined in: electron/events/eventTypes.ts:935

Emitted when a monitor is started.

identifier​

identifier: string

monitorId?​

optional monitorId: string

operation​

operation: "started"

summary?​

optional summary: MonitoringStartSummary

timestamp​

timestamp: number

Param​

The unique identifier for the monitor or site.

Param​

Optional monitor ID.

Param​

The operation type (always "started").

Param​

Unix timestamp (ms) when the monitor started.

internal:monitor:stopped​

internal:monitor:stopped: { identifier: string; monitorId?: string; operation: "stopped"; reason: EventReason; summary?: MonitoringStopSummary; timestamp: number; }

Defined in: electron/events/eventTypes.ts:952

Emitted when a monitor is stopped.

identifier​

identifier: string

monitorId?​

optional monitorId: string

operation​

operation: "stopped"

reason​

reason: EventReason

summary?​

optional summary: MonitoringStopSummary

timestamp​

timestamp: number

Param​

The unique identifier for the monitor or site.

Param​

Optional monitor ID.

Param​

The operation type (always "stopped").

Param​

The reason for stopping.

Param​

Unix timestamp (ms) when the monitor stopped.

internal:site:added​

internal:site:added: { identifier: string; operation: "added"; site: Site; source: "import" | "migration" | "user"; timestamp: number; }

Defined in: electron/events/eventTypes.ts:969

Emitted when a site is added internally.

identifier​

identifier: string

operation​

operation: "added"

site​

site: Site

source​

source: "import" | "migration" | "user"

timestamp​

timestamp: number

Param​

The unique identifier for the site.

Param​

The operation type (always "added").

Param​

The site object added.

Param​

Unix timestamp (ms) when the site was added.

internal:site:cache-miss​

internal:site:cache-miss: { backgroundLoading: boolean; identifier: string; operation: "cache-lookup"; timestamp: number; }

Defined in: electron/events/eventTypes.ts:985

Emitted when a site lookup misses the cache internally.

backgroundLoading​

backgroundLoading: boolean

identifier​

identifier: string

operation​

operation: "cache-lookup"

timestamp​

timestamp: number

Param​

Whether a background refresh was triggered.

Param​

The unique identifier for the site.

Param​

The operation type (always "cache-lookup").

Param​

Unix timestamp (ms) when the cache miss occurred.

internal:site:cache-updated​

internal:site:cache-updated: { identifier: string; operation: "background-load" | "cache-updated" | "manual-refresh"; timestamp: number; }

Defined in: electron/events/eventTypes.ts:999

Emitted when a site's cache is updated internally.

identifier​

identifier: string

operation​

operation: "background-load" | "cache-updated" | "manual-refresh"

timestamp​

timestamp: number

Param​

The unique identifier for the site.

Param​

The operation type (always "cache-updated").

Param​

Unix timestamp (ms) when the cache was updated.

internal:site:is-monitoring-active-requested​

internal:site:is-monitoring-active-requested: { identifier: string; monitorId?: string; operation: "is-monitoring-active-requested"; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1015

Emitted when a request is made to check if monitoring is active for a site.

identifier​

identifier: string

The unique identifier for the site.

monitorId?​

optional monitorId: string

Optional monitor ID.

operation​

operation: "is-monitoring-active-requested"

The operation type (always "is-monitoring-active-requested").

timestamp​

timestamp: number

Unix timestamp (ms) when the request was made.

Param​

The unique identifier for the site.

Param​

Optional monitor ID.

Param​

The operation type (always "is-monitoring-active-requested").

Param​

Unix timestamp (ms) when the request was made.

internal:site:is-monitoring-active-response​

internal:site:is-monitoring-active-response: { identifier: string; isActive: boolean; monitorId: string; operation: "is-monitoring-active-response"; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1036

Emitted in response to a monitoring active check request.

identifier​

identifier: string

The unique identifier for the site.

isActive​

isActive: boolean

Whether monitoring is active.

monitorId​

monitorId: string

The monitor ID.

operation​

operation: "is-monitoring-active-response"

The operation type (always "is-monitoring-active-response").

timestamp​

timestamp: number

Unix timestamp (ms) when the response was sent.

Param​

The unique identifier for the site.

Param​

Whether monitoring is active.

Param​

The monitor ID.

Param​

The operation type (always "is-monitoring-active-response").

Param​

Unix timestamp (ms) when the response was sent.

internal:site:removed​

internal:site:removed: { cascade?: boolean; identifier?: string; operation: "removed"; site?: Site; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1058

Emitted when a site is removed internally.

cascade?​

optional cascade: boolean

Whether the removal was part of a cascade/bulk operation.

identifier?​

optional identifier: string

operation​

operation: "removed"

site?​

optional site: Site

timestamp​

timestamp: number

Param​

The unique identifier for the site (optional when unavailable).

Param​

The operation type (always "removed").

Param​

Optional site snapshot captured prior to removal.

Param​

Unix timestamp (ms) when the site was removed.

internal:site:restart-monitoring-requested​

internal:site:restart-monitoring-requested: { identifier: string; monitor: Monitor; operation: "restart-monitoring-requested"; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1076

Emitted when a request is made to restart monitoring for a site.

identifier​

identifier: string

The unique identifier for the site.

monitor​

monitor: Monitor

The monitor object.

operation​

operation: "restart-monitoring-requested"

The operation type (always "restart-monitoring-requested").

timestamp​

timestamp: number

Unix timestamp (ms) when the request was made.

Param​

The unique identifier for the site.

Param​

The monitor object.

Param​

The operation type (always "restart-monitoring-requested").

Param​

Unix timestamp (ms) when the request was made.

internal:site:restart-monitoring-response​

internal:site:restart-monitoring-response: { identifier: string; monitorId?: string; operation: "restart-monitoring-response"; success: boolean; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1097

Emitted in response to a restart monitoring request.

identifier​

identifier: string

The unique identifier for the site.

monitorId?​

optional monitorId: string

Optional monitor ID.

operation​

operation: "restart-monitoring-response"

The operation type (always "restart-monitoring-response").

success​

success: boolean

Whether the restart was successful.

timestamp​

timestamp: number

Unix timestamp (ms) when the response was sent.

Param​

The unique identifier for the site.

Param​

Optional monitor ID.

Param​

The operation type (always "restart-monitoring-response").

Param​

Whether the restart was successful.

Param​

Unix timestamp (ms) when the response was sent.

internal:site:start-monitoring-requested​

internal:site:start-monitoring-requested: { identifier: string; monitorId?: string; operation: "start-monitoring-requested"; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1119

Emitted when a request is made to start monitoring for a site.

identifier​

identifier: string

The unique identifier for the site.

monitorId?​

optional monitorId: string

Optional monitor ID.

operation​

operation: "start-monitoring-requested"

The operation type (always "start-monitoring-requested").

timestamp​

timestamp: number

Unix timestamp (ms) when the request was made.

Param​

The unique identifier for the site.

Param​

Optional monitor ID.

Param​

The operation type (always "start-monitoring-requested").

Param​

Unix timestamp (ms) when the request was made.

internal:site:start-monitoring-response​

internal:site:start-monitoring-response: { identifier: string; monitorId?: string; operation: "start-monitoring-response"; success: boolean; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1133

Emitted in response to a start monitoring request.

identifier​

identifier: string

The unique identifier for the site.

monitorId?​

optional monitorId: string

Optional monitor ID.

operation​

operation: "start-monitoring-response"

The operation type (always "start-monitoring-response").

success​

success: boolean

Whether the start operation was successful.

timestamp​

timestamp: number

Unix timestamp (ms) when the response was sent.

internal:site:stop-monitoring-requested​

internal:site:stop-monitoring-requested: { identifier: string; monitorId?: string; operation: "stop-monitoring-requested"; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1155

Emitted when a request is made to stop monitoring for a site.

identifier​

identifier: string

The unique identifier for the site.

monitorId?​

optional monitorId: string

Optional monitor ID.

operation​

operation: "stop-monitoring-requested"

The operation type (always "stop-monitoring-requested").

timestamp​

timestamp: number

Unix timestamp (ms) when the request was made.

Param​

The unique identifier for the site.

Param​

Optional monitor ID.

Param​

The operation type (always "stop-monitoring-requested").

Param​

Unix timestamp (ms) when the request was made.

internal:site:stop-monitoring-response​

internal:site:stop-monitoring-response: { identifier: string; monitorId?: string; operation: "stop-monitoring-response"; success: boolean; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1176

Emitted in response to a stop monitoring request.

identifier​

identifier: string

The unique identifier for the site.

monitorId?​

optional monitorId: string

Optional monitor ID.

operation​

operation: "stop-monitoring-response"

The operation type (always "stop-monitoring-response").

success​

success: boolean

Whether the stop operation was successful.

timestamp​

timestamp: number

Unix timestamp (ms) when the response was sent.

Param​

The unique identifier for the site.

Param​

Optional monitor ID.

Param​

The operation type (always "stop-monitoring-response").

Param​

Whether the stop operation was successful.

Param​

Unix timestamp (ms) when the response was sent.

internal:site:updated​

internal:site:updated: { identifier: string; operation: "updated"; previousSite?: Site; site: Site; timestamp: number; updatedFields?: string[]; }

Defined in: electron/events/eventTypes.ts:1199

Emitted when a site is updated internally.

identifier​

identifier: string

The unique identifier for the site.

operation​

operation: "updated"

The operation type (always "updated").

previousSite?​

optional previousSite: Site

Previous site snapshot before the update (optional).

site​

site: Site

The updated site object.

timestamp​

timestamp: number

Unix timestamp (ms) when the update occurred.

updatedFields?​

optional updatedFields: string[]

Optional list of updated field names.

Param​

The unique identifier for the site.

Param​

The operation type (always "updated").

Param​

The updated site object.

Param​

Optional snapshot of the site before the update.

Param​

Unix timestamp (ms) when the update occurred.

Param​

Optional list of updated field names.

monitor:added​

monitor:added: { monitor: Monitor; siteIdentifier: string; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1222

Emitted when a monitor is added.

monitor​

monitor: Monitor

The monitor object added.

siteIdentifier​

siteIdentifier: string

The identifier of the site the monitor belongs to.

timestamp​

timestamp: number

Unix timestamp (ms) when the monitor was added.

Param​

The monitor object added.

Param​

The identifier of the site the monitor belongs to.

Param​

Unix timestamp (ms) when the monitor was added.

monitor:backoff-applied​

monitor:backoff-applied: { backoffAttempt: number; correlationId: string; delayMs: number; monitorId: string; siteIdentifier: string; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1232

Scheduler backoff applied for a monitor following failure/timeout.

backoffAttempt​

backoffAttempt: number

correlationId​

correlationId: string

delayMs​

delayMs: number

monitorId​

monitorId: string

siteIdentifier​

siteIdentifier: string

timestamp​

timestamp: number

monitor:check-completed​

monitor:check-completed: { checkType: "manual" | "scheduled"; monitorId: string; result: StatusUpdate; siteIdentifier: string; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1251

Emitted when a monitor check is completed.

checkType​

checkType: "manual" | "scheduled"

The type of check ("manual" or "scheduled").

monitorId​

monitorId: string

The monitor ID.

result​

result: StatusUpdate

The status update result.

siteIdentifier​

siteIdentifier: string

The identifier of the site the monitor belongs to.

timestamp​

timestamp: number

Unix timestamp (ms) when the check completed.

Param​

The type of check ("manual" or "scheduled").

Param​

The monitor ID.

Param​

The status update result.

Param​

The identifier of the site the monitor belongs to.

Param​

Unix timestamp (ms) when the check completed.

monitor:down​

monitor:down: never | number & StatusUpdate & { monitor: Monitor; site: Site; } & { status: "down"; } | bigint & StatusUpdate & { monitor: Monitor; site: Site; } & { status: "down"; } | false & StatusUpdate & { monitor: Monitor; site: Site; } & { status: "down"; } | true & StatusUpdate & { monitor: Monitor; site: Site; } & { status: "down"; } | symbol & StatusUpdate & { monitor: Monitor; site: Site; } & { status: "down"; } | never | never | Record<PropertyKey, unknown> & { length?: undefined; } & StatusUpdate & { monitor: Monitor; site: Site; } & { status: "down"; }

Defined in: electron/events/eventTypes.ts:1269

Emitted when a monitor goes down.

See​

MonitorDownEventData for payload details.

monitor:manual-check-started​

monitor:manual-check-started: { correlationId: string; monitorId: string; siteIdentifier: string; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1272

Manual check dispatched for a monitor (pre-empts scheduled job).

correlationId​

correlationId: string

monitorId​

monitorId: string

siteIdentifier​

siteIdentifier: string

timestamp​

timestamp: number

monitor:removed​

monitor:removed: { monitorId: string; siteIdentifier: string; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1287

Emitted when a monitor is removed.

monitorId​

monitorId: string

The monitor ID.

siteIdentifier​

siteIdentifier: string

The identifier of the site the monitor belonged to.

timestamp​

timestamp: number

Unix timestamp (ms) when the monitor was removed.

Param​

The monitor ID.

Param​

The identifier of the site the monitor belonged to.

Param​

Unix timestamp (ms) when the monitor was removed.

monitor:schedule-updated​

monitor:schedule-updated: { backoffAttempt: number; correlationId: string; delayMs: number; monitorId: string; siteIdentifier: string; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1297

Scheduler emitted when a monitor job is scheduled or rescheduled.

backoffAttempt​

backoffAttempt: number

correlationId​

correlationId: string

delayMs​

delayMs: number

monitorId​

monitorId: string

siteIdentifier​

siteIdentifier: string

timestamp​

timestamp: number

monitor:status-changed​

monitor:status-changed: never | number & StatusUpdate | bigint & StatusUpdate | false & StatusUpdate | true & StatusUpdate | symbol & StatusUpdate | never | never | Record<PropertyKey, unknown> & { length?: undefined; } & StatusUpdate

Defined in: electron/events/eventTypes.ts:1311

Emitted when a monitor's status changes.

See​

MonitorStatusChangedEventData for payload details.

monitor:timeout​

monitor:timeout: { correlationId: string; monitorId: string; siteIdentifier: string; timeoutMs: number; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1314

Emitted when a monitor check times out before completion.

correlationId​

correlationId: string

monitorId​

monitorId: string

siteIdentifier​

siteIdentifier: string

timeoutMs​

timeoutMs: number

timestamp​

timestamp: number

monitor:up​

monitor:up: never | number & StatusUpdate & { monitor: Monitor; site: Site; } & { status: "up"; } | bigint & StatusUpdate & { monitor: Monitor; site: Site; } & { status: "up"; } | false & StatusUpdate & { monitor: Monitor; site: Site; } & { status: "up"; } | true & StatusUpdate & { monitor: Monitor; site: Site; } & { status: "up"; } | symbol & StatusUpdate & { monitor: Monitor; site: Site; } & { status: "up"; } | never | never | Record<PropertyKey, unknown> & { length?: undefined; } & StatusUpdate & { monitor: Monitor; site: Site; } & { status: "up"; }

Defined in: electron/events/eventTypes.ts:1327

Emitted when a monitor goes up.

See​

MonitorUpEventData for payload details.

monitoring:started​

monitoring:started: UptimeEventPayload<MonitoringStartedEventData>

Defined in: electron/events/eventTypes.ts:1334

Emitted when monitoring is started.

See​

MonitoringControlEventData (shared/types/events) for common metadata fields.

monitoring:stopped​

monitoring:stopped: UptimeEventPayload<MonitoringStoppedEventData>

Defined in: electron/events/eventTypes.ts:1341

Emitted when monitoring is stopped.

See​

MonitoringControlEventData (shared/types/events) for common metadata fields.

notification:sent​

notification:sent: { correlationId: string; monitorId: string; siteIdentifier: string; status: "down" | "up"; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1347

Emitted when a system notification is dispatched for a monitor status change.

correlationId​

correlationId: string

Correlation identifier for the notification emission.

monitorId​

monitorId: string

Identifier of the monitor that triggered the notification.

siteIdentifier​

siteIdentifier: string

Identifier of the site that owns the monitor.

status​

status: "down" | "up"

Monitor status associated with the notification.

timestamp​

timestamp: number

Unix timestamp (ms) when the notification was dispatched.

performance:metric​

performance:metric: { category: "monitoring" | "database" | "system" | "ui"; metric: string; timestamp: number; unit: string; value: number; }

Defined in: electron/events/eventTypes.ts:1370

Emitted when a performance metric is recorded.

category​

category: "monitoring" | "database" | "system" | "ui"

The metric category ("database", "monitoring", "system", or "ui").

metric​

metric: string

The metric name.

timestamp​

timestamp: number

Unix timestamp (ms) when the metric was recorded.

unit​

unit: string

The unit of the metric.

value​

value: number

The value of the metric.

Param​

The metric category ("database", "monitoring", "system", or "ui").

Param​

The metric name.

Param​

Unix timestamp (ms) when the metric was recorded.

Param​

The unit of the metric.

Param​

The value of the metric.

performance:warning​

performance:warning: { actual: number; metric: string; suggestion?: string; threshold: number; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1392

Emitted when a performance warning is triggered.

actual​

actual: number

The actual value that triggered the warning.

metric​

metric: string

The metric name.

suggestion?​

optional suggestion: string

Optional suggestion for remediation.

threshold​

threshold: number

The threshold value for the warning.

timestamp​

timestamp: number

Unix timestamp (ms) when the warning was triggered.

Param​

The actual value that triggered the warning.

Param​

The metric name.

Param​

Optional suggestion for remediation.

Param​

The threshold value for the warning.

Param​

Unix timestamp (ms) when the warning was triggered.

settings:history-limit-updated​

settings:history-limit-updated: UptimeEventPayload<HistoryLimitUpdatedEventData>

Defined in: electron/events/eventTypes.ts:1422

Emitted when the database history retention limit changes.

Remarks​

Forwarded to renderer clients so settings views remain synchronized when imports or backend tooling adjust the configured limit.

See​

HistoryLimitUpdatedEventData for payload structure.

site:added​

site:added: { site: Site; source: "import" | "migration" | "user"; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1424

site​

site: Site

The site object added.

source​

source: "import" | "migration" | "user"

The source of the addition ("import", "migration", or "user").

timestamp​

timestamp: number

Unix timestamp (ms) when the site was added.

site:removed​

site:removed: { cascade: boolean; siteIdentifier: string; siteName: string; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1441

Emitted when a site is removed.

cascade​

cascade: boolean

Whether the removal was cascaded.

siteIdentifier​

siteIdentifier: string

The identifier of the site removed.

siteName​

siteName: string

The name of the site removed.

timestamp​

timestamp: number

Unix timestamp (ms) when the site was removed.

Param​

Whether the removal was cascaded.

Param​

The identifier of the site removed.

Param​

The name of the site removed.

Param​

Unix timestamp (ms) when the site was removed.

site:updated​

site:updated: { previousSite: Site; site: Site; timestamp: number; updatedFields: string[]; }

Defined in: electron/events/eventTypes.ts:1460

Emitted when a site is updated.

previousSite​

previousSite: Site

The previous site object.

site​

site: Site

The updated site object.

timestamp​

timestamp: number

Unix timestamp (ms) when the update occurred.

updatedFields​

updatedFields: string[]

List of updated field names.

Param​

The previous site object.

Param​

The updated site object.

Param​

Unix timestamp (ms) when the update occurred.

Param​

List of updated field names.

sites:state-synchronized​

sites:state-synchronized: { action: "bulk-sync" | "delete" | "update"; delta?: SiteSyncDelta; siteIdentifier?: string; sites: Site[]; source: "cache" | "database" | "frontend"; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1481

Emitted when site state is synchronized.

action​

action: "bulk-sync" | "delete" | "update"

The synchronization action ("bulk-sync", "delete", or "update").

delta?​

optional delta: SiteSyncDelta

Structured delta describing the changes applied by the synchronization.

siteIdentifier?​

optional siteIdentifier: string

Optional site identifier.

sites​

sites: Site[]

Complete dataset snapshot after the synchronization.

source​

source: "cache" | "database" | "frontend"

Source of the synchronization ("cache", "database", or "frontend").

timestamp​

timestamp: number

Unix timestamp (ms) when synchronization occurred.

Param​

The synchronization action ("bulk-sync", "delete", or "update").

Param​

Optional site identifier.

Param​

Optional source of the synchronization ("cache", "database", or "frontend").

Param​

Unix timestamp (ms) when synchronization occurred.

system:error​

system:error: { context: string; error: Error; recovery?: string; severity: "medium" | "critical" | "high" | "low"; timestamp: number; }

Defined in: electron/events/eventTypes.ts:1509

Emitted when a system error occurs.

context​

context: string

The error context string.

error​

error: Error

The error object.

recovery?​

optional recovery: string

Optional recovery suggestion.

severity​

severity: "medium" | "critical" | "high" | "low"

The severity of the error ("critical", "high", "low", or "medium").

timestamp​

timestamp: number

Unix timestamp (ms) when the error occurred.

Param​

The error context string.

Param​

The error object.

Param​

Optional recovery suggestion.

Param​

The severity of the error ("critical", "high", "low", or "medium").

Param​

Unix timestamp (ms) when the error occurred.

system:shutdown​

system:shutdown: { reason: "error" | "update" | "user"; timestamp: number; uptime: number; }

Defined in: electron/events/eventTypes.ts:1529

Emitted when the system is shutting down.

reason​

reason: "error" | "update" | "user"

The reason for shutdown ("error", "update", or "user").

timestamp​

timestamp: number

Unix timestamp (ms) when shutdown started.

uptime​

uptime: number

The system uptime in ms.

Param​

The reason for shutdown ("error", "update", or "user").

Param​

Unix timestamp (ms) when shutdown started.

Param​

The system uptime in ms.

system:startup​

system:startup: { environment: "production" | "development" | "test"; timestamp: number; version: string; }

Defined in: electron/events/eventTypes.ts:1546

Emitted when the system starts up.

environment​

environment: "production" | "development" | "test"

The runtime environment ("development", "production", or "test").

timestamp​

timestamp: number

Unix timestamp (ms) when startup completed.

version​

version: string

The application version string.

Param​

The runtime environment ("development", "production", or "test").

Param​

Unix timestamp (ms) when startup completed.

Param​

The application version string.