zele 0.2.0 → 0.3.5

package/README.md

@@ -39,6 +39,7 @@ zele mail read <thread-id>       # read a thread
 zele mail send                    # send an email
 zele mail reply <thread-id>      # reply to a thread
 zele mail forward <thread-id>    # forward a thread
+zele mail watch                   # watch for new emails (poll)
 ```
 
 ### Mail actions
@@ -55,6 +56,42 @@ 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:
+
+```bash
+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
@@ -89,7 +126,7 @@ zele cal freebusy                 # check availability
 ### Attachments
 
 ```bash
-zele attachment list <message-id>
+zele attachment list <thread-id>
 zele attachment get <message-id> <attachment-id>
 ```
 

package/bin/zele

@@ -0,0 +1,27 @@
+#!/usr/bin/env sh
+# Shell launcher for zele CLI.
+# Prefers bun (required for the TUI), falls back to node for non-TUI commands.
+# Uses exec so no child process is spawned — the shell is replaced in-place.
+#
+# Shebang uses "#!/usr/bin/env sh" instead of "#!/bin/sh" so that npm's
+# cmd-shim on Windows captures "sh" as the program name (looked up via PATH)
+# rather than the literal "/bin/sh" path which doesn't exist on Windows.
+# Git for Windows provides sh.exe on PATH, making this work cross-platform.
+
+# Resolve symlink (npm/pnpm create symlinks for bin entries)
+SELF="$0"
+if [ -L "$SELF" ]; then
+  LINK="$(readlink "$SELF")"
+  case "$LINK" in
+    /*) SELF="$LINK" ;;
+    *) SELF="$(dirname "$SELF")/$LINK" ;;
+  esac
+fi
+DIR="$(cd "$(dirname "$SELF")" && pwd)"
+CLI="$DIR/../dist/cli.js"
+
+if command -v bun >/dev/null 2>&1; then
+  exec bun "$CLI" "$@"
+else
+  exec node "$CLI" "$@"
+fi

package/dist/api-utils.d.ts

@@ -1,6 +1,55 @@
-/** Run promises with bounded concurrency */
-export declare function mapConcurrent<T, R>(items: T[], fn: (item: T) => Promise<R>, concurrency?: number): Promise<R[]>;
+import * as errore from 'errore';
+/** Exclude Error subtypes from a union. Used by mapConcurrent to strip
+ *  error return types from the success array — errors are returned separately. */
+type ExcludeError<T> = T extends Error ? never : T;
+/** Extract Error subtypes from a union. Used by mapConcurrent for the error branch. */
+type ExtractError<T> = T extends Error ? T : never;
+type Falsy = false | 0 | '' | null | undefined;
+/** Generic truthy type guard for Array.filter() chains.
+ *  Useful to drop null/undefined placeholders while preserving inferred item types. */
+export declare function isTruthy<T>(value: T): value is Exclude<T, Falsy>;
+/** Run promises with bounded concurrency.
+ *  Error-aware: if any callback returns an Error instance, remaining work is
+ *  aborted and that error is returned as a value (no throwing needed).
+ *  Callbacks should return Error for fatal failures (auth) and null for skip.
+ *  The success array is typed without Error — errors are only in the Error branch. */
+export declare function mapConcurrent<T, R>(items: T[], fn: (item: T) => Promise<R>, concurrency?: number): Promise<ExcludeError<R>[] | ExtractError<R>>;
 /** Simple retry for rate limit errors (429 and 403 quota errors).
  *  Matches Zero's gmail-rate-limit.ts schedule: up to 10 attempts, 60s base delay. */
 export declare function withRetry<T>(fn: () => Promise<T>, maxAttempts?: number, delayMs?: number): Promise<T>;
