queueItem method

void queueItem(LogEntry item)

Queue an item for syncing.

Implementation

void queueItem(T item) {
  if (!config.enabled || !config.isValid) return;

  // Apply optional filtering
  if (!shouldQueueItem(item)) return;

  _pendingItems.add(item);

  // Enforce max queue size (drop oldest)
  while (_pendingItems.length > config.maxQueueSize) {
    _pendingItems.removeFirst();
  }

  // Check for immediate flush (high-priority items)
  if (shouldFlushImmediately(item)) {
    _flushNow();
    return;
  }

  // Check if batch threshold reached
  if (_pendingItems.length >= config.batchSize) {
    _flushNow();
  }
}