@haex-space/vault-sdk 2.5.111 → 2.5.113

package/dist/index.js

@@ -676,6 +676,22 @@ var LOCALSEND_COMMANDS = {
   cancelSend: "localsend_cancel_send"
 };
 
+// src/commands/spaces.ts
+var SPACE_COMMANDS = {
+  /** Bulk assign rows to spaces */
+  assign: "extension_space_assign",
+  /** Bulk unassign rows from spaces */
+  unassign: "extension_space_unassign",
+  /** Get space assignments for a table */
+  getAssignments: "extension_space_get_assignments",
+  /** List all spaces the user is a member of (with decrypted names) */
+  list: "extension_space_list",
+  /** Create a new shared space */
+  create: "extension_space_create",
+  /** List available sync backends */
+  listBackends: "extension_space_list_backends"
+};
+
 // src/commands/index.ts
 var TAURI_COMMANDS = {
   database: DATABASE_COMMANDS,
@@ -686,7 +702,8 @@ var TAURI_COMMANDS = {
   externalBridge: EXTERNAL_BRIDGE_COMMANDS,
   extension: EXTENSION_COMMANDS,
   remoteStorage: REMOTE_STORAGE_COMMANDS,
-  localsend: LOCALSEND_COMMANDS
+  localsend: LOCALSEND_COMMANDS,
+  spaces: SPACE_COMMANDS
 };
 
 // src/api/storage.ts
@@ -1688,6 +1705,112 @@ var LocalSendAPI = class {
   }
 };
 
