47 lines
1.5 KiB
TypeScript
47 lines
1.5 KiB
TypeScript
|
import { ISync, EntityType, SyncStatus } from '../types/CalendarTypes';
|
||
|
|
|
||
|
|
/**
|
||
|
|
* IEntityService<T> - Generic interface for entity services with sync capabilities
|
||
|
|
*
|
||
|
|
* All entity services (Event, Booking, Customer, Resource) implement this interface
|
||
|
|
* to enable polymorphic sync status management in SyncManager.
|
||
|
|
*
|
||
|
|
* ENCAPSULATION: Services encapsulate sync status manipulation.
|
||
|
|
* SyncManager does NOT directly manipulate entity.syncStatus - it delegates to the service.
|
||
|
|
*
|
||
|
|
* POLYMORFI: SyncManager works with Array<IEntityService<any>> and uses
|
||
|
|
* entityType property for runtime routing, avoiding switch statements.
|
||
|
|
*/
|
||
|
|
export interface IEntityService<T extends ISync> {
|
||
|
|
/**
|
||
|
|
* Entity type discriminator for runtime routing
|
||
|
|
* Must match EntityType values: 'Event', 'Booking', 'Customer', 'Resource'
|
||
|
|
*/
|
||
|
|
readonly entityType: EntityType;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Mark entity as successfully synced with backend
|
||
|
|
* Sets syncStatus = 'synced' and persists to IndexedDB
|
||
|
|
*
|
||
|
|
* @param id - Entity ID
|
||
|
|
*/
|
||
|
|
markAsSynced(id: string): Promise<void>;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Mark entity as sync error (max retries exceeded)
|
||
|
|
* Sets syncStatus = 'error' and persists to IndexedDB
|
||
|
|
*
|
||
|
|
* @param id - Entity ID
|
||
|
|
*/
|
||
|
|
markAsError(id: string): Promise<void>;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Get current sync status for an entity
|
||
|
|
* Used by SyncManager to check entity state
|
||
|
|
*
|
||
|
|
* @param id - Entity ID
|
||
|
|
* @returns SyncStatus or null if entity not found
|
||
|
|
*/
|
||
|
|
getSyncStatus(id: string): Promise<SyncStatus | null>;
|
||
|
|
}
|