import 'package:flutter/foundation.dart'; /// Persisted synchronization lifecycle. enum SyncStatus { localOnly, queued, waitingForNetwork, uploading, synced, failed, retryWait, authRequired, cancelled; bool get isTerminal => this == synced || this == failed || this == cancelled; bool get isPending => this == queued || this == waitingForNetwork || this == retryWait || this == authRequired; bool get isInProgress => this == uploading; } /// Immutable outbox item. Raw telemetry is never stored here. @immutable class SyncItem { static const int schemaVersion = 2; final int localRideId; final String providerId; final SyncStatus status; final DateTime createdAt; final int attemptCount; final DateTime? lastAttemptAt; final DateTime? nextRetryAt; final DateTime? uploadedAt; final String? remoteId; final String? lastError; final String? bundleLocalPath; const SyncItem({ required this.localRideId, required this.providerId, this.status = SyncStatus.queued, required this.createdAt, this.attemptCount = 0, this.lastAttemptAt, this.nextRetryAt, this.uploadedAt, this.remoteId, this.lastError, this.bundleLocalPath, }); /// Stable logical identity for one ride/provider destination. String get key => '$providerId:$localRideId'; /// Stable idempotency identity shared by retries and app restarts. String get idempotencyKey => key; bool isEligibleForAttempt(DateTime now) { if (status.isTerminal || status == SyncStatus.uploading) return false; if (status == SyncStatus.retryWait && nextRetryAt != null) { return !now.isBefore(nextRetryAt!); } return true; } SyncItem copyWith({ int? localRideId, String? providerId, SyncStatus? status, DateTime? createdAt, int? attemptCount, DateTime? lastAttemptAt, DateTime? nextRetryAt, DateTime? uploadedAt, String? remoteId, String? lastError, String? bundleLocalPath, bool clearLastError = false, bool clearNextRetry = false, bool clearRemoteId = false, bool clearUploadedAt = false, }) { return SyncItem( localRideId: localRideId ?? this.localRideId, providerId: providerId ?? this.providerId, status: status ?? this.status, createdAt: createdAt ?? this.createdAt, attemptCount: attemptCount ?? this.attemptCount, lastAttemptAt: lastAttemptAt ?? this.lastAttemptAt, nextRetryAt: clearNextRetry ? null : (nextRetryAt ?? this.nextRetryAt), uploadedAt: clearUploadedAt ? null : (uploadedAt ?? this.uploadedAt), remoteId: clearRemoteId ? null : (remoteId ?? this.remoteId), lastError: clearLastError ? null : (lastError ?? this.lastError), bundleLocalPath: bundleLocalPath ?? this.bundleLocalPath, ); } Map toJson() => { 'schemaVersion': schemaVersion, 'localRideId': localRideId, 'providerId': providerId, 'status': status.name, 'createdAt': createdAt.toIso8601String(), 'attemptCount': attemptCount, 'lastAttemptAt': lastAttemptAt?.toIso8601String(), 'nextRetryAt': nextRetryAt?.toIso8601String(), 'uploadedAt': uploadedAt?.toIso8601String(), 'remoteId': remoteId, 'lastError': lastError, 'bundleLocalPath': bundleLocalPath, }; factory SyncItem.fromJson(Map json) { final localRideId = (json['localRideId'] as num?)?.toInt(); final providerId = json['providerId']; final createdAtRaw = json['createdAt']; if (localRideId == null || localRideId <= 0 || providerId is! String || providerId.trim().isEmpty || createdAtRaw is! String) { throw const FormatException('Invalid sync item identity or createdAt'); } final statusName = json['status'] as String?; final status = SyncStatus.values.firstWhere( (e) => e.name == statusName, orElse: () => SyncStatus.queued, ); final createdAt = DateTime.tryParse(createdAtRaw); if (createdAt == null) throw const FormatException('Invalid sync item createdAt'); DateTime? parseDate(String key) { final value = json[key]; if (value == null) return null; if (value is! String) throw FormatException('Invalid $key'); return DateTime.tryParse(value); } final attempts = (json['attemptCount'] as num?)?.toInt() ?? 0; if (attempts < 0) throw const FormatException('Negative attemptCount'); return SyncItem( localRideId: localRideId, providerId: providerId.trim(), status: status, createdAt: createdAt, attemptCount: attempts, lastAttemptAt: parseDate('lastAttemptAt'), nextRetryAt: parseDate('nextRetryAt'), uploadedAt: parseDate('uploadedAt'), remoteId: json['remoteId'] as String?, lastError: json['lastError'] as String?, bundleLocalPath: json['bundleLocalPath'] as String?, ); } @override bool operator ==(Object other) => identical(this, other) || other is SyncItem && localRideId == other.localRideId && providerId == other.providerId && status == other.status && attemptCount == other.attemptCount && nextRetryAt == other.nextRetryAt && remoteId == other.remoteId && lastError == other.lastError; @override int get hashCode => Object.hash(localRideId, providerId, status, attemptCount, nextRetryAt, remoteId, lastError); @override String toString() => 'SyncItem(ride: $localRideId, provider: $providerId, status: ${status.name}, attempts: $attemptCount, nextRetry: $nextRetryAt)'; } @immutable class SyncResult { final bool success; final String? remoteId; final String? errorMessage; final bool isRetryable; final bool requiresAuth; final DateTime timestamp; SyncResult({ required this.success, this.remoteId, this.errorMessage, this.isRetryable = true, this.requiresAuth = false, DateTime? timestamp, }) : timestamp = timestamp ?? DateTime.now(); SyncResult.success({required String remoteId, DateTime? timestamp}) : this(success: true, remoteId: remoteId, isRetryable: false, requiresAuth: false, timestamp: timestamp); SyncResult.temporaryFailure(String message, {DateTime? timestamp}) : this(success: false, errorMessage: message, isRetryable: true, timestamp: timestamp); SyncResult.permanentFailure(String message, {DateTime? timestamp}) : this(success: false, errorMessage: message, isRetryable: false, timestamp: timestamp); SyncResult.authRequired({String message = 'Authentication credentials required for sync', DateTime? timestamp}) : this(success: false, errorMessage: message, isRetryable: true, requiresAuth: true, timestamp: timestamp); @override String toString() => 'SyncResult(success: $success, remoteId: $remoteId, error: $errorMessage, retryable: $isRetryable, auth: $requiresAuth)'; } @immutable class SyncManagerState { final bool isProcessing; final int pendingCount; final int syncedCount; final int failedCount; final DateTime? lastSuccessfulSync; final String? lastError; final String activeProviderId; const SyncManagerState({ this.isProcessing = false, this.pendingCount = 0, this.syncedCount = 0, this.failedCount = 0, this.lastSuccessfulSync, this.lastError, this.activeProviderId = 'none', }); }