@aouda/client 0.1.6 → 0.1.8

package/dist/cli/index.d.cts

@@ -1,4 +1,4 @@
-import { A as AoudaClient } from '../client-Bb6UxTA4.cjs';
+import { A as AoudaClient } from '../client-TIOp5NUu.cjs';
 
 /**
  * CLI for @aouda/client.

package/dist/cli/index.d.ts

@@ -1,4 +1,4 @@
-import { A as AoudaClient } from '../client-Bb6UxTA4.js';
+import { A as AoudaClient } from '../client-TIOp5NUu.js';
 
 /**
  * CLI for @aouda/client.

package/dist/cli/index.js

@@ -392,7 +392,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "@aouda/client",
-  version: "0.1.6",
+  version: "0.1.8",
   description: "Official TypeScript/JavaScript client library for Aouda",
   type: "module",
   main: "./dist/index.cjs",
@@ -1396,7 +1396,8 @@ var BulkLoadCoordinator = class {
         pkUniquenessOverride: options.pkUniquenessOverride,
         replicationMode: options.replicationMode,
         forceSingleNodeReplicationBypass: options.forceSingleNodeReplicationBypass,
-        postLoadMqBehavior: options.postLoadMqBehavior
+        postLoadMqBehavior: options.postLoadMqBehavior,
+        ...options.identityInsert === true ? { identityInsert: true } : {}
       }
     };
     const beginResp = await this.transport.post(
@@ -3406,6 +3407,8 @@ var TableQuery = class _TableQuery {
    * a Promise. It does not use query builder state (where, orderBy, etc.).
    *
    * @param row - The row data to insert. Keys are column names.
+   * @param row - The row object to insert. Keys are column names.
+   * @param options - Optional insert options (e.g. `identityInsert`).
    * @returns The insert result with row count, execution time, and optional generated values.
    * @throws Error if `row` is null or undefined.
    *
@@ -3416,9 +3419,12 @@ var TableQuery = class _TableQuery {
    *
    * console.log(result.rowsInserted); // 1
    * console.log(result.generatedValues); // { "0": { id: 42 } }
+   *
+   * // Identity-insert (Bond isAutoIncrementDisabled: true): store explicit IDs including 0
+   * await client.table('orders').insert({ id: 1000, status: 'seeded' }, { identityInsert: true });
    * ```
    */
-  async insert(row) {
+  async insert(row, options) {
     if (row == null) {
       throw new Error("insert() requires a non-null row object");
     }
@@ -3428,6 +3434,9 @@ var TableQuery = class _TableQuery {
       database: this.database,
       rows: [row]
     };
+    if (options?.identityInsert === true) {
+      body.identityInsert = true;
+    }
     const response = await this.transport.post(path4, body);
     const result = {
       rowsInserted: response.rowsInserted,
@@ -3445,6 +3454,7 @@ var TableQuery = class _TableQuery {
    * a Promise. It does not use query builder state (where, orderBy, etc.).
    *
    * @param rows - Array of row objects to insert. Must contain at least one row.
+   * @param options - Optional insert options (e.g. `identityInsert`).
    * @returns The insert result with total row count, execution time, and optional generated values.
    * @throws Error if `rows` is empty.
    *
@@ -3457,9 +3467,14 @@ var TableQuery = class _TableQuery {
    *   ]);
    *
    * console.log(result.rowsInserted); // 2
+   *
+   * await client.table('orders').insertMany(
+   *   [{ id: 10 }, { id: 20 }],
+   *   { identityInsert: true },
+   * );
    * ```
    */
-  async insertMany(rows) {
+  async insertMany(rows, options) {
     if (!Array.isArray(rows) || rows.length === 0) {
       throw new Error("insertMany() requires a non-empty array of rows");
     }
@@ -3469,6 +3484,9 @@ var TableQuery = class _TableQuery {
       database: this.database,
       rows
     };
+    if (options?.identityInsert === true) {
+      body.identityInsert = true;
+    }
     const response = await this.transport.post(path4, body);
     const result = {
       rowsInserted: response.rowsInserted,
@@ -3906,23 +3924,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
     );
   }
   /**
@@ -4162,6 +4225,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) {
@@ -4671,6 +4765,35 @@ var NotificationsAdminApi = class {
       request
     );
   }
+  /**
+   * Get recent captured auth notifications (newest first).
+   * GET /admin/notifications/outbox?channel=&limit=
+   */
+  async getOutbox(options) {
+    return this.transport.get(
+      this.buildOutboxPath(options)
+    );
+  }
+  /**
+   * Clear the in-memory notification outbox.
+   * DELETE /admin/notifications/outbox
+   */
+  async clearOutbox() {
+    return this.transport.delete(
+      `${BASE_PATH7}/outbox`
+    );
+  }
+  buildOutboxPath(options) {
+    const params = new URLSearchParams();
+    if (options?.channel !== void 0 && options.channel.trim().length > 0) {
+      params.set("channel", options.channel);
+    }
+    if (options?.limit !== void 0) {
+      params.set("limit", String(options.limit));
+    }
+    const query = params.toString();
+    return query.length > 0 ? `${BASE_PATH7}/outbox?${query}` : `${BASE_PATH7}/outbox`;
+  }
 };
 
 // src/admin/index.ts
@@ -5410,7 +5533,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`);
   }
@@ -5425,8 +5548,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();
@@ -5508,6 +5631,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);
@@ -5601,7 +5725,7 @@ var AoudaClient = class {
    * ```
    */
   table(name) {
-    validateNonEmptyString2(name, "Table name");
+    validateNonEmptyString3(name, "Table name");
     return new TableQuery(
       this.transport,
       name,
@@ -5617,6 +5741,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.
@@ -5713,7 +5844,7 @@ var AoudaClient = class {
    * ```
    */
   bulkLoad(tableName, rows, options) {
-    validateNonEmptyString2(tableName, "tableName");
+    validateNonEmptyString3(tableName, "tableName");
     return new BulkLoadCoordinator(this.transport, this.database).run(
       [tableName],
       rows,