enqueue method

  1. @override
Future<RegenerationJob> enqueue({
  1. required String siteId,
  2. required String tenantId,
  3. required String path,
  4. required String routeId,
  5. required List<String> tags,
  6. required String idempotencyKey,
  7. String? sourceVersion,
  8. int maxAttempts = 5,
  9. DateTime? now,
})
override

Implementation

@override
Future<RegenerationJob> enqueue({
  required String siteId,
  required String tenantId,
  required String path,
  required String routeId,
  required List<String> tags,
  required String idempotencyKey,
  String? sourceVersion,
  int maxAttempts = 5,
  DateTime? now,
}) async => _locked(() async {
  _validateId(siteId, 'siteId');
  _validateId(tenantId, 'tenantId');
  _validateId(routeId, 'routeId');
  _validateId(idempotencyKey, 'idempotencyKey');
  final normalized = _normalizeQueuePath(path);
  if (tags.any(
    (tag) => tag.trim().isEmpty || tag.length > 200 || tag.contains('\u0000'),
  )) {
    throw const FormatException('Invalid job dependency tag.');
  }
  if (maxAttempts < 1 || maxAttempts > 20) {
    throw ArgumentError('maxAttempts must be between 1 and 20.');
  }

  final state = await _syncState();
  final composite = '$siteId|$tenantId|$idempotencyKey';
  final existingId = state.idempotency[composite];
  if (existingId != null) {
    final existing = await _tryRead(existingId);
    if (existing != null &&
        existing.status != RegenerationJobStatus.cancelled) {
      return existing;
    }
  }

  final created = (now ?? DateTime.now()).toUtc();
  final id = '${created.microsecondsSinceEpoch}_${pid}_${_queueNonce()}';
  final seq = ++state.lastSeq;
  final job = RegenerationJob(
    id: id,
    siteId: siteId,
    tenantId: tenantId,
    path: normalized,
    routeId: routeId,
    tags: List.unmodifiable(tags.toSet().toList()..sort()),
    idempotencyKey: idempotencyKey,
    sourceVersion: sourceVersion,
    status: RegenerationJobStatus.queued,
    attempts: 0,
    maxAttempts: maxAttempts,
    createdAt: created,
    availableAt: created,
    sequence: seq,
  );

  await _save(job);
  state.idempotency[composite] = id;
  state.pending.add(id);

  await _appendJournal({
    'seq': seq,
    'op': 'enqueue',
    'id': id,
    'composite': composite,
    'time': created.toIso8601String(),
  });

  if (state.lastSeq % 1000 == 0) {
    await _checkpointInternal();
  }

  return job;
});