Skip to main content

Interface: UptimeEvents

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

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

  • UnknownRecord

Indexable

[key: string]: unknown

[key: number]: unknown

[key: symbol]: unknown

Properties

cache:invalidated

cache:invalidated: { identifier?: string; reason: "delete" | "expiry" | "manual" | "update"; timestamp: number; type: "all" | "monitor" | "site"; }

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

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

identifier?

optional identifier: string

Optional unique identifier for the cache entry.

Remarks

Specifies which cache entry was invalidated when the invalidation is targeted to a specific entry rather than a broad invalidation.

reason

reason: "delete" | "expiry" | "manual" | "update"

Reason for invalidation.

Remarks

Indicates why the cache was invalidated: "delete" for item removal, "expiry" for TTL timeout, "manual" for user-initiated refresh, or "update" for data changes.

timestamp

timestamp: number

Unix timestamp (ms) when invalidation occurred.

Remarks

Provides precise timing for invalidation events to support debugging and audit trails.

type

type: "all" | "monitor" | "site"

Type of cache invalidated.

Remarks

Specifies the scope of invalidation: "all" for full cache clear, "monitor" for monitor-specific cache, or "site" for site-specific cache.

Remarks

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

Param

Optional unique identifier for the cache entry.

Param

Reason for invalidation ("delete", "expiry", "manual", or "update").

Param

Unix timestamp (ms) when invalidation occurred.

Param

Type of cache invalidated ("all", "monitor", or "site").


config:changed

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

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

Emitted when a configuration setting is changed.

newValue

newValue: unknown

The new value of the setting.

Remarks

Contains the updated value after the configuration change. Type is unknown to support any configuration value type.

oldValue

oldValue: unknown

The previous value of the setting.

Remarks

Contains the value before the configuration change for comparison and potential rollback scenarios.

setting

setting: string

The name of the setting that changed.

Remarks

Identifies which specific configuration setting was modified. Used for targeted event handling and change tracking.

source

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

The origin of the change.

Remarks

Indicates what initiated the configuration change: "migration" for database migrations, "system" for automatic updates, or "user" for manual changes.

timestamp

timestamp: number

Unix timestamp (ms) when the change occurred.

Remarks

Provides precise timing for configuration changes to support debugging and audit trails.

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" | "shutdown" | "scheduled"; }

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

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" | "shutdown" | "scheduled"

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

database:error: {[key: string]: unknown; error: Error; operation: string; timestamp: number; }

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

Emitted when a database error occurs.

Index Signature

[key: string]: unknown

error

error: Error

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]: unknown; attempt: number; operation: string; timestamp: number; }

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

Emitted when a database operation is retried after failure.

Index Signature

[key: string]: unknown

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]: unknown; duration?: number; operation: string; timestamp: number; }

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

Emitted when a database operation succeeds.

Index Signature

[key: string]: unknown

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; operation: string; recordsAffected?: number; success: boolean; timestamp: number; }

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

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.

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.


internal:database:backup-downloaded

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

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

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:data-exported

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

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

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

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

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

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

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

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

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

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

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

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

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

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"; timestamp: number; }

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

Emitted when a monitor is started.

identifier

identifier: string

monitorId?

optional monitorId: string

operation

operation: "started"

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; timestamp: number; }

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

Emitted when a monitor is stopped.

identifier

identifier: string

monitorId?

optional monitorId: string

operation

operation: "stopped"

reason

reason: EventReason

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; timestamp: number; }

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

Emitted when a site is added internally.

identifier

identifier: string

operation

operation: "added"

site

site: Site

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-updated

internal:site:cache-updated: { identifier: string; operation: "cache-updated"; timestamp: number; }

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

Emitted when a site's cache is updated internally.

identifier

identifier: string

operation

operation: "cache-updated"

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

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

monitorId: string

The 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

The 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:906

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: { identifier: string; operation: "removed"; timestamp: number; }

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

Emitted when a site is removed internally.

identifier

identifier: string

operation

operation: "removed"

timestamp

timestamp: number

Param

The unique identifier for the site.

Param

The operation type (always "removed").

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

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

Emitted in response to a restart monitoring request.

identifier

identifier: string

The unique identifier for the site.

monitorId

monitorId: string

The 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

The 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:984

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:stop-monitoring-requested

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

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

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

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

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

Emitted when a site is updated internally.

identifier

identifier: string

The unique identifier for the site.

operation

operation: "updated"

The operation type (always "updated").

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

Unix timestamp (ms) when the update occurred.

Param

Optional list of updated field names.


monitor:added

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

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

Emitted when a monitor is added.

monitor

monitor: Monitor

The monitor object added.

siteId

siteId: string

The ID 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 ID of the site the monitor belongs to.

Param

Unix timestamp (ms) when the monitor was added.


monitor:check-completed

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

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

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.

siteId

siteId: string

The ID 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 ID of the site the monitor belongs to.

Param

Unix timestamp (ms) when the check completed.


monitor:down

monitor:down: { monitor: Monitor; site: Site; siteId: string; timestamp: number; }

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

