IPersistBase

Persistence interface for custom adapters. Defines only the essential CRUD operations required for persistence. Custom adapters should implement this interface.

Architecture:

• IPersistBase: Public API for custom adapters (5 methods: waitForInit, readValue, hasValue, writeValue, keys)
• PersistBase: Default implementation with keys() method for validation and iteration
• TPersistBaseCtor: Constructor type requiring IPersistBase

Methods

waitForInit

waitForInit: (initial: boolean) => Promise<void>
Copy

Initialize persistence directory and validate existing files. Uses singleshot to ensure one-time execution.

readValue

readValue: (entityId: EntityId) => Promise<Entity>
Copy

Read entity from persistence storage.

hasValue

hasValue: (entityId: EntityId) => Promise<boolean>
Copy

Check if entity exists in storage.

writeValue

writeValue: (entityId: EntityId, entity: Entity) => Promise<void>
Copy

Write entity to storage with atomic file writes.

keys

keys: () => AsyncGenerator<EntityId, any, any>
Copy

Async generator yielding all entity IDs. Sorted alphanumerically. Used for iteration and validation.