@haex-space/vault-sdk 2.4.0 → 2.5.2

package/dist/{types-CmPqOcLB.d.mts → types-Dzp3QG4t.d.mts}

@@ -17,10 +17,18 @@ declare const HAEXTENSION_EVENTS: {
     readonly CONTEXT_CHANGED: "haextension:context:changed";
     /** Search request from HaexHub */
     readonly SEARCH_REQUEST: "haextension:search:request";
-    /** External request from authorized client (browser extension, CLI, server, etc.) */
-    readonly EXTERNAL_REQUEST: "haextension:external:request";
 };
 type HaextensionEvent = typeof HAEXTENSION_EVENTS[keyof typeof HAEXTENSION_EVENTS];
+/**
+ * Events for external client communication (browser extensions, CLI tools, servers, etc.)
+ */
+declare const EXTERNAL_EVENTS: {
+    /** External request from authorized client */
+    readonly REQUEST: "haextension:external:request";
+    /** New external client requesting authorization */
+    readonly AUTHORIZATION_REQUEST: "external:authorization-request";
+};
+type ExternalEvent = typeof EXTERNAL_EVENTS[keyof typeof EXTERNAL_EVENTS];
 
 declare const DEFAULT_TIMEOUT = 30000;
 declare const TABLE_SEPARATOR = "__";
@@ -162,7 +170,7 @@ interface SearchRequestEvent extends HaexHubEvent {
  * These requests come through the WebSocket bridge and are routed to the appropriate extension.
  */
 interface ExternalRequestEvent extends HaexHubEvent {
-    type: typeof HAEXTENSION_EVENTS.EXTERNAL_REQUEST;
+    type: typeof EXTERNAL_EVENTS.REQUEST;
     data: ExternalRequest;
 }
 /**
@@ -195,6 +203,93 @@ interface ExternalResponse {
  * Handler function type for external requests
  */
 type ExternalRequestHandler = (request: ExternalRequest) => Promise<ExternalResponse> | ExternalResponse;
+/**
+ * An authorized external client stored in the database
+ */
+interface AuthorizedClient {
+    /** Row ID */
+    id: string;
+    /** Unique client identifier (public key fingerprint) */
+    clientId: string;
+    /** Human-readable client name */
+    clientName: string;
+    /** Client's public key (base64) */
+    publicKey: string;
+    /** Extension ID this client can access */
+    extensionId: string;
+    /** When the client was authorized (ISO 8601) */
+    authorizedAt: string | null;
+    /** Last time the client connected (ISO 8601) */
+    lastSeen: string | null;
+}
+/**
+ * A blocked external client stored in the database
+ */
+interface BlockedClient {
+    /** Row ID */
+    id: string;
+    /** Unique client identifier (public key fingerprint) */
+    clientId: string;
+    /** Human-readable client name */
+    clientName: string;
+    /** Client's public key (base64) */
+    publicKey: string;
+    /** When the client was blocked (ISO 8601) */
+    blockedAt: string | null;
+}
+/**
+ * Pending authorization request waiting for user approval
+ */
+interface PendingAuthorization {
+    /** Unique client identifier */
+    clientId: string;
+    /** Human-readable client name */
+    clientName: string;
+    /** Client's public key (base64) */
+    publicKey: string;
+    /** Requested extension ID */
+    extensionId: string;
+}
+/**
+ * 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"
+}
+/**
+ * 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 message if connection failed */
+    error: 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;
@@ -275,4 +370,4 @@ declare class HaexVaultSdkError extends Error {
     };
 }
 
-export { type ApplicationContext as A, type ContextChangedEvent as C, type DatabaseQueryResult as D, type ExtensionManifest as E, type HaexHubConfig as H, 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, PermissionStatus as t, ErrorCode as u, DEFAULT_TIMEOUT as v, getTableName as w, HaexVaultSdkError as x, HAEXTENSION_EVENTS as y, type HaextensionEvent 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, isExternalClientConnected as I, canExternalClientSendRequests as J, HaexVaultSdkError as K, HAEXTENSION_EVENTS as L, type Migration as M, type HaextensionEvent as N, EXTERNAL_EVENTS as O, type PermissionResponse as P, type ExternalEvent as Q, 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-CmPqOcLB.d.ts → types-Dzp3QG4t.d.ts}

@@ -17,10 +17,18 @@ declare const HAEXTENSION_EVENTS: {
     readonly CONTEXT_CHANGED: "haextension:context:changed";
     /** Search request from HaexHub */
     readonly SEARCH_REQUEST: "haextension:search:request";
-    /** External request from authorized client (browser extension, CLI, server, etc.) */
-    readonly EXTERNAL_REQUEST: "haextension:external:request";
 };
 type HaextensionEvent = typeof HAEXTENSION_EVENTS[keyof typeof HAEXTENSION_EVENTS];
