@emailthing/cli 0.0.0-alpha.1

package/README.md

@@ -0,0 +1,24 @@
+<h1 align="center">
+  <a href="https://emailthing.app/home" target="_blank">
+    <img src="https://emailthing.app/logo.png" alt="EmailThing Logo" width="84">
+  </a>
+  <br>
+  EmailThing (CLI)
+</h1>
+
+An interactive terminal email client with AI agent mode for email automation.
+
+Modes:
+* Normal interactive: navigate mailboxes, read and compose emails from your terminal
+* Agent mode: let your agent interact with your emails via command line
+
+> Note: This package requires [Bun](https://bun.com/) as its runtime.
+
+```sh
+$ bunx @emailthing/cli
+# Welcome to EmailThing CLI!
+# <interactive terminal UI starts here>
+
+$ bunx @emailthing/cli agent list # see your email list
+$ bunx @emailthing/cli agent email id12345 # see that email
+```

package/dist/agent.js

@@ -0,0 +1,359 @@
+#!/usr/bin/env bun
+// @bun
+import {
+  EmailThingCLI,
+  syncData
+} from "./index-xp4bqj3r.js";
+import {
+  getDB,
+  loadAuth
+} from "./config-cfsae2jm.js";
+import"./index-afyvwmt5.js";
+
+// src/agent.ts
+import { parseArgs } from "util";
+async function main() {
+  let { values: globalValues, positionals: rootPositionals } = parseArgs({
+    options: {
+      help: { type: "boolean", short: "h", default: !1 },
+      sync: { type: "boolean", default: !1 }
+    },
+    allowPositionals: !0,
+    strict: !1,
+    allowNegative: !0
+  }), agentIndex = rootPositionals.findIndex((arg) => arg === "--agent" || arg === "agent"), subcmd = rootPositionals[agentIndex + 1], subcmdArgs = rootPositionals.slice(agentIndex + 2);
+  if (globalValues.help || !subcmd || !["list", "email", "sync"].includes(subcmd)) {
+    let nowIso = (/* @__PURE__ */ new Date()).toISOString();
+    console.log(`
+EmailThing CLI - Agent Mode
+
+AI-friendly command-line interface for email automation.
+
+Usage:
+  bunx @emailthing/cli agent <subcommand> [options]
+
+Subcommands:
+  list          List recent emails (default: 25)
+  email <id>    Show full email by ID (body, etc)
+  sync          Force fresh sync from server
+
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+
+agent list [filters]:
+  --unread          Show only unread emails
+  --read            Show only read emails
+  --starred         Show only starred emails
+  --from=<email>    Filter by sender
+  --subject=<text>  Search subject only
+  --search=<query>  Search subject, from, and body
+  --categoryid=<id> Filter by category
+  --before=<date>   Emails before ISO date
+  --after=<date>    Emails after ISO date
+  --limit=<n>       Number of emails to return (default: 25)
+  --offset=<n>      Skip first N emails (pagination)
+  --json            Output as JSON (default: plain text)
+  --count           Only show count of matching emails
+  --fields=a,b,c    Show only specific fields (id,from,subject,date,snippet)
+  --sync            Force a sync of emails before listing (recommended if new mail expected)
+
+agent email <id>:
+  --json            Output complete email as JSON
+  --fields=a,b,c    Show only those fields
+  --sync            Force sync before showing email details
+
+agent sync:
+  Triggers sync with server to update local cache
+  (No other options needed)
+
+Global Options:
+  -h, --help        Show this help message
+  --sync            Force fresh sync before any subcommand
+
+Examples:
+  bunx @emailthing/cli agent list --unread --limit=10 --sync
+  bunx @emailthing/cli agent email abc123xyz789example456id --json --sync
+  bunx @emailthing/cli agent sync
+
+Output Format:
+  List mode:
+    Email 1:
+      ID: abc123           # Use this ID with 'agent email <id>'
+      From: sender@example.com
+      Subject: Your 2FA code
+      Date: ${nowIso}
+      Read: No
+      Category: Security (cat123)
+      Snippet: Your code is 123456...
+  Detail mode:
+    Email Details:
+      ID: abc123
+      From: sender@example.com
+      To: you@example.com
+      CC: (none)
+      Subject: Your 2FA code
+      Date: ${nowIso}
+      Read: Yes
+      Starred: No
+      Body:
+        Your verification code is: 123456
+        This code expires in 10 minutes.
+`), process.exit(0);
+  }
+  let db = getDB(), client = new EmailThingCLI, auth = loadAuth(db);
+  if (!auth)
+    console.error("Error: Not authenticated. Please run the CLI first to login."), process.exit(1);
+  client.setAuth(auth.token, auth.refreshToken, auth.tokenExpiresAt);
+  let syncState = db.query("SELECT lastSync FROM sync_state WHERE id = 1").get(), lastSyncTime = syncState?.lastSync ? new Date(syncState.lastSync).getTime() : 0, TEN_MINUTES_MS = 600000, tenMinutesAgo = Date.now() - TEN_MINUTES_MS;
+  if (globalValues.sync || lastSyncTime < tenMinutesAgo)
+    try {
+      await syncData(client, db, !1);
+    } catch (error) {
+      console.error("Sync failed:", error instanceof Error ? error.message : error), console.error("Showing stale cached data...");
+    }
+  if (subcmd === "sync") {
+    let db2 = getDB(), client2 = new EmailThingCLI, auth2 = loadAuth(db2);
+    if (!auth2)
+      console.error("Error: Not authenticated. Please run the CLI first to login."), process.exit(1);
+    client2.setAuth(auth2.token, auth2.refreshToken, auth2.tokenExpiresAt), await syncData(client2, db2, !1), console.log("Sync complete. Local cache updated."), db2.close(), process.exit(0);
+  }
+  if (subcmd === "email") {
+    let parseResult = parseArgs({
+      options: {
+        json: { type: "boolean", default: !1 },
+        fields: { type: "string" },
+        sync: { type: "boolean", default: !1 }
+      },
+      allowPositionals: !0,
+      strict: !0,
+      allowNegative: !0
+    }), values = { ...parseResult.values }, positionals = parseResult.positionals, emailId = positionals[positionals.findIndex((arg) => arg === "email") + 1], syncFlag = globalValues.sync || values.sync, db2 = getDB(), client2 = new EmailThingCLI, auth2 = loadAuth(db2);
+    if (!auth2)
+      console.error("Error: Not authenticated. Please run the CLI first to login."), process.exit(1);
+    if (client2.setAuth(auth2.token, auth2.refreshToken, auth2.tokenExpiresAt), syncFlag)
+      await syncData(client2, db2, !1);
+    if (!emailId)
+      console.error(`Error: You must provide an email ID.
+Usage: bunx @emailthing/cli agent email <id>`), process.exit(1);
+    let jsonOutput = values.json, fields = values.fields ? values.fields.split(",") : void 0, email = db2.query(`
+          SELECT
+            e.*,
+            c.name as categoryName
+          FROM emails e
+            LEFT JOIN categories c
+              ON e.categoryId = c.id AND c.isDeleted = 0
+          WHERE e.id = ?
+        `).get(emailId);
+    if (!email)
+      console.error(`Error: Email ${emailId} not found`), process.exit(1);
+    if (jsonOutput) {
+      let emailData = {
+        id: email.id,
+        mailboxId: email.mailboxId,
+        mailboxAddress: email.mailboxAddress,
+        from: email.from_addr,
+        to: email.to_addr,
+        cc: email.cc,
+        bcc: email.bcc,
+        replyTo: email.replyTo,
+        subject: email.subject,
+        body: email.body,
+        html: email.html,
+        snippet: email.snippet,
+        isRead: email.isRead === 1,
+        isStarred: email.isStarred === 1,
+        createdAt: email.createdAt,
+        categoryId: email.categoryId,
+        categoryName: email.categoryName,
+        headers: email.headers ? JSON.parse(email.headers) : null
+      }, output = emailData;
+      if (fields)
+        output = fields.reduce((acc, f) => {
+          if (f in emailData)
+            acc[f] = emailData[f];
+          return acc;
+        }, {});
+      console.log(JSON.stringify(output, null, 2));
+    } else {
+      let lines = [
+        "Email Details:",
+        `  ID: ${email.id}`,
+        `  From: ${email.from_addr}`,
+        `  To: ${email.to_addr}`,
+        `  CC: ${email.cc || "(none)"}`,
+        `  Subject: ${email.subject || "(no subject)"}`,
+        `  Date: ${email.createdAt}`,
+        `  Read: ${email.isRead === 1 ? "Yes" : "No"}`,
+        `  Starred: ${email.isStarred === 1 ? "Yes" : "No"}`,
+        email.categoryName ? `  Category: ${email.categoryName} (${email.categoryId})` : "",
+        "  Body:"
+      ], body = (email.body || email.html || "(empty)").split(`
+`).map((line) => "    " + line).join(`
+`);
+      if (lines.push(body), fields)
+        lines = ["Email Details:"], fields.forEach((f) => {
+          if (f === "body")
+            lines.push(`Body:
+${body}`);
+          else if (f in email)
+            lines.push(`  ${f}: ${email[f]}`);
+        });
+      console.log(lines.join(`
+`));
+    }
+    db2.close();
+    return;
+  }
+  if (subcmd === "list") {
+    let values = { ...parseArgs({
+      options: {
+        unread: { type: "boolean" },
+        read: { type: "boolean" },
+        starred: { type: "boolean" },
+        from: { type: "string" },
+        subject: { type: "string" },
+        search: { type: "string" },
+        categoryid: { type: "string" },
+        before: { type: "string" },
+        after: { type: "string" },
+        limit: { type: "string", default: "25" },
+        offset: { type: "string", default: "0" },
+        json: { type: "boolean", default: !1 },
+        count: { type: "boolean", default: !1 },
+        fields: { type: "string" },
+        sync: { type: "boolean", default: !1 }
+      },
+      allowPositionals: !0,
+      strict: !0,
+      allowNegative: !0
+    }).values }, db2 = getDB(), client2 = new EmailThingCLI, auth2 = loadAuth(db2);
+    if (!auth2)
+      console.error("Error: Not authenticated. Please run the CLI first to login."), process.exit(1);
+    client2.setAuth(auth2.token, auth2.refreshToken, auth2.tokenExpiresAt);
+    let limit = values.limit ? parseInt(values.limit) : 25, offset = values.offset ? parseInt(values.offset) : 0, fields = values.fields ? values.fields.split(",") : void 0, query = `
+          SELECT
+        e.id,
+        e.subject,
+        e.from_addr,
+        e.snippet,
+        e.isRead,
+        e.isStarred,
+        e.createdAt,
+        e.categoryId,
+        c.name as categoryName
+          FROM emails e
+            LEFT JOIN categories c
+                ON e.categoryId = c.id AND c.isDeleted = 0
+          WHERE 1=1
+        `, extraFilters = { query: "", params: [] }, params = [];
+    if (values.before)
+      extraFilters.query += " AND e.createdAt < ?", extraFilters.params.push(values.before);
+    if (values.after)
+      extraFilters.query += " AND e.createdAt > ?", extraFilters.params.push(values.after);
+    if (values.search) {
+      extraFilters.query += " AND (e.subject LIKE ? OR e.from_addr LIKE ? OR e.body LIKE ?)";
+      let searchPattern = `%${values.search}%`;
+      extraFilters.params.push(searchPattern, searchPattern, searchPattern);
+    }
+    if (values.categoryid)
+      extraFilters.query += " AND e.categoryId = ?", extraFilters.params.push(values.categoryid);
+    if (values.unread !== void 0)
+      extraFilters.query += " AND e.isRead = 0";
+    if (values.read !== void 0)
+      extraFilters.query += " AND e.isRead = 1";
+    if (values.starred !== void 0)
+      extraFilters.query += " AND e.isStarred = 1";
+    if (values.from)
+      extraFilters.query += " AND e.from_addr LIKE ?", extraFilters.params.push(`%${values.from}%`);
+    if (values.subject)
+      extraFilters.query += " AND e.subject LIKE ?", extraFilters.params.push(`%${values.subject}%`);
+    query += extraFilters.query, params.push(...extraFilters.params), query += " ORDER BY e.createdAt DESC LIMIT ? OFFSET ?", params.push(limit, offset);
+    let emails = db2.query(query).all(...params), countQuery = "SELECT COUNT(*) as total FROM emails e WHERE 1=1";
+    countQuery += extraFilters.query;
+    let totalResult = db2.query(countQuery).get(...extraFilters.params), totalPages = Math.ceil(totalResult.total / limit), currentPage = Math.floor(offset / limit) + 1, hasMore = offset + emails.length < totalResult.total;
+    if (values.count) {
+      if (values.json)
+        console.log(JSON.stringify({ count: totalResult.total }));
+      else
+        console.log(totalResult.total);
+      db2.close();
+      return;
+    }
+    if (values.json) {
+      let emailsData = emails.map((e) => {
+        let baseEmail = {
+          id: e.id,
+          from: e.from_addr,
+          subject: e.subject,
+          date: e.createdAt,
+          isRead: e.isRead === 1,
+          isStarred: e.isStarred === 1,
+          snippet: e.snippet
+        };
+        if (e.categoryName)
+          baseEmail.category = { id: e.categoryId, name: e.categoryName };
+        if (fields) {
+          let filtered = {};
+          return fields.forEach((field) => {
+            if (field in baseEmail)
+              filtered[field] = baseEmail[field];
+          }), filtered;
+        }
+        return baseEmail;
+      });
+      console.log(JSON.stringify({
+        count: emails.length,
+        total: totalResult.total,
+        limit,
+        offset,
+        hasMore,
+        emails: emailsData
+      }, null, 2)), db2.close();
+      return;
+    }
+    let aliases = db2.query("SELECT * FROM mailbox_aliases WHERE `default` = 1 AND isDeleted = 0").all();
+    console.log(`Email List:
+
+For mailboxes: ${aliases.map((a) => a.alias).join(", ")} (default aliases)
+
+Showing ${emails.length} of ${totalResult.total} emails (page ${currentPage}/${totalPages})
+${hasMore ? `Next page: --offset=${offset + limit} --limit=${limit}` : "No more emails"}
+`), emails.forEach((email, idx) => {
+      let absoluteNumber = offset + idx + 1;
+      if (fields) {
+        let output = [`Email ${absoluteNumber}:`];
+        if (fields.includes("id"))
+          output.push(`  ID: ${email.id}`);
+        if (fields.includes("from"))
+          output.push(`  From: ${email.from_addr}`);
+        if (fields.includes("subject"))
+          output.push(`  Subject: ${email.subject || "(no subject)"}`);
+        if (fields.includes("date"))
+          output.push(`  Date: ${email.createdAt}`);
+        if (fields.includes("snippet"))
+          output.push(`  Snippet: ${email.snippet?.replaceAll(`
+`, " ")?.trim() || "(no preview)"}`);
+        console.log(output.join(`
+`) + `
+`);
+        return;
+      }
+      let categoryInfo = email.categoryName ? `
+  Category: ${email.categoryName} (${email.categoryId})` : "";
+      console.log(`Email ${absoluteNumber}:
+  ID: ${email.id}
+  From: ${email.from_addr}
+  Subject: ${email.subject || "(no subject)"}
+  Date: ${email.createdAt}
+  Read: ${email.isRead === 1 ? "Yes" : "No"}
+  Starred: ${email.isStarred === 1 ? "Yes" : "No"}${categoryInfo}
+  Snippet: ${email.snippet?.replaceAll(`
+`, " ")?.trim() || "(no preview)"}
+
+`);
+    }), db2.close();
+    return;
+  }
+}
+main().catch((error) => {
+  console.error("Error:", error.message, error instanceof Error ? error.stack : error), process.exit(1);
+});

package/dist/config-cfsae2jm.js

@@ -0,0 +1,154 @@
+// @bun
+import"./index-afyvwmt5.js";
+
+// src/utils/config.ts
+import { join } from "path";
+import { homedir } from "os";
+import { existsSync, mkdirSync } from "fs";
+
+// src/db/schema.ts
+import { Database } from "bun:sqlite";
+function initDB(dbPath) {
+  let db = new Database(dbPath);
+  db.run("PRAGMA journal_mode = WAL;");
+  let currentVersion = db.query("PRAGMA user_version").get().user_version;
+  if (db.run(`
+    CREATE TABLE IF NOT EXISTS auth (
+      id INTEGER PRIMARY KEY CHECK (id = 1),
+      token TEXT NOT NULL,
+      refreshToken TEXT NOT NULL,
+      tokenExpiresAt TEXT NOT NULL,
+      refreshTokenExpiresAt TEXT NOT NULL,
+      userId TEXT NOT NULL,
+      mailboxes TEXT NOT NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS emails (
+      id TEXT PRIMARY KEY,
+      mailboxId TEXT NOT NULL,
+      subject TEXT,
+      from_addr TEXT,
+      to_addr TEXT,
+      cc TEXT,
+      bcc TEXT,
+      replyTo TEXT,
+      body TEXT,
+      html TEXT,
+      snippet TEXT,
+      isRead BOOLEAN DEFAULT FALSE,
+      isStarred BOOLEAN DEFAULT FALSE,
+      createdAt TEXT NOT NULL,
+      headers TEXT,
+      raw TEXT,
+      categoryId TEXT,
+      isDeleted BOOLEAN DEFAULT FALSE
+    );
+
+    CREATE TABLE IF NOT EXISTS mailboxes (
+      id TEXT PRIMARY KEY,
+      isDeleted BOOLEAN DEFAULT FALSE
+    );
+
+    CREATE TABLE IF NOT EXISTS categories (
+      id TEXT PRIMARY KEY,
+      mailboxId TEXT NOT NULL,
+      name TEXT NOT NULL,
+      color TEXT,
+      order_num INTEGER DEFAULT 0,
+      isDeleted BOOLEAN DEFAULT FALSE
+    );
+
+    CREATE TABLE IF NOT EXISTS drafts (
+      id TEXT PRIMARY KEY,
+      mailboxId TEXT NOT NULL,
+      subject TEXT,
+      body TEXT,
+      html TEXT,
+      to_addr TEXT,
+      cc TEXT,
+      bcc TEXT,
+      from_addr TEXT,
+      updatedAt TEXT NOT NULL,
+      isDeleted BOOLEAN DEFAULT FALSE
+    );
+
+    CREATE TABLE IF NOT EXISTS mailbox_aliases (
+      id TEXT PRIMARY KEY,
+      mailboxId TEXT NOT NULL,
+      alias TEXT NOT NULL,
+      name TEXT,
+      createdAt TEXT NOT NULL,
+      updatedAt TEXT NOT NULL,
+      "default" BOOLEAN DEFAULT FALSE,
+      isDeleted BOOLEAN DEFAULT FALSE
+    );
+    CREATE INDEX IF NOT EXISTS idx_aliases_mailboxId ON mailbox_aliases(mailboxId);
+
+    CREATE TABLE IF NOT EXISTS sync_state (
+      id INTEGER PRIMARY KEY CHECK (id = 1),
+      lastSync TEXT
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_emails_mailbox ON emails(mailboxId);
+    CREATE INDEX IF NOT EXISTS idx_emails_created ON emails(createdAt);
+    CREATE INDEX IF NOT EXISTS idx_categories_mailbox ON categories(mailboxId);
+  `), currentVersion < 1) {
+    try {
+      db.run("ALTER TABLE emails ADD COLUMN categoryId TEXT");
+    } catch (e) {}
+    db.run("PRAGMA user_version = 1");
+  }
+  return db;
+}
+
+// src/utils/config.ts
+var CONFIG_DIR = join(homedir(), ".emailthing"), DB_PATH = join(CONFIG_DIR, "data.db");
+function ensureConfigDir() {
+  if (!existsSync(CONFIG_DIR))
+    mkdirSync(CONFIG_DIR, { recursive: !0 });
+}
+function getDB() {
+  return ensureConfigDir(), initDB(DB_PATH);
+}
+function loadAuth(db) {
+  let auth = db.query("SELECT * FROM auth WHERE id = 1").get();
+  return auth ? {
+    token: auth.token,
+    refreshToken: auth.refreshToken,
+    tokenExpiresAt: auth.tokenExpiresAt,
+    refreshTokenExpiresAt: auth.refreshTokenExpiresAt,
+    userId: auth.userId,
+    mailboxes: JSON.parse(auth.mailboxes)
+  } : null;
+}
+function saveAuth(db, auth) {
+  db.run(`
+    INSERT OR REPLACE INTO auth (id, token, refreshToken, tokenExpiresAt, refreshTokenExpiresAt, userId, mailboxes)
+    VALUES (1, ?, ?, ?, ?, ?, ?)
+  `, [
+    auth.token,
+    auth.refreshToken,
+    auth.tokenExpiresAt,
+    auth.refreshTokenExpiresAt,
+    auth.userId,
+    JSON.stringify(auth.mailboxes)
+  ]);
+}
+function clearAuth(db) {
+  db.run("DELETE FROM auth WHERE id = 1");
+}
+function resetDB(db) {
+  db.run("DELETE FROM auth"), db.run("DELETE FROM emails"), db.run("DELETE FROM mailboxes"), db.run("DELETE FROM categories"), db.run("DELETE FROM drafts"), db.run("DELETE FROM mailbox_aliases"), db.run("DELETE FROM sync_state");
+}
+export {
+  saveAuth,
+  resetDB,
+  loadAuth,
+  getDB,
+  ensureConfigDir,
+  clearAuth,
+  DB_PATH,
+  CONFIG_DIR
+};
+
+export { getDB, loadAuth, saveAuth };

package/dist/index-afyvwmt5.js

@@ -0,0 +1,47 @@
+// @bun
+var __create = Object.create;
+var { getPrototypeOf: __getProtoOf, defineProperty: __defProp, getOwnPropertyNames: __getOwnPropNames } = Object;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  let to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: !0 }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: !0
+      });
+  return to;
+};
+var __require = import.meta.require, __using = (stack, value, async) => {
+  if (value != null) {
+    if (typeof value !== "object" && typeof value !== "function")
+      throw TypeError('Object expected to be assigned to "using" declaration');
+    let dispose;
+    if (async)
+      dispose = value[Symbol.asyncDispose];
+    if (dispose === void 0)
+      dispose = value[Symbol.dispose];
+    if (typeof dispose !== "function")
+      throw TypeError("Object not disposable");
+    stack.push([async, dispose, value]);
+  } else if (async)
+    stack.push([async]);
+  return value;
+}, __callDispose = (stack, error, hasError) => {
+  let fail = (e) => error = hasError ? new SuppressedError(e, error, "An error was suppressed during disposal") : (hasError = !0, e), next = (it) => {
+    while (it = stack.pop())
+      try {
+        var result = it[1] && it[1].call(it[2]);
+        if (it[0])
+          return Promise.resolve(result).then(next, (e) => (fail(e), next()));
+      } catch (e) {
+        fail(e);
+      }
+    if (hasError)
+      throw error;
+  };
+  return next();
+};
+
+export { __toESM, __require, __using, __callDispose };