@carto/api-client 0.0.1-0 → 0.0.1-2

package/build/api-client.cjs

@@ -1,19 +1,32 @@
-const CLIENT_ID = 'carto-api-client';
-/** @internalRemarks Source: @carto/constants */
-exports.MapType = void 0;
-(function (MapType) {
-  MapType["TABLE"] = "table";
-  MapType["QUERY"] = "query";
-  MapType["TILESET"] = "tileset";
-})(exports.MapType || (exports.MapType = {}));
-/** @internalRemarks Source: @carto/constants */
-exports.ApiVersion = void 0;
-(function (ApiVersion) {
-  ApiVersion["V1"] = "v1";
-  ApiVersion["V2"] = "v2";
-  ApiVersion["V3"] = "v3";
-})(exports.ApiVersion || (exports.ApiVersion = {}));
-/** @internalRemarks Source: @carto/react-core */
+/**
+ * @internal
+ * @internalRemarks Source: @carto/react-core
+ */
+let client = 'carto-api-client';
+/**
+ * Returns current client ID, used to categorize API requests. For internal use only.
+ *
+ * @internal
+ * @internalRemarks Source: @carto/react-core
+ */
+function getClient() {
+  return client;
+}
+/**
+ * Sets current client ID, used to categorize API requests. For internal use only.
+ *
+ * @internal
+ * @internalRemarks Source: @carto/react-core
+ */
+function setClient(c) {
+  client = c;
+}
+
+/**
+ * Defines a step size increment for use with {@link TimeSeriesRequestOptions}.
+ *
+ * @internalRemarks Source: @carto/react-core
+ */
 exports.GroupDateType = void 0;
 (function (GroupDateType) {
   GroupDateType["YEARS"] = "year";
@@ -24,7 +37,20 @@ exports.GroupDateType = void 0;
   GroupDateType["MINUTES"] = "minute";
   GroupDateType["SECONDS"] = "second";
 })(exports.GroupDateType || (exports.GroupDateType = {}));
-/** @internalRemarks Source: @carto/react-api, @deck.gl/carto */
+/**
+ * Defines a comparator used when matching a column's values against given filter values.
+ *
+ * Example:
+ *
+ * ```javascript
+ * import { FilterType } from '@carto/api-client';
+ * const filters = {
+ *   column_name: { [FilterType.IN]: { values: ['a', 'b', 'c'] } }
+ * };
+ * ```
+ *
+ * @internalRemarks Source: @carto/react-api, @deck.gl/carto
+ */
 exports.FilterType = void 0;
 (function (FilterType) {
   FilterType["IN"] = "in";
@@ -36,26 +62,9 @@ exports.FilterType = void 0;
   FilterType["STRING_SEARCH"] = "stringSearch";
 })(exports.FilterType || (exports.FilterType = {}));
 
-/**
- * Default client
- * @internalRemarks Source: @carto/react-core
- */
-let client = CLIENT_ID;
-/** @internalRemarks Source: @carto/react-core */
-function getClient() {
-  return client;
-}
-/** @internalRemarks Source: @carto/react-core */
-function setClient(c) {
-  client = c;
-}
-
-/**
- * Threshold to use GET requests, vs POST
- * @internalRemarks Source: @carto/constants
- * @internal
+/******************************************************************************
+ * DEFAULTS
  */
-const REQUEST_GET_MAX_URL_LENGTH = 2048;
 /**
  * @internalRemarks Source: @carto/constants
  * @internal
@@ -66,6 +75,29 @@ const DEFAULT_API_BASE_URL$1 = 'https://gcp-us-east1.api.carto.com';
  * @internal
  */
 const DEFAULT_GEO_COLUMN = 'geom';
