@bobfrankston/mailx-types 0.1.8 → 0.1.11

package/index.d.ts

@@ -38,8 +38,7 @@ export interface AccountConfig {
     primaryContacts?: boolean; /** Per-feature override: use this account's Google Contacts. Falls back to `primary` if unset. */
     defaultSend?: boolean; /** Use this account's SMTP when From doesn't match any account */
     syncContacts?: boolean; /** Sync contacts even when account is disabled (contacts-only Gmail) */
-    relayDomains?: string[]; /** Domains to skip in Delivered-To chain (e.g., ["m.connectivity.xyz"]) */
-    deliveredToPrefix?: string[]; /** Prefixes to strip from Delivered-To to get clean alias (e.g., ["bobf-ma-", "bobf-"]) — order matters, longest first */
+    relayDomains?: string[]; /** Domains to skip in Delivered-To chain (e.g., ["relay.aaz.lt"]) */
     identityDomains?: string[]; /** Domains where Delivered-To address should become the reply From (e.g., ["bob.ma", "bobf.frankston.com"]) */
     spam?: string; /** IMAP folder path for "Mark as spam" button (e.g., "_spam"). Button hidden when not set. */
     signature?: string; /** Legacy: HTML signature appended to all outgoing messages (new + reply + forward). Plain text or HTML allowed. Superseded by `sig`. */
@@ -269,16 +268,40 @@ export interface AutocompleteResponse {
 }
 export interface AiTransformRequest {
     /** translate = render in `targetLang`; proofread = corrected version
-     *  with grammar/spelling fixes; summarize = short paragraph summary. */
-    action: "translate" | "proofread" | "summarize";
+     *  with grammar/spelling fixes; summarize = short paragraph summary;
+     *  extractEvent = parse natural-language event description into a
+     *  structured calendar event (title/start/end/location/notes). */
+    action: "translate" | "proofread" | "summarize" | "extractEvent";
     text: string;
     /** ISO-639-1 (or BCP-47) language code for translate. Defaults to "en". */
     targetLang?: string;
+    /** Caller's "now" hint, ISO 8601 (e.g. 2026-05-05T18:30:00). Used by
+     *  extractEvent to resolve relative dates ("tomorrow at 3pm"). The
+     *  service can't trust its own clock — the user might be on a phone
+     *  in a different timezone — so the caller supplies it. */
+    nowISO?: string;
+}
+/** Structured calendar event fields parsed from a natural-language
+ *  description by aiTransform({ action: "extractEvent" }). All times are
+ *  ISO 8601 in the caller's local timezone (no `Z` suffix); the client
+ *  shapes them into Google Calendar's `dates=` URL parameter. */
+export interface ExtractedEvent {
+    title: string;
+    startISO?: string;
+    endISO?: string;
+    allDay?: boolean;
+    location?: string;
+    notes?: string;
 }
 export interface AiTransformResponse {
     /** Transformed text. Empty when AI is disabled / provider error / feature
-     *  not enabled — caller should treat empty as "no result". */
+     *  not enabled — caller should treat empty as "no result". For
+     *  extractEvent this holds the JSON-stringified ExtractedEvent so the
+     *  response shape stays single-field across all actions. */
     text: string;
+    /** Parsed ExtractedEvent, populated only for extractEvent. Lets the
+     *  client skip the JSON.parse step (the service already validated). */
+    event?: ExtractedEvent;
     /** Optional reason for empty result, surfaced to UI status bar. */
     reason?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx-types",
-  "version": "0.1.8",
+  "version": "0.1.11",
   "type": "module",
   "main": "index.js",
   "types": "index.d.ts",