@aouda/client 0.1.3 → 0.1.5

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.3",
+  version: "0.1.5",
   description: "Official TypeScript/JavaScript client library for Aouda",
   type: "module",
   main: "./dist/index.cjs",
@@ -2848,7 +2848,8 @@ var TableQuery = class _TableQuery {
       limitValue: null,
       offsetValue: null,
       crossPartitionAccess: false,
-      selectExprs: null
+      selectExprs: null,
+      isDistinct: false
     };
   }
   where(column, operator, value) {
@@ -3017,11 +3018,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.
    *
@@ -3043,6 +3079,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
@@ -3087,6 +3126,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,
@@ -3226,6 +3268,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() {
@@ -3247,6 +3292,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