enqueue method
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,
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;
});