/api/qmail/db/messages/list

const API_BASE = 'http://localhost:8082/api';

const FOLDERS = { 0: 'Inbox', 1: 'Sent', 2: 'Drafts', 3: 'Trash', 4: 'Starred', 5: 'Archive' };

async function listInbox(folder = 0, limit = 50, offset = 0) {
    try {
        const params = new URLSearchParams({
            folder: folder,
            limit: limit,
            offset: offset
        });

        const response = await fetch(`${API_BASE}/qmail/db/messages/list?${params}`);
        const data = await response.json();

        if (data.success) {
            console.log(`Folder: ${FOLDERS[data.folder]}`);
            console.log(`Showing ${data.count} of ${data.total_in_folder} emails`);
            console.log(`Unread across all folders: ${data.unread_count}`);

            data.emails.forEach(email => {
                const status = email.is_read ? 'Read' : 'UNREAD';
                const star = email.is_starred ? ' *' : '';
                // Prefer the resolved contact name; fall back to the address, then the SN.
                const who = email.sender_name || email.sender_address || `SN ${email.sender_sn}`;
                const fav = email.sender_is_favorite ? ' [FAV]' : '';
                console.log(`[${status}${star}] ${email.subject} — from ${who}${fav}`);
                console.log(`  Preview: ${email.body_preview}`);
            });
        } else {
            console.error('Request failed:', data.message);
        }

        return data;
    } catch (error) {
        console.error('Error fetching inbox:', error);
    }
}

// List inbox
listInbox();

// List sent folder, page 2
// listInbox(1, 50, 50);

import requests

API_BASE = 'http://localhost:8082/api'

FOLDERS = {0: 'Inbox', 1: 'Sent', 2: 'Drafts', 3: 'Trash', 4: 'Starred', 5: 'Archive'}

def list_inbox(folder=0, limit=50, offset=0):
    """Retrieve a paginated list of emails from a folder."""
    params = {
        'folder': folder,
        'limit': limit,
        'offset': offset
    }

    response = requests.get(f'{API_BASE}/qmail/db/messages/list', params=params)
    data = response.json()

    if data.get('success'):
        print(f"Folder: {FOLDERS.get(data['folder'], 'Unknown')}")
        print(f"Showing {data['count']} of {data['total_in_folder']} emails")
        print(f"Unread across all folders: {data['unread_count']}")

        for email in data['emails']:
            status = 'Read' if email['is_read'] else 'UNREAD'
            star = ' *' if email['is_starred'] else ''
            # Prefer the resolved contact name; fall back to the address, then the SN.
            who = email.get('sender_name') or email.get('sender_address') or f"SN {email['sender_sn']}"
            fav = ' [FAV]' if email.get('sender_is_favorite') else ''
            print(f"[{status}{star}] {email['subject']} — from {who}{fav}")
            print(f"  Preview: {email['body_preview']}")
    else:
        print(f"Request failed: {data.get('message')}")

    return data

# List inbox
list_inbox()

# List sent folder, page 2
# list_inbox(folder=1, limit=50, offset=50)