@haex-space/vault-sdk 2.5.126 → 2.6.0

package/dist/react.mjs

@@ -612,6 +612,18 @@ var SPACE_COMMANDS = {
   listBackends: "extension_space_list_backends"
 };
 
+// src/commands/shell.ts
+var SHELL_COMMANDS = {
+  /** Create a new PTY shell session */
+  create: "extension_shell_create",
+  /** Write data to a shell session's stdin */
+  write: "extension_shell_write",
+  /** Resize a shell session's terminal */
+  resize: "extension_shell_resize",
+  /** Close a shell session */
+  close: "extension_shell_close"
+};
+
 // src/api/storage.ts
 var StorageAPI = class {
   constructor(client) {
@@ -1479,6 +1491,71 @@ var SpacesAPI = class {
   }
 };
 
+// src/api/shell.ts
+var ShellAPI = class {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+  /**
+   * Create a new PTY shell session.
+   * Returns a session ID used for subsequent write/resize/close operations.
+   * Listen for shell output via `sdk.shell.onData()`.
+   */
+  async create(options = {}) {
+    const result = await this.sdk.request(
+      SHELL_COMMANDS.create,
+      { options }
+    );
+    return result.sessionId;
+  }
+  /**
+   * Write data to a shell session's stdin.
+   * Typically used to forward terminal keystrokes.
+   */
+  async write(sessionId, data) {
+    await this.sdk.request(SHELL_COMMANDS.write, { sessionId, data });
+  }
+  /**
+   * Resize a shell session's terminal.
+   * Should be called when the terminal view is resized.
+   */
+  async resize(sessionId, cols, rows) {
+    await this.sdk.request(SHELL_COMMANDS.resize, { sessionId, cols, rows });
+  }
+  /**
+   * Close a shell session.
+   * This terminates the underlying PTY process.
+   */
+  async close(sessionId) {
+    await this.sdk.request(SHELL_COMMANDS.close, { sessionId });
+  }
+  /**
+   * Register a callback for shell output data.
+   * The callback receives output from the PTY's stdout/stderr.
+   */
+  onData(callback) {
+    this.sdk.on("shell:output", callback);
+  }
+  /**
+   * Register a callback for shell session exit.
+   */
+  onExit(callback) {
+    this.sdk.on("shell:exit", callback);
+  }
+  /**
+   * Remove a shell output callback.
+   */
+  offData(callback) {
+    this.sdk.off("shell:output", callback);
+  }
+  /**
+   * Remove a shell exit callback.
+   */
+  offExit(callback) {
+    this.sdk.off("shell:exit", callback);
+  }
+};
+
 // src/client/tableName.ts
 function validatePublicKey(publicKey) {
   if (!publicKey || typeof publicKey !== "string" || publicKey.trim() === "") {
@@ -2104,6 +2181,7 @@ var HaexVaultSdk = class {
     this.remoteStorage = new RemoteStorageAPI(this);
     this.localsend = new LocalSendAPI(this);
     this.spaces = new SpacesAPI(this);
+    this.shell = new ShellAPI(this);
     installConsoleForwarding(this.config.debug);
     this.readyPromise = new Promise((resolve) => {
       this.resolveReady = resolve;