const result = await client.send.email(options: SendEmailOptions): Promise<SendEmailResponse>

interface SendEmailResponse {
  id: string;      // Unique identifier for sent email
  sentAt: number;  // Unix timestamp (milliseconds)
}

const result = await client.send.email({
  to: 'customer@example.com',
  subject: 'Order Confirmation',
  text: 'Your order #12345 has been confirmed!'
});

console.log('Sent:', result.id);
console.log('At:', new Date(result.sentAt));

await client.send.email({
  to: 'customer@example.com',
  subject: 'Order Confirmation',
  html: `
    <h1>Order Confirmed!</h1>
    <p>Your order <strong>#12345</strong> has been confirmed.</p>
    <p>Thank you for your purchase!</p>
  `,
  text: 'Order Confirmed!\n\nYour order #12345 has been confirmed.\nThank you for your purchase!'
});

await client.send.email({
  to: ['admin@example.com', 'manager@example.com'],
  subject: 'Daily Report',
  text: 'Here is the daily report...'
});

await client.send.email({
  to: 'user@example.com',
  subject: 'Support Ticket #456',
  text: 'Your ticket has been created.',
  replyTo: 'support@example.com'
});

const result = await client.send.list(options?: ListSentEmailsOptions): Promise<PaginatedResponse<SentEmail>>

interface SentEmail {
  id: string;
  agentId: string;
  to: string;
  subject: string | null;
  bodyText: string | null;
  bodyHtml: string | null;
  sentAt: number;
  resendId: string | null;  // Resend tracking ID
}

const sent = await client.send.list({ limit: 20 });

console.log(`Sent ${sent.total} emails total`);

for (const email of sent.data) {
  console.log(`To: ${email.to}`);
  console.log(`Subject: ${email.subject}`);
  console.log(`Sent: ${new Date(email.sentAt)}`);
}

async function getAllSentEmails(client: ClawMailClient) {
  const allEmails: SentEmail[] = [];
  let offset = 0;
  const limit = 50;

  while (true) {
    const page = await client.send.list({ limit, offset });
    allEmails.push(...page.data);

    if (page.data.length < limit) break;
    offset += limit;
  }

  return allEmails;
}

const result = await client.send.reply(
  originalEmail: { from: { address: string }; subject?: string },
  content: { text?: string; html?: string }
): Promise<SendEmailResponse>

// Get an email from inbox
const inbox = await client.emails.list({ folder: 'inbox' });
const email = inbox.data[0];

// Send a reply
await client.send.reply(email, {
  text: 'Thank you for your message! We will get back to you shortly.'
});

await client.send.reply(email, {
  html: '<p>Thank you for your message!</p><p>We will get back to you shortly.</p>',
  text: 'Thank you for your message! We will get back to you shortly.'
});

async function autoReply(client: ClawMailClient) {
  const inbox = await client.emails.list({ folder: 'inbox' });

  for (const email of inbox.data) {
    if (!email.isRead) {
      // Send auto-reply
      await client.send.reply(email, {
        text: 'Thanks for reaching out! We received your email and will respond within 24 hours.'
      });

      // Mark as read
      await client.emails.markAsRead(email.id);
    }
  }
}

const results = await client.send.bulk(
  recipients: string[],
  options: Omit<SendEmailOptions, 'to'>
): Promise<SendEmailResponse[]>

const subscribers = [
  'user1@example.com',
  'user2@example.com',
  'user3@example.com'
];

const results = await client.send.bulk(subscribers, {
  subject: 'Monthly Newsletter',
  html: '<h1>Newsletter</h1><p>This month\'s updates...</p>',
  text: 'Newsletter\n\nThis month\'s updates...'
});

console.log(`Sent ${results.length} emails`);

// Check individual results
for (let i = 0; i < results.length; i++) {
  console.log(`${subscribers[i]}: ${results[i].id}`);
}

const count = await client.send.count(): Promise<number>

const sentCount = await client.send.count();
console.log(`Total emails sent: ${sentCount}`);

import { ClawMailRateLimitError } from '@clawmail/client';

try {
  await client.send.email({
    to: 'user@example.com',
    subject: 'Hello',
    text: 'Hi there!'
  });
} catch (error) {
  if (error instanceof ClawMailRateLimitError) {
    if (error.code === 'DAILY_SEND_LIMIT_EXCEEDED') {
      console.log(`Daily limit reached (${error.current}/${error.limit})`);
      console.log(`Resets at: ${error.resetAt}`);
    }
  }
}

import { ClawMailClient, ClawMailRateLimitError } from '@clawmail/client';

async function emailWorkflow(client: ClawMailClient) {
  // 1. Send a notification
  const notification = await client.send.email({
    to: 'admin@example.com',
    subject: 'Daily Report',
    html: `
      <h1>Daily Report</h1>
      <p>Here's your daily summary...</p>
    `,
    text: 'Daily Report\n\nHere\'s your daily summary...'
  });

  console.log('Notification sent:', notification.id);

  // 2. Process inbox and auto-reply
  const inbox = await client.emails.list({ folder: 'inbox' });

  for (const email of inbox.data) {
    if (!email.isRead) {
      try {
        // Reply to each email
        await client.send.reply(email, {
          text: 'Thank you for your message. We\'ll respond soon!'
        });

        // Archive after replying
        await client.emails.archive(email.id);
      } catch (error) {
        if (error instanceof ClawMailRateLimitError) {
          console.log('Rate limit reached, stopping auto-replies');
          break;
        }
        throw error;
      }
    }
  }

  // 3. Check sent history
  const sent = await client.send.list({ limit: 10 });
  console.log(`Recent sends: ${sent.data.length}`);

  for (const email of sent.data) {
    console.log(`- ${email.to}: ${email.subject}`);
  }

  // 4. Get total count
  const totalSent = await client.send.count();
  console.log(`Total emails sent: ${totalSent}`);
}