@haex-space/vault-sdk 3.2.7 → 3.2.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -13,16 +13,17 @@ var HAEXTENSION_EVENTS = {
13
13
  /** File system change detected (from native file watcher) */
14
14
  FILE_CHANGED: "filesync:file-changed",
15
15
  /** Tables have been updated via sync (CRDT pull from server) */
16
- SYNC_TABLES_UPDATED: "haextension:sync:tables-updated"
16
+ SYNC_TABLES_UPDATED: "haextension:sync:tables-updated",
17
+ /** A runtime permission prompt was resolved (granted/denied) by the user.
18
+ * The SDK uses this to auto-retry the original request; extensions may also
19
+ * subscribe via `client.on(HAEXTENSION_EVENTS.PERMISSION_RESOLVED, ...)`. */
20
+ PERMISSION_RESOLVED: "extension:permission-resolved"
17
21
  };
18
22
  var EXTERNAL_EVENTS = {
19
23
  /** External request from authorized client */
20
24
  REQUEST: "haextension:external:request",
21
25
  /** AI action request (tool calls from AI assistant) */
22
- ACTION_REQUEST: "haextension:action:request",
23
- /** New external client requesting authorization */
24
- AUTHORIZATION_REQUEST: "external:authorization-request"
25
- };
26
+ ACTION_REQUEST: "haextension:action:request"};
26
27
  var SHELL_EVENTS = {
27
28
  /** PTY output data from a shell session */
28
29
  OUTPUT: "shell:output",
@@ -36,6 +37,9 @@ var TABLE_SEPARATOR = "__";
36
37
  function getTableName(publicKey, extensionName, tableName) {
37
38
  return `${publicKey}${TABLE_SEPARATOR}${extensionName}${TABLE_SEPARATOR}${tableName}`;
38
39
  }
40
+ function isPermissionPromptError(error) {
41
+ return typeof error === "object" && error !== null && "code" in error && error.code === 1004 /* PROMPT_REQUIRED */;
42
+ }
39
43
  var HaexVaultSdkError = class extends Error {
40
44
  constructor(code, messageKey, details) {
41
45
  super(messageKey);
@@ -1606,6 +1610,21 @@ async function initNativeMode(ctx, log, onEvent, onContextChange) {
1606
1610
  await setupTauriEventListeners(ctx, log, onEvent, onContextChange);
1607
1611
  return { extensionInfo, context };
1608
1612
  }
1613
+ async function forwardEvent(listen, log, onEvent, listenOptions, eventName, shape) {
1614
+ try {
1615
+ await listen(eventName, (event) => {
1616
+ if (event.payload == null) {
1617
+ log(`Event '${eventName}' received with no payload`);
1618
+ return;
1619
+ }
1620
+ const extra = shape ? shape(event.payload) : { data: event.payload };
1621
+ onEvent({ type: eventName, timestamp: Date.now(), ...extra });
1622
+ }, listenOptions);
1623
+ log(`Listener registered: ${eventName}`);
1624
+ } catch (error) {
1625
+ log(`Failed to register listener '${eventName}':`, error);
1626
+ }
1627
+ }
1609
1628
  async function setupTauriEventListeners(ctx, log, onEvent, onContextChange) {
1610
1629
  const { listen } = getTauriEvent();
1611
1630
  const webviewLabel = getCurrentWebviewLabel();
@@ -1637,207 +1656,29 @@ async function setupTauriEventListeners(ctx, log, onEvent, onContextChange) {
1637
1656
  } catch (error) {
1638
1657
  log("Failed to setup context change listener:", error);
1639
1658
  }
1640
- try {
1641
- await listen(EXTERNAL_EVENTS.REQUEST, (event) => {
1642
- log("====== EXTERNAL REQUEST RECEIVED ======");
1643
- log("Event payload:", JSON.stringify(event.payload, null, 2));
1644
- if (event.payload) {
1645
- onEvent({
1646
- type: EXTERNAL_EVENTS.REQUEST,
1647
- data: event.payload,
1648
- timestamp: Date.now()
1649
- });
1650
- } else {
1651
- log("External request event has no payload!");
1652
- }
1653
- }, listenOptions);
1654
- log("External request listener registered successfully");
1655
- } catch (error) {
1656
- log("Failed to setup external request listener:", error);
1657
- }
1658
- try {
1659
- await listen(EXTERNAL_EVENTS.ACTION_REQUEST, (event) => {
1660
- log("====== AI ACTION REQUEST RECEIVED ======");
1661
- log("Payload:", JSON.stringify(event.payload));
1662
- if (event.payload) {
1663
- onEvent({
1664
- type: EXTERNAL_EVENTS.ACTION_REQUEST,
1665
- data: event.payload,
1666
- timestamp: Date.now()
1667
- });
1668
- } else {
1669
- log("AI action request event has no payload!");
1670
- }
1671
- }, listenOptions);
1672
- log("AI action request listener registered successfully");
1673
- } catch (error) {
1674
- log("Failed to setup AI action request listener:", error);
1675
- }
1676
- log("Registering file change listener for:", HAEXTENSION_EVENTS.FILE_CHANGED);
1677
- try {
1678
- await listen(HAEXTENSION_EVENTS.FILE_CHANGED, (event) => {
1679
- log("File change event received:", event.payload);
1680
- if (event.payload) {
1681
- const payload = event.payload;
1682
- onEvent({
1683
- type: HAEXTENSION_EVENTS.FILE_CHANGED,
1684
- ruleId: payload.ruleId,
1685
- changeType: payload.changeType,
1686
- path: payload.path,
1687
- timestamp: Date.now()
1688
- });
1689
- }
1690
- }, listenOptions);
1691
- log("File change listener registered successfully");
1692
- } catch (error) {
1693
- log("Failed to setup file change listener:", error);
1694
- }
1695
- log("Registering sync tables updated listener for:", HAEXTENSION_EVENTS.SYNC_TABLES_UPDATED);
1696
- try {
1697
- await listen(HAEXTENSION_EVENTS.SYNC_TABLES_UPDATED, (event) => {
1698
- log("Sync tables updated event received:", event.payload);
1699
- if (event.payload) {
1700
- const payload = event.payload;
1701
- onEvent({
1702
- type: HAEXTENSION_EVENTS.SYNC_TABLES_UPDATED,
1703
- data: { tables: payload.tables },
1704
- timestamp: Date.now()
1705
- });
1706
- }
1707
- }, listenOptions);
1708
- log("Sync tables updated listener registered successfully");
1709
- } catch (error) {
1710
- log("Failed to setup sync tables updated listener:", error);
1711
- }
1712
- log("Setting up LocalSend event listeners");
1713
- try {
1714
- await setupLocalSendEventListeners(log, onEvent, listenOptions);
1715
- log("LocalSend event listeners setup complete");
1716
- } catch (error) {
1717
- log("Failed to setup LocalSend event listeners:", error);
1718
- }
1719
- log("Setting up Shell event listeners");
1720
- try {
1721
- await listen(SHELL_EVENTS.OUTPUT, (event) => {
1722
- if (event.payload) {
1723
- const payload = event.payload;
1724
- onEvent({
1725
- type: SHELL_EVENTS.OUTPUT,
1726
- timestamp: Date.now(),
1727
- sessionId: payload.sessionId,
1728
- data: payload.data
1729
- });
1730
- }
1731
- }, listenOptions);
1732
- log("Shell output listener registered");
1733
- await listen(SHELL_EVENTS.EXIT, (event) => {
1734
- if (event.payload) {
1735
- const payload = event.payload;
1736
- onEvent({
1737
- type: SHELL_EVENTS.EXIT,
1738
- timestamp: Date.now(),
1739
- sessionId: payload.sessionId,
1740
- exitCode: payload.exitCode
1741
- });
1742
- }
1743
- }, listenOptions);
1744
- log("Shell exit listener registered");
1745
- } catch (error) {
1746
- log("Failed to setup Shell event listeners:", error);
1747
- }
1748
- }
1749
- async function setupLocalSendEventListeners(log, onEvent, listenOptions) {
1750
- const { listen } = getTauriEvent();
1751
- try {
1752
- await listen(LOCALSEND_EVENTS.deviceDiscovered, (event) => {
1753
- log("LocalSend device discovered:", event.payload);
1754
- if (event.payload) {
1755
- onEvent({
1756
- type: LOCALSEND_EVENTS.deviceDiscovered,
1757
- data: event.payload,
1758
- timestamp: Date.now()
1759
- });
1760
- }
1761
- }, listenOptions);
1762
- log("LocalSend device discovered listener registered");
1763
- } catch (error) {
1764
- log("Failed to setup LocalSend device discovered listener:", error);
1765
- }
1766
- try {
1767
- await listen(LOCALSEND_EVENTS.deviceLost, (event) => {
1768
- log("LocalSend device lost:", event.payload);
1769
- if (event.payload) {
1770
- onEvent({
1771
- type: LOCALSEND_EVENTS.deviceLost,
1772
- data: event.payload,
1773
- timestamp: Date.now()
1774
- });
1775
- }
1776
- }, listenOptions);
1777
- log("LocalSend device lost listener registered");
1778
- } catch (error) {
1779
- log("Failed to setup LocalSend device lost listener:", error);
1780
- }
1781
- try {
1782
- await listen(LOCALSEND_EVENTS.transferRequest, (event) => {
1783
- log("LocalSend transfer request:", event.payload);
1784
- if (event.payload) {
1785
- onEvent({
1786
- type: LOCALSEND_EVENTS.transferRequest,
1787
- data: event.payload,
1788
- timestamp: Date.now()
1789
- });
1790
- }
1791
- }, listenOptions);
1792
- log("LocalSend transfer request listener registered");
1793
- } catch (error) {
1794
- log("Failed to setup LocalSend transfer request listener:", error);
1795
- }
1796
- try {
1797
- await listen(LOCALSEND_EVENTS.transferProgress, (event) => {
1798
- log("LocalSend transfer progress event:", event);
1799
- if (event.payload) {
1800
- onEvent({
1801
- type: LOCALSEND_EVENTS.transferProgress,
1802
- data: event.payload,
1803
- timestamp: Date.now()
1804
- });
1805
- }
1806
- }, listenOptions);
1807
- log("LocalSend transfer progress listener registered");
1808
- } catch (error) {
1809
- log("Failed to setup LocalSend transfer progress listener:", error);
1810
- }
1811
- try {
1812
- await listen(LOCALSEND_EVENTS.transferComplete, (event) => {
1813
- log("LocalSend transfer complete:", event.payload);
1814
- if (event.payload) {
1815
- onEvent({
1816
- type: LOCALSEND_EVENTS.transferComplete,
1817
- data: event.payload,
1818
- timestamp: Date.now()
1819
- });
1820
- }
1821
- }, listenOptions);
1822
- log("LocalSend transfer complete listener registered");
1823
- } catch (error) {
1824
- log("Failed to setup LocalSend transfer complete listener:", error);
1825
- }
1826
- try {
1827
- await listen(LOCALSEND_EVENTS.transferFailed, (event) => {
1828
- log("LocalSend transfer failed:", event.payload);
1829
- if (event.payload) {
1830
- onEvent({
1831
- type: LOCALSEND_EVENTS.transferFailed,
1832
- data: event.payload,
1833
- timestamp: Date.now()
1834
- });
1835
- }
1836
- }, listenOptions);
1837
- log("LocalSend transfer failed listener registered");
1838
- } catch (error) {
1839
- log("Failed to setup LocalSend transfer failed listener:", error);
1840
- }
1659
+ for (const eventName of [
1660
+ HAEXTENSION_EVENTS.PERMISSION_RESOLVED,
1661
+ EXTERNAL_EVENTS.REQUEST,
1662
+ EXTERNAL_EVENTS.ACTION_REQUEST,
1663
+ ...Object.values(LOCALSEND_EVENTS)
1664
+ ]) {
1665
+ await forwardEvent(listen, log, onEvent, listenOptions, eventName);
1666
+ }
1667
+ await forwardEvent(listen, log, onEvent, listenOptions, HAEXTENSION_EVENTS.SYNC_TABLES_UPDATED, (payload) => ({
1668
+ data: { tables: payload.tables }
1669
+ }));
1670
+ await forwardEvent(listen, log, onEvent, listenOptions, HAEXTENSION_EVENTS.FILE_CHANGED, (payload) => {
1671
+ const { ruleId, changeType, path } = payload;
1672
+ return { ruleId, changeType, path };
1673
+ });
1674
+ await forwardEvent(listen, log, onEvent, listenOptions, SHELL_EVENTS.OUTPUT, (payload) => {
1675
+ const { sessionId, data } = payload;
1676
+ return { sessionId, data };
1677
+ });
1678
+ await forwardEvent(listen, log, onEvent, listenOptions, SHELL_EVENTS.EXIT, (payload) => {
1679
+ const { sessionId, exitCode } = payload;
1680
+ return { sessionId, exitCode };
1681
+ });
1841
1682
  }
1842
1683
  async function initIframeMode(ctx, log, messageHandler) {
1843
1684
  if (!isInIframe()) {
@@ -2181,6 +2022,68 @@ var AI_COMMANDS = {
2181
2022
  actionRespond: "ai_action_respond"
2182
2023
  };
2183
2024
 
2025
+ // src/client/permissionRetry.ts
2026
+ var PERMISSION_DECISION_TIMEOUT_MS = 5 * 60 * 1e3;
2027
+ var MAX_PERMISSION_RETRIES = 3;
2028
+ function permissionKey(resourceType, action, target) {
2029
+ return `${resourceType}:${action}:${target}`;
2030
+ }
2031
+ var PermissionWaiterRegistry = class {
2032
+ constructor() {
2033
+ this.waiters = /* @__PURE__ */ new Map();
2034
+ }
2035
+ /** Wait for a decision on `key`; resolves "timeout" if none arrives in time. */
2036
+ wait(key, timeoutMs = PERMISSION_DECISION_TIMEOUT_MS) {
2037
+ return new Promise((resolve) => {
2038
+ const set = this.waiters.get(key) ?? /* @__PURE__ */ new Set();
2039
+ this.waiters.set(key, set);
2040
+ const settle = (outcome) => {
2041
+ if (!set.has(callback)) return;
2042
+ set.delete(callback);
2043
+ if (set.size === 0) this.waiters.delete(key);
2044
+ clearTimeout(timer);
2045
+ resolve(outcome);
2046
+ };
2047
+ const callback = (outcome) => settle(outcome);
2048
+ const timer = setTimeout(() => settle("timeout"), timeoutMs);
2049
+ set.add(callback);
2050
+ });
2051
+ }
2052
+ /** Resolve everyone waiting on `key` with the user's decision. */
2053
+ resolve(key, decision) {
2054
+ const set = this.waiters.get(key);
2055
+ if (!set) return;
2056
+ for (const callback of [...set]) callback(decision);
2057
+ }
2058
+ };
2059
+ function toDeniedError(error) {
2060
+ return { ...error, code: 1002 /* DENIED */ };
2061
+ }
2062
+ async function withPermissionRetry(send, registry, log, timeoutMs = PERMISSION_DECISION_TIMEOUT_MS) {
2063
+ for (let attempt = 0; ; attempt++) {
2064
+ try {
2065
+ return await send();
2066
+ } catch (error) {
2067
+ if (!isPermissionPromptError(error) || attempt >= MAX_PERMISSION_RETRIES) {
2068
+ throw error;
2069
+ }
2070
+ const key = permissionKey(error.resourceType, error.action, error.target);
2071
+ log(`Permission prompt required for ${key} \u2014 waiting for user decision`);
2072
+ const outcome = await registry.wait(key, timeoutMs);
2073
+ if (outcome === "granted") {
2074
+ log(`Permission ${key} granted \u2014 retrying request`);
2075
+ continue;
2076
+ }
2077
+ if (outcome === "denied") {
2078
+ log(`Permission ${key} denied`);
2079
+ throw toDeniedError(error);
2080
+ }
2081
+ log(`Permission ${key} prompt timed out`);
2082
+ throw error;
2083
+ }
2084
+ }
2085
+ }
2086
+
2184
2087
  // src/client.ts
2185
2088
  var HaexVaultSdk = class {
2186
2089
  constructor(config = {}) {
@@ -2196,6 +2099,7 @@ var HaexVaultSdk = class {
2196
2099
  this.eventListeners = /* @__PURE__ */ new Map();
2197
2100
  this.externalRequestHandlers = /* @__PURE__ */ new Map();
2198
2101
  this.reactiveSubscribers = /* @__PURE__ */ new Set();
2102
+ this.permissionWaiters = new PermissionWaiterRegistry();
2199
2103
  // Handlers
2200
2104
  this.messageHandler = null;
2201
2105
  /**
@@ -2232,6 +2136,14 @@ var HaexVaultSdk = class {
2232
2136
  this.passwords = new PasswordsAPI(this);
2233
2137
  this.mail = new MailAPI(this);
2234
2138
  installConsoleForwarding(this.config.debug);
2139
+ this.on(HAEXTENSION_EVENTS.PERMISSION_RESOLVED, (event) => {
2140
+ const data = event.data;
2141
+ if (!data) return;
2142
+ this.permissionWaiters.resolve(
2143
+ permissionKey(data.resourceType, data.action, data.target),
2144
+ data.decision === "denied" ? "denied" : "granted"
2145
+ );
2146
+ });
2235
2147
  this.readyPromise = new Promise((resolve, reject) => {
2236
2148
  this.resolveReady = resolve;
2237
2149
  this.rejectReady = reject;
@@ -2380,24 +2292,27 @@ var HaexVaultSdk = class {
2380
2292
  // ==========================================================================
2381
2293
  async request(method, params) {
2382
2294
  const resolvedParams = params ?? {};
2383
- if (this.isNativeWindow && hasTauri()) {
2384
- const paramsWithCredentials = {
2385
- ...resolvedParams,
2386
- publicKey: this._extensionInfo?.publicKey,
2387
- name: this._extensionInfo?.name
2388
- };
2389
- return sendInvoke(method, paramsWithCredentials, this.config, this.log.bind(this));
2390
- }
2391
- const requestId = generateRequestId(++this.requestCounter);
2392
- return sendPostMessage(
2393
- method,
2394
- resolvedParams,
2395
- requestId,
2396
- this.config,
2397
- this._extensionInfo,
2398
- this.pendingRequests,
2399
- this.hostPort
2400
- );
2295
+ const send = () => {
2296
+ if (this.isNativeWindow && hasTauri()) {
2297
+ const paramsWithCredentials = {
2298
+ ...resolvedParams,
2299
+ publicKey: this._extensionInfo?.publicKey,
2300
+ name: this._extensionInfo?.name
2301
+ };
2302
+ return sendInvoke(method, paramsWithCredentials, this.config, this.log.bind(this));
2303
+ }
2304
+ const requestId = generateRequestId(++this.requestCounter);
2305
+ return sendPostMessage(
2306
+ method,
2307
+ resolvedParams,
2308
+ requestId,
2309
+ this.config,
2310
+ this._extensionInfo,
2311
+ this.pendingRequests,
2312
+ this.hostPort
2313
+ );
2314
+ };
2315
+ return withPermissionRetry(send, this.permissionWaiters, this.log.bind(this));
2401
2316
  }
2402
2317
  // ==========================================================================
2403
2318
  // Private: Initialization