@qwanyx/stack 0.2.101 → 0.2.103

package/dist/client/MailClient.d.ts

@@ -59,17 +59,19 @@ export declare class MailClient {
     /**
      * Move emails to trash (soft delete)
      * Tries multiple folder names for Gmail locales
+     * Note: This uses IMAP directly - for Gmail API accounts, use the trash endpoint instead
      * @param sourceFolder - The folder where the emails currently are (default: INBOX)
      */
-    trashEmails(accountId: string, uids: number[], sourceFolder?: string): Promise<{
+    trashEmails(accountId: string, uids: (number | string)[], sourceFolder?: string): Promise<{
         success: boolean;
         moved: number;
     }>;
     /**
      * Archive emails (remove from inbox, keep in All Mail)
+     * Note: This uses IMAP directly - for Gmail API accounts, use the archive endpoint instead
      * @param sourceFolder - The folder where the emails currently are (default: INBOX)
      */
-    archiveEmails(accountId: string, uids: number[], sourceFolder?: string): Promise<{
+    archiveEmails(accountId: string, uids: (number | string)[], sourceFolder?: string): Promise<{
         success: boolean;
         archived: number;
     }>;
@@ -88,9 +90,10 @@ export declare class MailClient {
     /**
      * Get a single email by UID with full body content (server-side parsing)
      * Returns attachments list from backend
+     * @param uid - IMAP uses numeric UID, Gmail API uses string message ID
      */
-    getEmail(accountId: string, uid: number, folder?: string): Promise<{
-        uid: number;
+    getEmail(accountId: string, uid: number | string, folder?: string): Promise<{
+        uid: number | string;
         from: string;
         subject: string;
         date: string;
@@ -100,13 +103,16 @@ export declare class MailClient {
             filename: string;
             content_type: string;
             size: number;
+            attachment_id?: string;
         }>;
     } | null>;
     /**
      * Get a specific attachment from an email
      * Returns base64-encoded content for download
+     * @param uid - IMAP uses numeric UID, Gmail API uses string message ID
+     * @param attachmentIdOrIndex - Gmail uses attachment_id string, IMAP uses numeric index
      */
-    getAttachment(accountId: string, uid: number, attachmentIndex: number, folder?: string): Promise<{
+    getAttachment(accountId: string, uid: number | string, attachmentIdOrIndex: number | string, folder?: string): Promise<{
         filename: string;
         content_type: string;
         size: number;
@@ -134,9 +140,10 @@ export declare class MailClient {
     /**
      * Get email with client-side parsing using postal-mime
      * This handles CID embedded images by converting them to base64 data URIs
+     * Note: This method uses IMAP directly and may not work with Gmail API accounts
      */
-    getEmailParsed(accountId: string, uid: number, folder?: string): Promise<{
-        uid: number;
+    getEmailParsed(accountId: string, uid: number | string, folder?: string): Promise<{
+        uid: number | string;
         from: string;
         subject: string;
         date: string;
@@ -229,4 +236,58 @@ export declare class MailClient {
         message_id?: string;
         error?: string;
     }>;
+    /**
+     * Get Gmail OAuth authorization URL
+     * Opens this URL in a popup to start the OAuth flow
+     * @param accountId - Optional account ID (defaults to 'gmail')
+     * @param redirectUri - Optional custom redirect URI
+     */
+    getGmailAuthUrl(accountId?: string, redirectUri?: string): Promise<{
+        auth_url: string;
+        state: string;
+    }>;
+    /**
+     * Check if an account is connected via Gmail API
+     * @param accountId - Account to check
+     */
+    isGmailConnected(accountId: string): Promise<boolean>;
+    /**
+     * Disconnect Gmail account (removes OAuth tokens, switches back to IMAP)
+     * @param accountId - Account to disconnect
+     */
+    disconnectGmail(accountId: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Search for an email via Gmail API by subject and/or from
+     * Use this as a fallback when UID-based fetch fails for Gmail accounts
+     * @param accountId - Account to search
+     * @param subject - Subject to search for (partial match)
+     * @param from - From address to search for
+     */
+    gmailSearchMessage(accountId: string, subject?: string, from?: string): Promise<{
+        uid: string;
+        from: string;
+        subject: string;
+        date: string;
+        body: string;
+        seen: boolean;
+        attachments?: Array<{
+            filename: string;
+            content_type: string;
+            size: number;
+            attachment_id?: string;
+        }>;
+    } | null>;
+    /**
+     * Open Gmail OAuth popup and wait for result
+     * Returns a promise that resolves when OAuth completes or rejects on error
+     * @param accountId - Optional account ID
+     */
+    connectGmail(accountId?: string): Promise<{
+        success: boolean;
+        email?: string;
+        error?: string;
+    }>;
 }

package/dist/components/Mail.d.ts

@@ -4,7 +4,7 @@
  */
 import React from 'react';
 export interface EmailMessage {
-    uid: number;
+    uid: number | string;
     subject: string;
     from: string;
     date: string;
@@ -24,13 +24,13 @@ export interface MailProps {
     emptyMessage?: string;
     autoLoad?: boolean;
     onSelect?: (email: EmailMessage) => void;
-    onSelectionChange?: (uids: number[]) => void;
-    onDelete?: (uids: number[]) => void;
+    onSelectionChange?: (uids: (number | string)[]) => void;
+    onDelete?: (uids: (number | string)[]) => void;
     onError?: (error: Error) => void;
     onLoad?: (emails: EmailMessage[]) => void;
     renderItem?: (email: EmailMessage, selected: boolean) => React.ReactNode;
     renderDetail?: (email: EmailMessage) => React.ReactNode;
-    renderActions?: (selectedUids: number[], actions: MailActions) => React.ReactNode;
+    renderActions?: (selectedUids: (number | string)[], actions: MailActions) => React.ReactNode;
     renderEmpty?: () => React.ReactNode;
     renderLoading?: () => React.ReactNode;
     theme?: MailTheme;

package/dist/components/MailComposer.d.ts

@@ -40,6 +40,8 @@ export interface MailComposerProps {
     placeholder?: string;
     /** Additional CSS class */
     className?: string;
+    /** Hide the To field (when recipient is controlled externally) */
+    hideToField?: boolean;
     /** Minimum height for editor */
     minHeight?: string;
     /** Custom send button text */
@@ -52,6 +54,14 @@ export interface MailComposerProps {
     onAiProofread?: (text: string) => Promise<string>;
     /** AI callback: rewrite text */
     onAiRewrite?: (text: string) => Promise<string>;
+    /** AI callback: generate email from prompt */
+    onAiGenerate?: (prompt: string, context: {
+        to: string;
+        subject: string;
+    }, options: {
+        useNotes: boolean;
+        addSignature: boolean;
+    }) => Promise<string>;
     /** Content to render above the toolbar (e.g., AudioEditor) */
     renderAboveToolbar?: React.ReactNode;
 }
@@ -81,4 +91,4 @@ export interface MailComposerTheme extends MailEditorTheme {
     attachmentBackground?: string;
     attachmentBorder?: string;
 }
-export declare function MailComposer({ to: initialTo, subject: initialSubject, body: initialBody, replyTo, onSend, onCancel, onBodyChange, externalUpdate, insertText, insertTextTrigger, theme: themeProp, disabled, showCcBcc, placeholder, className, minHeight, sendButtonText, hideCancelButton, onAiRestructure, onAiProofread, onAiRewrite, renderAboveToolbar, }: MailComposerProps): import("react/jsx-runtime").JSX.Element;
+export declare function MailComposer({ to: initialTo, subject: initialSubject, body: initialBody, replyTo, onSend, onCancel, onBodyChange, externalUpdate, insertText, insertTextTrigger, theme: themeProp, disabled, showCcBcc, placeholder, className, hideToField, minHeight, hideCancelButton, onAiRestructure, onAiProofread, onAiRewrite, onAiGenerate, renderAboveToolbar, }: MailComposerProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/QMap/QMap.d.ts

@@ -11,4 +11,4 @@
  */
 import { GraphNode } from '../../types';
 import type { QMapProps } from './types';
-export declare function QMap<T extends GraphNode = GraphNode>({ viewNode, nodes, edges, renderNode, defaultNodeWidth, defaultNodeHeight, onNodeMove, onNodeClick, onNodeDoubleClick, onNodeContextMenu, selectedIds: controlledSelectedIds, onSelectionChange, onEdgeClick, onViewChange, onTransformChange, minZoom, maxZoom, initialTransform, defaultEdgeStyle, defaultEdgeColor, defaultEdgeWidth, draggable, selectable, zoomable, pannable, className, style, background, showGrid, gridSize }: QMapProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare function QMap<T extends GraphNode = GraphNode>({ viewNode, nodes, edges, renderNode, defaultNodeWidth, defaultNodeHeight, onNodeMove, onNodeDrag, onNodeClick, onNodeDoubleClick, onNodeContextMenu, selectedIds: controlledSelectedIds, onSelectionChange, onEdgeClick, onViewChange, onTransformChange, minZoom, maxZoom, initialTransform, defaultEdgeStyle, defaultEdgeColor, defaultEdgeWidth, draggable, selectable, zoomable, pannable, className, style, background, showGrid, gridSize }: QMapProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/components/QMap/types.d.ts

@@ -47,6 +47,8 @@ export interface QMapProps<T extends GraphNode = GraphNode> {
     defaultNodeWidth?: number;
     defaultNodeHeight?: number;
     onNodeMove?: (nodeId: string, x: number, y: number) => void;
+    /** Called during node drag (real-time position updates) */
+    onNodeDrag?: (nodeId: string, x: number, y: number) => void;
     onNodeClick?: (node: T, event: React.MouseEvent) => void;
     onNodeDoubleClick?: (node: T, event: React.MouseEvent) => void;
     onNodeContextMenu?: (node: T, event: React.MouseEvent) => void;