fail method

  1. @override
Future<RegenerationJob> fail(
  1. String id, {
  2. required String leaseToken,
  3. required String errorCode,
  4. DateTime? now,
})
override

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;
});