@haex-space/vault-sdk 3.5.0 → 3.6.0

package/dist/{types-fHuxbqa4.d.mts → types-DQZCRfC-.d.mts}

@@ -57,6 +57,14 @@ declare const SHELL_EVENTS: {
     readonly EXIT: "shell:exit";
 };
 type ShellEvent = typeof SHELL_EVENTS[keyof typeof SHELL_EVENTS];
+/**
+ * Events for background mail-poll watches (`mail.startWatchingAsync`).
+ */
+declare const MAIL_EVENTS: {
+    /** A watched mailbox's UID high-water mark advanced — new mail arrived. */
+    readonly NEW_MESSAGES: "mail:new-messages";
+};
+type MailEvent = typeof MAIL_EVENTS[keyof typeof MAIL_EVENTS];
 
 declare const DEFAULT_TIMEOUT = 30000;
 declare const TABLE_SEPARATOR = "__";
@@ -407,4 +415,4 @@ declare class HaexVaultSdkError extends Error {
     };
 }
 
-export { isPermissionError as $, type ApplicationContext as A, type ManifestI18nEntry as B, type ClaimRequirement as C, type DatabaseQueryResult as D, type ExtensionManifest as E, type FileChangeEvent as F, type NotificationEvent as G, type HaexHubConfig as H, type IdentityClaim as I, type PermissionDeniedError as J, type PermissionErrorBase as K, PermissionErrorCode as L, type Migration as M, NOTIFICATION_EVENTS as N, type PermissionPromptError as O, type PermissionResponse as P, PermissionStatus as Q, SHELL_EVENTS as R, type SearchResult as S, type SearchQuery as T, type SearchRequestEvent as U, type ShellEvent as V, type WebRequestOptions as W, type SyncTablesUpdatedEvent as X, TABLE_SEPARATOR as Y, getTableName as Z, isPermissionDeniedError as _, type ExtensionInfo as a, isPermissionPromptError as a0, type HaexHubEvent as b, EXTERNAL_EVENTS as c, type MigrationResult as d, type WebResponse as e, type EventCallback as f, type DatabasePermissionRequest as g, type SignedClaimPresentation as h, type ContextChangedEvent as i, DEFAULT_TIMEOUT as j, type DatabaseColumnInfo as k, type DatabaseExecuteParams as l, type DatabasePermission as m, type DatabaseQueryParams as n, type DatabaseTableInfo as o, ErrorCode as p, type ExtensionRuntimeMode as q, type ExternalEvent as r, type FileChangePayload as s, type FileChangeType as t, type FilteredSyncTablesResult as u, HAEXTENSION_EVENTS as v, type HaexHubRequest as w, type HaexHubResponse as x, HaexVaultSdkError as y, type HaextensionEvent as z };
+export { getTableName as $, type ApplicationContext as A, MAIL_EVENTS as B, type ClaimRequirement as C, type DatabaseQueryResult as D, type ExtensionManifest as E, type FileChangeEvent as F, type MailEvent as G, type HaexHubConfig as H, type IdentityClaim as I, type ManifestI18nEntry as J, type NotificationEvent as K, type PermissionDeniedError as L, type Migration as M, NOTIFICATION_EVENTS as N, type PermissionErrorBase as O, type PermissionResponse as P, PermissionErrorCode as Q, type PermissionPromptError as R, type SearchResult as S, PermissionStatus as T, SHELL_EVENTS as U, type SearchQuery as V, type WebRequestOptions as W, type SearchRequestEvent as X, type ShellEvent as Y, type SyncTablesUpdatedEvent as Z, TABLE_SEPARATOR as _, type ExtensionInfo as a, isPermissionDeniedError as a0, isPermissionError as a1, isPermissionPromptError as a2, type HaexHubEvent as b, EXTERNAL_EVENTS as c, type MigrationResult as d, type WebResponse as e, type EventCallback as f, type DatabasePermissionRequest as g, type SignedClaimPresentation as h, type ContextChangedEvent as i, DEFAULT_TIMEOUT as j, type DatabaseColumnInfo as k, type DatabaseExecuteParams as l, type DatabasePermission as m, type DatabaseQueryParams as n, type DatabaseTableInfo as o, ErrorCode as p, type ExtensionRuntimeMode as q, type ExternalEvent as r, type FileChangePayload as s, type FileChangeType as t, type FilteredSyncTablesResult as u, HAEXTENSION_EVENTS as v, type HaexHubRequest as w, type HaexHubResponse as x, HaexVaultSdkError as y, type HaextensionEvent as z };

package/dist/{types-fHuxbqa4.d.ts → types-DQZCRfC-.d.ts}

@@ -57,6 +57,14 @@ declare const SHELL_EVENTS: {
     readonly EXIT: "shell:exit";
 };
 type ShellEvent = typeof SHELL_EVENTS[keyof typeof SHELL_EVENTS];
+/**
+ * Events for background mail-poll watches (`mail.startWatchingAsync`).
+ */
+declare const MAIL_EVENTS: {
+    /** A watched mailbox's UID high-water mark advanced — new mail arrived. */
+    readonly NEW_MESSAGES: "mail:new-messages";
+};
+type MailEvent = typeof MAIL_EVENTS[keyof typeof MAIL_EVENTS];
 
 declare const DEFAULT_TIMEOUT = 30000;
 declare const TABLE_SEPARATOR = "__";
