import: bound the memory an IMAP or EWS import holds

Two things let a large mailbox fill memory. IMAP workers handed every
fetched message to the archive writer through an unbounded queue, so fast
workers could hold whole folders' worth of bodies while the single writer
caught up. And fetch batches were sized by count only: 20 items per EWS
GetItem, 8 connections at a time, is a few megabytes of ordinary mail and
several gigabytes of large attachments.

- The IMAP event queue is bounded at two events per worker, so a worker
  waits for the writer instead of running ahead of it.
- Fetch batches are bounded by bytes as well as by count, with a shared
  helper, `sync::batch::by_count_and_bytes`: 32 MiB by default, and a
  single larger message goes alone.
  - IMAP learns each new message's RFC822.SIZE on the control connection,
    in 1000-UID metadata fetches, before the body fetch. A server that won't
    say leaves the chunks sized by count. `--fetch-batch-mib` sets the cap.
  - EWS asks FindItem for `item:Size` and packs GetItem batches by it,
    fetched `--ews-connections` batches at a time. `--ews-getitem-batch-mib`
    sets the cap. Items from an incremental SyncFolderItems run carry no
    size and stay batched by count.
- docs/usage.md describes both options.

src/sync/import_exchange_ews/contacts.rs

@@ -1,5 +1,6 @@
 /*
  * SPDX-FileCopyrightText: 2020 Stalwart Labs LLC <[email protected]>
+ * SPDX-FileCopyrightText: 2026 John Coffey <[email protected]>
  *
  * SPDX-License-Identifier: Apache-2.0 OR MIT
  */
@@ -96,40 +97,41 @@ fn reconcile_one(
         to_fetch.push(id.clone());
     }
     if !to_fetch.is_empty() {
-        let failed_items = for_each_fetched_item(ctx, ItemShape::Contact, &to_fetch, |msg| {
-            if !msg.success {
-                if matches!(
-                    msg.response_code,
-                    crate::exchange_ews::types::ResponseCode::ItemNotFound
-                ) {
-                    counts.skipped += 1;
-                } else {
-                    counts.failed += 1;
-                    ctx.logger
-                        .warn(&format!("GetItem (contact) error: {}", msg.response_code));
+        let failed_items =
+            for_each_fetched_item(ctx, ItemShape::Contact, &to_fetch, &outcome.sizes, |msg| {
+                if !msg.success {
+                    if matches!(
+                        msg.response_code,
+                        crate::exchange_ews::types::ResponseCode::ItemNotFound
+                    ) {
+                        counts.skipped += 1;
+                    } else {
+                        counts.failed += 1;
+                        ctx.logger
+                            .warn(&format!("GetItem (contact) error: {}", msg.response_code));
+                    }
+                    return Ok(());
                 }
-                return Ok(());
-            }
-            let parsed = parse_contact_item(&msg.inner_xml).map_err(Error::from)?;
-            if parsed.id.id.is_empty() {
-                counts.failed += 1;
-                return Ok(());
-            }
-            let existing = plan
-                .present_changed
-                .iter()
-                .find(|(id, _)| id.id == parsed.id.id)
-                .map(|(_, local)| *local);
-            apply_contact(
-                conn,
-                ctx,
-                &parsed,
-                local_folder_id,
-                &folder.id,
-                existing,
-                counts,
-            )
-        })?;
+                let parsed = parse_contact_item(&msg.inner_xml).map_err(Error::from)?;
+                if parsed.id.id.is_empty() {
+                    counts.failed += 1;
+                    return Ok(());
+                }
+                let existing = plan
+                    .present_changed
+                    .iter()
+                    .find(|(id, _)| id.id == parsed.id.id)
+                    .map(|(_, local)| *local);
+                apply_contact(
+                    conn,
+                    ctx,
+                    &parsed,
+                    local_folder_id,
+                    &folder.id,
+                    existing,
+                    counts,
+                )
+            })?;
         counts.failed += failed_items;
     }
     delete_vanished(