+/**
+ * Events for external client communication (browser extensions, CLI tools, servers, etc.)
+ */
+declare const EXTERNAL_EVENTS: {
+    /** External request from authorized client */
+    readonly REQUEST: "haextension:external:request";
+    /** New external client requesting authorization */
+    readonly AUTHORIZATION_REQUEST: "external:authorization-request";
+};
+type ExternalEvent = typeof EXTERNAL_EVENTS[keyof typeof EXTERNAL_EVENTS];
 
 declare const DEFAULT_TIMEOUT = 30000;
 declare const TABLE_SEPARATOR = "__";
@@ -162,7 +170,7 @@ interface SearchRequestEvent extends HaexHubEvent {
  * These requests come through the WebSocket bridge and are routed to the appropriate extension.
  */
 interface ExternalRequestEvent extends HaexHubEvent {
-    type: typeof HAEXTENSION_EVENTS.EXTERNAL_REQUEST;
+    type: typeof EXTERNAL_EVENTS.REQUEST;
     data: ExternalRequest;
 }
 /**
@@ -195,6 +203,93 @@ interface ExternalResponse {
  * Handler function type for external requests
  */
 type ExternalRequestHandler = (request: ExternalRequest) => Promise<ExternalResponse> | ExternalResponse;
+/**
+ * An authorized external client stored in the database
+ */
+interface AuthorizedClient {
+    /** Row ID */
+    id: string;
+    /** Unique client identifier (public key fingerprint) */
+    clientId: string;
+    /** Human-readable client name */
+    clientName: string;
+    /** Client's public key (base64) */
+    publicKey: string;
+    /** Extension ID this client can access */
+    extensionId: string;
+    /** When the client was authorized (ISO 8601) */
+    authorizedAt: string | null;
+    /** Last time the client connected (ISO 8601) */
+    lastSeen: string | null;
+}
+/**
+ * A blocked external client stored in the database
+ */
+interface BlockedClient {
+    /** Row ID */
+    id: string;
+    /** Unique client identifier (public key fingerprint) */
+    clientId: string;
+    /** Human-readable client name */
+    clientName: string;
+    /** Client's public key (base64) */
+    publicKey: string;
+    /** When the client was blocked (ISO 8601) */
+    blockedAt: string | null;
+}
+/**
+ * Pending authorization request waiting for user approval
+ */
+interface PendingAuthorization {
+    /** Unique client identifier */
+    clientId: string;
+    /** Human-readable client name */
+    clientName: string;
+    /** Client's public key (base64) */
+    publicKey: string;
+    /** Requested extension ID */
+    extensionId: string;
+}
+/**
+ * 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"
+}
+/**
+ * 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 message if connection failed */
+    error: 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;
@@ -275,4 +370,4 @@ declare class HaexVaultSdkError extends Error {
     };
 }
 
-export { type ApplicationContext as A, type ContextChangedEvent as C, type DatabaseQueryResult as D, type ExtensionManifest as E, type HaexHubConfig as H, 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, PermissionStatus as t, ErrorCode as u, DEFAULT_TIMEOUT as v, getTableName as w, HaexVaultSdkError as x, HAEXTENSION_EVENTS as y, type HaextensionEvent 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, isExternalClientConnected as I, canExternalClientSendRequests as J, HaexVaultSdkError as K, HAEXTENSION_EVENTS as L, type Migration as M, type HaextensionEvent as N, EXTERNAL_EVENTS as O, type PermissionResponse as P, type ExternalEvent as Q, 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-ClYpUDoI.mjs';
+import { H as HaexVaultClient, S as StorageAPI } from './client-DTqEEmX-.mjs';
 import * as drizzle_orm_sqlite_proxy from 'drizzle-orm/sqlite-proxy';
 import { Ref } from 'vue';
-import { H as HaexHubConfig } from './types-CmPqOcLB.mjs';
+import { H as HaexHubConfig } from './types-Dzp3QG4t.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-BSdAg7D1.js';
+import { H as HaexVaultClient, S as StorageAPI } from './client-DfmTO8Mz.js';
 import * as drizzle_orm_sqlite_proxy from 'drizzle-orm/sqlite-proxy';
 import { Ref } from 'vue';
-import { H as HaexHubConfig } from './types-CmPqOcLB.js';
+import { H as HaexHubConfig } from './types-Dzp3QG4t.js';
 
 /**
  * Vue 3 composable for HaexHub SDK

package/dist/vue.js

@@ -337,9 +337,7 @@ var HAEXTENSION_EVENTS = {
   /** Context (theme, locale, platform) has changed */
   CONTEXT_CHANGED: "haextension:context:changed",
   /** Search request from HaexHub */
-  SEARCH_REQUEST: "haextension:search:request",
-  /** External request from authorized client (browser extension, CLI, server, etc.) */
-  EXTERNAL_REQUEST: "haextension:external:request"
+  SEARCH_REQUEST: "haextension:search:request"
 };
 
 // src/types.ts
@@ -1205,8 +1203,8 @@ var TAURI_COMMANDS = {
     showImage: "webview_extension_fs_show_image"
   },
   external: {
-    respond: "webview_extension_external_respond"
-  },
+    // Response handling (called by extensions)
+    respond: "external_respond"},
   filesync: {
     // Spaces
     listSpaces: "filesync_list_spaces",