// 错误模型。

///|
/// 绑定层错误。
///
/// 前三档与 moonpg 的 `PgError` 同构;`Busy` / `Conflict` 是**可重试信号**,
/// 单列出来是为了让重试助手能用模式匹配判断(而不是匹配错误文本):
///
/// - `Busy`:写锁忙(`TURSO_BUSY`)。
/// - `Conflict`:MVCC 写写冲突(`TURSO_BUSY_SNAPSHOT`),事务已被中止。
///
/// 撞到哪一个**不取决于**你用哪个重试助手,而取决于这条连接的运行模式:
/// 没开 MVCC(或开了 MVCC 但用普通 `BEGIN`)走写者互斥 → `Busy`;
/// MVCC + `BEGIN CONCURRENT` 走乐观并发 → 提交时 `Conflict`。
#derive(Debug)
pub(all) enum SyncErrorKind {
  Network
  Auth
  Protocol
  RemoteBusy
  RemoteConflict
  Internal
}

#derive(Debug)
pub suberror TursoError {
  ConnectionError(String)
  QueryError(String)
  NoRows
  Busy(String)
  Conflict(String)
  SyncError(SyncErrorKind, String)
}

///|
pub fn sync_error(kind : SyncErrorKind, message : String) -> TursoError {
  TursoError::SyncError(kind, message)
}

///|
/// 值转换错误(与数据库错误分开:一个是「取出来的东西不是我想要的类型」,
/// 一个是「数据库那边失败了」)。
pub(all) suberror ValueError {
  ValueError(String)
}