zele 0.3.15 → 0.3.17

package/README.md

@@ -2,14 +2,14 @@
     <br/>
     <br/>
     <h3>zele</h3>
-    <p>Manage emails & calendar from your terminal. For you and your agents</p>
+    <p>Email & Calendar CLI — Gmail, IMAP/SMTP, Google Calendar. For you and your agents</p>
     <br/>
     <br/>
 </div>
 
 ## Install
 
-Multi-account Gmail and Google Calendar client with OAuth2 auth, SQLite cache, and YAML output.
+Multi-account email and calendar client supporting **Google OAuth** and **IMAP/SMTP** (Fastmail, Outlook, any provider). SQLite cache, YAML output.
 
 Requires [bun](https://bun.sh):
 
@@ -24,14 +24,53 @@ bun install -g zele
 
 ## Setup
 
+### Google accounts
+
 ```bash
 zele login
 ```
 
 Opens a browser for Google OAuth2. Repeat to add more accounts.
 
+### IMAP/SMTP accounts
+
+For non-Google providers (Fastmail, Outlook, Gmail with app passwords, any IMAP server):
+
+```bash
+# Fastmail
+zele login imap \
+  --email you@fastmail.com \
+  --imap-host imap.fastmail.com --imap-port 993 \
+  --smtp-host smtp.fastmail.com --smtp-port 465 \
+  --password "your-app-password"
+
+# Gmail (app password)
+zele login imap \
+  --email you@gmail.com \
+  --imap-host imap.gmail.com --imap-port 993 \
+  --smtp-host smtp.gmail.com --smtp-port 465 \
+  --password "your-app-password"
+
+# Outlook
+zele login imap \
+  --email you@outlook.com \
+  --imap-host outlook.office365.com --imap-port 993 \
+  --smtp-host smtp-mail.outlook.com --smtp-port 587 \
+  --password "your-password"
+
+# IMAP-only (no sending)
+zele login imap \
+  --email reader@example.com \
+  --imap-host imap.example.com --imap-port 993 \
+  --password "pass"
+```
+
+Use `--imap-user` / `--smtp-user` if the login username differs from your email. Omit `--smtp-host` for read-only access.
+
+### Account management
+
 ```bash
-zele whoami         # show authenticated accounts
+zele whoami         # show authenticated accounts (type, capabilities)
 zele logout         # remove credentials
 ```
 
@@ -41,6 +80,7 @@ zele logout         # remove credentials
 
 ```bash
 zele mail list                    # list recent threads
+zele mail list --filter "is:unread"  # only unread threads
 zele mail search "from:github"   # search with Gmail query syntax
 zele mail read <thread-id>       # read a thread
 zele mail send                    # send an email
@@ -59,46 +99,44 @@ zele mail trash <thread-id>
 zele mail untrash <thread-id>
 zele mail read-mark <thread-id>
 zele mail unread-mark <thread-id>
+zele mail spam <thread-id>
+zele mail unspam <thread-id>
 zele mail label <thread-id>
 zele mail trash-spam
 ```
 
 ### Search query syntax
 
-`mail search` and `mail watch --query` use [Gmail search operators](https://support.google.com/mail/answer/7190). `mail search` sends the query server-side (full Gmail support), while `mail watch --query` evaluates a subset client-side.
-
-| Operator | Example | Description |
-|---|---|---|
-| `from:` | `from:github` | Messages from a sender |
-| `to:` | `to:me@example.com` | Messages sent to a recipient |
-| `cc:` | `cc:team@example.com` | Messages where recipient was CC'd |
-| `subject:` | `subject:invoice` | Messages with words in the subject |
-| `is:unread` | `is:unread` | Unread messages |
-| `is:read` | `is:read` | Read messages |
-| `is:starred` | `is:starred` | Starred messages |
-| `has:attachment` | `has:attachment` | Messages with attachments (heuristic in watch) |
-| `-` (negate) | `-from:noreply` | Exclude matching messages |
-| `" "` (quotes) | `"exact phrase"` | Match an exact phrase |
-| `label:` | `label:work` | Messages with a specific label (search only) |
-| `in:` | `in:sent` | Messages in a folder (search only) |
-| `after:` | `after:2024/01/01` | Messages after a date (search only) |
-| `before:` | `before:2024/12/31` | Messages before a date (search only) |
-| `newer_than:` | `newer_than:7d` | Messages newer than a period (search only) |
-| `older_than:` | `older_than:1m` | Messages older than a period (search only) |
-| `filename:` | `filename:pdf` | Attachment filename (search only) |
-| `size:` / `larger:` / `smaller:` | `larger:5M` | Filter by message size (search only) |
-| `OR` | `from:a OR from:b` | Match either term (search only) |
-| `{ }` | `{from:a from:b}` | Group OR terms (search only) |
-
-Combine multiple operators to narrow results:
+For **Google accounts**, `mail search` and `mail list --filter` use [Gmail search operators](https://support.google.com/mail/answer/7190) server-side. For **IMAP accounts**, queries are translated to IMAP SEARCH criteria (a subset is supported).
+
+| Operator | Example | Google | IMAP |
+|---|---|---|---|
+| `from:` | `from:github` | yes | yes |
+| `to:` | `to:me@example.com` | yes | yes |
+| `subject:` | `subject:invoice` | yes | yes |
+| `is:unread` | `is:unread` | yes | yes |
+| `is:starred` | `is:starred` | yes | yes |
+| `has:attachment` | `has:attachment` | yes | yes |
+| `newer_than:` | `newer_than:7d` | yes | yes |
+| `older_than:` | `older_than:1m` | yes | yes |
+| `after:` | `after:2024/01/01` | yes | yes |
+| `before:` | `before:2024/12/31` | yes | yes |
+| `cc:` | `cc:team@example.com` | yes | no |
+| `-` (negate) | `-from:noreply` | yes | no |
+| `" "` (quotes) | `"exact phrase"` | yes | no |
+| `label:` | `label:work` | yes | no |
+| `in:` | `in:sent` | yes | no |
+| `filename:` | `filename:pdf` | yes | no |
+| `size:` / `larger:` / `smaller:` | `larger:5M` | yes | no |
+| `OR` / `{ }` | `from:a OR from:b` | yes | no |
 
 ```bash
+zele mail list --filter "is:unread"
+zele mail list --filter "from:github newer_than:7d" --folder sent
 zele mail search "from:github is:unread newer_than:7d"
 zele mail watch --query "from:github has:attachment"
 ```
 
-Operators marked **(search only)** are handled server-side by Gmail and only available in `mail search`. Using them in `mail watch --query` prints a warning and skips the operator.
-
 ### Drafts
 
 ```bash
@@ -108,7 +146,7 @@ zele draft send <draft-id>
 zele draft delete <draft-id>
 ```
 
-### Labels
+### Labels (Google only)
 
 ```bash
 zele label list
@@ -117,7 +155,13 @@ zele label create <name>
 zele label delete <label-id>
 ```
 
-### Calendar
+### Filters (Google only)
+
+```bash
+zele mail filter list
+```
+
+### Calendar (Google only)
 
 ```bash
 zele cal list                     # list calendars
@@ -130,6 +174,24 @@ zele cal respond <event-id>       # accept/decline
 zele cal freebusy                 # check availability
 ```
 
+#### Shared / subscribed calendars
+
+Zele uses Google CalDAV for calendar access. By default, Google only syncs calendars you **own** over CalDAV — shared or subscribed calendars (e.g. a partner's calendar) won't appear in `zele cal list` even after accepting the share invitation.
+
+To fix this, visit Google's CalDAV sync settings and enable the shared calendar:
+
+1. Open **https://www.google.com/calendar/syncselect** (logged in as the account you use with zele)
+2. Check the box next to any shared calendar you want to access
+3. Click **Save**
+
+After that, `zele cal list` will show the shared calendar and you can query it:
+
+```bash
+zele cal events --calendar "other-person@gmail.com" --week
+```
+
+> **Why is this needed?** Google's CalDAV endpoint only exposes calendars marked for sync (originally designed for mobile device sync). The Google Calendar web UI uses a different internal API, so calendars visible there may not appear via CalDAV until explicitly enabled at the sync settings page.
+
 ### Attachments
 
 ```bash
@@ -147,6 +209,24 @@ zele profile                      # show account info
 
 All commands support `--account <email>` to filter by account. Without it, commands fetch from all accounts and merge results.
 
+Google and IMAP/SMTP accounts work side by side — `mail list` merges results from both. Google-only features (labels, filters, calendar) show a helpful error when used with IMAP accounts.
+
+### Feature compatibility
+
+| Feature | Google | IMAP/SMTP |
+|---|---|---|
+| List, read, search emails | yes | yes |
+| Send, reply, forward | yes | yes (requires SMTP) |
+| Star, archive, trash, mark read | yes | yes |
+| Drafts | yes | yes |
+| Attachments | yes | yes |
+| Watch for new emails | yes | yes |
+| Date/sender/subject filters | yes | yes |
+| Labels | yes | no (IMAP uses folders) |
+| Filters | yes | no |
+| Calendar | yes | no |
+| Gmail search operators | full | subset (see table above) |
+
 ## Output
 
 All structured data is output as YAML. In TTY mode, keys are colored for readability. Pipe output to other tools for scripting.

package/dist/api-utils.d.ts

@@ -46,10 +46,17 @@ declare const ApiError_base: errore.FactoryTaggedErrorClass<"ApiError", "API cal
 /** Returned when a non-auth, non-ratelimit API call fails. */
 export declare class ApiError extends ApiError_base {
 }
+declare const UnsupportedError_base: errore.FactoryTaggedErrorClass<"UnsupportedError", "$feature is not available for $accountType accounts. $hint", Error>;
+/** Returned when a command requires a capability (e.g. gmail labels) that the account doesn't support. */
+export declare class UnsupportedError extends UnsupportedError_base {
+}
 /** Detect auth-like errors from underlying libraries (tsdav string errors, googleapis structured errors).
  *  Used inside clients to decide whether to return an AuthError.
  *  NOTE: String matching here is intentional — this is the boundary layer that converts
  *  untyped external library exceptions into typed AuthError values (errore "wrapping libraries" pattern). */
 export declare function isAuthLikeError(err: unknown): boolean;
+/** Check if an error is specifically about missing OAuth scopes (not expired tokens or revoked access).
+ *  When true, the user needs to `zele login` again to grant the new scope. */
+export declare function isScopeError(err: unknown): boolean;
 export declare function isRateLimitError(err: any): boolean;
 export {};

package/dist/api-utils.js

@@ -101,6 +101,12 @@ export class ApiError extends errore.createTaggedError({
     message: 'API call failed: $reason',
 }) {
 }
+/** Returned when a command requires a capability (e.g. gmail labels) that the account doesn't support. */
+export class UnsupportedError extends errore.createTaggedError({
+    name: 'UnsupportedError',
+    message: '$feature is not available for $accountType accounts. $hint',
+}) {
+}
 /** Detect auth-like errors from underlying libraries (tsdav string errors, googleapis structured errors).
  *  Used inside clients to decide whether to return an AuthError.
  *  NOTE: String matching here is intentional — this is the boundary layer that converts
@@ -115,6 +121,12 @@ export function isAuthLikeError(err) {
     const msg = String(err);
     return msg.includes('Invalid credentials') || msg.includes('Unauthorized') || msg.includes('invalid_grant');
 }
+/** Check if an error is specifically about missing OAuth scopes (not expired tokens or revoked access).
+ *  When true, the user needs to `zele login` again to grant the new scope. */
+export function isScopeError(err) {
+    const msg = String(err);
+    return msg.includes('insufficient authentication scopes') || msg.includes('Insufficient Permission');
+}
 // ---------------------------------------------------------------------------
 // Rate limit detection
 // ---------------------------------------------------------------------------

package/dist/api-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-utils.js","sourceRoot":"","sources":["../src/api-utils.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,oEAAoE;AACpE,kEAAkE;AAClE,EAAE;AACF,qEAAqE;AACrE,mEAAmE;AACnE,2EAA2E;AAC3E,+CAA+C;AAE/C,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAEhC,MAAM,eAAe,GAAG,EAAE,CAAA;AAW1B;uFACuF;AACvF,MAAM,UAAU,QAAQ,CAAI,KAAQ;IAClC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAA;AACvB,CAAC;AAED;;;;sFAIsF;AACtF,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAU,EACV,EAA2B,EAC3B,WAAW,GAAG,eAAe;IAE7B,MAAM,OAAO,GAAsB,EAAE,CAAA;IACrC,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,UAAU,GAAiB,IAAI,CAAA;IAEnC,KAAK,UAAU,MAAM;QACnB,OAAO,KAAK,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YAC3C,MAAM,CAAC,GAAG,KAAK,EAAE,CAAA;YACjB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAA;YAClC,IAAI,MAAM,YAAY,KAAK,EAAE,CAAC;gBAC5B,UAAU,GAAG,MAAM,CAAA;gBACnB,OAAM;YACR,CAAC;YACD,OAAO,CAAC,CAAC,CAAC,GAAG,MAAyB,CAAA;QACxC,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAA;IAC3F,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAC1B,IAAI,UAAU;QAAE,OAAO,UAA6B,CAAA;IACpD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;sFACsF;AACtF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,EAAoB,EAAE,WAAW,GAAG,EAAE,EAAE,OAAO,GAAG,KAAK;IACxF,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAA;QACnB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,OAAO,KAAK,WAAW;gBAAE,MAAM,GAAG,CAAA;YAChE,MAAM,IAAI,GAAG,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAA;YAC/C,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;QAC/C,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAA;AAChC,CAAC;AAED,8EAA8E;AAC9E,iEAAiE;AACjE,8EAA8E;AAE9E;iFACiF;AACjF,MAAM,OAAO,SAAU,SAAQ,MAAM,CAAC,iBAAiB,CAAC;IACtD,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,2CAA2C;CACrD,CAAC;CAAG;AAEL,gGAAgG;AAChG,MAAM,OAAO,aAAc,SAAQ,MAAM,CAAC,iBAAiB,CAAC;IAC1D,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,qBAAqB;CAC/B,CAAC;CAAG;AAEL,6DAA6D;AAC7D,MAAM,OAAO,gBAAiB,SAAQ,MAAM,CAAC,iBAAiB,CAAC;IAC7D,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,iCAAiC;CAC3C,CAAC;CAAG;AAEL,6EAA6E;AAC7E,MAAM,OAAO,UAAW,SAAQ,MAAM,CAAC,iBAAiB,CAAC;IACvD,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,gCAAgC;CAC1C,CAAC;CAAG;AAEL,oFAAoF;AACpF,MAAM,OAAO,gBAAiB,SAAQ,MAAM,CAAC,iBAAiB,CAAC;IAC7D,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,6BAA6B;CACvC,CAAC;CAAG;AAEL,2FAA2F;AAC3F,MAAM,OAAO,eAAgB,SAAQ,MAAM,CAAC,iBAAiB,CAAC;IAC5D,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,yBAAyB;CACnC,CAAC;CAAG;AAEL,8DAA8D;AAC9D,MAAM,OAAO,QAAS,SAAQ,MAAM,CAAC,iBAAiB,CAAC;IACrD,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,0BAA0B;CACpC,CAAC;CAAG;AAEL;;;6GAG6G;AAC7G,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,MAAM,CAAC,GAAG,GAAU,CAAA;IACpB,MAAM,MAAM,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAA;IAC1D,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAA;IAC/B,IAAI,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IACvD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;IACvB,OAAO,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAA;AAC7G,CAAC;AAGD,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,MAAM,UAAU,gBAAgB,CAAC,GAAQ;IACvC,MAAM,MAAM,GAAG,GAAG,EAAE,IAAI,IAAI,GAAG,EAAE,MAAM,IAAI,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAA;IAChE,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAA;IAC/B,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,GAAG,EAAE,MAAM,IAAI,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,IAAI,EAAE,CAAA;QACtE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAC5B;YACE,uBAAuB;YACvB,mBAAmB;YACnB,eAAe;YACf,oBAAoB;YACpB,eAAe;YACf,cAAc;SACf,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CACrB,CAAA;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}
+{"version":3,"file":"api-utils.js","sourceRoot":"","sources":["../src/api-utils.ts"],"names":[],"mappings":"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"}

package/dist/auth.d.ts

@@ -1,6 +1,32 @@
 import { OAuth2Client } from 'google-auth-library';
 import { GmailClient } from './gmail-client.js';
 import { CalendarClient } from './calendar-client.js';
+import { ImapSmtpClient } from './imap-smtp-client.js';
+export type AccountType = 'google' | 'imap_smtp';
+export declare const IMAP_SMTP_APP_ID: "imap_smtp";
+export interface ImapCredentials {
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    tls: boolean;
+}
+export interface SmtpCredentials {
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    tls: boolean;
+}
+/** Stored in the `tokens` column for imap_smtp accounts. */
+export interface ImapSmtpCredentials {
+    imap?: ImapCredentials;
+    smtp?: SmtpCredentials;
+}
+/** Capabilities an account can have. */
+export type AccountCapability = 'gmail' | 'calendar' | 'smtp' | 'imap';
+export declare function parseCapabilities(raw: string): AccountCapability[];
+export declare function hasCapability(capabilities: string | AccountCapability[], cap: AccountCapability): boolean;
 /**
  * Create an OAuth2Client. If appId is provided, looks up the matching
  * client credentials from OAUTH_CLIENTS by client ID. Falls back to
@@ -10,6 +36,8 @@ export declare function createOAuth2Client(appId?: string): OAuth2Client;
 export interface AccountId {
     email: string;
     appId: string;
+    accountType: AccountType;
+    capabilities: AccountCapability[];
 }
 interface BrowserAuthOptions {
     openBrowser?: boolean;
@@ -25,28 +53,60 @@ export declare function login(appId?: string, options?: BrowserAuthOptions): Pro
     appId: string;
     client: GmailClient;
 } | Error>;
+export interface LoginImapOptions {
+    email: string;
+    imapHost: string;
+    imapPort?: number;
+    smtpHost?: string;
+    smtpPort?: number;
+    password?: string;
+    imapUser?: string;
+    imapPassword?: string;
+    smtpUser?: string;
+    smtpPassword?: string;
+    tls?: boolean;
+}
+/**
+ * Login with IMAP/SMTP credentials. Tests connections before saving.
+ * Returns an error value if validation or connection test fails.
+ */
+export declare function loginImap(options: LoginImapOptions): Promise<{
+    email: string;
+    appId: string;
+} | Error>;
 export declare function logout(email: string): Promise<void | Error>;
 export declare function listAccounts(): Promise<AccountId[]>;
+/** Entry returned by getClients — client is GmailClient for Google accounts, ImapSmtpClient for IMAP/SMTP. */
+export interface ClientEntry {
+    email: string;
+    appId: string;
+    accountType: AccountType;
+    capabilities: AccountCapability[];
+    client: GmailClient | ImapSmtpClient;
+}
 /**
- * Get authenticated GmailClient instances for all accounts (or filtered by email list).
+ * Get authenticated client instances for all accounts (or filtered by email list).
+ * Returns GmailClient for Google accounts and ImapSmtpClient for IMAP/SMTP accounts.
  * If no accounts are registered, throws with a helpful message.
  */
-export declare function getClients(accounts?: string[]): Promise<Array<{
-    email: string;
-    appId: string;
-    client: GmailClient;
-}>>;
+export declare function getClients(accounts?: string[]): Promise<ClientEntry[]>;
 /**
- * Get a single authenticated GmailClient. Errors if multiple accounts exist
+ * Get a single authenticated client. Errors if multiple accounts exist
  * and no --account filter was provided.
  */
-export declare function getClient(accounts?: string[]): Promise<{
+export declare function getClient(accounts?: string[]): Promise<ClientEntry>;
+/**
+ * Get a single authenticated GmailClient. Errors if account is not a Google account.
+ * Use this for commands that require Gmail-specific features.
+ */
+export declare function getGmailClient(accounts?: string[]): Promise<{
     email: string;
     appId: string;
     client: GmailClient;
 }>;
 /**
- * Get authenticated CalendarClient instances for all accounts (or filtered by email list).
+ * Get authenticated CalendarClient instances for Google accounts only.
+ * IMAP/SMTP accounts are silently skipped (calendar requires Google OAuth).
  */
 export declare function getCalendarClients(accounts?: string[]): Promise<Array<{
     email: string;
@@ -65,6 +125,8 @@ export declare function getCalendarClient(accounts?: string[]): Promise<{
 export interface AuthStatus {
     email: string;
     appId: string;
+    accountType: AccountType;
+    capabilities: AccountCapability[];
     expiresAt?: Date;
 }
 export declare function getAuthStatuses(): Promise<AuthStatus[]>;