+/******************************************************************************
+ * ENUMS
+ */
+/**
+ * @internal
+ * @internalRemarks Source: @carto/constants
+ */
+var MapType;
+(function (MapType) {
+  MapType["TABLE"] = "table";
+  MapType["QUERY"] = "query";
+  MapType["TILESET"] = "tileset";
+})(MapType || (MapType = {}));
+/**
+ * @internal
+ * @internalRemarks Source: @carto/constants
+ */
+var ApiVersion;
+(function (ApiVersion) {
+  ApiVersion["V1"] = "v1";
+  ApiVersion["V2"] = "v2";
+  ApiVersion["V3"] = "v3";
+})(ApiVersion || (ApiVersion = {}));
 
 const FILTER_TYPES = new Set(Object.values(exports.FilterType));
 const isFilterType = type => FILTER_TYPES.has(type);
@@ -149,7 +181,7 @@ function _catch(body, recover) {
 const makeCall = function (_ref2) {
   let {
     url,
-    credentials,
+    accessToken,
     opts
   } = _ref2;
   try {
@@ -170,15 +202,15 @@ const makeCall = function (_ref2) {
     const _temp = _catch(function () {
       return Promise.resolve(fetch(url.toString(), {
         headers: {
-          Authorization: `Bearer ${credentials.accessToken}`,
-          ...(isPost ? {
+          Authorization: `Bearer ${accessToken}`,
+          ...(isPost && {
             'Content-Type': 'application/json'
-          } : {})
+          })
         },
-        ...(isPost ? {
+        ...(isPost && {
           method: opts?.method,
           body: opts?.body
-        } : {}),
+        }),
         signal: opts?.abortController?.signal,
         ...opts?.otherOptions
       })).then(function (_fetch) {
@@ -217,15 +249,13 @@ function dealWithApiError(_ref) {
       throw new Error(msg);
   }
 }
-/** @internalRemarks Source: @carto/react-api */
-function checkCredentials(credentials) {
-  if (!credentials || !credentials.apiBaseUrl || !credentials.accessToken) {
-    throw new Error('Missing or bad credentials provided');
-  }
-}
 
 /** @internalRemarks Source: @carto/react-api */
 const AVAILABLE_MODELS = ['category', 'histogram', 'formula', 'timeseries', 'range', 'scatterplot', 'table'];
+const {
+  V3
+} = ApiVersion;
+const REQUEST_GET_MAX_URL_LENGTH = 2048;
 /**
  * Execute a SQL model request.
  * @internalRemarks Source: @carto/react-api
@@ -234,23 +264,29 @@ function executeModel(props) {
   assert(props.source, 'executeModel: missing source');
   assert(props.model, 'executeModel: missing model');
   assert(props.params, 'executeModel: missing params');
-  assert(AVAILABLE_MODELS.indexOf(props.model) !== -1, `executeModel: model provided isn't valid. Available models: ${AVAILABLE_MODELS.join(', ')}`);
+  assert(AVAILABLE_MODELS.includes(props.model), `executeModel: model provided isn't valid. Available models: ${AVAILABLE_MODELS.join(', ')}`);
   const {
-    source,
     model,
+    source,
     params,
-    spatialFilter,
     opts
   } = props;
-  checkCredentials(source.credentials);
-  assert(source.credentials.apiVersion === exports.ApiVersion.V3, 'SQL Model API is a feature only available in CARTO 3.');
-  assert(source.type !== exports.MapType.TILESET, 'executeModel: Tileset not supported');
-  let url = `${source.credentials.apiBaseUrl}/v3/sql/${source.connection}/model/${model}`;
+  const {
+    type,
+    apiVersion,
+    apiBaseUrl,
+    accessToken,
+    connectionName
+  } = source;
+  assert(apiBaseUrl, 'executeModel: missing apiBaseUrl');
+  assert(accessToken, 'executeModel: missing accessToken');
+  assert(apiVersion === V3, 'executeModel: SQL Model API requires CARTO 3+');
+  assert(type !== MapType.TILESET, 'executeModel: Tilesets not supported');
+  let url = `${apiBaseUrl}/v3/sql/${connectionName}/model/${model}`;
   const {
     filters,
     filtersLogicalOperator = 'and',
-    data,
-    type
+    data
   } = source;
   const queryParameters = source.queryParameters ? JSON.stringify(source.queryParameters) : '';
   const queryParams = {
@@ -263,8 +299,8 @@ function executeModel(props) {
     filtersLogicalOperator
   };
   // API supports multiple filters, we apply it only to geoColumn
-  const spatialFilters = spatialFilter ? {
-    [source.geoColumn ? source.geoColumn : DEFAULT_GEO_COLUMN]: spatialFilter
+  const spatialFilters = source.spatialFilter ? {
+    [source.geoColumn ? source.geoColumn : DEFAULT_GEO_COLUMN]: source.spatialFilter
   } : undefined;
   if (spatialFilters) {
     queryParams.spatialFilters = JSON.stringify(spatialFilters);
@@ -284,7 +320,7 @@ function executeModel(props) {
   }
   return makeCall({
     url,
-    credentials: source.credentials,
+    accessToken: source.accessToken,
     opts: {
       ...opts,
       method: isGet ? 'GET' : 'POST',
@@ -295,95 +331,120 @@ function executeModel(props) {
   });
 }
 
+/**
+ * Source for Widget API requests on a data source defined by a SQL query.
+ *
+ * Abstract class. Use {@link WidgetQuerySource} or {@link WidgetTableSource}.
+ */
 class WidgetBaseSource {
   constructor(props) {
     this.props = void 0;
-    this.credentials = void 0;
-    this.connectionName = void 0;
     this.props = {
       ...WidgetBaseSource.defaultProps,
       ...props
     };
-    this.connectionName = props.connectionName;
-    this.credentials = {
-      apiVersion: props.apiVersion || exports.ApiVersion.V3,
-      apiBaseUrl: props.apiBaseUrl || DEFAULT_API_BASE_URL$1,
-      clientId: props.clientId || getClient(),
-      accessToken: props.accessToken,
-      geoColumn: props.geoColumn || DEFAULT_GEO_COLUMN
-    };
   }
-  getSource(owner) {
+  _getModelSource(owner) {
+    const props = this.props;
     return {
-      ...this.props,
-      credentials: this.credentials,
-      connection: this.connectionName,
-      filters: getApplicableFilters(owner, this.props.filters)
+      apiVersion: props.apiVersion,
+      apiBaseUrl: props.apiBaseUrl,
+      clientId: props.clientId,
+      accessToken: props.accessToken,
+      connectionName: props.connectionName,
+      filters: getApplicableFilters(owner, props.filters),
+      filtersLogicalOperator: props.filtersLogicalOperator,
+      geoColumn: props.geoColumn
     };
   }
-  getFormula(props) {
+  /****************************************************************************
+   * CATEGORIES
+   */
+  /**
+   * Returns a list of labeled datapoints for categorical data. Suitable for
+   * charts including grouped bar charts, pie charts, and tree charts.
+   */
+  getCategories(props) {
     try {
       const _this = this;
       const {
         filterOwner,
         spatialFilter,
         abortController,
-        operationExp,
         ...params
       } = props;
       const {
         column,
-        operation
+        operation,
+        operationColumn
       } = params;
       return Promise.resolve(executeModel({
-        model: 'formula',
-        source: _this.getSource(filterOwner),
-        spatialFilter,
+        model: 'category',
+        source: {
+          ..._this.getModelSource(filterOwner),
+          spatialFilter
+        },
         params: {
-          column: column ?? '*',
+          column,
           operation,
-          operationExp
+          operationColumn: operationColumn || column
         },
         opts: {
           abortController
         }
-      }).then(res => normalizeObjectKeys(res.rows[0])));
+      }).then(res => normalizeObjectKeys(res.rows)));
     } catch (e) {
       return Promise.reject(e);
     }
   }
-  getCategories(props) {
+  /****************************************************************************
+   * FORMULA
+   */
+  /**
+   * Returns a scalar numerical statistic over all matching data. Suitable
+   * for 'headline' or 'scorecard' figures such as counts and sums.
+   */
+  getFormula(props) {
     try {
       const _this2 = this;
       const {
         filterOwner,
         spatialFilter,
         abortController,
+        operationExp,
         ...params
       } = props;
       const {
         column,
-        operation,
-        operationColumn
+        operation
       } = params;
       return Promise.resolve(executeModel({
-        model: 'category',
-        source: _this2.getSource(filterOwner),
-        spatialFilter,
+        model: 'formula',
+        source: {
+          ..._this2.getModelSource(filterOwner),
+          spatialFilter
+        },
         params: {
-          column,
+          column: column ?? '*',
           operation,
-          operationColumn: operationColumn || column
+          operationExp
         },
         opts: {
           abortController
         }
-      }).then(res => normalizeObjectKeys(res.rows)));
+      }).then(res => normalizeObjectKeys(res.rows[0])));
     } catch (e) {
       return Promise.reject(e);
     }
   }
-  getRange(props) {
+  /****************************************************************************
+   * HISTOGRAM
+   */
+  /**
+   * Returns a list of labeled datapoints for 'bins' of data defined as ticks
+   * over a numerical range. Suitable for histogram charts.
+   */
+  getHistogram(props) {
     try {
       const _this3 = this;
       const {
@@ -393,24 +454,53 @@ class WidgetBaseSource {
         ...params
       } = props;
       const {
-        column
+        column,
+        operation,
+        ticks
       } = params;
       return Promise.resolve(executeModel({
-        model: 'range',
-        source: _this3.getSource(filterOwner),
-        spatialFilter,
+        model: 'histogram',
+        source: {
+          ..._this3.getModelSource(filterOwner),
+          spatialFilter
+        },
         params: {
-          column
+          column,
+          operation,
+          ticks
         },
         opts: {
           abortController
         }
-      }).then(res => normalizeObjectKeys(res.rows[0])));
+      }).then(res => normalizeObjectKeys(res.rows))).then(function (data) {
+        if (data.length) {
+          // Given N ticks the API returns up to N+1 bins, omitting any empty bins. Bins
+          // include 1 bin below the lowest tick, N-1 between ticks, and 1 bin above the highest tick.
+          const result = Array(ticks.length + 1).fill(0);
+          data.forEach(_ref => {
+            let {
+              tick,
+              value
+            } = _ref;
+            return result[tick] = value;
+          });
+          return result;
+        }
+        return [];
+      });
     } catch (e) {
       return Promise.reject(e);
     }
   }
-  getTable(props) {
+  /****************************************************************************
+   * RANGE
+   */
+  /**
+   * Returns a range (min and max) for a numerical column of matching rows.
+   * Suitable for displaying certain 'headline' or 'scorecard' statistics,
+   * or rendering a range slider UI for filtering.
+   */
+  getRange(props) {
     try {
       const _this4 = this;
       const {
@@ -420,34 +510,32 @@ class WidgetBaseSource {
         ...params
       } = props;
       const {
-        columns,
-        sortBy,
-        sortDirection,
-        page = 0,
-        rowsPerPage = 10
+        column
       } = params;
       return Promise.resolve(executeModel({
-        model: 'table',
-        source: _this4.getSource(filterOwner),
-        spatialFilter,
+        model: 'range',
+        source: {
+          ..._this4.getModelSource(filterOwner),
+          spatialFilter
+        },
         params: {
-          column: columns,
-          sortBy,
-          sortDirection,
-          limit: rowsPerPage,
-          offset: page * rowsPerPage
+          column
         },
         opts: {
           abortController
         }
-      }).then(res => ({
-        rows: normalizeObjectKeys(res.rows),
-        totalCount: res.metadata.total
-      })));
+      }).then(res => normalizeObjectKeys(res.rows[0])));
     } catch (e) {
       return Promise.reject(e);
     }
   }
+  /****************************************************************************
+   * SCATTER
+   */
+  /**
+   * Returns a list of bivariate datapoints defined as numerical 'x' and 'y'
+   * values. Suitable for rendering scatter plots.
+   */
   getScatter(props) {
     try {
       const _this5 = this;
@@ -467,8 +555,10 @@ class WidgetBaseSource {
       const HARD_LIMIT = 500;
       return Promise.resolve(executeModel({
         model: 'scatterplot',
-        source: _this5.getSource(filterOwner),
-        spatialFilter,
+        source: {
+          ..._this5.getModelSource(filterOwner),
+          spatialFilter
+        },
         params: {
           xAxisColumn,
           xAxisJoinOperation,
@@ -479,130 +569,189 @@ class WidgetBaseSource {
         opts: {
           abortController
         }
-      }).then(res => normalizeObjectKeys(res.rows)).then(res => res.map(_ref => {
+      }).then(res => normalizeObjectKeys(res.rows)).then(res => res.map(_ref2 => {
         let {
           x,
           y
-        } = _ref;
+        } = _ref2;
         return [x, y];
       })));
     } catch (e) {
       return Promise.reject(e);
     }
   }
-  getTimeSeries(props) {
+  /****************************************************************************
+   * TABLE
+   */
+  /**
+   * Returns a list of arbitrary data rows, with support for pagination and
+   * sorting. Suitable for displaying tables and lists.
+   */
+  getTable(props) {
     try {
       const _this6 = this;
       const {
         filterOwner,
-        abortController,
         spatialFilter,
+        abortController,
         ...params
       } = props;
       const {
-        column,
-        operationColumn,
-        joinOperation,
-        operation,
-        stepSize,
-        stepMultiplier,
-        splitByCategory,
-        splitByCategoryLimit,
-        splitByCategoryValues
+        columns,
+        sortBy,
+        sortDirection,
+        page = 0,
+        rowsPerPage = 10
       } = params;
       return Promise.resolve(executeModel({
-        model: 'timeseries',
-        source: _this6.getSource(filterOwner),
-        spatialFilter,
+        model: 'table',
+        source: {
+          ..._this6.getModelSource(filterOwner),
+          spatialFilter
+        },
         params: {
-          column,
-          stepSize,
-          stepMultiplier,
-          operationColumn: operationColumn || column,
-          joinOperation,
-          operation,
-          splitByCategory,
-          splitByCategoryLimit,
-          splitByCategoryValues
+          column: columns,
+          sortBy,
+          sortDirection,
+          limit: rowsPerPage,
+          offset: page * rowsPerPage
         },
         opts: {
           abortController
         }
       }).then(res => ({
         rows: normalizeObjectKeys(res.rows),
-        categories: res.metadata?.categories
+        totalCount: res.metadata.total
       })));
     } catch (e) {
       return Promise.reject(e);
     }
   }
-  getHistogram(props) {
+  /****************************************************************************
+   * TIME SERIES
+   */
+  /**
+   * Returns a series of labeled numerical values, grouped into equally-sized
+   * time intervals. Suitable for rendering time series charts.
+   */
+  getTimeSeries(props) {
     try {
       const _this7 = this;
       const {
         filterOwner,
-        spatialFilter,
         abortController,
+        spatialFilter,
         ...params
       } = props;
       const {
         column,
+        operationColumn,
+        joinOperation,
         operation,
-        ticks
+        stepSize,
+        stepMultiplier,
+        splitByCategory,
+        splitByCategoryLimit,
+        splitByCategoryValues
       } = params;
       return Promise.resolve(executeModel({
-        model: 'histogram',
-        source: _this7.getSource(filterOwner),
-        spatialFilter,
+        model: 'timeseries',
+        source: {
+          ..._this7.getModelSource(filterOwner),
+          spatialFilter
+        },
         params: {
           column,
+          stepSize,
+          stepMultiplier,
+          operationColumn: operationColumn || column,
+          joinOperation,
           operation,
-          ticks
+          splitByCategory,
+          splitByCategoryLimit,
+          splitByCategoryValues
         },
         opts: {
           abortController
         }
-      }).then(res => normalizeObjectKeys(res.rows))).then(function (data) {
-        if (data.length) {
-          // Given N ticks the API returns up to N+1 bins, omitting any empty bins. Bins
-          // include 1 bin below the lowest tick, N-1 between ticks, and 1 bin above the highest tick.
-          const result = Array(ticks.length + 1).fill(0);
-          data.forEach(_ref2 => {
-            let {
-              tick,
-              value
-            } = _ref2;
-            return result[tick] = value;
-          });
-          return result;
-        }
-        return [];
-      });
+      }).then(res => ({
+        rows: normalizeObjectKeys(res.rows),
+        categories: res.metadata?.categories
+      })));
     } catch (e) {
       return Promise.reject(e);
     }
   }
 }
 WidgetBaseSource.defaultProps = {
+  apiVersion: ApiVersion.V3,
+  apiBaseUrl: DEFAULT_API_BASE_URL$1,
+  clientId: getClient(),
   filters: {},
-  filtersLogicalOperator: 'and'
+  filtersLogicalOperator: 'and',
+  geoColumn: DEFAULT_GEO_COLUMN
 };
 
+/**
+ * Source for Widget API requests on a data source defined by a SQL query.
+ *
+ * Generally not intended to be constructed directly. Instead, call
+ * {@link vectorQuerySource}, {@link h3QuerySource}, or {@link quadbinQuerySource},
+ * which can be shared with map layers. Sources contain a `widgetSource` property,
+ * for use by widget implementations.
+ *
+ * Example:
+ *
+ * ```javascript
+ * import { vectorQuerySource } from '@carto/api-client';
+ *
+ * const data = vectorQuerySource({
+ *   accessToken: '••••',
+ *   connectionName: 'carto_dw',
+ *   sqlQuery: 'SELECT * FROM carto-demo-data.demo_tables.retail_stores'
+ * });
+ *
+ * const { widgetSource } = await data;
+ * ```
+ */
 class WidgetQuerySource extends WidgetBaseSource {
-  getSource(owner) {
+  getModelSource(owner) {
     return {
-      ...super.getSource(owner),
-      type: exports.MapType.QUERY,
-      data: this.props.sqlQuery
+      ...super._getModelSource(owner),
+      type: MapType.QUERY,
+      data: this.props.sqlQuery,
+      queryParameters: this.props.queryParameters
     };
   }
 }
 
+/**
+ * Source for Widget API requests on a data source defined as a table.
+ *
+ * Generally not intended to be constructed directly. Instead, call
+ * {@link vectorTableSource}, {@link h3TableSource}, or {@link quadbinTableSource},
+ * which can be shared with map layers. Sources contain a `widgetSource` property,
+ * for use by widget implementations.
+ *
+ * Example:
+ *
+ * ```javascript
+ * import { vectorTableSource } from '@carto/api-client';
+ *
+ * const data = vectorTableSource({
+ *   accessToken: '••••',
+ *   connectionName: 'carto_dw',
+ *   tableName: 'carto-demo-data.demo_tables.retail_stores'
+ * });
+ *
+ * const { widgetSource } = await data;
+ * ```
+ */
 class WidgetTableSource extends WidgetBaseSource {
-  getSource(owner) {
+  getModelSource(owner) {
     return {
-      ...super.getSource(owner),
-      type: exports.MapType.TABLE,
+      ...super._getModelSource(owner),
+      type: MapType.TABLE,
       data: this.props.tableName
     };
   }
@@ -666,7 +815,7 @@ const V3_MINOR_VERSION = '3.4';
 const MAX_GET_LENGTH = 8192;
 const DEFAULT_PARAMETERS = {
   v: V3_MINOR_VERSION,
-  deckglVersion: "0.0.1-0"
+  deckglVersion: "0.0.1-2"
 };
 const DEFAULT_HEADERS = {
   Accept: 'application/json',
@@ -1070,12 +1219,9 @@ const vectorTilesetSource$1 = async function (options) {
   vectorTilesetSource: vectorTilesetSource$1
 });
 
-/******************************************************************************
- * VECTOR SOURCES
- */
-/** Wrapper adding widget support to {@link _vectorTableSource}. */
+/** Wrapper adding Widget API support to [vectorTableSource](https://deck.gl/docs/api-reference/carto/data-sources). */
 
-/** Wrapper adding widget support to {@link _quadbinTilesetSource}. */
+/** Wrapper adding Widget API support to [quadbinTilesetSource](https://deck.gl/docs/api-reference/carto/data-sources). */
 const quadbinTilesetSource = function () {
   try {
     throw new Error('not implemented');
@@ -1083,7 +1229,7 @@ const quadbinTilesetSource = function () {
     return Promise.reject(e);
   }
 };
-/** Wrapper adding widget support to {@link _quadbinQuerySource}. */
+/** Wrapper adding Widget API support to [quadbinQuerySource](https://deck.gl/docs/api-reference/carto/data-sources). */
 const quadbinQuerySource = function (props) {
   try {
     return Promise.resolve(quadbinQuerySource$1(props)).then(function (response) {
@@ -1096,10 +1242,7 @@ const quadbinQuerySource = function (props) {
     return Promise.reject(e);
   }
 };
-/******************************************************************************
- * QUADBIN SOURCES
- */
-/** Wrapper adding widget support to {@link _quadbinTableSource}. */
+/** Wrapper adding Widget API support to [quadbinTableSource](https://deck.gl/docs/api-reference/carto/data-sources). */
 const quadbinTableSource = function (props) {
   try {
     return Promise.resolve(quadbinTableSource$1(props)).then(function (response) {
@@ -1112,7 +1255,7 @@ const quadbinTableSource = function (props) {
     return Promise.reject(e);
   }
 };
-/** Wrapper adding widget support to {@link _h3TilesetSource}. */
+/** Wrapper adding Widget API support to [h3TilesetSource](https://deck.gl/docs/api-reference/carto/data-sources). */
 const h3TilesetSource = function () {
   try {
     throw new Error('not implemented');
@@ -1120,7 +1263,7 @@ const h3TilesetSource = function () {
     return Promise.reject(e);
   }
 };
-/** Wrapper adding widget support to {@link _h3QuerySource}. */
+/** Wrapper adding Widget API support to [h3QuerySource](https://deck.gl/docs/api-reference/carto/data-sources). */
 const h3QuerySource = function (props) {
   try {
     return Promise.resolve(h3QuerySource$1(props)).then(function (response) {
@@ -1133,10 +1276,7 @@ const h3QuerySource = function (props) {
     return Promise.reject(e);
   }
 };
-/******************************************************************************
- * H3 SOURCES
- */
-/** Wrapper adding widget support to {@link _h3TableSource}. */
+/** Wrapper adding Widget API support to [h3TableSource](https://deck.gl/docs/api-reference/carto/data-sources). */
 const h3TableSource = function (props) {
   try {
     return Promise.resolve(h3TableSource$1(props)).then(function (response) {
@@ -1149,7 +1289,7 @@ const h3TableSource = function (props) {
     return Promise.reject(e);
   }
 };
-/** Wrapper adding widget support to {@link _vectorTilesetSource}. */
+/** Wrapper adding Widget API support to [vectorTilesetSource](https://deck.gl/docs/api-reference/carto/data-sources). */
 const vectorTilesetSource = function () {
   try {
     throw new Error('not implemented');
@@ -1157,7 +1297,7 @@ const vectorTilesetSource = function () {
     return Promise.reject(e);
   }
 };
-/** Wrapper adding widget support to {@link _vectorQuerySource}. */
+/** Wrapper adding Widget API support to [vectorQuerySource](https://deck.gl/docs/api-reference/carto/data-sources). */
 const vectorQuerySource = function (props) {
   try {
     return Promise.resolve(vectorQuerySource$1(props)).then(function (response) {
@@ -1183,11 +1323,9 @@ const vectorTableSource = function (props) {
   }
 };
 
-exports.CLIENT_ID = CLIENT_ID;
 exports.WidgetBaseSource = WidgetBaseSource;
 exports.WidgetQuerySource = WidgetQuerySource;
 exports.WidgetTableSource = WidgetTableSource;
-exports.executeModel = executeModel;
 exports.getClient = getClient;
 exports.h3QuerySource = h3QuerySource;
 exports.h3TableSource = h3TableSource;