PersistLogUtils

Utility class for managing log entry persistence.

Features:

• Memoized storage instance
• Custom adapter support
• Atomic read/write operations for LogData
• Each log entry stored as separate file keyed by id
• Crash-safe log state management

Used by LogPersistUtils for log entry persistence.

Constructor

constructor();
Copy

Properties

PersistLogFactory

PersistLogFactory: any
Copy

_logStorage

_logStorage: any
Copy

getLogStorage

getLogStorage: any
Copy

readLogData

readLogData: () => Promise<LogData>
Copy

Reads persisted log entries.

Called by LogPersistUtils.waitForInit() to restore state. Uses keys() from PersistBase to iterate over all stored entries. Returns empty array if no entries exist.

writeLogData

writeLogData: (logData: LogData) => Promise<void>
Copy

Writes log entries to disk with atomic file writes.

Called by LogPersistUtils after each log call to persist state. Uses entry.id as the storage key for individual file storage. Uses atomic writes to prevent corruption on crashes.

Methods

usePersistLogAdapter

usePersistLogAdapter(Ctor: TPersistBaseCtor<string, ILogEntry>): void;
Copy

Registers a custom persistence adapter.

useJson

useJson(): void;
Copy

Switches to the default JSON persist adapter. All future persistence writes will use JSON storage.

useDummy

useDummy(): void;
Copy

Switches to a dummy persist adapter that discards all writes. All future persistence writes will be no-ops.