@haex-space/vault-sdk 3.2.8 → 3.3.0

package/dist/react.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",
@@ -686,6 +690,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) {
@@ -1760,6 +1772,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 +1971,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 +2447,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;