@haex-space/vault-sdk 2.5.0 → 2.5.4

package/dist/{types-Bw5uc1vm.d.mts → types-mMVOhsmm.d.mts}

@@ -254,6 +254,68 @@ interface PendingAuthorization {
  * Decision type for external authorization prompts
  */
 type ExternalAuthDecision = 'allow' | 'deny';
+/**
+ * Connection state for external clients connecting to haex-vault via WebSocket.
+ * Used by browser extensions, CLI tools, servers, and other external clients.
+ */
+declare enum ExternalConnectionState {
+    /** Not connected to haex-vault */
+    DISCONNECTED = "disconnected",
+    /** Attempting to establish connection */
+    CONNECTING = "connecting",
+    /** WebSocket connected but not yet authorized */
+    CONNECTED = "connected",
+    /** Connected and waiting for user approval in haex-vault */
+    PENDING_APPROVAL = "pending_approval",
+    /** Connected and authorized to communicate */
+    PAIRED = "paired"
+}
+/**
+ * Error codes for external client connections.
+ * Used to identify specific error conditions for i18n in the frontend.
+ */
+declare enum ExternalConnectionErrorCode {
+    /** No error */
+    NONE = "none",
+    /** Client is not authorized (rejected or not yet approved) */
+    CLIENT_NOT_AUTHORIZED = "client_not_authorized",
+    /** Client was blocked by the user */
+    CLIENT_BLOCKED = "client_blocked",
+    /** Connection to haex-vault failed (not running or network error) */
+    CONNECTION_FAILED = "connection_failed",
+    /** Connection timed out */
+    CONNECTION_TIMEOUT = "connection_timeout",
+    /** WebSocket connection was closed unexpectedly */
+    CONNECTION_CLOSED = "connection_closed",
+    /** Failed to decrypt message (invalid key or corrupted data) */
+    DECRYPTION_FAILED = "decryption_failed",
+    /** Invalid message format received */
+    INVALID_MESSAGE = "invalid_message",
+    /** Unknown or unspecified error */
+    UNKNOWN = "unknown"
+}
+/**
+ * Full connection status including state, client ID, and any error
+ */
+interface ExternalConnection {
+    /** Current connection state */
+    state: ExternalConnectionState;
+    /** Client identifier (derived from public key) */
+    clientId: string | null;
+    /** Error code for i18n (use this for translations) */
+    errorCode: ExternalConnectionErrorCode;
+    /** Error message (original message, for logging/debugging) */
+    errorMessage: string | null;
+}
+/**
+ * Check if external client connection state indicates an active connection
+ * (connected, pending approval, or paired)
+ */
+declare function isExternalClientConnected(state: ExternalConnectionState): boolean;
+/**
+ * Check if external client can send requests (only when paired/authorized)
+ */
+declare function canExternalClientSendRequests(state: ExternalConnectionState): boolean;
 type EventCallback = (event: HaexHubEvent) => void;
 interface ExtensionManifest {
     name: string;
@@ -334,4 +396,4 @@ declare class HaexVaultSdkError extends Error {
     };
 }
 
-export { type ApplicationContext as A, type BlockedClient as B, type ContextChangedEvent as C, type DatabaseQueryResult as D, type ExtensionManifest as E, HaexVaultSdkError as F, HAEXTENSION_EVENTS as G, type HaexHubConfig as H, type HaextensionEvent as I, EXTERNAL_EVENTS as J, type ExternalEvent as K, type Migration as M, type PermissionResponse as P, type SearchResult as S, TABLE_SEPARATOR as T, type WebRequestOptions as W, type ExtensionInfo as a, type MigrationResult as b, type WebResponse as c, type DatabasePermissionRequest as d, type ExternalRequestHandler as e, type ExternalResponse as f, type EventCallback as g, type HaexHubRequest as h, type HaexHubResponse as i, type HaexHubEvent as j, type DatabasePermission as k, type DatabaseQueryParams as l, type DatabaseExecuteParams as m, type DatabaseTableInfo as n, type DatabaseColumnInfo as o, type SearchQuery as p, type SearchRequestEvent as q, type ExternalRequestEvent as r, type ExternalRequest as s, type AuthorizedClient as t, type PendingAuthorization as u, type ExternalAuthDecision as v, PermissionStatus as w, ErrorCode as x, DEFAULT_TIMEOUT as y, getTableName as z };
+export { type ApplicationContext as A, type BlockedClient as B, type ContextChangedEvent as C, type DatabaseQueryResult as D, type ExtensionManifest as E, getTableName as F, ExternalConnectionState as G, type HaexHubConfig as H, ExternalConnectionErrorCode as I, isExternalClientConnected as J, canExternalClientSendRequests as K, HaexVaultSdkError as L, type Migration as M, HAEXTENSION_EVENTS as N, type HaextensionEvent as O, type PermissionResponse as P, EXTERNAL_EVENTS as Q, type ExternalEvent as R, type SearchResult as S, TABLE_SEPARATOR as T, type WebRequestOptions as W, type ExtensionInfo as a, type MigrationResult as b, type WebResponse as c, type DatabasePermissionRequest as d, type ExternalRequestHandler as e, type ExternalResponse as f, type EventCallback as g, type HaexHubRequest as h, type HaexHubResponse as i, type HaexHubEvent as j, type DatabasePermission as k, type DatabaseQueryParams as l, type DatabaseExecuteParams as m, type DatabaseTableInfo as n, type DatabaseColumnInfo as o, type SearchQuery as p, type SearchRequestEvent as q, type ExternalRequestEvent as r, type ExternalRequest as s, type AuthorizedClient as t, type PendingAuthorization as u, type ExternalAuthDecision as v, type ExternalConnection as w, PermissionStatus as x, ErrorCode as y, DEFAULT_TIMEOUT as z };

package/dist/{types-Bw5uc1vm.d.ts → types-mMVOhsmm.d.ts}

@@ -254,6 +254,68 @@ interface PendingAuthorization {
  * Decision type for external authorization prompts
  */
 type ExternalAuthDecision = 'allow' | 'deny';
+/**
+ * Connection state for external clients connecting to haex-vault via WebSocket.
+ * Used by browser extensions, CLI tools, servers, and other external clients.
+ */
+declare enum ExternalConnectionState {
+    /** Not connected to haex-vault */
+    DISCONNECTED = "disconnected",
+    /** Attempting to establish connection */
+    CONNECTING = "connecting",
+    /** WebSocket connected but not yet authorized */
+    CONNECTED = "connected",
+    /** Connected and waiting for user approval in haex-vault */
+    PENDING_APPROVAL = "pending_approval",
+    /** Connected and authorized to communicate */
+    PAIRED = "paired"
+}
+/**
+ * Error codes for external client connections.
+ * Used to identify specific error conditions for i18n in the frontend.
+ */
+declare enum ExternalConnectionErrorCode {
+    /** No error */
+    NONE = "none",
+    /** Client is not authorized (rejected or not yet approved) */
+    CLIENT_NOT_AUTHORIZED = "client_not_authorized",
+    /** Client was blocked by the user */
+    CLIENT_BLOCKED = "client_blocked",
+    /** Connection to haex-vault failed (not running or network error) */
+    CONNECTION_FAILED = "connection_failed",
+    /** Connection timed out */
+    CONNECTION_TIMEOUT = "connection_timeout",
+    /** WebSocket connection was closed unexpectedly */
+    CONNECTION_CLOSED = "connection_closed",
+    /** Failed to decrypt message (invalid key or corrupted data) */
+    DECRYPTION_FAILED = "decryption_failed",
+    /** Invalid message format received */
+    INVALID_MESSAGE = "invalid_message",
+    /** Unknown or unspecified error */
+    UNKNOWN = "unknown"
+}
+/**
+ * Full connection status including state, client ID, and any error
+ */
+interface ExternalConnection {
+    /** Current connection state */
+    state: ExternalConnectionState;
+    /** Client identifier (derived from public key) */
+    clientId: string | null;
+    /** Error code for i18n (use this for translations) */
+    errorCode: ExternalConnectionErrorCode;
+    /** Error message (original message, for logging/debugging) */
+    errorMessage: string | null;
+}
+/**
+ * Check if external client connection state indicates an active connection
+ * (connected, pending approval, or paired)
+ */
+declare function isExternalClientConnected(state: ExternalConnectionState): boolean;
+/**
+ * Check if external client can send requests (only when paired/authorized)
+ */
+declare function canExternalClientSendRequests(state: ExternalConnectionState): boolean;
 type EventCallback = (event: HaexHubEvent) => void;
 interface ExtensionManifest {
     name: string;
@@ -334,4 +396,4 @@ declare class HaexVaultSdkError extends Error {
     };
 }
 
-export { type ApplicationContext as A, type BlockedClient as B, type ContextChangedEvent as C, type DatabaseQueryResult as D, type ExtensionManifest as E, HaexVaultSdkError as F, HAEXTENSION_EVENTS as G, type HaexHubConfig as H, type HaextensionEvent as I, EXTERNAL_EVENTS as J, type ExternalEvent as K, type Migration as M, type PermissionResponse as P, type SearchResult as S, TABLE_SEPARATOR as T, type WebRequestOptions as W, type ExtensionInfo as a, type MigrationResult as b, type WebResponse as c, type DatabasePermissionRequest as d, type ExternalRequestHandler as e, type ExternalResponse as f, type EventCallback as g, type HaexHubRequest as h, type HaexHubResponse as i, type HaexHubEvent as j, type DatabasePermission as k, type DatabaseQueryParams as l, type DatabaseExecuteParams as m, type DatabaseTableInfo as n, type DatabaseColumnInfo as o, type SearchQuery as p, type SearchRequestEvent as q, type ExternalRequestEvent as r, type ExternalRequest as s, type AuthorizedClient as t, type PendingAuthorization as u, type ExternalAuthDecision as v, PermissionStatus as w, ErrorCode as x, DEFAULT_TIMEOUT as y, getTableName as z };
+export { type ApplicationContext as A, type BlockedClient as B, type ContextChangedEvent as C, type DatabaseQueryResult as D, type ExtensionManifest as E, getTableName as F, ExternalConnectionState as G, type HaexHubConfig as H, ExternalConnectionErrorCode as I, isExternalClientConnected as J, canExternalClientSendRequests as K, HaexVaultSdkError as L, type Migration as M, HAEXTENSION_EVENTS as N, type HaextensionEvent as O, type PermissionResponse as P, EXTERNAL_EVENTS as Q, type ExternalEvent as R, type SearchResult as S, TABLE_SEPARATOR as T, type WebRequestOptions as W, type ExtensionInfo as a, type MigrationResult as b, type WebResponse as c, type DatabasePermissionRequest as d, type ExternalRequestHandler as e, type ExternalResponse as f, type EventCallback as g, type HaexHubRequest as h, type HaexHubResponse as i, type HaexHubEvent as j, type DatabasePermission as k, type DatabaseQueryParams as l, type DatabaseExecuteParams as m, type DatabaseTableInfo as n, type DatabaseColumnInfo as o, type SearchQuery as p, type SearchRequestEvent as q, type ExternalRequestEvent as r, type ExternalRequest as s, type AuthorizedClient as t, type PendingAuthorization as u, type ExternalAuthDecision as v, type ExternalConnection as w, PermissionStatus as x, ErrorCode as y, DEFAULT_TIMEOUT as z };

package/dist/vue.d.mts

@@ -1,7 +1,7 @@
-import { H as HaexVaultClient, S as StorageAPI } from './client-DQ6VwHic.mjs';
+import { H as HaexVaultClient, S as StorageAPI } from './client-Bw04hBmE.mjs';
 import * as drizzle_orm_sqlite_proxy from 'drizzle-orm/sqlite-proxy';
 import { Ref } from 'vue';
-import { H as HaexHubConfig } from './types-Bw5uc1vm.mjs';
+import { H as HaexHubConfig } from './types-mMVOhsmm.mjs';
 
 /**
  * Vue 3 composable for HaexHub SDK

package/dist/vue.d.ts

@@ -1,7 +1,7 @@
-import { H as HaexVaultClient, S as StorageAPI } from './client-BNq2TcVs.js';
+import { H as HaexVaultClient, S as StorageAPI } from './client-CJC-_fwd.js';
 import * as drizzle_orm_sqlite_proxy from 'drizzle-orm/sqlite-proxy';
 import { Ref } from 'vue';
-import { H as HaexHubConfig } from './types-Bw5uc1vm.js';
+import { H as HaexHubConfig } from './types-mMVOhsmm.js';
 
 /**
  * Vue 3 composable for HaexHub SDK