autoql-fe-utils 1.11.18 → 1.11.21

package/dist/index.mjs

@@ -837,6 +837,7 @@ var DisplayTypes = /* @__PURE__ */ ((DisplayTypes2) => {
   DisplayTypes2["SCATTERPLOT"] = "scatterplot";
   DisplayTypes2["COLUMN_LINE"] = "column_line";
   DisplayTypes2["NETWORK_GRAPH"] = "network_graph";
+  DisplayTypes2["SANKEY"] = "sankey";
   return DisplayTypes2;
 })(DisplayTypes || {});
 var QueryErrorTypes = /* @__PURE__ */ ((QueryErrorTypes2) => {
@@ -1038,7 +1039,8 @@ var CHART_TYPES = [
   "column_line" /* COLUMN_LINE */,
   "histogram" /* HISTOGRAM */,
   "scatterplot" /* SCATTERPLOT */,
-  "network_graph" /* NETWORK_GRAPH */
+  "network_graph" /* NETWORK_GRAPH */,
+  "sankey" /* SANKEY */
 ];
 var CHARTS_WITHOUT_LEGENDS = [
   "pie" /* PIE */,
@@ -1046,16 +1048,18 @@ var CHARTS_WITHOUT_LEGENDS = [
   "bubble" /* BUBBLE */,
   "scatterplot" /* SCATTERPLOT */,
   "histogram" /* HISTOGRAM */,
-  "network_graph" /* NETWORK_GRAPH */
+  "network_graph" /* NETWORK_GRAPH */,
+  "sankey" /* SANKEY */
 ];
 var CHARTS_WITHOUT_AGGREGATED_DATA = [
   "histogram" /* HISTOGRAM */,
   "scatterplot" /* SCATTERPLOT */,
-  "network_graph" /* NETWORK_GRAPH */
+  "network_graph" /* NETWORK_GRAPH */,
+  "sankey" /* SANKEY */
 ];
 var DATE_ONLY_CHART_TYPES = ["line" /* LINE */, "stacked_line" /* STACKED_LINE */];
 var DOUBLE_AXIS_CHART_TYPES = ["column_line" /* COLUMN_LINE */];
-var CHARTS_WITHOUT_AXES = ["pie" /* PIE */, "network_graph" /* NETWORK_GRAPH */];
+var CHARTS_WITHOUT_AXES = ["pie" /* PIE */, "network_graph" /* NETWORK_GRAPH */, "sankey" /* SANKEY */];
 var DEFAULT_CHART_CONFIG = {
   isScaled: false
 };
@@ -2161,18 +2165,33 @@ var getUniqueYearsForColumn = (data, columns, index) => {
   return uniqueYears;
 };
 var supportsNetworkGraph = (data, columns) => {
-  if (!data || data.length < 2) return false;
-  if (!columns || columns.length < 2) return false;
+  var _a2, _b2;
+  const logUnsupportedReason = (message) => {
+    console.warn(`[supportsNetworkGraph] ${message}`);
+  };
+  if (!data || data.length < 2) {
+    logUnsupportedReason(`Insufficient rows (${(_a2 = data == null ? void 0 : data.length) != null ? _a2 : 0}). Need at least 2 rows.`);
+    return false;
+  }
+  if (!columns || columns.length < 2) {
+    logUnsupportedReason(`Insufficient columns (${(_b2 = columns == null ? void 0 : columns.length) != null ? _b2 : 0}). Need at least 2 visible columns.`);
+    return false;
+  }
   const networkColumns = findNetworkColumns(columns);
-  if (!networkColumns || networkColumns.sourceColumnIndex === -1 || networkColumns.targetColumnIndex === -1)
+  if (!networkColumns || networkColumns.sourceColumnIndex === -1 || networkColumns.targetColumnIndex === -1) {
+    logUnsupportedReason("Unable to determine source/target columns from provided metadata.");
     return false;
+  }
   const { sourceColumnIndex, targetColumnIndex } = networkColumns;
   const sourceValues = data.map((row) => row[sourceColumnIndex]).filter(Boolean);
   const targetValues = data.map((row) => row[targetColumnIndex]).filter(Boolean);
   const uniqueSources = new Set(sourceValues);
   const uniqueTargets = new Set(targetValues);
   const totalUniqueEntities = (/* @__PURE__ */ new Set([...uniqueSources, ...uniqueTargets])).size;
-  if (totalUniqueEntities < 1) return false;
+  if (totalUniqueEntities < 2) {
+    logUnsupportedReason(`Found only ${totalUniqueEntities} unique node(s). Need at least 2.`);
+    return false;
+  }
   const sourceCounts = {};
   const targetCounts = {};
   const relationshipPairs = /* @__PURE__ */ new Set();
@@ -2186,9 +2205,18 @@ var supportsNetworkGraph = (data, columns) => {
     }
   });
   const actualConnections = relationshipPairs.size;
-  if (actualConnections === 0) return false;
+  if (actualConnections === 0) {
+    logUnsupportedReason("No valid source\u2192target connections detected in dataset.");
+    return false;
+  }
   const MAX_UNIQUE_ENTITIES = 5e4;
-  return totalUniqueEntities <= MAX_UNIQUE_ENTITIES;
+  if (totalUniqueEntities > MAX_UNIQUE_ENTITIES) {
+    logUnsupportedReason(
+      `Too many unique nodes (${totalUniqueEntities}). Limit is ${MAX_UNIQUE_ENTITIES} for performance reasons.`
+    );
+    return false;
+  }
+  return true;
 };
 var findNetworkColumns = (columns) => {
   if (!columns || columns.length < 2) {
@@ -2265,6 +2293,78 @@ var findNetworkColumns = (columns) => {
   }
   return { sourceColumnIndex, targetColumnIndex, weightColumnIndex };
 };
+var supportsSankey = (rows, columns) => {
+  var _a2, _b2;
+  try {
+    const logUnsupportedReason = (message) => {
+      console.warn(`[supportsSankey] ${message}`);
+    };
+    if (!(rows == null ? void 0 : rows.length) || !(columns == null ? void 0 : columns.length)) {
+      logUnsupportedReason(
+        `Missing required data. rows=${(_a2 = rows == null ? void 0 : rows.length) != null ? _a2 : 0}, columns=${(_b2 = columns == null ? void 0 : columns.length) != null ? _b2 : 0}. Need at least 1 row and 3 columns.`
+      );
+      return false;
+    }
+    const { sourceColumnIndex, targetColumnIndex, weightColumnIndex } = findNetworkColumns(columns);
+    if (sourceColumnIndex === -1 || targetColumnIndex === -1 || weightColumnIndex === -1) {
+      logUnsupportedReason("Unable to determine source, target, and weight columns required for Sankey.");
+      return false;
+    }
+    const uniqueNodes = /* @__PURE__ */ new Set();
+    const uniqueLinks = /* @__PURE__ */ new Set();
+    let skippedRows = 0;
+    const normalizeNodeValue = (value) => {
+      if (value === void 0 || value === null) {
+        return void 0;
+      }
+      const sanitized = `${value}`.trim();
+      return sanitized.length ? sanitized : void 0;
+    };
+    const toFinitePositiveNumber = (value) => {
+      if (typeof value === "number") {
+        return Number.isFinite(value) ? value : NaN;
+      }
+      if (typeof value === "string") {
+        const cleaned = value.replace(/[^0-9.-]/g, "");
+        if (!cleaned.length) {
+          return NaN;
+        }
+        const parsed = Number(cleaned);
+        return Number.isFinite(parsed) ? parsed : NaN;
+      }
+      return NaN;
+    };
+    for (const row of rows) {
+      if (!row) {
+        continue;
+      }
+      const source = normalizeNodeValue(row[sourceColumnIndex]);
+      const target = normalizeNodeValue(row[targetColumnIndex]);
+      if (!source || !target || source === target) {
+        skippedRows += 1;
+        continue;
+      }
+      const weight = toFinitePositiveNumber(row[weightColumnIndex]);
+      if (!Number.isFinite(weight) || weight <= 0) {
+        skippedRows += 1;
+        continue;
+      }
+      uniqueNodes.add(source);
+      uniqueNodes.add(target);
+      uniqueLinks.add(`${source}__${target}`);
+    }
+    if (!uniqueLinks.size || uniqueNodes.size < 2) {
+      logUnsupportedReason(
+        `Insufficient valid flows. uniqueNodes=${uniqueNodes.size}, uniqueLinks=${uniqueLinks.size}, skippedRows=${skippedRows}.`
+      );
+      return false;
+    }
+    return true;
+  } catch (error) {
+    console.error("[supportsSankey] Unexpected error determining support", error);
+    return false;
+  }
+};
 var getSupportedDisplayTypes = ({
   response,
   columns,
@@ -2353,6 +2453,9 @@ var getSupportedDisplayTypes = ({
     if (supportsNetworkGraph(rows, visibleColumns)) {
       supportedDisplayTypes.push("network_graph");
     }
+    if (supportsSankey(rows, visibleColumns)) {
+      supportedDisplayTypes.push("sankey");
+    }
     return supportedDisplayTypes;
   } catch (error) {
     console.error(error);
@@ -4860,13 +4963,20 @@ var formatElement = ({
           const validatedQuantityDecimals = !isNaN(quantityDecimals) ? quantityDecimals : 2;
           const elementNumber = parseFloat(`${element}`);
           if (!isNaN(elementNumber)) {
-            const numDecimals = elementNumber % 1 !== 0 ? validatedQuantityDecimals : 0;
+            let numDecimals;
+            if ((column == null ? void 0 : column.quantity_type) === "integer") {
+              numDecimals = 0;
+            } else if ((column == null ? void 0 : column.quantity_type) === "float") {
+              numDecimals = validatedQuantityDecimals;
+            } else {
+              numDecimals = elementNumber % 1 !== 0 ? validatedQuantityDecimals : 0;
+            }
             formattedElement = new Intl.NumberFormat(languageCode, {
               minimumFractionDigits: numDecimals,
               maximumFractionDigits: numDecimals
             }).format(elementNumber);
-            if (formattedElement.endsWith(".00")) {
-              formattedElement = formattedElement.replace(".00", "");
+            if ((column == null ? void 0 : column.quantity_type) !== "float" && `${formattedElement}`.endsWith(".00")) {
+              formattedElement = `${formattedElement}`.replace(".00", "");
             }
           }
           break;
@@ -9853,16 +9963,27 @@ var transformQueryResponse = (response, originalQueryID, isDrilldown2 = false, n
   }
   return transformedResponse;
 };
+var detectQuantityType = (rows, colIndex) => {
+  if (!(rows == null ? void 0 : rows.length)) return "float";
+  for (const row of rows) {
+    const val = row == null ? void 0 : row[colIndex];
+    if (val === null || val === void 0) continue;
+    const num = typeof val === "number" ? val : parseFloat(val);
+    if (!isNaN(num) && num % 1 !== 0) return "float";
+  }
+  return "integer";
+};
 var transformQueryResponseColumns = (response, addedColumns) => {
-  var _a2, _b2;
+  var _a2, _b2, _c, _d;
   const columns = (_b2 = (_a2 = response == null ? void 0 : response.data) == null ? void 0 : _a2.data) == null ? void 0 : _b2.columns;
+  const rows = (_d = (_c = response == null ? void 0 : response.data) == null ? void 0 : _c.data) == null ? void 0 : _d.rows;
   if (!(columns == null ? void 0 : columns.length)) {
     return columns;
   }
   const isSingleValue = isSingleValueResponse(response);
   const transformedColumns = columns.map((col, i) => {
-    var _a3, _b3, _c, _d;
-    const dataSample = (_d = (_c = (_b3 = (_a3 = response == null ? void 0 : response.data) == null ? void 0 : _a3.data) == null ? void 0 : _b3.rows) == null ? void 0 : _c.find((row) => row[i])) == null ? void 0 : _d[i];
+    var _a3;
+    const dataSample = (_a3 = rows == null ? void 0 : rows.find((row) => row[i])) == null ? void 0 : _a3[i];
     const drilldownGroupby = getDrilldownGroupby(response, col);
     let additional = false;
     let is_timestamp = false;
@@ -9879,6 +10000,7 @@ var transformQueryResponseColumns = (response, addedColumns) => {
     if (isSingleValue) {
       is_visible = true;
     }
+    const quantity_type = col.type === "QUANTITY" /* QUANTITY */ ? detectQuantityType(rows, i) : void 0;
     return new Column({
       ...col,
       field: `${i}`,
@@ -9886,7 +10008,8 @@ var transformQueryResponseColumns = (response, addedColumns) => {
       drilldownGroupby,
       additional,
       is_visible,
-      is_timestamp
+      is_timestamp,
+      quantity_type
     });
   });
   return transformedColumns;
@@ -10334,12 +10457,22 @@ var exportCSV = ({
   domain,
   apiKey,
   token,
-  csvProgressCallback
+  filters,
+  tableFilters,
+  csvProgressCallback,
+  source = DEFAULT_SOURCE,
+  scope = "null"
 } = {}) => {
   if (!token || !domain || !apiKey) {
     return Promise.reject(new Error("Unauthenticated" /* UNAUTHENTICATED */));
   }
   const url = `${domain}/autoql/api/v1/query/${queryId}/export?key=${apiKey}`;
+  const data = {
+    session_filter_locks: filters,
+    filters: tableFilters,
+    source,
+    scope
+  };
   const config = {
     headers: {
       Authorization: `Bearer ${token}`
@@ -10352,7 +10485,7 @@ var exportCSV = ({
       }
     }
   };
-  return axios.post(url, {}, config).then((response) => Promise.resolve(response)).catch((error) => Promise.reject(error == null ? void 0 : error.response));
+  return axios.post(url, data, config).then((response) => Promise.resolve(response)).catch((error) => Promise.reject(error == null ? void 0 : error.response));
 };
 var runDrilldown = ({
   queryID,
@@ -13182,6 +13315,7 @@ export {
   supportsNetworkGraph,
   supportsPieChart,
   supportsRegularPivotTable,
+  supportsSankey,
   svgPathD,
   svgToPng,
   titlelizeString,