@aouda/client 0.1.6 → 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.6",
+  version: "0.1.8",
   description: "Official TypeScript/JavaScript client library for Aouda",
   type: "module",
   main: "./dist/index.cjs",
@@ -1425,7 +1425,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(
@@ -3435,6 +3436,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.
    *
@@ -3445,9 +3448,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");
     }
@@ -3457,6 +3463,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,
@@ -3474,6 +3483,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.
    *
@@ -3486,9 +3496,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");
     }
@@ -3498,6 +3513,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,
@@ -3935,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
     );
   }
   /**
@@ -4191,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) {
@@ -4700,6 +4794,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
@@ -5439,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`);
   }
@@ -5454,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();
@@ -5537,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);
@@ -5630,7 +5754,7 @@ var AoudaClient = class {
    * ```
    */
   table(name) {
-    validateNonEmptyString2(name, "Table name");
+    validateNonEmptyString3(name, "Table name");
     return new TableQuery(
       this.transport,
       name,
@@ -5646,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.
@@ -5742,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,