+// src/api/spaces.ts
+var SpacesAPI = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Bulk assign rows to spaces.
+   * @param assignments - Array of row-to-space mappings
+   * @returns Number of assignments created
+   */
+  async assignAsync(assignments) {
+    return this.client.request(SPACE_COMMANDS.assign, {
+      assignments: assignments.map(toSnakeCase)
+    });
+  }
+  /**
+   * Bulk unassign rows from spaces.
+   * @param assignments - Array of row-to-space mappings to remove
+   * @returns Number of assignments removed
+   */
+  async unassignAsync(assignments) {
+    return this.client.request(SPACE_COMMANDS.unassign, {
+      assignments: assignments.map(toSnakeCase)
+    });
+  }
+  /**
+   * Get space assignments for a table, optionally filtered by row.
+   * @param tableName - The table to query assignments for
+   * @param rowPks - Optional row primary key(s) to filter by
+   * @returns Array of space assignments
+   */
+  async getAssignmentsAsync(tableName, rowPks) {
+    const result = await this.client.request(
+      SPACE_COMMANDS.getAssignments,
+      {
+        table_name: tableName,
+        row_pks: rowPks
+      }
+    );
+    return result.map(fromSnakeCase);
+  }
+  /**
+   * Convenience method to assign a single row to a space.
+   * @param tableName - The table name
+   * @param rowPks - The row primary key(s)
+   * @param spaceId - The space ID to assign to
+   * @returns Number of assignments created (0 or 1)
+   */
+  async assignRowAsync(tableName, rowPks, spaceId) {
+    return this.assignAsync([{ tableName, rowPks, spaceId }]);
+  }
+  /**
+   * Convenience method to unassign a single row from a space.
+   * @param tableName - The table name
+   * @param rowPks - The row primary key(s)
+   * @param spaceId - The space ID to unassign from
+   * @returns Number of assignments removed (0 or 1)
+   */
+  async unassignRowAsync(tableName, rowPks, spaceId) {
+    return this.unassignAsync([{ tableName, rowPks, spaceId }]);
+  }
+  // ==========================================================================
+  // Space Management
+  // ==========================================================================
+  /**
+   * List all shared spaces the user is a member of.
+   * Returns spaces with decrypted names (decryption happens vault-side).
+   */
+  async listSpacesAsync() {
+    return this.client.request(SPACE_COMMANDS.list);
+  }
+  /**
+   * Create a new shared space.
+   * @param name - Human-readable space name
+   * @param serverUrl - The sync server URL to create the space on
+   * @returns The created space with decrypted name
+   */
+  async createSpaceAsync(name, serverUrl) {
+    return this.client.request(SPACE_COMMANDS.create, {
+      name,
+      server_url: serverUrl
+    });
+  }
+  /**
+   * List available sync backends that can host shared spaces.
+   * @returns Array of backend info with server URLs
+   */
+  async listSyncBackendsAsync() {
+    return this.client.request(SPACE_COMMANDS.listBackends);
+  }
+};
+function toSnakeCase(assignment) {
+  return {
+    table_name: assignment.tableName,
+    row_pks: assignment.rowPks,
+    space_id: assignment.spaceId
+  };
+}
+function fromSnakeCase(assignment) {
+  return {
+    tableName: assignment.table_name,
+    rowPks: assignment.row_pks,
+    spaceId: assignment.space_id
+  };
+}
+
 // src/client/tableName.ts
 function validatePublicKey(publicKey) {
   if (!publicKey || typeof publicKey !== "string" || publicKey.trim() === "") {
@@ -2312,6 +2435,7 @@ var HaexVaultSdk = class {
     this.permissions = new PermissionsAPI(this);
     this.remoteStorage = new RemoteStorageAPI(this);
     this.localsend = new LocalSendAPI(this);
+    this.spaces = new SpacesAPI(this);
     installConsoleForwarding(this.config.debug);
     this.readyPromise = new Promise((resolve) => {
       this.resolveReady = resolve;
@@ -2861,6 +2985,27 @@ async function decryptSpaceKeyAsync(encrypted, ownPrivateKeyBase64) {
   );
   return new Uint8Array(decrypted);
 }
+async function encryptSpaceNameAsync(spaceKey, spaceName) {
+  const cryptoKey = await crypto.subtle.importKey(
+    "raw",
+    new Uint8Array(spaceKey).buffer,
+    { name: "AES-GCM" },
+    false,
+    ["encrypt"]
+  );
+  const { encryptedData, nonce } = await encryptString(spaceName, cryptoKey);
+  return { encryptedName: encryptedData, nameNonce: nonce };
+}
+async function decryptSpaceNameAsync(spaceKey, encryptedName, nameNonce) {
+  const cryptoKey = await crypto.subtle.importKey(
+    "raw",
+    new Uint8Array(spaceKey).buffer,
+    { name: "AES-GCM" },
+    false,
+    ["decrypt"]
+  );
+  return decryptString(encryptedName, nameNonce, cryptoKey);
+}
 
 // src/crypto/recordSigning.ts
 function canonicalize(record) {
@@ -3114,6 +3259,7 @@ exports.PermissionStatus = PermissionStatus;
 exports.PermissionsAPI = PermissionsAPI;
 exports.RemoteStorageAPI = RemoteStorageAPI;
 exports.SIGNING_ALGO = SIGNING_ALGO;
+exports.SpacesAPI = SpacesAPI;
 exports.TABLE_SEPARATOR = TABLE_SEPARATOR;
 exports.TAURI_COMMANDS = TAURI_COMMANDS;
 exports.WebAPI = WebAPI;
@@ -3124,6 +3270,7 @@ exports.createHaexVaultSdk = createHaexVaultSdk;
 exports.decryptCrdtData = decryptCrdtData;
 exports.decryptPrivateKeyAsync = decryptPrivateKeyAsync;
 exports.decryptSpaceKeyAsync = decryptSpaceKeyAsync;
+exports.decryptSpaceNameAsync = decryptSpaceNameAsync;
 exports.decryptString = decryptString;
 exports.decryptVaultKey = decryptVaultKey;
 exports.decryptVaultName = decryptVaultName;
@@ -3131,6 +3278,7 @@ exports.deriveKeyFromPassword = deriveKeyFromPassword;
 exports.encryptCrdtData = encryptCrdtData;
 exports.encryptPrivateKeyAsync = encryptPrivateKeyAsync;
 exports.encryptSpaceKeyForRecipientAsync = encryptSpaceKeyForRecipientAsync;
+exports.encryptSpaceNameAsync = encryptSpaceNameAsync;
 exports.encryptString = encryptString;
 exports.encryptVaultKey = encryptVaultKey;
 exports.exportKeyPairAsync = exportKeyPairAsync;