@haex-space/vault-sdk 3.5.0 → 3.6.0

package/dist/svelte.mjs

@@ -417,6 +417,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;
@@ -689,7 +693,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
@@ -1787,6 +1795,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
@@ -1989,6 +2032,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);