@haex-space/vault-sdk 3.5.1 → 3.7.0

package/dist/{client-DCoY4f3Q.d.mts → client-DH4Km77u.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';
 
 /**
@@ -983,6 +983,14 @@ interface SpaceMemberInfo {
     invitedBy: string | null;
     joinedAt: string;
 }
+interface SpaceMember {
+    /** DID of this member (did:key:z...) */
+    did: string;
+    /** Display label (identity name) */
+    label: string;
+    /** True if this member is one of the current vault's own identities */
+    isSelf: boolean;
+}
 interface SpaceKeyGrantInfo {
     spaceId: string;
     generation: number;
@@ -1047,6 +1055,8 @@ interface SpaceAssignment {
     type?: string;
     /** Optional display label (e.g. "Personal", "Team Q1") */
     label?: string;
+    /** DID of the member who created this assignment (did:key:z...). Undefined for local/legacy rows. */
+    authoredByDid?: string;
 }
 /**
  * Spaces API for managing row-to-space assignments.
@@ -1113,6 +1123,11 @@ declare class SpacesAPI {
      * Returns spaces with decrypted names (decryption happens vault-side).
      */
     listSpacesAsync(): Promise<DecryptedSpace[]>;
+    /**
+     * List members of a shared space (DID + label), flagging the current user.
+     * Used to resolve assignment authors to names and to detect own vs shared-in content.
+     */
+    getMembersAsync(spaceId: string): Promise<SpaceMember[]>;
 }
 
 interface ShellCreateOptions {
@@ -1318,6 +1333,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 +1425,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 +1480,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 +1675,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 SpaceMember as ap, type SpaceMemberInfo as aq, SpacesAPI as ar, type SyncBackendInfo as as, type TransferDirection as at, type TransferProgress as au, type TransferState as av, WebAPI as aw, canExternalClientSendRequests as ax, isExternalClientConnected as ay, 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-mcuC3gP5.d.ts → client-Dn4AbXbT.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';
 
 /**
@@ -983,6 +983,14 @@ interface SpaceMemberInfo {
     invitedBy: string | null;
     joinedAt: string;
 }
+interface SpaceMember {
+    /** DID of this member (did:key:z...) */
+    did: string;
+    /** Display label (identity name) */
+    label: string;
+    /** True if this member is one of the current vault's own identities */
+    isSelf: boolean;
+}
 interface SpaceKeyGrantInfo {
     spaceId: string;
     generation: number;
@@ -1047,6 +1055,8 @@ interface SpaceAssignment {
     type?: string;
     /** Optional display label (e.g. "Personal", "Team Q1") */
     label?: string;
+    /** DID of the member who created this assignment (did:key:z...). Undefined for local/legacy rows. */
+    authoredByDid?: string;
 }
 /**
  * Spaces API for managing row-to-space assignments.
@@ -1113,6 +1123,11 @@ declare class SpacesAPI {
      * Returns spaces with decrypted names (decryption happens vault-side).
      */
     listSpacesAsync(): Promise<DecryptedSpace[]>;
+    /**
+     * List members of a shared space (DID + label), flagging the current user.
+     * Used to resolve assignment authors to names and to detect own vs shared-in content.
+     */
+    getMembersAsync(spaceId: string): Promise<SpaceMember[]>;
 }
 
 interface ShellCreateOptions {
@@ -1318,6 +1333,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 +1425,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 +1480,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 +1675,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 SpaceMember as ap, type SpaceMemberInfo as aq, SpacesAPI as ar, type SyncBackendInfo as as, type TransferDirection as at, type TransferProgress as au, type TransferState as av, WebAPI as aw, canExternalClientSendRequests as ax, isExternalClientConnected as ay, 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-Dn4AbXbT.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 SpaceMember, aq as SpaceMemberInfo, ar as SpacesAPI, as as SyncBackendInfo, at as TransferDirection, au as TransferProgress, av as TransferState, aw as WebAPI, ax as canExternalClientSendRequests, ay as isExternalClientConnected } from './client-Dn4AbXbT.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];
 
@@ -614,6 +619,8 @@ declare const SPACE_COMMANDS: {
     readonly unassign: "extension_space_unassign";
     /** Get space assignments for a table */
     readonly getAssignments: "extension_space_get_assignments";
+    /** Get members of a shared space */
+    readonly getMembers: "extension_space_get_members";
     /** List all spaces the user is a member of (with decrypted names) */
     readonly list: "extension_space_list";
     /** Create a new shared space */
@@ -765,6 +772,7 @@ declare const TAURI_COMMANDS: {
         readonly assign: "extension_space_assign";
         readonly unassign: "extension_space_unassign";
         readonly getAssignments: "extension_space_get_assignments";
+        readonly getMembers: "extension_space_get_members";
         readonly list: "extension_space_list";
         readonly create: "extension_space_create";
         readonly listBackends: "extension_space_list_backends";
@@ -793,6 +801,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-DH4Km77u.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 SpaceMember, aq as SpaceMemberInfo, ar as SpacesAPI, as as SyncBackendInfo, at as TransferDirection, au as TransferProgress, av as TransferState, aw as WebAPI, ax as canExternalClientSendRequests, ay as isExternalClientConnected } from './client-DH4Km77u.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];
 
@@ -614,6 +619,8 @@ declare const SPACE_COMMANDS: {
     readonly unassign: "extension_space_unassign";
     /** Get space assignments for a table */
     readonly getAssignments: "extension_space_get_assignments";
+    /** Get members of a shared space */
+    readonly getMembers: "extension_space_get_members";
     /** List all spaces the user is a member of (with decrypted names) */
     readonly list: "extension_space_list";
     /** Create a new shared space */
@@ -765,6 +772,7 @@ declare const TAURI_COMMANDS: {
         readonly assign: "extension_space_assign";
         readonly unassign: "extension_space_unassign";
         readonly getAssignments: "extension_space_get_assignments";
+        readonly getMembers: "extension_space_get_members";
         readonly list: "extension_space_list";
         readonly create: "extension_space_create";
         readonly listBackends: "extension_space_list_backends";
@@ -793,6 +801,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;
@@ -1035,6 +1039,8 @@ var SPACE_COMMANDS = {
   unassign: "extension_space_unassign",
   /** Get space assignments for a table */
   getAssignments: "extension_space_get_assignments",
+  /** Get members of a shared space */
+  getMembers: "extension_space_get_members",
   /** List all spaces the user is a member of (with decrypted names) */
   list: "extension_space_list",
   /** Create a new shared space */
@@ -1090,7 +1096,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
@@ -1995,6 +2005,13 @@ var SpacesAPI = class {
   async listSpacesAsync() {
     return this.client.request(SPACE_COMMANDS.list);
   }
+  /**
+   * List members of a shared space (DID + label), flagging the current user.
+   * Used to resolve assignment authors to names and to detect own vs shared-in content.
+   */
+  async getMembersAsync(spaceId) {
+    return this.client.request(SPACE_COMMANDS.getMembers, { spaceId });
+  }
 };
 
 // src/api/shell.ts
@@ -2215,6 +2232,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 +2469,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 +3900,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;