@aouda/client 0.1.7 → 0.1.8

package/dist/cli/index.cjs

@@ -421,7 +421,7 @@ var import_node_url = require("url");
 // package.json
 var package_default = {
   name: "@aouda/client",
-  version: "0.1.7",
+  version: "0.1.8",
   description: "Official TypeScript/JavaScript client library for Aouda",
   type: "module",
   main: "./dist/index.cjs",
@@ -3953,23 +3953,68 @@ var TablesApi = class {
     );
   }
   /**
-   * Renames a column.
+   * Alters a column (type, nullable, encoder, autoIncrement, references, and/or rename).
+   * PATCH /api/databases/{db}/tables/{t}/columns/{c}.
+   * Omit a property to leave it unchanged. For `references`, omit unchanged; `""` or `null` clears.
    * @param tableName - Table name.
    * @param columnName - Current column name.
-   * @param body - Request body (database, newName).
-   * @returns 200 response body (column detail).
-   * @throws AoudaNotFoundError if table or column does not exist; AoudaApiError for WRITE_NOT_ALLOWED, etc.
+   * @param body - Fields to change. `database` is injected from the client scope when omitted.
+   * @returns Updated column detail.
    */
-  async renameColumn(tableName, columnName, body) {
+  async alterColumn(tableName, columnName, body) {
     validateNonEmptyString(tableName, "Table name");
     validateNonEmptyString(columnName, "Column name");
-    validateNonEmptyString(body.newName, "New column name");
+    const hasField = body.newName !== void 0 || body.type !== void 0 || body.nullable !== void 0 || body.encoder !== void 0 || body.autoIncrement !== void 0 || body.references !== void 0;
+    if (!hasField) {
+      throw new Error(
+        "AlterColumnRequest must set at least one of: newName, type, nullable, encoder, autoIncrement, references"
+      );
+    }
     const prefix = databasePath2(this.database);
     const encodedTable = encodeURIComponent(tableName);
     const encodedColumn = encodeURIComponent(columnName);
+    const requestBody = {
+      database: this.database,
+      ...body
+    };
     return this.transport.patch(
       `${prefix}/tables/${encodedTable}/columns/${encodedColumn}`,
-      body
+      requestBody
+    );
+  }
+  /**
+   * Renames a column (convenience wrapper over {@link alterColumn}).
+   * @param tableName - Table name.
+   * @param columnName - Current column name.
+   * @param body - Request body with newName (database optional; injected when omitted).
+   * @returns 200 response body (column detail).
+   * @throws AoudaNotFoundError if table or column does not exist; AoudaApiError for WRITE_NOT_ALLOWED, etc.
+   */
+  async renameColumn(tableName, columnName, body) {
+    validateNonEmptyString(body.newName ?? "", "New column name");
+    return this.alterColumn(tableName, columnName, { newName: body.newName });
+  }
+  /**
+   * Reorders columns in a table.
+   * PUT /api/databases/{db}/tables/{t}/columns:order (204 No Content).
+   * @param tableName - Table name.
+   * @param columnsOrBody - Ordered column names, or a request body with `columns`.
+   */
+  async reorderColumns(tableName, columnsOrBody) {
+    validateNonEmptyString(tableName, "Table name");
+    const columns = Array.isArray(columnsOrBody) ? columnsOrBody : columnsOrBody.columns;
+    if (!columns?.length) {
+      throw new Error("columns array is required and must be non-empty");
+    }
+    const prefix = databasePath2(this.database);
+    const encodedTable = encodeURIComponent(tableName);
+    const requestBody = {
+      database: this.database,
+      columns
+    };
+    await this.transport.put(
+      `${prefix}/tables/${encodedTable}/columns:order`,
+      requestBody
     );
   }
   /**
@@ -4209,6 +4254,37 @@ var BranchesApi = class {
   }
 };
 
+// src/jobs.ts
+function validateNonEmptyString2(value, name) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new Error(`${name} must be a non-empty string`);
+  }
+}
+var JobsApi = class {
+  constructor(transport, database) {
+    this.transport = transport;
+    this.database = database;
+  }
+  get prefix() {
+    return `${databasePath2(this.database)}/jobs`;
+  }
+  /**
+   * Lists jobs whose params target this database.
+   */
+  async list() {
+    return this.transport.get(this.prefix);
+  }
+  /**
+   * Gets a single job by id when it belongs to this database.
+   * @param jobId - Job GUID string.
+   */
+  async get(jobId) {
+    validateNonEmptyString2(jobId, "Job id");
+    const encoded = encodeURIComponent(jobId);
+    return this.transport.get(`${this.prefix}/${encoded}`);
+  }
+};
+
 // src/admin/server.ts
 var ServerAdminApi = class {
   constructor(transport) {
@@ -5486,7 +5562,7 @@ var DEFAULT_TIMEOUT_MS = 3e4;
 function normalizeBaseUrl(url) {
   return url.replace(/\/+$/, "");
 }
-function validateNonEmptyString2(value, name) {
+function validateNonEmptyString3(value, name) {
   if (typeof value !== "string" || value.trim().length === 0) {
     throw new Error(`${name} must be a non-empty string`);
   }
@@ -5501,8 +5577,8 @@ var AoudaClient = class {
   constructor(options) {
     this.connected = false;
     this._wsTransport = null;
-    validateNonEmptyString2(options.serverUrl, "serverUrl");
-    validateNonEmptyString2(options.database, "database");
+    validateNonEmptyString3(options.serverUrl, "serverUrl");
+    validateNonEmptyString3(options.database, "database");
     this.baseUrl = normalizeBaseUrl(options.serverUrl);
     this.timeout = options.timeout ?? DEFAULT_TIMEOUT_MS;
     this.database = options.database.trim();
@@ -5584,6 +5660,7 @@ var AoudaClient = class {
       this._authHandler = null;
     }
     this._tables = new TablesApi(this.transport, this.database);
+    this._jobs = new JobsApi(this.transport, this.database);
     this._databases = new DatabasesApi(this.transport);
     this._schema = new SchemaApi(this.transport, this.database);
     this._branches = new BranchesApi(this.transport, this.database);
@@ -5677,7 +5754,7 @@ var AoudaClient = class {
    * ```
    */
   table(name) {
-    validateNonEmptyString2(name, "Table name");
+    validateNonEmptyString3(name, "Table name");
     return new TableQuery(
       this.transport,
       name,
@@ -5693,6 +5770,13 @@ var AoudaClient = class {
   get tables() {
     return this._tables;
   }
+  /**
+   * Access pending/background jobs for the current database (e.g. ColumnRewrite).
+   * @returns The jobs API.
+   */
+  get jobs() {
+    return this._jobs;
+  }
   /**
    * Access server-level database operations (list, create, get, drop).
    * @returns The databases API.
@@ -5789,7 +5873,7 @@ var AoudaClient = class {
    * ```
    */
   bulkLoad(tableName, rows, options) {
-    validateNonEmptyString2(tableName, "tableName");
+    validateNonEmptyString3(tableName, "tableName");
     return new BulkLoadCoordinator(this.transport, this.database).run(
       [tableName],
       rows,