Interface IPersistBase<Entity>

Persistence interface for CRUD operations. Implemented by PersistBase.

interface IPersistBase<Entity extends IEntity = IEntity> {
    hasValue(entityId: EntityId): Promise<boolean>;
    readValue(entityId: EntityId): Promise<Entity>;
    waitForInit(initial: boolean): Promise<void>;
    writeValue(entityId: EntityId, entity: Entity): Promise<void>;
}

Type Parameters

Entity extends IEntity = IEntity

Index

Methods

hasValue readValue waitForInit writeValue

Methods

hasValue

hasValue(entityId: EntityId): Promise<boolean>
Check if entity exists in storage.
Parameters
- entityId: EntityId
  Unique entity identifier
Returns Promise<boolean>
Promise resolving to true if exists, false otherwise
- Defined in types.d.ts:4636

readValue

readValue(entityId: EntityId): Promise<Entity>
Read entity from persistence storage.
Parameters
- entityId: EntityId
  Unique entity identifier
Returns Promise<Entity>
Promise resolving to entity data

Throws
Error if entity not found or read fails
- Defined in types.d.ts:4629

waitForInit

waitForInit(initial: boolean): Promise<void>
Initialize persistence directory and validate existing files. Uses singleshot to ensure one-time execution.
Parameters
- initial: boolean
  Whether this is the first initialization
Returns Promise<void>
Promise that resolves when initialization is complete
- Defined in types.d.ts:4621

writeValue

writeValue(entityId: EntityId, entity: Entity): Promise<void>
Write entity to storage with atomic file writes.
Parameters
- entityId: EntityId
  Unique entity identifier
- entity: Entity
  Entity data to persist
Returns Promise<void>
Promise that resolves when write is complete

Throws
Error if write fails
- Defined in types.d.ts:4645