Emitted when a monitor goes down.

monitor

monitor: Monitor

The monitor object.

site

site: Site

The site object.

siteId

siteId: string

The ID of the site.

timestamp

timestamp: number

Unix timestamp (ms) when the monitor went down.

Param

The monitor object.

Param

The site object.

Param

The ID of the site.

Param

Unix timestamp (ms) when the monitor went down.


monitor:removed

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

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

Emitted when a monitor is removed.

monitorId

monitorId: string

The monitor ID.

siteId

siteId: string

The ID of the site the monitor belonged to.

timestamp

timestamp: number

Unix timestamp (ms) when the monitor was removed.

Param

The monitor ID.

Param

The ID of the site the monitor belonged to.

Param

Unix timestamp (ms) when the monitor was removed.


monitor:status-changed

monitor:status-changed: { monitor: Monitor; newStatus: string; previousStatus: string; responseTime?: number; site: Site; siteId: string; timestamp: number; }

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

Emitted when a monitor's status changes.

monitor

monitor: Monitor

The monitor object.

newStatus

newStatus: string

The new status string.

previousStatus

previousStatus: string

The previous status string.

responseTime?

optional responseTime: number

Optional response time in ms.

site

site: Site

The site object.

siteId

siteId: string

The ID of the site.

timestamp

timestamp: number

Unix timestamp (ms) when the status changed.

Param

The monitor object.

Param

The new status string.

Param

The previous status string.

Param

Optional response time in ms.

Param

The site object.

Param

The ID of the site.

Param

Unix timestamp (ms) when the status changed.


monitor:up

monitor:up: { monitor: Monitor; site: Site; siteId: string; timestamp: number; }

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

Emitted when a monitor goes up.

monitor

monitor: Monitor

The monitor object.

site

site: Site

The site object.

siteId

siteId: string

The ID of the site.

timestamp

timestamp: number

Unix timestamp (ms) when the monitor went up.

Param

The monitor object.

Param

The site object.

Param

The ID of the site.

Param

Unix timestamp (ms) when the monitor went up.


monitoring:started

monitoring:started: { monitorCount: number; siteCount: number; timestamp: number; }

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

Emitted when monitoring is started.

monitorCount

monitorCount: number

The number of monitors started.

siteCount

siteCount: number

The number of sites involved.

timestamp

timestamp: number

Unix timestamp (ms) when monitoring started.

Param

The number of monitors started.

Param

The number of sites involved.

Param

Unix timestamp (ms) when monitoring started.


monitoring:stopped

monitoring:stopped: { activeMonitors: number; reason: "error" | "shutdown" | "user"; timestamp: number; }

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

Emitted when monitoring is stopped.

activeMonitors

activeMonitors: number

The number of monitors that were active.

reason

reason: "error" | "shutdown" | "user"

The reason for stopping.

timestamp

timestamp: number

Unix timestamp (ms) when monitoring stopped.

Param

The number of monitors that were active.

Param

The reason for stopping.

Param

Unix timestamp (ms) when monitoring stopped.


performance:metric

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

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

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

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.


site:added

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

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

Emitted when a site is added.

site

site: Site

The site object added.

source

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

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

timestamp

timestamp: number

Unix timestamp (ms) when the site was added.

Param

The site object added.

Param

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

Param

Unix timestamp (ms) when the site was added.


site:cache-miss

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

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

Emitted when a site cache miss occurs.

backgroundLoading

backgroundLoading: boolean

Whether background loading is in progress.

identifier

identifier: string

The unique identifier for the site.

operation

operation: "cache-lookup"

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

timestamp

timestamp: number

Unix timestamp (ms) when the cache miss occurred.

Param

Whether background loading is in progress.

Param

The unique identifier for the site.

Param

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

Param

Unix timestamp (ms) when the cache miss occurred.


site:cache-updated

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

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

Emitted when a site's cache is updated.

identifier

identifier: string

The unique identifier for the site.

operation

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

The operation type ("background-load", "cache-updated", or "manual-refresh").

timestamp

timestamp: number

Unix timestamp (ms) when the cache was updated.

Param

The unique identifier for the site.

Param

The operation type ("background-load", "cache-updated", or "manual-refresh").

Param

Unix timestamp (ms) when the cache was updated.


site:removed

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

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

Emitted when a site is removed.

cascade

cascade: boolean

Whether the removal was cascaded.

siteId

siteId: string

The ID 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 ID 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:1317

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: "delete" | "update" | "bulk-sync"; siteIdentifier?: string; source?: "cache" | "database" | "frontend"; timestamp: number; }

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

Emitted when site state is synchronized.

action

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

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

siteIdentifier?

optional siteIdentifier: string

Optional site identifier.

source?

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

Optional 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:1362

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: "update" | "error" | "user"; timestamp: number; uptime: number; }

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

Emitted when the system is shutting down.

reason

reason: "update" | "error" | "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: "development" | "production" | "test"; timestamp: number; version: string; }

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

Emitted when the system starts up.

environment

environment: "development" | "production" | "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.