@haex-space/vault-sdk 3.5.0 → 3.6.0

package/dist/index.mjs

@@ -733,6 +733,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;
@@ -1088,7 +1092,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
@@ -2213,6 +2221,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
@@ -2415,6 +2458,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);
@@ -3829,6 +3873,6 @@ function createHaexVaultSdk(config = {}) {
   return new HaexVaultSdk(config);
 }
 
-export { COSE_ALGORITHM, DEFAULT_TIMEOUT, DatabaseAPI, EXTERNAL_EVENTS, ErrorCode, ExternalConnectionErrorCode, ExternalConnectionState, FilesystemAPI, HAEXSPACE_MESSAGE_TYPES, HAEXTENSION_EVENTS, HaexVaultSdk, HaexVaultSdkError, KEY_AGREEMENT_ALGO, KnownPath, LOCALSEND_EVENTS, LocalSendAPI, MAIL_COMMANDS, MailAPI, NOTIFICATION_COMMANDS, NOTIFICATION_EVENTS, NotificationsAPI, PASSWORD_COMMANDS, PasswordsAPI, PermissionErrorCode, PermissionStatus, PermissionsAPI, RemoteStorageAPI, SHELL_EVENTS, SIGNING_ALGO, SPACE_COMMANDS, ShellAPI, SpacesAPI, TABLE_SEPARATOR, TAURI_COMMANDS, WebAPI, arrayBufferToBase64, base58btcDecode, base58btcEncode, base64ToArrayBuffer, canExternalClientSendRequests, createHaexVaultSdk, decryptCrdtData, decryptPrivateKeyAsync, decryptSpaceNameAsync, decryptString, decryptVaultKey, decryptVaultName, decryptWithPrivateKeyAsync, deriveKeyFromPassword, didKeyToPublicKeyAsync, encryptCrdtData, encryptPrivateKeyAsync, encryptSpaceNameAsync, encryptString, encryptVaultKey, encryptWithPublicKeyAsync, exportKeyPairAsync, exportPrivateKeyAsync, exportPublicKeyAsync, exportPublicKeyCoseAsync, exportUserKeypairAsync, generateCredentialId, generateIdentityAsync, generatePasskeyPairAsync, generateSpaceKey, generateUserKeypairAsync, generateVaultKey, getTableName, hexToBytes, importPrivateKeyAsync, importPrivateKeyForKeyAgreementAsync, importPublicKeyAsync, importPublicKeyForKeyAgreementAsync, importUserPrivateKeyAsync, importUserPublicKeyAsync, installBaseTag, installCookiePolyfill, installHistoryPolyfill, installLocalStoragePolyfill, installPolyfills, installSessionStoragePolyfill, isExternalClientConnected, isPermissionDeniedError, isPermissionError, isPermissionPromptError, publicKeyToDidKeyAsync, signClaimPresentationAsync, signRecordAsync, signSpaceChallengeAsync, signWithPasskeyAsync, sortObjectKeysRecursively, unwrapKey, verifyClaimPresentationAsync, verifyExtensionSignature, verifyRecordSignatureAsync, verifySpaceChallengeAsync, verifyWithPasskeyAsync, wrapKey };
+export { COSE_ALGORITHM, DEFAULT_TIMEOUT, DatabaseAPI, EXTERNAL_EVENTS, ErrorCode, ExternalConnectionErrorCode, ExternalConnectionState, FilesystemAPI, HAEXSPACE_MESSAGE_TYPES, HAEXTENSION_EVENTS, HaexVaultSdk, HaexVaultSdkError, KEY_AGREEMENT_ALGO, KnownPath, LOCALSEND_EVENTS, LocalSendAPI, MAIL_COMMANDS, MAIL_EVENTS, MailAPI, NOTIFICATION_COMMANDS, NOTIFICATION_EVENTS, NotificationsAPI, PASSWORD_COMMANDS, PasswordsAPI, PermissionErrorCode, PermissionStatus, PermissionsAPI, RemoteStorageAPI, SHELL_EVENTS, SIGNING_ALGO, SPACE_COMMANDS, ShellAPI, SpacesAPI, TABLE_SEPARATOR, TAURI_COMMANDS, WebAPI, arrayBufferToBase64, base58btcDecode, base58btcEncode, base64ToArrayBuffer, canExternalClientSendRequests, createHaexVaultSdk, decryptCrdtData, decryptPrivateKeyAsync, decryptSpaceNameAsync, decryptString, decryptVaultKey, decryptVaultName, decryptWithPrivateKeyAsync, deriveKeyFromPassword, didKeyToPublicKeyAsync, encryptCrdtData, encryptPrivateKeyAsync, encryptSpaceNameAsync, encryptString, encryptVaultKey, encryptWithPublicKeyAsync, exportKeyPairAsync, exportPrivateKeyAsync, exportPublicKeyAsync, exportPublicKeyCoseAsync, exportUserKeypairAsync, generateCredentialId, generateIdentityAsync, generatePasskeyPairAsync, generateSpaceKey, generateUserKeypairAsync, generateVaultKey, getTableName, hexToBytes, importPrivateKeyAsync, importPrivateKeyForKeyAgreementAsync, importPublicKeyAsync, importPublicKeyForKeyAgreementAsync, importUserPrivateKeyAsync, importUserPublicKeyAsync, installBaseTag, installCookiePolyfill, installHistoryPolyfill, installLocalStoragePolyfill, installPolyfills, installSessionStoragePolyfill, isExternalClientConnected, isPermissionDeniedError, isPermissionError, isPermissionPromptError, publicKeyToDidKeyAsync, signClaimPresentationAsync, signRecordAsync, signSpaceChallengeAsync, signWithPasskeyAsync, sortObjectKeysRecursively, unwrapKey, verifyClaimPresentationAsync, verifyExtensionSignature, verifyRecordSignatureAsync, verifySpaceChallengeAsync, verifyWithPasskeyAsync, wrapKey };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map