+declare const AuthError_base: errore.FactoryTaggedErrorClass<"AuthError", "Authentication failed for $email: $reason", Error>;
+/** Returned by client methods when authentication fails (expired token, revoked access, etc.).
+ *  Callers check with `instanceof AuthError` and TypeScript narrows the type. */
+export declare class AuthError extends AuthError_base {
+}
+declare const NotFoundError_base: errore.FactoryTaggedErrorClass<"NotFoundError", "$resource not found", Error>;
+/** Returned when a requested resource doesn't exist (calendar, event, thread, draft, label). */
+export declare class NotFoundError extends NotFoundError_base {
+}
+declare const EmptyThreadError_base: errore.FactoryTaggedErrorClass<"EmptyThreadError", "No messages in thread $threadId", Error>;
+/** Returned when a thread has no messages (empty thread). */
+export declare class EmptyThreadError extends EmptyThreadError_base {
+}
+declare const ParseError_base: errore.FactoryTaggedErrorClass<"ParseError", "Failed to parse $what: $reason", Error>;
+/** Returned when data cannot be parsed (iCal, event response, raw email). */
+export declare class ParseError extends ParseError_base {
+}
+declare const MissingDataError_base: errore.FactoryTaggedErrorClass<"MissingDataError", "Missing $what for $resource", Error>;
+/** Returned when required data is missing from an API response or cached object. */
+export declare class MissingDataError extends MissingDataError_base {
+}
+declare const ValidationError_base: errore.FactoryTaggedErrorClass<"ValidationError", "Invalid $field: $reason", Error>;
+/** Returned when user input fails validation (reminder format, time expressions, etc.). */
+export declare class ValidationError extends ValidationError_base {
+}
+declare const ApiError_base: errore.FactoryTaggedErrorClass<"ApiError", "API call failed: $reason", Error>;
+/** Returned when a non-auth, non-ratelimit API call fails. */
+export declare class ApiError extends ApiError_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;
 export declare function isRateLimitError(err: any): boolean;
+export {};

package/dist/api-utils.js

@@ -1,19 +1,42 @@
 // Shared API utilities for Gmail and Calendar clients.
 // Retry logic for rate limit errors and bounded concurrency helper.
 // Extracted from gmail-client.ts to be reused across API clients.
+//
+// Auth error handling follows the errore pattern (errors as values):
+// - Clients return AuthError instead of throwing for auth failures
+// - Callers narrow with instanceof, no try/catch or string matching needed
+// - See https://errore.org/ for the philosophy
+import * as errore from 'errore';
 const MAX_CONCURRENCY = 10;
