@haex-space/vault-sdk 3.2.8 → 3.4.0

package/dist/svelte.mjs

@@ -402,6 +402,10 @@ var HAEXTENSION_EVENTS = {
    *  subscribe via `client.on(HAEXTENSION_EVENTS.PERMISSION_RESOLVED, ...)`. */
   PERMISSION_RESOLVED: "extension:permission-resolved"
 };
+var NOTIFICATION_EVENTS = {
+  /** A click on one of this extension's notifications (body or action button). */
+  CLICK: "haextension:notification:click"
+};
 var EXTERNAL_EVENTS = {
   /** External request from authorized client */
   REQUEST: "haextension:external:request",
@@ -674,6 +678,8 @@ var MAIL_COMMANDS = {
   fetchEnvelopes: "extension_mail_fetch_envelopes",
   /** Full message fetch (envelope + body + attachment metadata) */
   fetchMessage: "extension_mail_fetch_message",
+  /** Fetch a single attachment's bytes (base64) by part index */
+  fetchAttachment: "extension_mail_fetch_attachment",
   /** Set or unset IMAP flags on a UID set */
   setFlags: "extension_mail_set_flags",
   /** MOVE messages between mailboxes (COPY+EXPUNGE fallback) */
@@ -686,6 +692,14 @@ var MAIL_COMMANDS = {
   buildRfc822: "extension_mail_build_rfc822"
 };
 
+// src/commands/notifications.ts
+var NOTIFICATION_COMMANDS = {
+  /** Show an OS notification. Returns the assigned notification id. */
+  show: "extension_notifications_show",
+  /** Dismiss a previously shown notification (only own notifications). */
+  dismiss: "extension_notifications_dismiss"
+};
+
 // src/api/storage.ts
 var StorageAPI = class {
   constructor(client) {
@@ -1705,6 +1719,21 @@ var MailAPI = class {
       uid
     });
   }
+  /**
+   * Fetch a single attachment's raw bytes by its `partIndex` (from the
+   * `attachments` array of a fetched `MailMessage`), returned as a
+   * standard-alphabet base64 string. The base64 form drops straight into
+   * `OutgoingAttachment.data` when forwarding, and decodes to bytes for
+   * viewing or downloading.
+   */
+  async fetchAttachmentAsync(imap, mailbox, uid, partIndex) {
+    return this.client.request(MAIL_COMMANDS.fetchAttachment, {
+      imap,
+      mailbox,
+      uid,
+      partIndex
+    });
+  }
   /**
    * Set or unset IMAP flags. Use `flags=["\\Seen"]` + `add=true` to
    * mark messages as read; `add=false` removes the flag(s).
@@ -1760,6 +1789,38 @@ var MailAPI = class {
   }
 };
 
+// src/api/notifications.ts
+var NotificationsAPI = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Show a notification. Returns its id so it can be dismissed later. */
+  async show(opts) {
+    return this.client.request(NOTIFICATION_COMMANDS.show, {
+      options: opts
+    });
+  }
+  /** Dismiss a previously shown notification (only own notifications). */
+  async dismiss(id) {
+    return this.client.request(NOTIFICATION_COMMANDS.dismiss, { id });
+  }
+  /**
+   * Listen for clicks on this extension's notifications. Useful when the
+   * extension is already open and wants to react in-app (e.g. router.push the
+   * `path`) instead of relying on the host to focus the webview.
+   *
+   * Returns an unsubscribe function.
+   */
+  onClick(handler) {
+    const wrapped = (event) => {
+      const data = event.data;
+      if (data) handler(data);
+    };
+    this.client.on(NOTIFICATION_EVENTS.CLICK, wrapped);
+    return () => this.client.off(NOTIFICATION_EVENTS.CLICK, wrapped);
+  }
+};
+
 // src/client/tableName.ts
 function validatePublicKey(publicKey) {
   if (!publicKey || typeof publicKey !== "string" || publicKey.trim() === "") {
@@ -1927,6 +1988,7 @@ async function setupTauriEventListeners(ctx, log, onEvent, onContextChange) {
     HAEXTENSION_EVENTS.PERMISSION_RESOLVED,
     EXTERNAL_EVENTS.REQUEST,
     EXTERNAL_EVENTS.ACTION_REQUEST,
+    NOTIFICATION_EVENTS.CLICK,
     ...Object.values(LOCALSEND_EVENTS)
   ]) {
     await forwardEvent(listen, log, onEvent, listenOptions, eventName);
@@ -2402,6 +2464,7 @@ var HaexVaultSdk = class {
     this.shell = new ShellAPI(this);
     this.passwords = new PasswordsAPI(this);
     this.mail = new MailAPI(this);
+    this.notifications = new NotificationsAPI(this);
     installConsoleForwarding(this.config.debug);
     this.on(HAEXTENSION_EVENTS.PERMISSION_RESOLVED, (event) => {
       const data = event.data;