@aouda/client 0.1.3 → 0.1.5

package/dist/cli/index.d.cts

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

package/dist/cli/index.d.ts

@@ -1,4 +1,4 @@
-import { A as AoudaClient } from '../client-B9a2zoUU.js';
+import { A as AoudaClient } from '../client-CD9Ew5sO.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.3",
+  version: "0.1.5",
   description: "Official TypeScript/JavaScript client library for Aouda",
   type: "module",
   main: "./dist/index.cjs",
@@ -2819,7 +2819,8 @@ var TableQuery = class _TableQuery {
       limitValue: null,
       offsetValue: null,
       crossPartitionAccess: false,
-      selectExprs: null
+      selectExprs: null,
+      isDistinct: false
     };
   }
   where(column, operator, value) {
@@ -2988,11 +2989,46 @@ var TableQuery = class _TableQuery {
    * ```
    */
   select(...columns) {
+    if (this.state.isDistinct) {
+      throw new Error(
+        "select() cannot be combined with distinct(). Use distinct(columns) instead."
+      );
+    }
     return new _TableQuery(this.transport, this.tableName, this.database, {
       ...this.state,
       selectColumns: columns.length > 0 ? columns : null
     }, this.getWebSocketTransport);
   }
+  /**
+   * Return only distinct (de-duplicated) rows for the given columns — SQL `SELECT DISTINCT`.
+   * Mutually exclusive with `selectExpr()` and joins.
+   *
+   * When T is a specific row type, only keys of T are accepted as column names.
+   *
+   * @param columns - The column names to de-duplicate on.
+   * @returns A new TableQuery with distinct projection set.
+   *
+   * @example
+   * ```typescript
+   * query.distinct('category', 'region')
+   * ```
+   */
+  distinct(...columns) {
+    if (columns.length === 0) {
+      throw new Error("At least one column is required.");
+    }
+    if (this.state.selectExprs !== null && this.state.selectExprs.length > 0) {
+      throw new Error("distinct() cannot be combined with selectExpr().");
+    }
+    if (this.state.joinClauses.length > 0) {
+      throw new Error("distinct() cannot be combined with joins().");
+    }
+    return new _TableQuery(this.transport, this.tableName, this.database, {
+      ...this.state,
+      selectColumns: columns,
+      isDistinct: true
+    }, this.getWebSocketTransport);
+  }
   /**
    * Adds server-side computed columns to the query result.
    *
@@ -3014,6 +3050,9 @@ var TableQuery = class _TableQuery {
     if (projections.length === 0) {
       throw new Error("selectExpr() requires at least one projection.");
     }
+    if (this.state.isDistinct) {
+      throw new Error("selectExpr() cannot be combined with distinct().");
+    }
     return new _TableQuery(this.transport, this.tableName, this.database, {
       ...this.state,
       selectExprs: projections
@@ -3058,6 +3097,9 @@ var TableQuery = class _TableQuery {
     if (rightTable.trim().length === 0) {
       throw new Error("crossJoin() requires a non-empty rightTable");
     }
+    if (this.state.isDistinct) {
+      throw new Error("joins() cannot be combined with distinct().");
+    }
     return new _TableQuery(
       this.transport,
       this.tableName,
@@ -3197,6 +3239,9 @@ var TableQuery = class _TableQuery {
     if (this.state.selectExprs !== null && this.state.selectExprs.length > 0) {
       request.selectExpr = this.state.selectExprs;
     }
+    if (this.state.isDistinct) {
+      request.distinct = true;
+    }
     return request;
   }
   buildWhereClause() {
@@ -3218,6 +3263,9 @@ var TableQuery = class _TableQuery {
     if (rightTable.trim().length === 0) {
       throw new Error("join() requires a non-empty rightTable");
     }
+    if (this.state.isDistinct) {
+      throw new Error("joins() cannot be combined with distinct().");
+    }
     const joinClause = {
       table: rightTable,
       type