recover method
Recovers persistent queue state by validating journal entries and reconciling stored jobs.
Implementation
@override
Future<QueueRecoveryReport> recover() => _locked(() async {
var corruptedEntriesDiscarded = 0;
var recoveredJobs = 0;
// 1. Truncate incomplete journal line if present
if (await _journalFile.exists()) {
final bytes = await _journalFile.readAsBytes();
if (bytes.isNotEmpty && bytes.last != 10) {
final lastNewline = bytes.lastIndexOf(10);
if (lastNewline >= 0) {
await _journalFile.writeAsBytes(
bytes.sublist(0, lastNewline + 1),
flush: true,
);
corruptedEntriesDiscarded++;
} else {
await _journalFile.delete();
corruptedEntriesDiscarded++;
}
}
}
// 2. Reload state
_state = null;
final state = await _syncState();
// 3. Scan jobs directory for unindexed or uncommitted jobs
final diskJobs = await _allJobs();
for (final job in diskJobs) {
if (job.status == RegenerationJobStatus.queued) {
final composite = '${job.siteId}|${job.tenantId}|${job.idempotencyKey}';
if (!state.idempotency.containsKey(composite) ||
!state.pending.contains(job.id)) {
state.idempotency[composite] = job.id;
state.pending.add(job.id);
recoveredJobs++;
}
} else if (job.status == RegenerationJobStatus.processing &&
job.leaseUntil != null) {
if (!state.processing.containsKey(job.id)) {
state.processing[job.id] = job.leaseUntil!;
recoveredJobs++;
}
}
}
await _checkpointInternal();
return QueueRecoveryReport(
journalEntriesReplayed: state.lastSeq,
recoveredJobs: recoveredJobs,
corruptedEntriesDiscarded: corruptedEntriesDiscarded,
rebuiltFromDisk: true,
activePendingCount: state.pending.length,
activeProcessingCount: state.processing.length,
idempotencyCount: state.idempotency.length,
);
});