Skip to main content

Class: ImportDataCommand

Defined in: electron/services/commands/DatabaseCommands.ts:421

Command for importing application data from JSON.

Remarks

Encapsulates the logic for importing data, updating the cache, and emitting a success event. Rollback restores the previous cache state. Validation checks for valid JSON and non-empty input.

Extends

Constructors

Constructor

new ImportDataCommand(serviceFactory: DatabaseServiceFactory, eventEmitter: TypedEventBus<UptimeEvents>, cache: StandardizedCache<Site>, data: string): ImportDataCommand

Defined in: electron/services/commands/DatabaseCommands.ts:494

Parameters

serviceFactory

DatabaseServiceFactory

eventEmitter

TypedEventBus<UptimeEvents>

cache

StandardizedCache<Site>

data

string

Returns

ImportDataCommand

Overrides

DatabaseCommand.constructor

Properties

cache

protected readonly cache: StandardizedCache<Site>

Defined in: electron/services/commands/DatabaseCommands.ts:95

Site cache for data synchronization during operations

Inherited from

DatabaseCommand.cache


eventEmitter

protected readonly eventEmitter: TypedEventBus<UptimeEvents>

Defined in: electron/services/commands/DatabaseCommands.ts:98

Event bus for emitting command execution events

Inherited from

DatabaseCommand.eventEmitter


serviceFactory

protected readonly serviceFactory: DatabaseServiceFactory

Defined in: electron/services/commands/DatabaseCommands.ts:101

Factory for accessing database services and repositories

Inherited from

DatabaseCommand.serviceFactory


backupSites

private backupSites: Site[] = []

Defined in: electron/services/commands/DatabaseCommands.ts:423

Backup of current sites for rollback functionality


data

private readonly data: string

Defined in: electron/services/commands/DatabaseCommands.ts:426

JSON data string to be imported

Methods

emitFailureEvent()

protected emitFailureEvent(eventType: keyof UptimeEvents, error: Error, data: Partial<UptimeEvents[keyof UptimeEvents]>): Promise<void>

Defined in: electron/services/commands/DatabaseCommands.ts:116

Internal

Emits a failure event for the command operation.

Parameters

eventType

keyof UptimeEvents

The event type to emit.

error

Error

The ://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error that occurred.

data

Partial<UptimeEvents[keyof UptimeEvents]> = {}

Additional event data to include in the event payload.

Returns

Promise<void>

Remarks

Used internally to emit a typed event indicating command failure, including error details and additional event data.

Inherited from

DatabaseCommand.emitFailureEvent


emitSuccessEvent()

protected emitSuccessEvent(eventType: keyof UptimeEvents, data: Partial<UptimeEvents[keyof UptimeEvents]>): Promise<void>

Defined in: electron/services/commands/DatabaseCommands.ts:141

Internal

Emits a success event for the command operation.

Parameters

eventType

keyof UptimeEvents

The event type to emit.

data

Partial<UptimeEvents[keyof UptimeEvents]>

Additional event data to include in the event payload.

Returns

Promise<void>

Remarks

Used internally to emit a typed event indicating command success, including additional event data.

Inherited from

DatabaseCommand.emitSuccessEvent


execute()

execute(): Promise<boolean>

Defined in: electron/services/commands/DatabaseCommands.ts:428

Executes the command operation.

Returns

Promise<boolean>

Promise resolving to the operation result.

Remarks

Performs the main database operation encapsulated by the command.

Throws

When command execution fails.

Overrides

DatabaseCommand.execute


rollback()

rollback(): Promise<void>

Defined in: electron/services/commands/DatabaseCommands.ts:459

Rolls back the command operation if possible.

Returns

Promise<void>

Promise resolving when rollback is complete.

Remarks

Attempts to revert the effects of the command. Not all commands require rollback.

Overrides

DatabaseCommand.rollback


validate()

validate(): Promise<{ errors: string[]; isValid: boolean; }>

Defined in: electron/services/commands/DatabaseCommands.ts:468

Validates the command before execution.

Returns

Promise<{ errors: string[]; isValid: boolean; }>

Promise resolving to validation result.

Remarks

Ensures the command is in a valid state before execution. Returns a validation result with errors if any.

Overrides

DatabaseCommand.validate


getDescription()

getDescription(): string

Defined in: electron/services/commands/DatabaseCommands.ts:504

Gets a description of the command for logging and debugging.

Returns

string

Human-readable command description.

Overrides

DatabaseCommand.getDescription