// AK-P16a · conflict resolution decision (PURE) — Last-Write-Wins (M25 Block F). // // When a calendar event changed on BOTH sides between two syncs, HiveGrid resolves // with Last-Write-Wins and tells the user in Klartext (DoD 4). This module holds // the DECISION only (no DB, no network) so it is unit-tested in isolation; the // ConflictResolver service applies the decision (persist + notify + conflict-log). // // Default tie-breaker: the EXTERNAL provider wins (M25 Block F-1) — the user can // then manually re-apply their HiveGrid edit from the Klartext notification. /** Mirror of the Prisma enum CalendarConflictResolution (kept in sync). */ export type ConflictResolution = "external_won" | "hivegrid_won" | "external_deleted" | "hivegrid_deleted"; export interface ConflictInput { /** Last HiveGrid-side modification (null = unknown/never). */ readonly internalLastModified: Date | null; /** Last external modification reported by the provider (null = unknown). */ readonly externalLastModified: Date | null; /** The HiveGrid-internal event was deleted. */ readonly internalDeleted: boolean; /** The external mirror was deleted/cancelled at the provider. */ readonly externalDeleted: boolean; } export interface ConflictDecision { readonly resolution: ConflictResolution; /** Which side's state should be applied. `none` = no content overwrite. */ readonly winner: "external" | "hivegrid" | "none"; /** i18n key for the Klartext conflict-log entry + notification (M002/M003). */ readonly descriptionKey: string; } /** * Decide a single event conflict. Deletion beats edit; otherwise the most-recent * write wins, with the external provider winning ties (authoritative default). */ export function resolveConflict(input: ConflictInput): ConflictDecision { // Deletion cases first — a delete is a terminal state, not a timestamp race. if (input.externalDeleted && !input.internalDeleted) { // External mirror gone; the HiveGrid event stays (e.g. a Booking still exists). return { resolution: "external_deleted", winner: "none", descriptionKey: "calendar.conflict.externalDeleted" }; } if (input.internalDeleted) { // HiveGrid event deleted → push the delete to the external mirror. return { resolution: "hivegrid_deleted", winner: "hivegrid", descriptionKey: "calendar.conflict.hivegridDeleted" }; } const internalAt = input.internalLastModified?.getTime() ?? 0; const externalAt = input.externalLastModified?.getTime() ?? 0; if (internalAt > externalAt) { return { resolution: "hivegrid_won", winner: "hivegrid", descriptionKey: "calendar.conflict.hivegridWon" }; } // external newer OR tie → external wins (authoritative default, M25 Block F-1). return { resolution: "external_won", winner: "external", descriptionKey: "calendar.conflict.externalWon" }; }