@carto/api-client 0.5.30-alpha.143d135.117 → 0.5.30-alpha.b195e7f.118

package/CHANGELOG.md

@@ -4,6 +4,7 @@
 
 ### 0.5.30
 
+- feat(widgetSources): support `featureIds` / `geometryType` request options to filter widget aggregations by a feature selection without relying on the synthetic `_carto_feature_id` column (#294)
 - feat(widgetSources): support `SpatialIndexFilter` (H3/Quadbin cell selection) on `spatialFilter` (#296)
 
 ### 0.5.29

package/build/api-client.cjs

@@ -6594,6 +6594,19 @@ init_cjs_shims();
 var OTHERS_CATEGORY_NAME = "_carto_others";
 
 // src/widget-sources/widget-remote-source.ts
+var FEATURE_IDS_LIMIT = 1e3;
+function getFeatureSelectionParams(options) {
+  const { featureIds, geometryType } = options;
+  if (!featureIds || featureIds.length === 0) {
+    return {};
+  }
+  assert2(geometryType, "geometryType is required when featureIds are provided");
+  assert2(
+    featureIds.length <= FEATURE_IDS_LIMIT,
+    `featureIds is limited to ${FEATURE_IDS_LIMIT} values, received ${featureIds.length}`
+  );
+  return { featureIds, geometryType };
+}
 var WidgetRemoteSource = class extends WidgetSource {
   _getModelSource(filters, filterOwner) {
     const props = this.props;
@@ -6644,7 +6657,8 @@ var WidgetRemoteSource = class extends WidgetSource {
         operationExp,
         operationColumn: operationColumn || column,
         othersThreshold,
-        orderBy
+        orderBy,
+        ...getFeatureSelectionParams(options)
       },
       opts: { signal, headers: this.props.headers }
     });
@@ -6714,7 +6728,8 @@ var WidgetRemoteSource = class extends WidgetSource {
       params: {
         column: column ?? "*",
         operation: operation2 ?? AggregationTypes.Count,
-        operationExp
+        operationExp,
+        ...getFeatureSelectionParams(options)
       },
       opts: { signal, headers: this.props.headers }
     }).then((res) => normalizeObjectKeys(res.rows[0]));
@@ -6736,7 +6751,7 @@ var WidgetRemoteSource = class extends WidgetSource {
         spatialFiltersMode,
         spatialFilter
       },
-      params: { column, operation: operation2, ticks },
+      params: { column, operation: operation2, ticks, ...getFeatureSelectionParams(options) },
       opts: { signal, headers: this.props.headers }
     }).then((res) => normalizeObjectKeys(res.rows));
     if (data.length) {
@@ -6765,7 +6780,7 @@ var WidgetRemoteSource = class extends WidgetSource {
         spatialFiltersMode,
         spatialFilter
       },
-      params: { column },
+      params: { column, ...getFeatureSelectionParams(options) },
       opts: { signal, headers: this.props.headers }
     }).then((res) => normalizeObjectKeys(res.rows[0]));
   }
@@ -6792,7 +6807,8 @@ var WidgetRemoteSource = class extends WidgetSource {
         xAxisJoinOperation,
         yAxisColumn,
         yAxisJoinOperation,
-        limit: HARD_LIMIT
+        limit: HARD_LIMIT,
+        ...getFeatureSelectionParams(options)
       },
       opts: { signal, headers: this.props.headers }
     }).then((res) => normalizeObjectKeys(res.rows)).then((res) => res.map(({ x, y }) => [x, y]));
@@ -6819,7 +6835,8 @@ var WidgetRemoteSource = class extends WidgetSource {
         sortBy,
         sortDirection,
         limit,
-        offset
+        offset,
+        ...getFeatureSelectionParams(options)
       },
       opts: { signal, headers: this.props.headers }
     }).then((res) => ({
@@ -6869,7 +6886,8 @@ var WidgetRemoteSource = class extends WidgetSource {
         operationExp,
         splitByCategory,
         splitByCategoryLimit,
-        splitByCategoryValues
+        splitByCategoryValues,
+        ...getFeatureSelectionParams(options)
       },
       opts: { signal, headers: this.props.headers }
     }).then((res) => ({
@@ -6894,7 +6912,8 @@ var WidgetRemoteSource = class extends WidgetSource {
         spatialFilter
       },
       params: {
-        aggregations
+        aggregations,
+        ...getFeatureSelectionParams(options)
       },
       opts: { signal, headers: this.props.headers }
     }).then((res) => ({