@aouda/client 0.1.4 → 0.1.5

package/dist/{client-DXLViyzE.d.cts → client-CD9Ew5sO.d.cts}

@@ -2441,6 +2441,8 @@ interface QueryBuilderState {
     crossPartitionAccess: boolean;
     /** Server-side computed column projections (S7). */
     selectExprs: ComputedColumnDef[] | null;
+    /** When true, emit `distinct: true` on the wire (SQL SELECT DISTINCT). */
+    isDistinct: boolean;
 }
 /**
  * Coerces a raw columnar value using the server-declared column type name.
@@ -2617,6 +2619,21 @@ declare class TableQuery<T = Record<string, unknown>> {
      * ```
      */
     select(...columns: (keyof T & string)[]): TableQuery<T>;
+    /**
+     * 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: (keyof T & string)[]): TableQuery<T>;
     /**
      * Adds server-side computed columns to the query result.
      *

package/dist/{client-DXLViyzE.d.ts → client-CD9Ew5sO.d.ts}

@@ -2441,6 +2441,8 @@ interface QueryBuilderState {
     crossPartitionAccess: boolean;
     /** Server-side computed column projections (S7). */
     selectExprs: ComputedColumnDef[] | null;
+    /** When true, emit `distinct: true` on the wire (SQL SELECT DISTINCT). */
+    isDistinct: boolean;
 }
 /**
  * Coerces a raw columnar value using the server-declared column type name.
@@ -2617,6 +2619,21 @@ declare class TableQuery<T = Record<string, unknown>> {
      * ```
      */
     select(...columns: (keyof T & string)[]): TableQuery<T>;
+    /**
+     * 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: (keyof T & string)[]): TableQuery<T>;
     /**
      * Adds server-side computed columns to the query result.
      *

package/dist/index.cjs

@@ -82,7 +82,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@aouda/client",
-  version: "0.1.4",
+  version: "0.1.5",
   description: "Official TypeScript/JavaScript client library for Aouda",
   type: "module",
   main: "./dist/index.cjs",
@@ -2542,7 +2542,8 @@ var TableQuery = class _TableQuery {
       limitValue: null,
       offsetValue: null,
       crossPartitionAccess: false,
-      selectExprs: null
+      selectExprs: null,
+      isDistinct: false
     };
   }
   where(column, operator, value) {
@@ -2711,11 +2712,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.
    *
@@ -2737,6 +2773,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
@@ -2781,6 +2820,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,
@@ -2920,6 +2962,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() {
@@ -2941,6 +2986,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