-/** Run promises with bounded concurrency */
+/** Generic truthy type guard for Array.filter() chains.
+ *  Useful to drop null/undefined placeholders while preserving inferred item types. */
+export function isTruthy(value) {
+    return Boolean(value);
+}
+/** Run promises with bounded concurrency.
+ *  Error-aware: if any callback returns an Error instance, remaining work is
+ *  aborted and that error is returned as a value (no throwing needed).
+ *  Callbacks should return Error for fatal failures (auth) and null for skip.
+ *  The success array is typed without Error — errors are only in the Error branch. */
 export async function mapConcurrent(items, fn, concurrency = MAX_CONCURRENCY) {
     const results = [];
     let index = 0;
+    let fatalError = null;
     async function worker() {
-        while (index < items.length) {
+        while (index < items.length && !fatalError) {
             const i = index++;
-            results[i] = await fn(items[i]);
+            const result = await fn(items[i]);
+            if (result instanceof Error) {
+                fatalError = result;
+                return;
+            }
+            results[i] = result;
         }
     }
     const workers = Array.from({ length: Math.min(concurrency, items.length) }, () => worker());
     await Promise.all(workers);
+    if (fatalError)
+        return fatalError;
     return results;
 }
 /** Simple retry for rate limit errors (429 and 403 quota errors).
@@ -32,6 +55,69 @@ export async function withRetry(fn, maxAttempts = 10, delayMs = 60000) {
     }
     throw new Error('unreachable');
 }
+// ---------------------------------------------------------------------------
+// Auth errors (errore pattern: errors as values, not exceptions)
+// ---------------------------------------------------------------------------
+/** Returned by client methods when authentication fails (expired token, revoked access, etc.).
+ *  Callers check with `instanceof AuthError` and TypeScript narrows the type. */
+export class AuthError extends errore.createTaggedError({
+    name: 'AuthError',
+    message: 'Authentication failed for $email: $reason',
+}) {
+}
+/** Returned when a requested resource doesn't exist (calendar, event, thread, draft, label). */
+export class NotFoundError extends errore.createTaggedError({
+    name: 'NotFoundError',
+    message: '$resource not found',
+}) {
+}
+/** Returned when a thread has no messages (empty thread). */
+export class EmptyThreadError extends errore.createTaggedError({
+    name: 'EmptyThreadError',
+    message: 'No messages in thread $threadId',
+}) {
+}
+/** Returned when data cannot be parsed (iCal, event response, raw email). */
+export class ParseError extends errore.createTaggedError({
+    name: 'ParseError',
+    message: 'Failed to parse $what: $reason',
+}) {
+}
+/** Returned when required data is missing from an API response or cached object. */
+export class MissingDataError extends errore.createTaggedError({
+    name: 'MissingDataError',
+    message: 'Missing $what for $resource',
+}) {
+}
+/** Returned when user input fails validation (reminder format, time expressions, etc.). */
+export class ValidationError extends errore.createTaggedError({
+    name: 'ValidationError',
+    message: 'Invalid $field: $reason',
+}) {
+}
+/** Returned when a non-auth, non-ratelimit API call fails. */
+export class ApiError extends errore.createTaggedError({
+    name: 'ApiError',
+    message: 'API call failed: $reason',
+}) {
+}
+/** 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 function isAuthLikeError(err) {
+    const e = err;
+    const status = e?.code ?? e?.status ?? e?.response?.status;
+    if (status === 401)
+        return true;
+    if (status === 403 && !isRateLimitError(e))
+        return true;
+    const msg = String(err);
+    return msg.includes('Invalid credentials') || msg.includes('Unauthorized') || msg.includes('invalid_grant');
+}
+// ---------------------------------------------------------------------------
+// Rate limit detection
+// ---------------------------------------------------------------------------
 export function isRateLimitError(err) {
     const status = err?.code ?? err?.status ?? err?.response?.status;
     if (status === 429)

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;AAElE,MAAM,eAAe,GAAG,EAAE,CAAA;AAE1B,4CAA4C;AAC5C,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAU,EACV,EAA2B,EAC3B,WAAW,GAAG,eAAe;IAE7B,MAAM,OAAO,GAAQ,EAAE,CAAA;IACvB,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,KAAK,UAAU,MAAM;QACnB,OAAO,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,KAAK,EAAE,CAAA;YACjB,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAA;QAClC,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,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,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,23 +1,39 @@
 import { OAuth2Client } from 'google-auth-library';
 import { GmailClient } from './gmail-client.js';
 import { CalendarClient } from './calendar-client.js';
-export declare function createOAuth2Client(): OAuth2Client;
+/**
+ * Create an OAuth2Client. If appId is provided, looks up the matching
+ * client credentials from OAUTH_CLIENTS by client ID. Falls back to
+ * the active client / env vars.
+ */
+export declare function createOAuth2Client(appId?: string): OAuth2Client;
+export interface AccountId {
+    email: string;
+    appId: string;
+}
+interface BrowserAuthOptions {
+    openBrowser?: boolean;
+    allowManualCodeEntry?: boolean;
+    showInstructions?: boolean;
+}
 /**
  * Run the full browser OAuth flow and save the account to the DB.
- * Returns the email and an authenticated GmailClient.
+ * Returns either a successful login payload or an Error value.
  */
-export declare function login(): Promise<{
+export declare function login(appId?: string, options?: BrowserAuthOptions): Promise<{
     email: string;
+    appId: string;
     client: GmailClient;
-}>;
-export declare function logout(email: string): Promise<void>;
-export declare function listAccounts(): Promise<string[]>;
+} | Error>;
+export declare function logout(email: string): Promise<void | Error>;
+export declare function listAccounts(): Promise<AccountId[]>;
 /**
  * Get authenticated GmailClient instances for all accounts (or filtered by email list).
  * If no accounts are registered, throws with a helpful message.
  */
 export declare function getClients(accounts?: string[]): Promise<Array<{
     email: string;
+    appId: string;
     client: GmailClient;
 }>>;
 /**
@@ -26,6 +42,7 @@ export declare function getClients(accounts?: string[]): Promise<Array<{
  */
 export declare function getClient(accounts?: string[]): Promise<{
     email: string;
+    appId: string;
     client: GmailClient;
 }>;
 /**
@@ -33,6 +50,7 @@ export declare function getClient(accounts?: string[]): Promise<{
  */
 export declare function getCalendarClients(accounts?: string[]): Promise<Array<{
     email: string;
+    appId: string;
     client: CalendarClient;
 }>>;
 /**
@@ -41,10 +59,13 @@ export declare function getCalendarClients(accounts?: string[]): Promise<Array<{
  */
 export declare function getCalendarClient(accounts?: string[]): Promise<{
     email: string;
+    appId: string;
     client: CalendarClient;
 }>;
 export interface AuthStatus {
     email: string;
+    appId: string;
     expiresAt?: Date;
 }
 export declare function getAuthStatuses(): Promise<AuthStatus[]>;
+export {};