@haex-space/vault-sdk 2.0.0 → 2.2.0

package/dist/{client-O_JEOzfx.d.mts → client-Dr3nKgRa.d.mts}

@@ -92,6 +92,15 @@ interface DatabaseQueryResult {
 interface DatabaseExecuteParams {
     statements: string[];
 }
+interface MigrationResult {
+    appliedCount: number;
+    alreadyAppliedCount: number;
+    appliedMigrations: string[];
+}
+interface Migration {
+    name: string;
+    sql: string;
+}
 interface DatabaseTableInfo {
     name: string;
     columns: DatabaseColumnInfo[];
@@ -219,17 +228,20 @@ declare class DatabaseAPI {
     createTable(tableName: string, columns: string): Promise<void>;
     dropTable(tableName: string): Promise<void>;
     /**
-     * Registers extension migrations with HaexVault for CRDT synchronization
-     * HaexVault will validate and execute these migrations, ensuring only
-     * tables with the correct prefix are manipulated
+     * Registers and applies extension migrations with HaexVault
+     *
+     * HaexVault will:
+     * 1. Validate all SQL statements (ensure only extension's own tables are accessed)
+     * 2. Store migrations with applied_at = NULL
+     * 3. Query pending migrations sorted by name
+     * 4. Apply pending migrations and set up CRDT triggers
+     * 5. Mark successful migrations with applied_at timestamp
+     *
      * @param extensionVersion - The version of the extension
      * @param migrations - Array of migration objects with name and SQL content
-     * @returns Promise that resolves when migrations are registered
+     * @returns Promise with migration result (applied count, already applied count, applied migration names)
      */
-    registerMigrationsAsync(extensionVersion: string, migrations: Array<{
-        name: string;
-        sql: string;
-    }>): Promise<void>;
+    registerMigrationsAsync(extensionVersion: string, migrations: Migration[]): Promise<MigrationResult>;
     insert(tableName: string, data: Record<string, unknown>): Promise<number>;
     update(tableName: string, data: Record<string, unknown>, where: string, whereParams?: unknown[]): Promise<number>;
     delete(tableName: string, where: string, whereParams?: unknown[]): Promise<number>;
@@ -458,16 +470,20 @@ declare class HaexVaultClient {
         lastInsertId?: number;
     }>;
     /**
-     * Registers extension migrations with HaexVault for CRDT synchronization
-     * HaexVault will validate and execute these migrations
+     * Registers and applies extension migrations with HaexVault
+     *
+     * HaexVault will:
+     * 1. Validate all SQL statements (ensure only extension's own tables are accessed)
+     * 2. Store migrations with applied_at = NULL
+     * 3. Query pending migrations sorted by name
+     * 4. Apply pending migrations and set up CRDT triggers
+     * 5. Mark successful migrations with applied_at timestamp
+     *
      * @param extensionVersion - The version of the extension
      * @param migrations - Array of migration objects with name and SQL content
-     * @returns Promise that resolves when migrations are registered
+     * @returns Promise with migration result (applied count, already applied count, applied migration names)
      */
-    registerMigrationsAsync(extensionVersion: string, migrations: Array<{
-        name: string;
-        sql: string;
-    }>): Promise<void>;
+    registerMigrationsAsync(extensionVersion: string, migrations: Migration[]): Promise<MigrationResult>;
     requestDatabasePermission(request: DatabasePermissionRequest): Promise<PermissionResponse>;
     checkDatabasePermission(resource: string, operation: "read" | "write"): Promise<boolean>;
     respondToSearch(requestId: string, results: SearchResult[]): Promise<void>;

package/dist/{client-O_JEOzfx.d.ts → client-Dr3nKgRa.d.ts}

@@ -92,6 +92,15 @@ interface DatabaseQueryResult {
 interface DatabaseExecuteParams {
     statements: string[];
 }
+interface MigrationResult {
+    appliedCount: number;
+    alreadyAppliedCount: number;
+    appliedMigrations: string[];
+}
+interface Migration {
+    name: string;
+    sql: string;
+}
 interface DatabaseTableInfo {
     name: string;
     columns: DatabaseColumnInfo[];
@@ -219,17 +228,20 @@ declare class DatabaseAPI {
     createTable(tableName: string, columns: string): Promise<void>;
     dropTable(tableName: string): Promise<void>;
     /**
-     * Registers extension migrations with HaexVault for CRDT synchronization
-     * HaexVault will validate and execute these migrations, ensuring only
-     * tables with the correct prefix are manipulated
+     * Registers and applies extension migrations with HaexVault
+     *
+     * HaexVault will:
+     * 1. Validate all SQL statements (ensure only extension's own tables are accessed)
+     * 2. Store migrations with applied_at = NULL
+     * 3. Query pending migrations sorted by name
+     * 4. Apply pending migrations and set up CRDT triggers
+     * 5. Mark successful migrations with applied_at timestamp
+     *
      * @param extensionVersion - The version of the extension
      * @param migrations - Array of migration objects with name and SQL content
-     * @returns Promise that resolves when migrations are registered
+     * @returns Promise with migration result (applied count, already applied count, applied migration names)
      */
-    registerMigrationsAsync(extensionVersion: string, migrations: Array<{
-        name: string;
-        sql: string;
-    }>): Promise<void>;
+    registerMigrationsAsync(extensionVersion: string, migrations: Migration[]): Promise<MigrationResult>;
     insert(tableName: string, data: Record<string, unknown>): Promise<number>;
     update(tableName: string, data: Record<string, unknown>, where: string, whereParams?: unknown[]): Promise<number>;
     delete(tableName: string, where: string, whereParams?: unknown[]): Promise<number>;
@@ -458,16 +470,20 @@ declare class HaexVaultClient {
         lastInsertId?: number;
     }>;
     /**
-     * Registers extension migrations with HaexVault for CRDT synchronization
-     * HaexVault will validate and execute these migrations
+     * Registers and applies extension migrations with HaexVault
+     *
+     * HaexVault will:
+     * 1. Validate all SQL statements (ensure only extension's own tables are accessed)
+     * 2. Store migrations with applied_at = NULL
+     * 3. Query pending migrations sorted by name
+     * 4. Apply pending migrations and set up CRDT triggers
+     * 5. Mark successful migrations with applied_at timestamp
+     *
      * @param extensionVersion - The version of the extension
      * @param migrations - Array of migration objects with name and SQL content
-     * @returns Promise that resolves when migrations are registered
+     * @returns Promise with migration result (applied count, already applied count, applied migration names)
      */
-    registerMigrationsAsync(extensionVersion: string, migrations: Array<{
-        name: string;
-        sql: string;
-    }>): Promise<void>;
+    registerMigrationsAsync(extensionVersion: string, migrations: Migration[]): Promise<MigrationResult>;
     requestDatabasePermission(request: DatabasePermissionRequest): Promise<PermissionResponse>;
     checkDatabasePermission(resource: string, operation: "read" | "write"): Promise<boolean>;
     respondToSearch(requestId: string, results: SearchResult[]): Promise<void>;

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { H as HaexHubConfig, a as HaexVaultClient } from './client-O_JEOzfx.mjs';
-export { A as ApplicationContext, C as ContextChangedEvent, u as DEFAULT_TIMEOUT, D as DatabaseAPI, m as DatabaseColumnInfo, k as DatabaseExecuteParams, g as DatabasePermission, h as DatabasePermissionRequest, i as DatabaseQueryParams, j as DatabaseQueryResult, l as DatabaseTableInfo, t as ErrorCode, e as EventCallback, E as ExtensionInfo, F as FilesystemAPI, w as HAEXTENSION_EVENTS, v as HaexHubError, d as HaexHubEvent, b as HaexHubRequest, c as HaexHubResponse, x as HaextensionEvent, f as PermissionResponse, s as PermissionStatus, P as PermissionsAPI, n as SearchQuery, p as SearchRequestEvent, o as SearchResult, T as TABLE_SEPARATOR, W as WebAPI, q as WebRequestOptions, r as WebResponse } from './client-O_JEOzfx.mjs';
+import { H as HaexHubConfig, a as HaexVaultClient } from './client-Dr3nKgRa.mjs';
+export { A as ApplicationContext, C as ContextChangedEvent, u as DEFAULT_TIMEOUT, D as DatabaseAPI, m as DatabaseColumnInfo, k as DatabaseExecuteParams, g as DatabasePermission, h as DatabasePermissionRequest, i as DatabaseQueryParams, j as DatabaseQueryResult, l as DatabaseTableInfo, t as ErrorCode, e as EventCallback, E as ExtensionInfo, F as FilesystemAPI, w as HAEXTENSION_EVENTS, v as HaexHubError, d as HaexHubEvent, b as HaexHubRequest, c as HaexHubResponse, x as HaextensionEvent, f as PermissionResponse, s as PermissionStatus, P as PermissionsAPI, n as SearchQuery, p as SearchRequestEvent, o as SearchResult, T as TABLE_SEPARATOR, W as WebAPI, q as WebRequestOptions, r as WebResponse } from './client-Dr3nKgRa.mjs';
 export { HaextensionConfig } from './node.mjs';
 import 'drizzle-orm/sqlite-proxy';
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { H as HaexHubConfig, a as HaexVaultClient } from './client-O_JEOzfx.js';
-export { A as ApplicationContext, C as ContextChangedEvent, u as DEFAULT_TIMEOUT, D as DatabaseAPI, m as DatabaseColumnInfo, k as DatabaseExecuteParams, g as DatabasePermission, h as DatabasePermissionRequest, i as DatabaseQueryParams, j as DatabaseQueryResult, l as DatabaseTableInfo, t as ErrorCode, e as EventCallback, E as ExtensionInfo, F as FilesystemAPI, w as HAEXTENSION_EVENTS, v as HaexHubError, d as HaexHubEvent, b as HaexHubRequest, c as HaexHubResponse, x as HaextensionEvent, f as PermissionResponse, s as PermissionStatus, P as PermissionsAPI, n as SearchQuery, p as SearchRequestEvent, o as SearchResult, T as TABLE_SEPARATOR, W as WebAPI, q as WebRequestOptions, r as WebResponse } from './client-O_JEOzfx.js';
+import { H as HaexHubConfig, a as HaexVaultClient } from './client-Dr3nKgRa.js';
+export { A as ApplicationContext, C as ContextChangedEvent, u as DEFAULT_TIMEOUT, D as DatabaseAPI, m as DatabaseColumnInfo, k as DatabaseExecuteParams, g as DatabasePermission, h as DatabasePermissionRequest, i as DatabaseQueryParams, j as DatabaseQueryResult, l as DatabaseTableInfo, t as ErrorCode, e as EventCallback, E as ExtensionInfo, F as FilesystemAPI, w as HAEXTENSION_EVENTS, v as HaexHubError, d as HaexHubEvent, b as HaexHubRequest, c as HaexHubResponse, x as HaextensionEvent, f as PermissionResponse, s as PermissionStatus, P as PermissionsAPI, n as SearchQuery, p as SearchRequestEvent, o as SearchResult, T as TABLE_SEPARATOR, W as WebAPI, q as WebRequestOptions, r as WebResponse } from './client-Dr3nKgRa.js';
 export { HaextensionConfig } from './node.js';
 import 'drizzle-orm/sqlite-proxy';
 

package/dist/index.js

@@ -522,18 +522,27 @@ var DatabaseAPI = class {
     await this.execute(query);
   }
   /**
-   * Registers extension migrations with HaexVault for CRDT synchronization
-   * HaexVault will validate and execute these migrations, ensuring only
-   * tables with the correct prefix are manipulated
+   * Registers and applies extension migrations with HaexVault
+   *
+   * HaexVault will:
+   * 1. Validate all SQL statements (ensure only extension's own tables are accessed)
+   * 2. Store migrations with applied_at = NULL
+   * 3. Query pending migrations sorted by name
+   * 4. Apply pending migrations and set up CRDT triggers
+   * 5. Mark successful migrations with applied_at timestamp
+   *
    * @param extensionVersion - The version of the extension
    * @param migrations - Array of migration objects with name and SQL content
-   * @returns Promise that resolves when migrations are registered
+   * @returns Promise with migration result (applied count, already applied count, applied migration names)
    */
   async registerMigrationsAsync(extensionVersion, migrations) {
-    await this.client.request(HAEXTENSION_METHODS.database.registerMigrations, {
-      extensionVersion,
-      migrations
-    });
+    return this.client.request(
+      HAEXTENSION_METHODS.database.registerMigrations,
+      {
+        extensionVersion,
+        migrations
+      }
+    );
   }
   async insert(tableName, data) {
     const keys = Object.keys(data);
@@ -1022,11 +1031,18 @@ var HaexVaultClient = class {
     };
   }
   /**
-   * Registers extension migrations with HaexVault for CRDT synchronization
-   * HaexVault will validate and execute these migrations
+   * Registers and applies extension migrations with HaexVault
+   *
+   * HaexVault will:
+   * 1. Validate all SQL statements (ensure only extension's own tables are accessed)
+   * 2. Store migrations with applied_at = NULL
+   * 3. Query pending migrations sorted by name
+   * 4. Apply pending migrations and set up CRDT triggers
+   * 5. Mark successful migrations with applied_at timestamp
+   *
    * @param extensionVersion - The version of the extension
    * @param migrations - Array of migration objects with name and SQL content
-   * @returns Promise that resolves when migrations are registered
+   * @returns Promise with migration result (applied count, already applied count, applied migration names)
    */
   async registerMigrationsAsync(extensionVersion, migrations) {
     return this.database.registerMigrationsAsync(extensionVersion, migrations);