@aouda/client 0.1.13 → 0.1.14

package/dist/{client-DFujaTFB.d.cts → client-BCMP-Fge.d.cts}

@@ -432,6 +432,8 @@ interface QueryStats {
     segmentsAccessed: number;
     /** Query execution time in milliseconds. */
     executionMs: number;
+    /** True when DISTINCT was served from the partition directory. Omitted when false. */
+    distinctServedFromPartitionMetadata?: boolean;
 }
 /**
  * Result of a query execution.
@@ -444,6 +446,8 @@ interface QueryResult<T = Record<string, unknown>> {
     stats: QueryStats;
     /** Additive warnings (e.g. named-query deprecation). */
     warnings?: ResultWarning[];
+    /** Total matching rows when the named query declared `count`. */
+    totalMatches?: number;
 }
 /** Additive result warning from the server. */
 interface ResultWarning {
@@ -464,6 +468,8 @@ interface WherePredicate {
     column: string;
     op: WireOperator;
     value: unknown;
+    /** When true, bind skips this condition unless the named param is present (D-34). */
+    whenParamPresent?: boolean;
 }
 /**
  * Where clause structure for the wire protocol.
@@ -526,6 +532,8 @@ interface ColumnarResponse {
     rowCount: number;
     stats: QueryStats;
     warnings?: ResultWarning[];
+    /** Total matching rows when the named query declared `count`. */
+    totalMatches?: number;
 }
 /**
  * Summary of a table returned by list().
@@ -2472,6 +2480,8 @@ interface AuthMessage {
 interface ConflateOptions {
     key?: string[];
     interval_ms: number;
+    /** When true, matching inserts are held latest-wins per key (D-32). Default omitted/false. */
+    collapse_inserts?: boolean;
 }
 interface SubscribeMessage {
     type: "subscribe";
@@ -2482,6 +2492,7 @@ interface SubscribeMessage {
     hash?: string;
     args?: Record<string, unknown>;
     conflate?: ConflateOptions;
+    orderByIndex?: number;
 }
 interface ReAuthMessage {
     type: "re_auth";
@@ -2533,6 +2544,7 @@ interface SnapshotCompleteMessage {
     id: string;
     version: number;
     row_count: number;
+    total_matches?: number;
     warnings?: Array<{
         code: string;
         hash?: string;
@@ -2599,6 +2611,7 @@ interface SubscriptionSnapshotEvent<T = Record<string, unknown>> {
     type: "snapshot";
     rows: T[];
     version: number;
+    totalMatches?: number;
 }
 interface SubscriptionChangeEvent<T = Record<string, unknown>> {
     type: "change";
@@ -2611,7 +2624,7 @@ interface SubscriptionChangeEvent<T = Record<string, unknown>> {
 }
 type SubscriptionEvent<T = Record<string, unknown>> = SubscriptionSnapshotEvent<T> | SubscriptionChangeEvent<T>;
 interface SubscribeOptions<T = Record<string, unknown>> {
-    onSnapshot?: (rows: T[], version: number) => void;
+    onSnapshot?: (rows: T[], version: number, totalMatches?: number) => void;
     onChange?: (event: SubscriptionChangeEvent<T>) => void;
     onError?: (error: Error) => void;
     filter?: Record<string, unknown>;
@@ -3410,7 +3423,9 @@ interface NamedQueryDefinition {
     selectExpr?: ComputedColumnDef[];
     joins?: JoinClause[];
     orderBy?: OrderByClause[];
+    orderByChoices?: OrderByClause[][];
     distinct?: boolean;
+    count?: boolean;
     limit?: number;
     offset?: number;
     limitParam?: string;
@@ -3839,16 +3854,21 @@ declare class MaterializedQueriesApi {
 
 interface NamedQueryExecuteOptions {
     signal?: AbortSignal;
+    /** 0-based index into the definition's `orderByChoices`. Sibling of `args`, not a named-query param. */
+    orderByIndex?: number;
 }
 interface NamedQuerySubscribeOptions<T = Record<string, unknown>> {
-    onSnapshot?: (rows: T[], version: number) => void;
+    onSnapshot?: (rows: T[], version: number, totalMatches?: number) => void;
     onChange?: (event: SubscriptionChangeEvent<T>) => void;
     onError?: (error: Error) => void;
     conflate?: ConflateOptions;
+    /** 0-based index into the definition's `orderByChoices`. */
+    orderByIndex?: number;
 }
 interface NamedQueryBatchItem {
     hash: string;
     args?: Record<string, unknown>;
+    orderByIndex?: number;
 }
 interface NamedQueryBatchSlotResult<T = Record<string, unknown>> {
     isError: boolean;

package/dist/{client-DFujaTFB.d.ts → client-BCMP-Fge.d.ts}

@@ -432,6 +432,8 @@ interface QueryStats {
     segmentsAccessed: number;
     /** Query execution time in milliseconds. */
     executionMs: number;
+    /** True when DISTINCT was served from the partition directory. Omitted when false. */
+    distinctServedFromPartitionMetadata?: boolean;
 }
 /**
  * Result of a query execution.
@@ -444,6 +446,8 @@ interface QueryResult<T = Record<string, unknown>> {
     stats: QueryStats;
     /** Additive warnings (e.g. named-query deprecation). */
     warnings?: ResultWarning[];
+    /** Total matching rows when the named query declared `count`. */
+    totalMatches?: number;
 }
 /** Additive result warning from the server. */
 interface ResultWarning {
@@ -464,6 +468,8 @@ interface WherePredicate {
     column: string;
     op: WireOperator;
     value: unknown;
+    /** When true, bind skips this condition unless the named param is present (D-34). */
+    whenParamPresent?: boolean;
 }
 /**
  * Where clause structure for the wire protocol.
@@ -526,6 +532,8 @@ interface ColumnarResponse {
     rowCount: number;
     stats: QueryStats;
     warnings?: ResultWarning[];
+    /** Total matching rows when the named query declared `count`. */
+    totalMatches?: number;
 }
 /**
  * Summary of a table returned by list().
@@ -2472,6 +2480,8 @@ interface AuthMessage {
 interface ConflateOptions {
     key?: string[];
     interval_ms: number;
+    /** When true, matching inserts are held latest-wins per key (D-32). Default omitted/false. */
+    collapse_inserts?: boolean;
 }
 interface SubscribeMessage {
     type: "subscribe";
@@ -2482,6 +2492,7 @@ interface SubscribeMessage {
     hash?: string;
     args?: Record<string, unknown>;
     conflate?: ConflateOptions;
+    orderByIndex?: number;
 }
 interface ReAuthMessage {
     type: "re_auth";
@@ -2533,6 +2544,7 @@ interface SnapshotCompleteMessage {
     id: string;
     version: number;
     row_count: number;
+    total_matches?: number;
     warnings?: Array<{
         code: string;
         hash?: string;
@@ -2599,6 +2611,7 @@ interface SubscriptionSnapshotEvent<T = Record<string, unknown>> {
     type: "snapshot";
     rows: T[];
     version: number;
+    totalMatches?: number;
 }
 interface SubscriptionChangeEvent<T = Record<string, unknown>> {
     type: "change";
@@ -2611,7 +2624,7 @@ interface SubscriptionChangeEvent<T = Record<string, unknown>> {
 }
 type SubscriptionEvent<T = Record<string, unknown>> = SubscriptionSnapshotEvent<T> | SubscriptionChangeEvent<T>;
 interface SubscribeOptions<T = Record<string, unknown>> {
-    onSnapshot?: (rows: T[], version: number) => void;
+    onSnapshot?: (rows: T[], version: number, totalMatches?: number) => void;
     onChange?: (event: SubscriptionChangeEvent<T>) => void;
     onError?: (error: Error) => void;
     filter?: Record<string, unknown>;
@@ -3410,7 +3423,9 @@ interface NamedQueryDefinition {
     selectExpr?: ComputedColumnDef[];
     joins?: JoinClause[];
     orderBy?: OrderByClause[];
+    orderByChoices?: OrderByClause[][];
     distinct?: boolean;
+    count?: boolean;
     limit?: number;
     offset?: number;
     limitParam?: string;
@@ -3839,16 +3854,21 @@ declare class MaterializedQueriesApi {
 
 interface NamedQueryExecuteOptions {
     signal?: AbortSignal;
+    /** 0-based index into the definition's `orderByChoices`. Sibling of `args`, not a named-query param. */
+    orderByIndex?: number;
 }
 interface NamedQuerySubscribeOptions<T = Record<string, unknown>> {
-    onSnapshot?: (rows: T[], version: number) => void;
+    onSnapshot?: (rows: T[], version: number, totalMatches?: number) => void;
     onChange?: (event: SubscriptionChangeEvent<T>) => void;
     onError?: (error: Error) => void;
     conflate?: ConflateOptions;
+    /** 0-based index into the definition's `orderByChoices`. */
+    orderByIndex?: number;
 }
 interface NamedQueryBatchItem {
     hash: string;
     args?: Record<string, unknown>;
+    orderByIndex?: number;
 }
 interface NamedQueryBatchSlotResult<T = Record<string, unknown>> {
     isError: boolean;

package/dist/index.cjs

@@ -87,7 +87,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@aouda/client",
-  version: "0.1.13",
+  version: "0.1.14",
   description: "Official TypeScript/JavaScript client library for Aouda",
   type: "module",
   main: "./dist/index.cjs",
@@ -2203,6 +2203,9 @@ var TableSubscription = class {
       if (this._identity.args !== void 0) {
         message.args = this._identity.args;
       }
+      if (this._identity.orderByIndex !== void 0) {
+        message.orderByIndex = this._identity.orderByIndex;
+      }
     } else {
       message.target = this._identity.target;
       if (this._identity.filter !== void 0) {
@@ -2251,12 +2254,16 @@ var TableSubscription = class {
     }
     const rows = this._pendingSnapshotRows;
     this._pendingSnapshotRows = [];
-    this._onSnapshot?.(rows, message.version);
-    this._queue.push({
+    this._onSnapshot?.(rows, message.version, message.total_matches);
+    const snapshot = {
       type: "snapshot",
       rows,
       version: message.version
-    });
+    };
+    if (message.total_matches !== void 0) {
+      snapshot.totalMatches = message.total_matches;
+    }
+    this._queue.push(snapshot);
   }
   async _handleGap(message) {
     this._pendingSnapshotRows = [];
@@ -4843,9 +4850,15 @@ var NamedQueriesApi = class {
     }
     const prefix = databasePath2(this.database);
     const path = `${prefix}/named-queries/${encodeURIComponent(hash)}/query?format=columnar`;
+    const body = {
+      args: args ?? {}
+    };
+    if (options?.orderByIndex !== void 0) {
+      body.orderByIndex = options.orderByIndex;
+    }
     const response = await this.transport.post(
       path,
-      { args: args ?? {} },
+      body,
       { signal: options?.signal }
     );
     const rows = columnarToRows(response);
@@ -4853,7 +4866,8 @@ var NamedQueriesApi = class {
     return {
       rows,
       stats: response.stats,
-      warnings: response.warnings
+      warnings: response.warnings,
+      totalMatches: response.totalMatches
     };
   }
   async batch(items, options) {
@@ -4892,12 +4906,14 @@ var NamedQueriesApi = class {
         data: slot.data ?? [],
         rowCount: slot.rowCount ?? 0,
         stats: slot.stats ?? emptyStats(),
-        warnings: slot.warnings
+        warnings: slot.warnings,
+        totalMatches: slot.totalMatches
       };
       const result = {
         rows: columnarToRows(columnar),
         stats: columnar.stats,
-        warnings: slot.warnings
+        warnings: slot.warnings,
+        totalMatches: slot.totalMatches
       };
       raiseDeprecationWarnings(this.onWarning, slot.warnings);
       return { isError: false, result };
@@ -4909,7 +4925,7 @@ var NamedQueriesApi = class {
     }
     const subscription = new TableSubscription(
       this.getStreamingTransport(),
-      { kind: "named", hash, args },
+      { kind: "named", hash, args, orderByIndex: options.orderByIndex },
       {
         onSnapshot: options.onSnapshot,
         onChange: options.onChange,