Errors

Stable error codes:

ADAPTER_UNAVAILABLE
AUTH_FAILED
CAPABILITY_MISSING
SESSION_NOT_FOUND
SESSION_EXPIRED
BASELINE_CONFLICT
PROMOTE_FAILED
WRITE_REJECTED
EVICTION_RACE
METADATA_VERSION_UNSUPPORTED

Error classes:

class GittrixError extends Error { code: string }
class AdapterUnavailableError extends GittrixError
class AuthError extends GittrixError
class CapabilityMissingError extends GittrixError
class SessionNotFoundError extends GittrixError
class SessionExpiredError extends GittrixError
class BaselineConflictError extends GittrixError
class PromoteFailedError extends GittrixError
class WriteRejectedError extends GittrixError
class EvictionRaceError extends GittrixError
class MetadataVersionError extends GittrixError

Baseline conflict shape:

class BaselineConflictError extends GittrixError {
  code: 'BASELINE_CONFLICT'
  conflictingFiles: string[]
  durableSha: string
  baselineSha: string
}

Promotion failures include a stage:

class PromoteFailedError extends GittrixError {
  code: 'PROMOTE_FAILED'
  stage: 'staging' | 'apply' | 'cleanup'
  cause: Error
}