@haex-space/vault-sdk 3.2.8 → 3.4.0

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

@@ -27,6 +27,14 @@ declare const HAEXTENSION_EVENTS: {
     readonly PERMISSION_RESOLVED: "extension:permission-resolved";
 };
 type HaextensionEvent = typeof HAEXTENSION_EVENTS[keyof typeof HAEXTENSION_EVENTS];
+/**
+ * Events for the generic notifications API.
+ */
+declare const NOTIFICATION_EVENTS: {
+    /** A click on one of this extension's notifications (body or action button). */
+    readonly CLICK: "haextension:notification:click";
+};
+type NotificationEvent = typeof NOTIFICATION_EVENTS[keyof typeof NOTIFICATION_EVENTS];
 /**
  * Events for external client communication (browser extensions, CLI tools, servers, etc.)
  */
@@ -399,4 +407,4 @@ declare class HaexVaultSdkError extends Error {
     };
 }
 
-export { 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 PermissionDeniedError as G, type HaexHubConfig as H, type IdentityClaim as I, type PermissionErrorBase as J, PermissionErrorCode as K, type PermissionPromptError as L, type Migration as M, PermissionStatus as N, SHELL_EVENTS as O, type PermissionResponse as P, type SearchQuery as Q, type SearchRequestEvent as R, type SearchResult as S, type ShellEvent as T, type SyncTablesUpdatedEvent as U, TABLE_SEPARATOR as V, type WebRequestOptions as W, getTableName as X, isPermissionDeniedError as Y, isPermissionError as Z, isPermissionPromptError as _, type ExtensionInfo as a, 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 { 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 };

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

@@ -27,6 +27,14 @@ declare const HAEXTENSION_EVENTS: {
     readonly PERMISSION_RESOLVED: "extension:permission-resolved";
 };
 type HaextensionEvent = typeof HAEXTENSION_EVENTS[keyof typeof HAEXTENSION_EVENTS];
+/**
+ * Events for the generic notifications API.
+ */
+declare const NOTIFICATION_EVENTS: {
+    /** A click on one of this extension's notifications (body or action button). */
+    readonly CLICK: "haextension:notification:click";
+};
+type NotificationEvent = typeof NOTIFICATION_EVENTS[keyof typeof NOTIFICATION_EVENTS];
 /**
  * Events for external client communication (browser extensions, CLI tools, servers, etc.)
  */
@@ -399,4 +407,4 @@ declare class HaexVaultSdkError extends Error {
     };
 }
 
-export { 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 PermissionDeniedError as G, type HaexHubConfig as H, type IdentityClaim as I, type PermissionErrorBase as J, PermissionErrorCode as K, type PermissionPromptError as L, type Migration as M, PermissionStatus as N, SHELL_EVENTS as O, type PermissionResponse as P, type SearchQuery as Q, type SearchRequestEvent as R, type SearchResult as S, type ShellEvent as T, type SyncTablesUpdatedEvent as U, TABLE_SEPARATOR as V, type WebRequestOptions as W, getTableName as X, isPermissionDeniedError as Y, isPermissionError as Z, isPermissionPromptError as _, type ExtensionInfo as a, 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 { 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 };

package/dist/vue.d.mts

@@ -1,7 +1,7 @@
-import { H as HaexVaultSdk, S as StorageAPI } from './client-DaS2fAf-.mjs';
+import { H as HaexVaultSdk, S as StorageAPI } from './client-C9FyPkqp.mjs';
 import * as drizzle_orm_sqlite_proxy from 'drizzle-orm/sqlite-proxy';
 import { Ref } from 'vue';
-import { H as HaexHubConfig } from './types-Cji-mUN0.mjs';
+import { H as HaexHubConfig } from './types-fHuxbqa4.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-BBD-YsPv.js';
+import { H as HaexVaultSdk, S as StorageAPI } from './client--_QYySP0.js';
 import * as drizzle_orm_sqlite_proxy from 'drizzle-orm/sqlite-proxy';
 import { Ref } from 'vue';
-import { H as HaexHubConfig } from './types-Cji-mUN0.js';
+import { H as HaexHubConfig } from './types-fHuxbqa4.js';
 
 /**
  * Vue 3 composable for HaexVault SDK

package/dist/vue.js

@@ -404,6 +404,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",
@@ -676,6 +680,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) */
@@ -688,6 +694,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) {
@@ -1707,6 +1721,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).
@@ -1762,6 +1791,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() === "") {
@@ -1929,6 +1990,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);
@@ -2404,6 +2466,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;