@@ -407,4 +415,4 @@ declare class HaexVaultSdkError extends Error {
     };
 }
 
-export { isPermissionError as $, type ApplicationContext as A, type ManifestI18nEntry as B, type ClaimRequirement as C, type DatabaseQueryResult as D, type ExtensionManifest as E, type FileChangeEvent as F, type NotificationEvent as G, type HaexHubConfig as H, type IdentityClaim as I, type PermissionDeniedError as J, type PermissionErrorBase as K, PermissionErrorCode as L, type Migration as M, NOTIFICATION_EVENTS as N, type PermissionPromptError as O, type PermissionResponse as P, PermissionStatus as Q, SHELL_EVENTS as R, type SearchResult as S, type SearchQuery as T, type SearchRequestEvent as U, type ShellEvent as V, type WebRequestOptions as W, type SyncTablesUpdatedEvent as X, TABLE_SEPARATOR as Y, getTableName as Z, isPermissionDeniedError as _, type ExtensionInfo as a, isPermissionPromptError as a0, type HaexHubEvent as b, EXTERNAL_EVENTS as c, type MigrationResult as d, type WebResponse as e, type EventCallback as f, type DatabasePermissionRequest as g, type SignedClaimPresentation as h, type ContextChangedEvent as i, DEFAULT_TIMEOUT as j, type DatabaseColumnInfo as k, type DatabaseExecuteParams as l, type DatabasePermission as m, type DatabaseQueryParams as n, type DatabaseTableInfo as o, ErrorCode as p, type ExtensionRuntimeMode as q, type ExternalEvent as r, type FileChangePayload as s, type FileChangeType as t, type FilteredSyncTablesResult as u, HAEXTENSION_EVENTS as v, type HaexHubRequest as w, type HaexHubResponse as x, HaexVaultSdkError as y, type HaextensionEvent as z };
+export { getTableName as $, type ApplicationContext as A, MAIL_EVENTS as B, type ClaimRequirement as C, type DatabaseQueryResult as D, type ExtensionManifest as E, type FileChangeEvent as F, type MailEvent as G, type HaexHubConfig as H, type IdentityClaim as I, type ManifestI18nEntry as J, type NotificationEvent as K, type PermissionDeniedError as L, type Migration as M, NOTIFICATION_EVENTS as N, type PermissionErrorBase as O, type PermissionResponse as P, PermissionErrorCode as Q, type PermissionPromptError as R, type SearchResult as S, PermissionStatus as T, SHELL_EVENTS as U, type SearchQuery as V, type WebRequestOptions as W, type SearchRequestEvent as X, type ShellEvent as Y, type SyncTablesUpdatedEvent as Z, TABLE_SEPARATOR as _, type ExtensionInfo as a, isPermissionDeniedError as a0, isPermissionError as a1, isPermissionPromptError as a2, type HaexHubEvent as b, EXTERNAL_EVENTS as c, type MigrationResult as d, type WebResponse as e, type EventCallback as f, type DatabasePermissionRequest as g, type SignedClaimPresentation as h, type ContextChangedEvent as i, DEFAULT_TIMEOUT as j, type DatabaseColumnInfo as k, type DatabaseExecuteParams as l, type DatabasePermission as m, type DatabaseQueryParams as n, type DatabaseTableInfo as o, ErrorCode as p, type ExtensionRuntimeMode as q, type ExternalEvent as r, type FileChangePayload as s, type FileChangeType as t, type FilteredSyncTablesResult as u, HAEXTENSION_EVENTS as v, type HaexHubRequest as w, type HaexHubResponse as x, HaexVaultSdkError as y, type HaextensionEvent as z };

package/dist/vue.d.mts

@@ -1,7 +1,7 @@
-import { H as HaexVaultSdk, S as StorageAPI } from './client-DCoY4f3Q.mjs';
+import { H as HaexVaultSdk, S as StorageAPI } from './client-DnCZ3KyI.mjs';
 import * as drizzle_orm_sqlite_proxy from 'drizzle-orm/sqlite-proxy';
 import { Ref } from 'vue';
-import { H as HaexHubConfig } from './types-fHuxbqa4.mjs';
+import { H as HaexHubConfig } from './types-DQZCRfC-.mjs';
 
 /**
  * Vue 3 composable for HaexVault SDK

package/dist/vue.d.ts

@@ -1,7 +1,7 @@
-import { H as HaexVaultSdk, S as StorageAPI } from './client-mcuC3gP5.js';
+import { H as HaexVaultSdk, S as StorageAPI } from './client-uuhuCPDu.js';
 import * as drizzle_orm_sqlite_proxy from 'drizzle-orm/sqlite-proxy';
 import { Ref } from 'vue';
-import { H as HaexHubConfig } from './types-fHuxbqa4.js';
+import { H as HaexHubConfig } from './types-DQZCRfC-.js';
 
 /**
  * Vue 3 composable for HaexVault SDK

package/dist/vue.js

@@ -419,6 +419,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;
@@ -691,7 +695,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
@@ -1789,6 +1797,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
@@ -1991,6 +2034,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);