Get authenticated Gmail API service. Returns: tuple: (service, error_message) - service is None if auth needed

Build Gmail search query from filter parameters. Args: filters: dict with keys: - older_than: '7d', '30d', '90d', '180d', '36

Check if a file exists and is empty. Args: file_path: Path to the file to check. Returns: True if file exists and is empty,

Check if we should use web-based auth (for Docker/headless).

Decode base64 URL-safe encoded email content.

Reset delete scan state.

Reset mark read state.

Reset scan state.

Common helper for applying or removing labels from senders (background task). Args: label_id: The label ID to apply or remove sen

Attempt to refresh expired credentials and save to token file. Args: creds: Credentials that are expired but have a refresh_token. R

Application factory - creates and configures the FastAPI app.

Delete all emails from a specific sender.

Extract sender name and email from headers.

Extract subject from email headers.

Get credentials - from file or create from env var. Returns: Path to valid credentials file, or None if not found or invalid.

Check if user is logged in and get their email.

Create a new Gmail label.

Delete a Gmail label.

Get archive operation status.

Get cache-busting value using a robust strategy: 1. Try git commit hash (most specific) 2. If uncommitted changes exist in static files,

Get delete bulk operation status.

Get delete scan results.

Get delete scan status.

Get the generated CSV data.

Get download operation status (without CSV data).

Extract email body from payload. Prefers text/plain over text/html.

Get mark important operation status.

Get label operation status.

Get all Gmail labels.

Get mark-as-read status.

Get scan results.

Get current scan status.

Get estimated count of unread emails in Inbox (fast, for display).

Extract unsubscribe link from email headers.

Get current web auth status.

Check if authentication is needed.

Reset archive state.

Reset delete bulk state.

Reset download state.

Reset mark important state.

Reset label operation state.

Sign out by removing the token file.

Attempt to unsubscribe from a single sender.

Validate URL to prevent SSRF. Checks scheme and resolves hostname to ensure it's not a local/private IP. Resolves all A and AAAA records

Initialize settings and auto-detect data directory for token persistence.

Initialize the handler with thread-safe callback primitives.

Apply a label to emails from selected senders.

Archive emails from selected senders (remove from inbox).

Get archive operation status.

Get authentication status.

Create a new Gmail label.

Get bulk delete operation status.

Delete emails from a specific sender.

Delete emails from multiple senders (background task with progress).

Delete a Gmail label.

Scan senders for bulk delete.

Get delete scan results (senders grouped by count).

Get delete scan status.

Get the generated CSV file.

Start downloading email metadata for selected senders.

Get download operation status.

Get all Gmail labels.

Get mark important operation status.

Get label operation status (apply/remove).

Mark/unmark emails from selected senders as important.

Mark emails as read.

Get mark-as-read operation status.

Remove a label from emails from selected senders.

Get email scan results.

Start email scan for unsubscribe links.

Trigger OAuth sign-in flow.

Sign out and clear credentials.

Get email scan status.

Get unread email count.

Unsubscribe from a single sender.

Get web auth status for Docker/headless mode.

Apply a label to all emails from specified senders (background task).

Archive emails from selected senders (remove INBOX label).

FastAPI test client.

Delete emails from multiple senders.

Delete emails from multiple senders with progress updates (background task). Optimized to collect all message IDs first, then batch delete in lar