fail method
Implementation
@override
Future<RegenerationJob> fail(
String id, {
required String leaseToken,
required String errorCode,
DateTime? now,
}) => _locked(() async {
final job = await _read(id);
if (job.status != RegenerationJobStatus.processing) {
throw StateError('Only processing jobs can fail.');
}
_checkLeaseToken(job, leaseToken);
if (!RegExp(r'^[a-z0-9_]{1,48}$').hasMatch(errorCode)) {
throw ArgumentError('errorCode must be a safe identifier.');
}
final time = (now ?? DateTime.now()).toUtc();
final exhausted = job.attempts >= job.maxAttempts;
final exponent = job.attempts.clamp(0, 10).toInt();
final delay = Duration(seconds: 1 << exponent);
final updated = job.copyWith(
status: exhausted
? RegenerationJobStatus.failed
: RegenerationJobStatus.queued,
availableAt: time.add(delay),
clearLease: true,
errorCode: errorCode,
);
await _save(updated);
final state = await _syncState();
state.processing.remove(id);
if (!exhausted) {
state.pending.add(id);
} else {
state.pending.remove(id);
}
await _appendJournal({
'seq': ++state.lastSeq,
'op': 'fail',
'id': id,
'token': leaseToken,
'status': updated.status.name,
'availableAt': updated.availableAt.toIso8601String(),
'errorCode': errorCode,
});
return updated;
});