@haex-space/vault-sdk 3.5.0 → 3.6.0

package/dist/{client-mcuC3gP5.d.ts → client-DnCZ3KyI.d.mts}

@@ -1,4 +1,4 @@
-import { b as HaexHubEvent, c as EXTERNAL_EVENTS, D as DatabaseQueryResult, M as Migration, d as MigrationResult, W as WebRequestOptions, e as WebResponse, f as EventCallback, H as HaexHubConfig, a as ExtensionInfo, A as ApplicationContext, g as DatabasePermissionRequest, P as PermissionResponse, S as SearchResult } from './types-fHuxbqa4.js';
+import { b as HaexHubEvent, c as EXTERNAL_EVENTS, D as DatabaseQueryResult, M as Migration, d as MigrationResult, W as WebRequestOptions, e as WebResponse, f as EventCallback, H as HaexHubConfig, a as ExtensionInfo, A as ApplicationContext, g as DatabasePermissionRequest, P as PermissionResponse, S as SearchResult } from './types-DQZCRfC-.mjs';
 import { SqliteRemoteDatabase } from 'drizzle-orm/sqlite-proxy';
 
 /**
@@ -1318,6 +1318,12 @@ interface MailAccount {
     imap: ImapConfig;
     smtp?: SmtpConfig;
 }
+/** Payload of `MAIL_EVENTS.NEW_MESSAGES`, emitted by a background poll watch. */
+interface MailNewMessagesEvent {
+    accountId: string;
+    mailboxName: string;
+    newCount: number;
+}
 interface MailAddress {
     name?: string;
     email: string;
@@ -1404,6 +1410,8 @@ interface OutgoingMessage {
  *  - All IMAP operations require `mail` permission with action `fetch`
  *    on `imap.host`.
  *  - SMTP send requires `mail` permission with action `send` on `smtp.host`.
+ *  - Background watching requires `mail` permission with action `poll`
+ *    on the account's IMAP host.
  *  - target="gmail.com" matches "imap.gmail.com" / "smtp.gmail.com".
  *
  * Credentials live with the caller (typically loaded from
@@ -1457,6 +1465,26 @@ declare class MailAPI {
      * this is a fetch operation (no SMTP host involved).
      */
     buildRfc822Async(imapHost: string, message: OutgoingMessage): Promise<string>;
+    /**
+     * Start (or replace) a background poll watch for `accountId`/`mailboxName`.
+     * The host resolves credentials itself from `accountId` — no `ImapConfig`
+     * is passed in. Requires `mail` permission with action `poll` on the
+     * account's IMAP host (prompted on first call, same as `fetch`/`send`).
+     *
+     * `intervalSeconds` is clamped host-side to [30, 3600]. Listen for
+     * results via `onNewMessages`.
+     */
+    startWatchingAsync(accountId: string, mailboxName: string, intervalSeconds: number): Promise<void>;
+    /** Stop a background poll watch previously started with `startWatchingAsync`. */
+    stopWatchingAsync(accountId: string, mailboxName: string): Promise<void>;
+    /**
+     * Register a callback for new-mail notifications from any active watch.
+     * `event.data` is a `MailNewMessagesEvent` — check `accountId`/`mailboxName`
+     * before refreshing if watching more than one account.
+     */
+    onNewMessages(callback: EventCallback): void;
+    /** Remove a new-mail callback registered with `onNewMessages`. */
+    offNewMessages(callback: EventCallback): void;
 }
 
 /**
@@ -1632,4 +1660,4 @@ declare class HaexVaultSdk {
     private log;
 }
 
-export { PermissionsAPI as $, type AuthorizedClient as A, type BlockedClient as B, type ConnectionSecurity as C, DatabaseAPI as D, type ExternalAuthDecision as E, type FileStat as F, type MessageEnvelope as G, HaexVaultSdk as H, type ImapConfig as I, type NotificationClickEvent as J, KnownPath as K, LOCALSEND_EVENTS as L, MailAPI as M, type NotificationAction as N, type NotificationOptions as O, NotificationsAPI as P, type OutgoingAttachment as Q, type OutgoingMessage as R, StorageAPI as S, type PasswordInput as T, type PasswordItemFull as U, type PasswordItemSummary as V, type PasswordKeyValue as W, type PasswordKeyValueInput as X, PasswordsAPI as Y, type PendingAuthorization as Z, type PendingTransfer as _, type DecryptedSpace as a, type AddBackendRequest as a0, type S3Config as a1, type S3PublicConfig as a2, RemoteStorageAPI as a3, type StorageBackendInfo as a4, type StorageObjectInfo as a5, type UpdateBackendRequest as a6, type RequestedExtension as a7, type SelectFileOptions as a8, type SelectFolderOptions as a9, type ServerInfo as aa, type ServerStatus as ab, type SessionAuthorization as ac, type SharedSpace as ad, ShellAPI as ae, type ShellCreateOptions as af, type ShellCreateResponse as ag, type ShellExitEvent as ah, type ShellOutputEvent as ai, type SmtpConfig as aj, type SpaceAccessTokenInfo as ak, type SpaceAssignment as al, type SpaceInvite as am, type SpaceKeyGrantInfo as an, type SpaceMemberInfo as ao, SpacesAPI as ap, type SyncBackendInfo as aq, type TransferDirection as ar, type TransferProgress as as, type TransferState as at, WebAPI as au, canExternalClientSendRequests as av, isExternalClientConnected as aw, type DeepLink as b, type Device as c, type DeviceInfo as d, type DeviceType as e, type DirEntry as f, type ExternalConnection as g, ExternalConnectionErrorCode as h, ExternalConnectionState as i, type ExternalRequest as j, type ExternalRequestEvent as k, type ExternalRequestHandler as l, type ExternalRequestPayload as m, type ExternalResponse as n, FilesystemAPI as o, type KnownPaths as p, LocalSendAPI as q, type LocalSendEvent as r, type FileInfo as s, type LocalSendSettings as t, type MailAccount as u, type MailAddress as v, type Attachment as w, type FetchRange as x, type MailMessage as y, type MailboxInfo as z };
+export { type PendingTransfer as $, type AuthorizedClient as A, type BlockedClient as B, type ConnectionSecurity as C, DatabaseAPI as D, type ExternalAuthDecision as E, type FileStat as F, type MailboxInfo as G, HaexVaultSdk as H, type ImapConfig as I, type MessageEnvelope as J, KnownPath as K, LOCALSEND_EVENTS as L, MailAPI as M, type NotificationAction as N, type NotificationClickEvent as O, type NotificationOptions as P, NotificationsAPI as Q, type OutgoingAttachment as R, StorageAPI as S, type OutgoingMessage as T, type PasswordInput as U, type PasswordItemFull as V, type PasswordItemSummary as W, type PasswordKeyValue as X, type PasswordKeyValueInput as Y, PasswordsAPI as Z, type PendingAuthorization as _, type DecryptedSpace as a, PermissionsAPI as a0, type AddBackendRequest as a1, type S3Config as a2, type S3PublicConfig as a3, RemoteStorageAPI as a4, type StorageBackendInfo as a5, type StorageObjectInfo as a6, type UpdateBackendRequest as a7, type RequestedExtension as a8, type SelectFileOptions as a9, type SelectFolderOptions as aa, type ServerInfo as ab, type ServerStatus as ac, type SessionAuthorization as ad, type SharedSpace as ae, ShellAPI as af, type ShellCreateOptions as ag, type ShellCreateResponse as ah, type ShellExitEvent as ai, type ShellOutputEvent as aj, type SmtpConfig as ak, type SpaceAccessTokenInfo as al, type SpaceAssignment as am, type SpaceInvite as an, type SpaceKeyGrantInfo as ao, type SpaceMemberInfo as ap, SpacesAPI as aq, type SyncBackendInfo as ar, type TransferDirection as as, type TransferProgress as at, type TransferState as au, WebAPI as av, canExternalClientSendRequests as aw, isExternalClientConnected as ax, type DeepLink as b, type Device as c, type DeviceInfo as d, type DeviceType as e, type DirEntry as f, type ExternalConnection as g, ExternalConnectionErrorCode as h, ExternalConnectionState as i, type ExternalRequest as j, type ExternalRequestEvent as k, type ExternalRequestHandler as l, type ExternalRequestPayload as m, type ExternalResponse as n, FilesystemAPI as o, type KnownPaths as p, LocalSendAPI as q, type LocalSendEvent as r, type FileInfo as s, type LocalSendSettings as t, type MailAccount as u, type MailAddress as v, type Attachment as w, type FetchRange as x, type MailMessage as y, type MailNewMessagesEvent as z };

package/dist/{client-DCoY4f3Q.d.mts → client-uuhuCPDu.d.ts}

@@ -1,4 +1,4 @@
-import { b as HaexHubEvent, c as EXTERNAL_EVENTS, D as DatabaseQueryResult, M as Migration, d as MigrationResult, W as WebRequestOptions, e as WebResponse, f as EventCallback, H as HaexHubConfig, a as ExtensionInfo, A as ApplicationContext, g as DatabasePermissionRequest, P as PermissionResponse, S as SearchResult } from './types-fHuxbqa4.mjs';
+import { b as HaexHubEvent, c as EXTERNAL_EVENTS, D as DatabaseQueryResult, M as Migration, d as MigrationResult, W as WebRequestOptions, e as WebResponse, f as EventCallback, H as HaexHubConfig, a as ExtensionInfo, A as ApplicationContext, g as DatabasePermissionRequest, P as PermissionResponse, S as SearchResult } from './types-DQZCRfC-.js';
 import { SqliteRemoteDatabase } from 'drizzle-orm/sqlite-proxy';
 
 /**
@@ -1318,6 +1318,12 @@ interface MailAccount {
     imap: ImapConfig;
     smtp?: SmtpConfig;
 }
+/** Payload of `MAIL_EVENTS.NEW_MESSAGES`, emitted by a background poll watch. */
+interface MailNewMessagesEvent {
+    accountId: string;
+    mailboxName: string;
+    newCount: number;
+}
 interface MailAddress {
     name?: string;
     email: string;
@@ -1404,6 +1410,8 @@ interface OutgoingMessage {
  *  - All IMAP operations require `mail` permission with action `fetch`
  *    on `imap.host`.
  *  - SMTP send requires `mail` permission with action `send` on `smtp.host`.
+ *  - Background watching requires `mail` permission with action `poll`
+ *    on the account's IMAP host.
  *  - target="gmail.com" matches "imap.gmail.com" / "smtp.gmail.com".
  *
  * Credentials live with the caller (typically loaded from
@@ -1457,6 +1465,26 @@ declare class MailAPI {
      * this is a fetch operation (no SMTP host involved).
      */
     buildRfc822Async(imapHost: string, message: OutgoingMessage): Promise<string>;
+    /**
+     * Start (or replace) a background poll watch for `accountId`/`mailboxName`.
+     * The host resolves credentials itself from `accountId` — no `ImapConfig`
+     * is passed in. Requires `mail` permission with action `poll` on the
+     * account's IMAP host (prompted on first call, same as `fetch`/`send`).
+     *
+     * `intervalSeconds` is clamped host-side to [30, 3600]. Listen for
+     * results via `onNewMessages`.
+     */
+    startWatchingAsync(accountId: string, mailboxName: string, intervalSeconds: number): Promise<void>;
+    /** Stop a background poll watch previously started with `startWatchingAsync`. */
+    stopWatchingAsync(accountId: string, mailboxName: string): Promise<void>;
+    /**
+     * Register a callback for new-mail notifications from any active watch.
+     * `event.data` is a `MailNewMessagesEvent` — check `accountId`/`mailboxName`
+     * before refreshing if watching more than one account.
+     */
+    onNewMessages(callback: EventCallback): void;
+    /** Remove a new-mail callback registered with `onNewMessages`. */
+    offNewMessages(callback: EventCallback): void;
 }
 
 /**
@@ -1632,4 +1660,4 @@ declare class HaexVaultSdk {
     private log;
 }
 
-export { PermissionsAPI as $, type AuthorizedClient as A, type BlockedClient as B, type ConnectionSecurity as C, DatabaseAPI as D, type ExternalAuthDecision as E, type FileStat as F, type MessageEnvelope as G, HaexVaultSdk as H, type ImapConfig as I, type NotificationClickEvent as J, KnownPath as K, LOCALSEND_EVENTS as L, MailAPI as M, type NotificationAction as N, type NotificationOptions as O, NotificationsAPI as P, type OutgoingAttachment as Q, type OutgoingMessage as R, StorageAPI as S, type PasswordInput as T, type PasswordItemFull as U, type PasswordItemSummary as V, type PasswordKeyValue as W, type PasswordKeyValueInput as X, PasswordsAPI as Y, type PendingAuthorization as Z, type PendingTransfer as _, type DecryptedSpace as a, type AddBackendRequest as a0, type S3Config as a1, type S3PublicConfig as a2, RemoteStorageAPI as a3, type StorageBackendInfo as a4, type StorageObjectInfo as a5, type UpdateBackendRequest as a6, type RequestedExtension as a7, type SelectFileOptions as a8, type SelectFolderOptions as a9, type ServerInfo as aa, type ServerStatus as ab, type SessionAuthorization as ac, type SharedSpace as ad, ShellAPI as ae, type ShellCreateOptions as af, type ShellCreateResponse as ag, type ShellExitEvent as ah, type ShellOutputEvent as ai, type SmtpConfig as aj, type SpaceAccessTokenInfo as ak, type SpaceAssignment as al, type SpaceInvite as am, type SpaceKeyGrantInfo as an, type SpaceMemberInfo as ao, SpacesAPI as ap, type SyncBackendInfo as aq, type TransferDirection as ar, type TransferProgress as as, type TransferState as at, WebAPI as au, canExternalClientSendRequests as av, isExternalClientConnected as aw, type DeepLink as b, type Device as c, type DeviceInfo as d, type DeviceType as e, type DirEntry as f, type ExternalConnection as g, ExternalConnectionErrorCode as h, ExternalConnectionState as i, type ExternalRequest as j, type ExternalRequestEvent as k, type ExternalRequestHandler as l, type ExternalRequestPayload as m, type ExternalResponse as n, FilesystemAPI as o, type KnownPaths as p, LocalSendAPI as q, type LocalSendEvent as r, type FileInfo as s, type LocalSendSettings as t, type MailAccount as u, type MailAddress as v, type Attachment as w, type FetchRange as x, type MailMessage as y, type MailboxInfo as z };
+export { type PendingTransfer as $, type AuthorizedClient as A, type BlockedClient as B, type ConnectionSecurity as C, DatabaseAPI as D, type ExternalAuthDecision as E, type FileStat as F, type MailboxInfo as G, HaexVaultSdk as H, type ImapConfig as I, type MessageEnvelope as J, KnownPath as K, LOCALSEND_EVENTS as L, MailAPI as M, type NotificationAction as N, type NotificationClickEvent as O, type NotificationOptions as P, NotificationsAPI as Q, type OutgoingAttachment as R, StorageAPI as S, type OutgoingMessage as T, type PasswordInput as U, type PasswordItemFull as V, type PasswordItemSummary as W, type PasswordKeyValue as X, type PasswordKeyValueInput as Y, PasswordsAPI as Z, type PendingAuthorization as _, type DecryptedSpace as a, PermissionsAPI as a0, type AddBackendRequest as a1, type S3Config as a2, type S3PublicConfig as a3, RemoteStorageAPI as a4, type StorageBackendInfo as a5, type StorageObjectInfo as a6, type UpdateBackendRequest as a7, type RequestedExtension as a8, type SelectFileOptions as a9, type SelectFolderOptions as aa, type ServerInfo as ab, type ServerStatus as ac, type SessionAuthorization as ad, type SharedSpace as ae, ShellAPI as af, type ShellCreateOptions as ag, type ShellCreateResponse as ah, type ShellExitEvent as ai, type ShellOutputEvent as aj, type SmtpConfig as ak, type SpaceAccessTokenInfo as al, type SpaceAssignment as am, type SpaceInvite as an, type SpaceKeyGrantInfo as ao, type SpaceMemberInfo as ap, SpacesAPI as aq, type SyncBackendInfo as ar, type TransferDirection as as, type TransferProgress as at, type TransferState as au, WebAPI as av, canExternalClientSendRequests as aw, isExternalClientConnected as ax, type DeepLink as b, type Device as c, type DeviceInfo as d, type DeviceType as e, type DirEntry as f, type ExternalConnection as g, ExternalConnectionErrorCode as h, ExternalConnectionState as i, type ExternalRequest as j, type ExternalRequestEvent as k, type ExternalRequestHandler as l, type ExternalRequestPayload as m, type ExternalResponse as n, FilesystemAPI as o, type KnownPaths as p, LocalSendAPI as q, type LocalSendEvent as r, type FileInfo as s, type LocalSendSettings as t, type MailAccount as u, type MailAddress as v, type Attachment as w, type FetchRange as x, type MailMessage as y, type MailNewMessagesEvent as z };

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-import { H as HaexVaultSdk } from './client-DCoY4f3Q.mjs';
-export { A as AuthorizedClient, B as BlockedClient, C as ConnectionSecurity, D as DatabaseAPI, a as DecryptedSpace, b as DeepLink, c as Device, d as DeviceInfo, e as DeviceType, f as DirEntry, E as ExternalAuthDecision, g as ExternalConnection, h as ExternalConnectionErrorCode, i as ExternalConnectionState, j as ExternalRequest, k as ExternalRequestEvent, l as ExternalRequestHandler, m as ExternalRequestPayload, n as ExternalResponse, F as FileStat, o as FilesystemAPI, I as ImapConfig, K as KnownPath, p as KnownPaths, L as LOCALSEND_EVENTS, q as LocalSendAPI, r as LocalSendEvent, s as LocalSendFileInfo, t as LocalSendSettings, M as MailAPI, u as MailAccount, v as MailAddress, w as MailAttachment, x as MailFetchRange, y as MailMessage, z as MailboxInfo, G as MessageEnvelope, N as NotificationAction, J as NotificationClickEvent, O as NotificationOptions, P as NotificationsAPI, Q as OutgoingAttachment, R as OutgoingMessage, T as PasswordInput, U as PasswordItemFull, V as PasswordItemSummary, W as PasswordKeyValue, X as PasswordKeyValueInput, Y as PasswordsAPI, Z as PendingAuthorization, _ as PendingTransfer, $ as PermissionsAPI, a0 as RemoteAddBackendRequest, a1 as RemoteS3Config, a2 as RemoteS3PublicConfig, a3 as RemoteStorageAPI, a4 as RemoteStorageBackendInfo, a5 as RemoteStorageObjectInfo, a6 as RemoteUpdateBackendRequest, a7 as RequestedExtension, a8 as SelectFileOptions, a9 as SelectFolderOptions, aa as ServerInfo, ab as ServerStatus, ac as SessionAuthorization, ad as SharedSpace, ae as ShellAPI, af as ShellCreateOptions, ag as ShellCreateResponse, ah as ShellExitEvent, ai as ShellOutputEvent, aj as SmtpConfig, ak as SpaceAccessTokenInfo, al as SpaceAssignment, am as SpaceInvite, an as SpaceKeyGrantInfo, ao as SpaceMemberInfo, ap as SpacesAPI, aq as SyncBackendInfo, ar as TransferDirection, as as TransferProgress, at as TransferState, au as WebAPI, av as canExternalClientSendRequests, aw as isExternalClientConnected } from './client-DCoY4f3Q.mjs';
-import { E as ExtensionManifest, h as SignedClaimPresentation, H as HaexHubConfig } from './types-fHuxbqa4.mjs';
-export { A as ApplicationContext, C as ClaimRequirement, i as ContextChangedEvent, j as DEFAULT_TIMEOUT, k as DatabaseColumnInfo, l as DatabaseExecuteParams, m as DatabasePermission, g as DatabasePermissionRequest, n as DatabaseQueryParams, D as DatabaseQueryResult, o as DatabaseTableInfo, c as EXTERNAL_EVENTS, p as ErrorCode, f as EventCallback, a as ExtensionInfo, q as ExtensionRuntimeMode, r as ExternalEvent, F as FileChangeEvent, s as FileChangePayload, t as FileChangeType, u as FilteredSyncTablesResult, v as HAEXTENSION_EVENTS, b as HaexHubEvent, w as HaexHubRequest, x as HaexHubResponse, y as HaexVaultSdkError, z as HaextensionEvent, I as IdentityClaim, B as ManifestI18nEntry, N as NOTIFICATION_EVENTS, G as NotificationEvent, J as PermissionDeniedError, K as PermissionErrorBase, L as PermissionErrorCode, O as PermissionPromptError, P as PermissionResponse, Q as PermissionStatus, R as SHELL_EVENTS, T as SearchQuery, U as SearchRequestEvent, S as SearchResult, V as ShellEvent, X as SyncTablesUpdatedEvent, Y as TABLE_SEPARATOR, W as WebRequestOptions, e as WebResponse, Z as getTableName, _ as isPermissionDeniedError, $ as isPermissionError, a0 as isPermissionPromptError } from './types-fHuxbqa4.mjs';
+import { H as HaexVaultSdk } from './client-DnCZ3KyI.mjs';
+export { A as AuthorizedClient, B as BlockedClient, C as ConnectionSecurity, D as DatabaseAPI, a as DecryptedSpace, b as DeepLink, c as Device, d as DeviceInfo, e as DeviceType, f as DirEntry, E as ExternalAuthDecision, g as ExternalConnection, h as ExternalConnectionErrorCode, i as ExternalConnectionState, j as ExternalRequest, k as ExternalRequestEvent, l as ExternalRequestHandler, m as ExternalRequestPayload, n as ExternalResponse, F as FileStat, o as FilesystemAPI, I as ImapConfig, K as KnownPath, p as KnownPaths, L as LOCALSEND_EVENTS, q as LocalSendAPI, r as LocalSendEvent, s as LocalSendFileInfo, t as LocalSendSettings, M as MailAPI, u as MailAccount, v as MailAddress, w as MailAttachment, x as MailFetchRange, y as MailMessage, z as MailNewMessagesEvent, G as MailboxInfo, J as MessageEnvelope, N as NotificationAction, O as NotificationClickEvent, P as NotificationOptions, Q as NotificationsAPI, R as OutgoingAttachment, T as OutgoingMessage, U as PasswordInput, V as PasswordItemFull, W as PasswordItemSummary, X as PasswordKeyValue, Y as PasswordKeyValueInput, Z as PasswordsAPI, _ as PendingAuthorization, $ as PendingTransfer, a0 as PermissionsAPI, a1 as RemoteAddBackendRequest, a2 as RemoteS3Config, a3 as RemoteS3PublicConfig, a4 as RemoteStorageAPI, a5 as RemoteStorageBackendInfo, a6 as RemoteStorageObjectInfo, a7 as RemoteUpdateBackendRequest, a8 as RequestedExtension, a9 as SelectFileOptions, aa as SelectFolderOptions, ab as ServerInfo, ac as ServerStatus, ad as SessionAuthorization, ae as SharedSpace, af as ShellAPI, ag as ShellCreateOptions, ah as ShellCreateResponse, ai as ShellExitEvent, aj as ShellOutputEvent, ak as SmtpConfig, al as SpaceAccessTokenInfo, am as SpaceAssignment, an as SpaceInvite, ao as SpaceKeyGrantInfo, ap as SpaceMemberInfo, aq as SpacesAPI, ar as SyncBackendInfo, as as TransferDirection, at as TransferProgress, au as TransferState, av as WebAPI, aw as canExternalClientSendRequests, ax as isExternalClientConnected } from './client-DnCZ3KyI.mjs';
+import { E as ExtensionManifest, h as SignedClaimPresentation, H as HaexHubConfig } from './types-DQZCRfC-.mjs';
+export { A as ApplicationContext, C as ClaimRequirement, i as ContextChangedEvent, j as DEFAULT_TIMEOUT, k as DatabaseColumnInfo, l as DatabaseExecuteParams, m as DatabasePermission, g as DatabasePermissionRequest, n as DatabaseQueryParams, D as DatabaseQueryResult, o as DatabaseTableInfo, c as EXTERNAL_EVENTS, p as ErrorCode, f as EventCallback, a as ExtensionInfo, q as ExtensionRuntimeMode, r as ExternalEvent, F as FileChangeEvent, s as FileChangePayload, t as FileChangeType, u as FilteredSyncTablesResult, v as HAEXTENSION_EVENTS, b as HaexHubEvent, w as HaexHubRequest, x as HaexHubResponse, y as HaexVaultSdkError, z as HaextensionEvent, I as IdentityClaim, B as MAIL_EVENTS, G as MailEvent, J as ManifestI18nEntry, N as NOTIFICATION_EVENTS, K as NotificationEvent, L as PermissionDeniedError, O as PermissionErrorBase, Q as PermissionErrorCode, R as PermissionPromptError, P as PermissionResponse, T as PermissionStatus, U as SHELL_EVENTS, V as SearchQuery, X as SearchRequestEvent, S as SearchResult, Y as ShellEvent, Z as SyncTablesUpdatedEvent, _ as TABLE_SEPARATOR, W as WebRequestOptions, e as WebResponse, $ as getTableName, a0 as isPermissionDeniedError, a1 as isPermissionError, a2 as isPermissionPromptError } from './types-DQZCRfC-.mjs';
 export { H as HaextensionConfig } from './config-D_HXjsEV.mjs';
 import 'drizzle-orm/sqlite-proxy';
 
@@ -108,7 +108,8 @@ type PasswordCommand = (typeof PASSWORD_COMMANDS)[keyof typeof PASSWORD_COMMANDS
  * Mail Commands (IMAP fetch + SMTP send).
  *
  * Permissions are split protocol-wise: `fetch` covers all IMAP
- * operations (list/read/flag/move/append), `send` covers SMTP. Target
+ * operations (list/read/flag/move/append), `send` covers SMTP, `poll`
+ * covers background new-mail watching (startWatch/stopWatch). Target
  * matches mail-server hostnames; subdomain match is supported, so
  * target="gmail.com" grants access to "imap.gmail.com" and
  * "smtp.gmail.com".
@@ -134,6 +135,10 @@ declare const MAIL_COMMANDS: {
     readonly sendMessage: "extension_mail_send_message";
     /** Build RFC822 bytes without sending (for Drafts via APPEND) */
     readonly buildRfc822: "extension_mail_build_rfc822";
+    /** Start (or replace) a background poll watch for an account/mailbox */
+    readonly startWatch: "extension_mail_start_watch";
+    /** Stop a background poll watch */
+    readonly stopWatch: "extension_mail_stop_watch";
 };
 type MailCommand = (typeof MAIL_COMMANDS)[keyof typeof MAIL_COMMANDS];
 
@@ -793,6 +798,8 @@ declare const TAURI_COMMANDS: {
         readonly appendMessage: "extension_mail_append_message";
         readonly sendMessage: "extension_mail_send_message";
         readonly buildRfc822: "extension_mail_build_rfc822";
+        readonly startWatch: "extension_mail_start_watch";
+        readonly stopWatch: "extension_mail_stop_watch";
     };
     readonly notifications: {
         readonly show: "extension_notifications_show";

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { H as HaexVaultSdk } from './client-mcuC3gP5.js';
-export { A as AuthorizedClient, B as BlockedClient, C as ConnectionSecurity, D as DatabaseAPI, a as DecryptedSpace, b as DeepLink, c as Device, d as DeviceInfo, e as DeviceType, f as DirEntry, E as ExternalAuthDecision, g as ExternalConnection, h as ExternalConnectionErrorCode, i as ExternalConnectionState, j as ExternalRequest, k as ExternalRequestEvent, l as ExternalRequestHandler, m as ExternalRequestPayload, n as ExternalResponse, F as FileStat, o as FilesystemAPI, I as ImapConfig, K as KnownPath, p as KnownPaths, L as LOCALSEND_EVENTS, q as LocalSendAPI, r as LocalSendEvent, s as LocalSendFileInfo, t as LocalSendSettings, M as MailAPI, u as MailAccount, v as MailAddress, w as MailAttachment, x as MailFetchRange, y as MailMessage, z as MailboxInfo, G as MessageEnvelope, N as NotificationAction, J as NotificationClickEvent, O as NotificationOptions, P as NotificationsAPI, Q as OutgoingAttachment, R as OutgoingMessage, T as PasswordInput, U as PasswordItemFull, V as PasswordItemSummary, W as PasswordKeyValue, X as PasswordKeyValueInput, Y as PasswordsAPI, Z as PendingAuthorization, _ as PendingTransfer, $ as PermissionsAPI, a0 as RemoteAddBackendRequest, a1 as RemoteS3Config, a2 as RemoteS3PublicConfig, a3 as RemoteStorageAPI, a4 as RemoteStorageBackendInfo, a5 as RemoteStorageObjectInfo, a6 as RemoteUpdateBackendRequest, a7 as RequestedExtension, a8 as SelectFileOptions, a9 as SelectFolderOptions, aa as ServerInfo, ab as ServerStatus, ac as SessionAuthorization, ad as SharedSpace, ae as ShellAPI, af as ShellCreateOptions, ag as ShellCreateResponse, ah as ShellExitEvent, ai as ShellOutputEvent, aj as SmtpConfig, ak as SpaceAccessTokenInfo, al as SpaceAssignment, am as SpaceInvite, an as SpaceKeyGrantInfo, ao as SpaceMemberInfo, ap as SpacesAPI, aq as SyncBackendInfo, ar as TransferDirection, as as TransferProgress, at as TransferState, au as WebAPI, av as canExternalClientSendRequests, aw as isExternalClientConnected } from './client-mcuC3gP5.js';
-import { E as ExtensionManifest, h as SignedClaimPresentation, H as HaexHubConfig } from './types-fHuxbqa4.js';
-export { A as ApplicationContext, C as ClaimRequirement, i as ContextChangedEvent, j as DEFAULT_TIMEOUT, k as DatabaseColumnInfo, l as DatabaseExecuteParams, m as DatabasePermission, g as DatabasePermissionRequest, n as DatabaseQueryParams, D as DatabaseQueryResult, o as DatabaseTableInfo, c as EXTERNAL_EVENTS, p as ErrorCode, f as EventCallback, a as ExtensionInfo, q as ExtensionRuntimeMode, r as ExternalEvent, F as FileChangeEvent, s as FileChangePayload, t as FileChangeType, u as FilteredSyncTablesResult, v as HAEXTENSION_EVENTS, b as HaexHubEvent, w as HaexHubRequest, x as HaexHubResponse, y as HaexVaultSdkError, z as HaextensionEvent, I as IdentityClaim, B as ManifestI18nEntry, N as NOTIFICATION_EVENTS, G as NotificationEvent, J as PermissionDeniedError, K as PermissionErrorBase, L as PermissionErrorCode, O as PermissionPromptError, P as PermissionResponse, Q as PermissionStatus, R as SHELL_EVENTS, T as SearchQuery, U as SearchRequestEvent, S as SearchResult, V as ShellEvent, X as SyncTablesUpdatedEvent, Y as TABLE_SEPARATOR, W as WebRequestOptions, e as WebResponse, Z as getTableName, _ as isPermissionDeniedError, $ as isPermissionError, a0 as isPermissionPromptError } from './types-fHuxbqa4.js';
+import { H as HaexVaultSdk } from './client-uuhuCPDu.js';
+export { A as AuthorizedClient, B as BlockedClient, C as ConnectionSecurity, D as DatabaseAPI, a as DecryptedSpace, b as DeepLink, c as Device, d as DeviceInfo, e as DeviceType, f as DirEntry, E as ExternalAuthDecision, g as ExternalConnection, h as ExternalConnectionErrorCode, i as ExternalConnectionState, j as ExternalRequest, k as ExternalRequestEvent, l as ExternalRequestHandler, m as ExternalRequestPayload, n as ExternalResponse, F as FileStat, o as FilesystemAPI, I as ImapConfig, K as KnownPath, p as KnownPaths, L as LOCALSEND_EVENTS, q as LocalSendAPI, r as LocalSendEvent, s as LocalSendFileInfo, t as LocalSendSettings, M as MailAPI, u as MailAccount, v as MailAddress, w as MailAttachment, x as MailFetchRange, y as MailMessage, z as MailNewMessagesEvent, G as MailboxInfo, J as MessageEnvelope, N as NotificationAction, O as NotificationClickEvent, P as NotificationOptions, Q as NotificationsAPI, R as OutgoingAttachment, T as OutgoingMessage, U as PasswordInput, V as PasswordItemFull, W as PasswordItemSummary, X as PasswordKeyValue, Y as PasswordKeyValueInput, Z as PasswordsAPI, _ as PendingAuthorization, $ as PendingTransfer, a0 as PermissionsAPI, a1 as RemoteAddBackendRequest, a2 as RemoteS3Config, a3 as RemoteS3PublicConfig, a4 as RemoteStorageAPI, a5 as RemoteStorageBackendInfo, a6 as RemoteStorageObjectInfo, a7 as RemoteUpdateBackendRequest, a8 as RequestedExtension, a9 as SelectFileOptions, aa as SelectFolderOptions, ab as ServerInfo, ac as ServerStatus, ad as SessionAuthorization, ae as SharedSpace, af as ShellAPI, ag as ShellCreateOptions, ah as ShellCreateResponse, ai as ShellExitEvent, aj as ShellOutputEvent, ak as SmtpConfig, al as SpaceAccessTokenInfo, am as SpaceAssignment, an as SpaceInvite, ao as SpaceKeyGrantInfo, ap as SpaceMemberInfo, aq as SpacesAPI, ar as SyncBackendInfo, as as TransferDirection, at as TransferProgress, au as TransferState, av as WebAPI, aw as canExternalClientSendRequests, ax as isExternalClientConnected } from './client-uuhuCPDu.js';
+import { E as ExtensionManifest, h as SignedClaimPresentation, H as HaexHubConfig } from './types-DQZCRfC-.js';
+export { A as ApplicationContext, C as ClaimRequirement, i as ContextChangedEvent, j as DEFAULT_TIMEOUT, k as DatabaseColumnInfo, l as DatabaseExecuteParams, m as DatabasePermission, g as DatabasePermissionRequest, n as DatabaseQueryParams, D as DatabaseQueryResult, o as DatabaseTableInfo, c as EXTERNAL_EVENTS, p as ErrorCode, f as EventCallback, a as ExtensionInfo, q as ExtensionRuntimeMode, r as ExternalEvent, F as FileChangeEvent, s as FileChangePayload, t as FileChangeType, u as FilteredSyncTablesResult, v as HAEXTENSION_EVENTS, b as HaexHubEvent, w as HaexHubRequest, x as HaexHubResponse, y as HaexVaultSdkError, z as HaextensionEvent, I as IdentityClaim, B as MAIL_EVENTS, G as MailEvent, J as ManifestI18nEntry, N as NOTIFICATION_EVENTS, K as NotificationEvent, L as PermissionDeniedError, O as PermissionErrorBase, Q as PermissionErrorCode, R as PermissionPromptError, P as PermissionResponse, T as PermissionStatus, U as SHELL_EVENTS, V as SearchQuery, X as SearchRequestEvent, S as SearchResult, Y as ShellEvent, Z as SyncTablesUpdatedEvent, _ as TABLE_SEPARATOR, W as WebRequestOptions, e as WebResponse, $ as getTableName, a0 as isPermissionDeniedError, a1 as isPermissionError, a2 as isPermissionPromptError } from './types-DQZCRfC-.js';
 export { H as HaextensionConfig } from './config-D_HXjsEV.js';
 import 'drizzle-orm/sqlite-proxy';
 
@@ -108,7 +108,8 @@ type PasswordCommand = (typeof PASSWORD_COMMANDS)[keyof typeof PASSWORD_COMMANDS
  * Mail Commands (IMAP fetch + SMTP send).
  *
  * Permissions are split protocol-wise: `fetch` covers all IMAP
- * operations (list/read/flag/move/append), `send` covers SMTP. Target
+ * operations (list/read/flag/move/append), `send` covers SMTP, `poll`
+ * covers background new-mail watching (startWatch/stopWatch). Target
  * matches mail-server hostnames; subdomain match is supported, so
  * target="gmail.com" grants access to "imap.gmail.com" and
  * "smtp.gmail.com".
@@ -134,6 +135,10 @@ declare const MAIL_COMMANDS: {
     readonly sendMessage: "extension_mail_send_message";
     /** Build RFC822 bytes without sending (for Drafts via APPEND) */
     readonly buildRfc822: "extension_mail_build_rfc822";
+    /** Start (or replace) a background poll watch for an account/mailbox */
+    readonly startWatch: "extension_mail_start_watch";
+    /** Stop a background poll watch */
+    readonly stopWatch: "extension_mail_stop_watch";
 };
 type MailCommand = (typeof MAIL_COMMANDS)[keyof typeof MAIL_COMMANDS];
 
@@ -793,6 +798,8 @@ declare const TAURI_COMMANDS: {
         readonly appendMessage: "extension_mail_append_message";
         readonly sendMessage: "extension_mail_send_message";
         readonly buildRfc822: "extension_mail_build_rfc822";
+        readonly startWatch: "extension_mail_start_watch";
+        readonly stopWatch: "extension_mail_stop_watch";
     };
     readonly notifications: {
         readonly show: "extension_notifications_show";

package/dist/index.js

@@ -735,6 +735,10 @@ var SHELL_EVENTS = {
   /** Shell session has exited */
   EXIT: "shell:exit"
 };
+var MAIL_EVENTS = {
+  /** A watched mailbox's UID high-water mark advanced — new mail arrived. */
+  NEW_MESSAGES: "mail:new-messages"
+};
 
 // src/types.ts
 var DEFAULT_TIMEOUT = 3e4;
@@ -1090,7 +1094,11 @@ var MAIL_COMMANDS = {
   /** SMTP send. Returns the assigned Message-ID. */
   sendMessage: "extension_mail_send_message",
   /** Build RFC822 bytes without sending (for Drafts via APPEND) */
-  buildRfc822: "extension_mail_build_rfc822"
+  buildRfc822: "extension_mail_build_rfc822",
+  /** Start (or replace) a background poll watch for an account/mailbox */
+  startWatch: "extension_mail_start_watch",
+  /** Stop a background poll watch */
+  stopWatch: "extension_mail_stop_watch"
 };
 
 // src/commands/notifications.ts
@@ -2215,6 +2223,41 @@ var MailAPI = class {
       message
     });
   }
+  /**
+   * Start (or replace) a background poll watch for `accountId`/`mailboxName`.
+   * The host resolves credentials itself from `accountId` — no `ImapConfig`
+   * is passed in. Requires `mail` permission with action `poll` on the
+   * account's IMAP host (prompted on first call, same as `fetch`/`send`).
+   *
+   * `intervalSeconds` is clamped host-side to [30, 3600]. Listen for
+   * results via `onNewMessages`.
+   */
+  async startWatchingAsync(accountId, mailboxName, intervalSeconds) {
+    return this.client.request(MAIL_COMMANDS.startWatch, {
+      accountId,
+      mailboxName,
+      intervalSeconds
+    });
+  }
+  /** Stop a background poll watch previously started with `startWatchingAsync`. */
+  async stopWatchingAsync(accountId, mailboxName) {
+    return this.client.request(MAIL_COMMANDS.stopWatch, {
+      accountId,
+      mailboxName
+    });
+  }
+  /**
+   * Register a callback for new-mail notifications from any active watch.
+   * `event.data` is a `MailNewMessagesEvent` — check `accountId`/`mailboxName`
+   * before refreshing if watching more than one account.
+   */
+  onNewMessages(callback) {
+    this.client.on(MAIL_EVENTS.NEW_MESSAGES, callback);
+  }
+  /** Remove a new-mail callback registered with `onNewMessages`. */
+  offNewMessages(callback) {
+    this.client.off(MAIL_EVENTS.NEW_MESSAGES, callback);
+  }
 };
 
 // src/api/notifications.ts
@@ -2417,6 +2460,7 @@ async function setupTauriEventListeners(ctx, log, onEvent, onContextChange) {
     EXTERNAL_EVENTS.REQUEST,
     EXTERNAL_EVENTS.ACTION_REQUEST,
     NOTIFICATION_EVENTS.CLICK,
+    MAIL_EVENTS.NEW_MESSAGES,
     ...Object.values(LOCALSEND_EVENTS)
   ]) {
     await forwardEvent(listen, log, onEvent, listenOptions, eventName);
@@ -3847,6 +3891,7 @@ exports.KnownPath = KnownPath;
 exports.LOCALSEND_EVENTS = LOCALSEND_EVENTS;
 exports.LocalSendAPI = LocalSendAPI;
 exports.MAIL_COMMANDS = MAIL_COMMANDS;
+exports.MAIL_EVENTS = MAIL_EVENTS;
 exports.MailAPI = MailAPI;
 exports.NOTIFICATION_COMMANDS = NOTIFICATION_COMMANDS;
 exports.NOTIFICATION_EVENTS = NOTIFICATION_EVENTS;