@querypanel/node-sdk 1.3.7 → 1.3.8

package/dist/index.d.cts

@@ -867,6 +867,12 @@ interface AskOptions {
     previousSql?: string;
     /** Maximum number of retry attempts on execution failure. */
     maxRetry?: number;
+    /**
+     * Also retry (within `maxRetry`) when the query returns no rows, or one row of only zeros/NULLs
+     * (what `COUNT(*) ... WHERE status = 'approved'` returns when the data stores 'APPROVE').
+     * Only that fact is sent to QueryPanel, never rows or values. Default false.
+     */
+    retryOnEmptyResult?: boolean;
     /** Maximum number of retries for chart generation. */
     chartMaxRetries?: number;
     /** Choose chart generation method. */

package/dist/index.d.ts

@@ -867,6 +867,12 @@ interface AskOptions {
     previousSql?: string;
     /** Maximum number of retry attempts on execution failure. */
     maxRetry?: number;
+    /**
+     * Also retry (within `maxRetry`) when the query returns no rows, or one row of only zeros/NULLs
+     * (what `COUNT(*) ... WHERE status = 'approved'` returns when the data stores 'APPROVE').
+     * Only that fact is sent to QueryPanel, never rows or values. Default false.
+     */
+    retryOnEmptyResult?: boolean;
     /** Maximum number of retries for chart generation. */
     chartMaxRetries?: number;
     /** Choose chart generation method. */

package/dist/index.js

@@ -2444,6 +2444,15 @@ function resolveQueryPipeline(pipeline) {
   }
   return "v2";
 }
+var EMPTY_RESULT_ERROR = "The query ran but returned no rows (or only zero/NULL values). A filter value probably does not match how the data stores it (case, spelling, codes such as 'APPROVE' vs 'approved'), or a filter is narrower than the question. Check each filter value against the column's documented values and fix it; keep every filter the question asks for.";
+function isEmptyLikeResult(rows) {
+  if (rows.length === 0) return true;
+  if (rows.length > 1) return false;
+  const row = rows[0];
+  if (!row || typeof row !== "object") return false;
+  const values = Object.values(row);
+  return values.length > 0 && values.every((v) => v === null || v === 0 || v === "0" || v === 0n);
+}
 async function ask(client, queryEngine, question, options, signal) {
   const tenantId = resolveTenantId5(client, options.tenantId);
   const sessionId = crypto3.randomUUID();
@@ -2526,6 +2535,17 @@ async function ask(client, queryEngine, question, options, signal) {
         tenantId
       );
       const rows = execution.rows ?? [];
+      if (options.retryOnEmptyResult && attempt < maxRetry && isEmptyLikeResult(rows)) {
+        attempt++;
+        lastError = EMPTY_RESULT_ERROR;
+        previousSql = sql;
+        console.warn("Query returned no data, retrying query generation", {
+          attempt,
+          maxAttempts: maxRetry + 1,
+          sql
+        });
+        continue;
+      }
       const chartType = options.chartType ?? "vega-lite";
       let chart = {
         specType: chartType,