@deck.gl/carto 8.8.19 → 8.8.21

package/dist/dist.dev.js

@@ -13018,7 +13018,7 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
-const VERSION =  true ? "8.8.19" : undefined;
+const VERSION =  true ? "8.8.21" : undefined;
 const isBrowser = Object(_lib_is_browser__WEBPACK_IMPORTED_MODULE_0__["default"])();
 //# sourceMappingURL=globals.js.map
 
@@ -54543,7 +54543,7 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
-const VERSION =  true ? "8.8.19" : undefined;
+const VERSION =  true ? "8.8.21" : undefined;
 const isBrowser = Object(_env_is_browser__WEBPACK_IMPORTED_MODULE_0__["default"])();
 //# sourceMappingURL=globals.js.map
 
@@ -55072,35 +55072,118 @@ module.exports = Object.assign(deck, {
 
 /***/ }),
 
+/***/ "./src/api/carto-api-error.ts":
+/*!************************************!*\
+  !*** ./src/api/carto-api-error.ts ***!
+  \************************************/
+/*! exports provided: CartoAPIError */
+/***/ (function(module, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "CartoAPIError", function() { return CartoAPIError; });
+function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+
+/**
+ *
+ * Custom error for reported errors in CARTO Maps API.
+ * Provides useful debugging information in console and context for applications.
+ *
+ */
+class CartoAPIError extends Error {
+  /** Source error from server */
+
+  /** Context (API call & parameters) in which error occured */
+
+  /** Response from server */
+  constructor(error, errorContext, response) {
+    let responseString = 'Failed to connect';
+
+    if (response) {
+      responseString = 'Server returned: ';
+
+      if (response.status === 400) {
+        responseString += 'Bad request';
+      } else if (response.status === 401 || response.status === 403) {
+        responseString += 'Unauthorized access';
+      } else if (response.status === 404) {
+        responseString += 'Not found';
+      } else {
+        responseString += 'Error';
+      }
+
+      responseString += ` (${response.status}):`;
+    }
+
+    responseString += ` ${error.message || error}`;
+    let message = `${errorContext.requestType} API request failed`;
+    message += `\n${responseString}`;
+
+    for (const key of Object.keys(errorContext)) {
+      if (key === 'requestType') continue; // eslint-disable-line no-continue
+
+      message += `\n${formatErrorKey(key)}: ${errorContext[key]}`;
+    }
+
+    message += '\n';
+    super(message);
+
+    _defineProperty(this, "error", void 0);
+
+    _defineProperty(this, "errorContext", void 0);
+
+    _defineProperty(this, "response", void 0);
+
+    this.name = 'CartoAPIError';
+    this.response = response;
+    this.error = error;
+    this.errorContext = errorContext;
+  }
+
+}
+/**
+ * Converts camelCase to Camel Case
+ */
+
+function formatErrorKey(key) {
+  return key.replace(/([A-Z])/g, ' $1').replace(/^./, s => s.toUpperCase());
+}
+
+/***/ }),
+
 /***/ "./src/api/index.ts":
 /*!**************************!*\
   !*** ./src/api/index.ts ***!
   \**************************/
-/*! exports provided: FORMATS, TILE_FORMATS, MAP_TYPES, API_VERSIONS, getDataV2, CONNECTIONS, fetchLayerData, fetchMap, mapInstantiation */
+/*! exports provided: CartoAPIError, FORMATS, TILE_FORMATS, MAP_TYPES, API_VERSIONS, getDataV2, CONNECTIONS, fetchLayerData, fetchMap, mapInstantiation */
 /***/ (function(module, __webpack_exports__, __webpack_require__) {
 
 "use strict";
 __webpack_require__.r(__webpack_exports__);
-/* harmony import */ var _maps_api_common__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./maps-api-common */ "./src/api/maps-api-common.ts");
-/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "FORMATS", function() { return _maps_api_common__WEBPACK_IMPORTED_MODULE_0__["FORMATS"]; });
+/* harmony import */ var _carto_api_error__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./carto-api-error */ "./src/api/carto-api-error.ts");
+/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "CartoAPIError", function() { return _carto_api_error__WEBPACK_IMPORTED_MODULE_0__["CartoAPIError"]; });
+
+/* harmony import */ var _maps_api_common__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./maps-api-common */ "./src/api/maps-api-common.ts");
+/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "FORMATS", function() { return _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["FORMATS"]; });
 
-/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "TILE_FORMATS", function() { return _maps_api_common__WEBPACK_IMPORTED_MODULE_0__["TILE_FORMATS"]; });
+/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "TILE_FORMATS", function() { return _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["TILE_FORMATS"]; });
 
-/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "MAP_TYPES", function() { return _maps_api_common__WEBPACK_IMPORTED_MODULE_0__["MAP_TYPES"]; });
+/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "MAP_TYPES", function() { return _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["MAP_TYPES"]; });
 
-/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "API_VERSIONS", function() { return _maps_api_common__WEBPACK_IMPORTED_MODULE_0__["API_VERSIONS"]; });
+/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "API_VERSIONS", function() { return _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["API_VERSIONS"]; });
 
-/* harmony import */ var _maps_client__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./maps-client */ "./src/api/maps-client.ts");
-/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "getDataV2", function() { return _maps_client__WEBPACK_IMPORTED_MODULE_1__["getDataV2"]; });
+/* harmony import */ var _maps_client__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./maps-client */ "./src/api/maps-client.ts");
+/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "getDataV2", function() { return _maps_client__WEBPACK_IMPORTED_MODULE_2__["getDataV2"]; });
 
-/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "CONNECTIONS", function() { return _maps_client__WEBPACK_IMPORTED_MODULE_1__["CONNECTIONS"]; });
+/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "CONNECTIONS", function() { return _maps_client__WEBPACK_IMPORTED_MODULE_2__["CONNECTIONS"]; });
 
-/* harmony import */ var _maps_v3_client__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./maps-v3-client */ "./src/api/maps-v3-client.ts");
-/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "fetchLayerData", function() { return _maps_v3_client__WEBPACK_IMPORTED_MODULE_2__["fetchLayerData"]; });
+/* harmony import */ var _maps_v3_client__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./maps-v3-client */ "./src/api/maps-v3-client.ts");
+/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "fetchLayerData", function() { return _maps_v3_client__WEBPACK_IMPORTED_MODULE_3__["fetchLayerData"]; });
 
-/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "fetchMap", function() { return _maps_v3_client__WEBPACK_IMPORTED_MODULE_2__["fetchMap"]; });
+/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "fetchMap", function() { return _maps_v3_client__WEBPACK_IMPORTED_MODULE_3__["fetchMap"]; });
+
+/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "mapInstantiation", function() { return _maps_v3_client__WEBPACK_IMPORTED_MODULE_3__["mapInstantiation"]; });
 
-/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "mapInstantiation", function() { return _maps_v3_client__WEBPACK_IMPORTED_MODULE_2__["mapInstantiation"]; });
 
 
 
@@ -55679,7 +55762,7 @@ function getTextPixelOffsetAccessor({
 /*!************************************!*\
   !*** ./src/api/maps-api-common.ts ***!
   \************************************/
-/*! exports provided: DEFAULT_USER_COMPONENT_IN_URL, DEFAULT_REGION_COMPONENT_IN_URL, API_VERSIONS, DEFAULT_MAPS_URL_FORMAT, MAP_TYPES, COLUMNS_SUPPORT, GEO_COLUMN_SUPPORT, FORMATS, TILE_FORMATS, SchemaFieldType, encodeParameter */
+/*! exports provided: DEFAULT_USER_COMPONENT_IN_URL, DEFAULT_REGION_COMPONENT_IN_URL, API_VERSIONS, DEFAULT_MAPS_URL_FORMAT, MAP_TYPES, COLUMNS_SUPPORT, GEO_COLUMN_SUPPORT, FORMATS, TILE_FORMATS, SchemaFieldType, REQUEST_TYPES, encodeParameter */
 /***/ (function(module, __webpack_exports__, __webpack_require__) {
 
 "use strict";
@@ -55694,6 +55777,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "FORMATS", function() { return FORMATS; });
 /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "TILE_FORMATS", function() { return TILE_FORMATS; });
 /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "SchemaFieldType", function() { return SchemaFieldType; });
+/* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "REQUEST_TYPES", function() { return REQUEST_TYPES; });
 /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "encodeParameter", function() { return encodeParameter; });
 const DEFAULT_USER_COMPONENT_IN_URL = '{user}';
 const DEFAULT_REGION_COMPONENT_IN_URL = '{region}';
@@ -55741,6 +55825,13 @@ let SchemaFieldType;
   SchemaFieldType["Unknown"] = "unknown";
 })(SchemaFieldType || (SchemaFieldType = {}));
 
+const REQUEST_TYPES = {
+  DATA: 'Map data',
+  INSTANTIATION: 'Map instantiation',
+  PUBLIC_MAP: 'Public map',
+  TILE_STATS: 'Tile stats'
+};
+
 /**
  * Simple encode parameter
  */
@@ -55956,10 +56047,11 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "fetchMap", function() { return fetchMap; });
 /* harmony import */ var _config__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ../config */ "./src/config.ts");
 /* harmony import */ var _maps_api_common__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./maps-api-common */ "./src/api/maps-api-common.ts");
-/* harmony import */ var _parseMap__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./parseMap */ "./src/api/parseMap.ts");
-/* harmony import */ var _deck_gl_core__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! @deck.gl/core */ "@deck.gl/core");
-/* harmony import */ var _deck_gl_core__WEBPACK_IMPORTED_MODULE_3___default = /*#__PURE__*/__webpack_require__.n(_deck_gl_core__WEBPACK_IMPORTED_MODULE_3__);
-/* harmony import */ var _utils__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ../utils */ "./src/utils.ts");
+/* harmony import */ var _carto_api_error__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./carto-api-error */ "./src/api/carto-api-error.ts");
+/* harmony import */ var _parseMap__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./parseMap */ "./src/api/parseMap.ts");
+/* harmony import */ var _deck_gl_core__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! @deck.gl/core */ "@deck.gl/core");
+/* harmony import */ var _deck_gl_core__WEBPACK_IMPORTED_MODULE_4___default = /*#__PURE__*/__webpack_require__.n(_deck_gl_core__WEBPACK_IMPORTED_MODULE_4__);
+/* harmony import */ var _utils__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(/*! ../utils */ "./src/utils.ts");
 /**
  * Maps API Client for Carto 3
  */
@@ -55968,6 +56060,7 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
+
 const MAX_GET_LENGTH = 2048;
 const DEFAULT_CLIENT = 'deck-gl-carto';
 const V3_MINOR_VERSION = '3.1';
@@ -55980,7 +56073,8 @@ async function request({
   url,
   headers: customHeaders,
   accessToken,
-  body
+  body,
+  errorContext
 }) {
   const headers = { ...customHeaders,
     Accept: 'application/json'
@@ -56002,7 +56096,7 @@ async function request({
       body
     });
   } catch (error) {
-    throw new Error(`Failed to connect to Maps API: ${error}`);
+    throw new _carto_api_error__WEBPACK_IMPORTED_MODULE_2__["CartoAPIError"](error, errorContext);
   }
 }
 
@@ -56011,22 +56105,21 @@ async function requestJson({
   url,
   headers,
   accessToken,
-  body
+  body,
+  errorContext
 }) {
   const response = await request({
     method,
     url,
     headers,
     accessToken,
-    body
+    body,
+    errorContext
   });
   const json = await response.json();
 
   if (!response.ok) {
-    dealWithError({
-      response,
-      error: json.error
-    });
+    throw new _carto_api_error__WEBPACK_IMPORTED_MODULE_2__["CartoAPIError"](json.error, errorContext, response);
   }
 
   return json;
@@ -56037,14 +56130,16 @@ async function requestData({
   url,
   accessToken,
   format,
-  body
+  body,
+  errorContext
 }) {
   if (format === _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["FORMATS"].NDJSON) {
     return request({
       method,
       url,
       accessToken,
-      body
+      body,
+      errorContext
     });
   }
 
@@ -56052,31 +56147,11 @@ async function requestData({
     method,
     url,
     accessToken,
-    body
+    body,
+    errorContext
   });
   return data.rows ? data.rows : data;
 }
-/**
- * Display proper message from Maps API error
- */
-
-
-function dealWithError({
-  response,
-  error
-}) {
-  switch (response.status) {
-    case 400:
-      throw new Error(`Bad request. ${error}`);
-
-    case 401:
-    case 403:
-      throw new Error(`Unauthorized access. ${error}`);
-
-    default:
-      throw new Error(error);
-  }
-}
 
 /**
  * Build a URL with all required parameters
@@ -56154,12 +56229,21 @@ async function mapInstantiation({
   const {
     accessToken
   } = credentials;
+  const errorContext = {
+    requestType: _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["REQUEST_TYPES"].INSTANTIATION,
+    connection,
+    type,
+    source
+  };
 
   if (url.length > MAX_GET_LENGTH && type === _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["MAP_TYPES"].QUERY) {
     // need to be a POST request
     const body = JSON.stringify({
       q: source,
       client: clientId || DEFAULT_CLIENT,
+      aggregationResLevel,
+      aggregationExp,
+      geoColumn,
       queryParameters
     });
     return await requestJson({
@@ -56167,14 +56251,16 @@ async function mapInstantiation({
       url: baseUrl,
       headers,
       accessToken,
-      body
+      body,
+      errorContext
     });
   }
 
   return await requestJson({
     url,
     headers,
-    accessToken
+    accessToken,
+    errorContext
   });
 }
 
@@ -56198,22 +56284,22 @@ function checkFetchLayerDataParameters({
   aggregationExp,
   aggregationResLevel
 }) {
-  Object(_utils__WEBPACK_IMPORTED_MODULE_4__["assert"])(connection, 'Must define connection');
-  Object(_utils__WEBPACK_IMPORTED_MODULE_4__["assert"])(type, 'Must define a type');
-  Object(_utils__WEBPACK_IMPORTED_MODULE_4__["assert"])(source, 'Must define a source');
-  Object(_utils__WEBPACK_IMPORTED_MODULE_4__["assert"])(credentials.apiVersion === _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["API_VERSIONS"].V3, 'Method only available for v3');
-  Object(_utils__WEBPACK_IMPORTED_MODULE_4__["assert"])(credentials.apiBaseUrl, 'Must define apiBaseUrl');
-  Object(_utils__WEBPACK_IMPORTED_MODULE_4__["assert"])(credentials.accessToken, 'Must define an accessToken');
+  Object(_utils__WEBPACK_IMPORTED_MODULE_5__["assert"])(connection, 'Must define connection');
+  Object(_utils__WEBPACK_IMPORTED_MODULE_5__["assert"])(type, 'Must define a type');
+  Object(_utils__WEBPACK_IMPORTED_MODULE_5__["assert"])(source, 'Must define a source');
+  Object(_utils__WEBPACK_IMPORTED_MODULE_5__["assert"])(credentials.apiVersion === _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["API_VERSIONS"].V3, 'Method only available for v3');
+  Object(_utils__WEBPACK_IMPORTED_MODULE_5__["assert"])(credentials.apiBaseUrl, 'Must define apiBaseUrl');
+  Object(_utils__WEBPACK_IMPORTED_MODULE_5__["assert"])(credentials.accessToken, 'Must define an accessToken');
 
   if (columns) {
-    Object(_utils__WEBPACK_IMPORTED_MODULE_4__["assert"])(_maps_api_common__WEBPACK_IMPORTED_MODULE_1__["COLUMNS_SUPPORT"].includes(type), `The columns parameter is not supported by type ${type}`);
+    Object(_utils__WEBPACK_IMPORTED_MODULE_5__["assert"])(_maps_api_common__WEBPACK_IMPORTED_MODULE_1__["COLUMNS_SUPPORT"].includes(type), `The columns parameter is not supported by type ${type}`);
   }
 
   if (geoColumn) {
-    Object(_utils__WEBPACK_IMPORTED_MODULE_4__["assert"])(_maps_api_common__WEBPACK_IMPORTED_MODULE_1__["GEO_COLUMN_SUPPORT"].includes(type), `The geoColumn parameter is not supported by type ${type}`);
+    Object(_utils__WEBPACK_IMPORTED_MODULE_5__["assert"])(_maps_api_common__WEBPACK_IMPORTED_MODULE_1__["GEO_COLUMN_SUPPORT"].includes(type), `The geoColumn parameter is not supported by type ${type}`);
   } else {
-    Object(_utils__WEBPACK_IMPORTED_MODULE_4__["assert"])(!aggregationExp, 'Have aggregationExp, but geoColumn parameter is missing');
-    Object(_utils__WEBPACK_IMPORTED_MODULE_4__["assert"])(!aggregationResLevel, 'Have aggregationResLevel, but geoColumn parameter is missing');
+    Object(_utils__WEBPACK_IMPORTED_MODULE_5__["assert"])(!aggregationExp, 'Have aggregationExp, but geoColumn parameter is missing');
+    Object(_utils__WEBPACK_IMPORTED_MODULE_5__["assert"])(!aggregationResLevel, 'Have aggregationResLevel, but geoColumn parameter is missing');
   }
 }
 
@@ -56254,10 +56340,17 @@ async function fetchLayerData({
     aggregationResLevel,
     queryParameters
   });
+  const errorContext = {
+    requestType: _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["REQUEST_TYPES"].DATA,
+    connection,
+    type,
+    source
+  };
   const data = await requestData({
     url,
     format: mapFormat,
-    accessToken
+    accessToken,
+    errorContext
   });
   const result = {
     data,
@@ -56322,7 +56415,7 @@ async function _fetchDataUrl({
   if (format) {
     mapFormat = format;
     url = getUrlFromMetadata(metadata, format);
-    Object(_utils__WEBPACK_IMPORTED_MODULE_4__["assert"])(url, `Format ${format} not available`);
+    Object(_utils__WEBPACK_IMPORTED_MODULE_5__["assert"])(url, `Format ${format} not available`);
   } else {
     // guess map format
     const prioritizedFormats = [_maps_api_common__WEBPACK_IMPORTED_MODULE_1__["FORMATS"].GEOJSON, _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["FORMATS"].JSON, _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["FORMATS"].NDJSON, _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["FORMATS"].TILEJSON];
@@ -56336,11 +56429,11 @@ async function _fetchDataUrl({
       }
     }
 
-    Object(_utils__WEBPACK_IMPORTED_MODULE_4__["assert"])(url && mapFormat, 'Unsupported data formats received from backend.');
+    Object(_utils__WEBPACK_IMPORTED_MODULE_5__["assert"])(url && mapFormat, 'Unsupported data formats received from backend.');
   }
 
   if (format === _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["FORMATS"].TILEJSON && formatTiles) {
-    _deck_gl_core__WEBPACK_IMPORTED_MODULE_3__["log"].assert(Object.values(_maps_api_common__WEBPACK_IMPORTED_MODULE_1__["TILE_FORMATS"]).includes(formatTiles), `Invalid value for formatTiles: ${formatTiles}. Use value from TILE_FORMATS`);
+    _deck_gl_core__WEBPACK_IMPORTED_MODULE_4__["log"].assert(Object.values(_maps_api_common__WEBPACK_IMPORTED_MODULE_1__["TILE_FORMATS"]).includes(formatTiles), `Invalid value for formatTiles: ${formatTiles}. Use value from TILE_FORMATS`);
     url += `&${Object(_maps_api_common__WEBPACK_IMPORTED_MODULE_1__["encodeParameter"])('formatTiles', formatTiles)}`;
   }
 
@@ -56398,10 +56491,17 @@ async function _fetchMapDataset(dataset, accessToken, credentials, clientId, hea
 
   dataset.cache = cache; // Only fetch if the data has changed
 
+  const errorContext = {
+    requestType: _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["REQUEST_TYPES"].DATA,
+    connection,
+    type,
+    source
+  };
   dataset.data = await requestData({
     url,
     format: mapFormat,
-    accessToken
+    accessToken,
+    errorContext
   });
   return true;
 }
@@ -56422,10 +56522,17 @@ async function _fetchTilestats(attribute, dataset, accessToken, credentials) {
     url += `${source}/${attribute}`;
   }
 
+  const errorContext = {
+    requestType: _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["REQUEST_TYPES"].TILE_STATS,
+    connection,
+    type,
+    source
+  };
   const stats = await requestData({
     url,
     format: _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["FORMATS"].JSON,
-    accessToken
+    accessToken,
+    errorContext
   }); // Replace tilestats for attribute with value from API
 
   const {
@@ -56506,25 +56613,30 @@ async function fetchMap({
   const {
     accessToken
   } = localCreds;
-  Object(_utils__WEBPACK_IMPORTED_MODULE_4__["assert"])(cartoMapId, 'Must define CARTO map id: fetchMap({cartoMapId: "XXXX-XXXX-XXXX"})');
-  Object(_utils__WEBPACK_IMPORTED_MODULE_4__["assert"])(localCreds.apiVersion === _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["API_VERSIONS"].V3, 'Method only available for v3');
-  Object(_utils__WEBPACK_IMPORTED_MODULE_4__["assert"])(localCreds.apiBaseUrl, 'Must define apiBaseUrl');
+  Object(_utils__WEBPACK_IMPORTED_MODULE_5__["assert"])(cartoMapId, 'Must define CARTO map id: fetchMap({cartoMapId: "XXXX-XXXX-XXXX"})');
+  Object(_utils__WEBPACK_IMPORTED_MODULE_5__["assert"])(localCreds.apiVersion === _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["API_VERSIONS"].V3, 'Method only available for v3');
+  Object(_utils__WEBPACK_IMPORTED_MODULE_5__["assert"])(localCreds.apiBaseUrl, 'Must define apiBaseUrl');
 
   if (!localCreds.mapsUrl) {
     localCreds.mapsUrl = Object(_config__WEBPACK_IMPORTED_MODULE_0__["buildMapsUrlFromBase"])(localCreds.apiBaseUrl);
   }
 
   if (autoRefresh || onNewData) {
-    Object(_utils__WEBPACK_IMPORTED_MODULE_4__["assert"])(onNewData, 'Must define `onNewData` when using autoRefresh');
-    Object(_utils__WEBPACK_IMPORTED_MODULE_4__["assert"])(typeof onNewData === 'function', '`onNewData` must be a function');
-    Object(_utils__WEBPACK_IMPORTED_MODULE_4__["assert"])(typeof autoRefresh === 'number' && autoRefresh > 0, '`autoRefresh` must be a positive number');
+    Object(_utils__WEBPACK_IMPORTED_MODULE_5__["assert"])(onNewData, 'Must define `onNewData` when using autoRefresh');
+    Object(_utils__WEBPACK_IMPORTED_MODULE_5__["assert"])(typeof onNewData === 'function', '`onNewData` must be a function');
+    Object(_utils__WEBPACK_IMPORTED_MODULE_5__["assert"])(typeof autoRefresh === 'number' && autoRefresh > 0, '`autoRefresh` must be a positive number');
   }
 
   const url = `${localCreds.mapsUrl}/public/${cartoMapId}`;
+  const errorContext = {
+    requestType: _maps_api_common__WEBPACK_IMPORTED_MODULE_1__["REQUEST_TYPES"].PUBLIC_MAP,
+    mapId: cartoMapId
+  };
   const map = await requestJson({
     url,
     headers,
-    accessToken
+    accessToken,
+    errorContext
   }); // Periodically check if the data has changed. Note that this
   // will not update when a map is published.
 
@@ -56536,7 +56648,7 @@ async function fetchMap({
       const changed = await fillInMapDatasets(map, clientId, localCreds, headers);
 
       if (onNewData && changed.some(v => v === true)) {
-        onNewData(Object(_parseMap__WEBPACK_IMPORTED_MODULE_2__["parseMap"])(map));
+        onNewData(Object(_parseMap__WEBPACK_IMPORTED_MODULE_3__["parseMap"])(map));
       }
     }, autoRefresh * 1000);
 
@@ -56566,7 +56678,7 @@ async function fetchMap({
   await fillInMapDatasets(map, clientId, localCreds, headers); // Mutates attributes in visualChannels to contain tile stats
 
   await fillInTileStats(map, localCreds);
-  return { ...Object(_parseMap__WEBPACK_IMPORTED_MODULE_2__["parseMap"])(map),
+  return { ...Object(_parseMap__WEBPACK_IMPORTED_MODULE_3__["parseMap"])(map),
     ...{
       stopAutoRefresh
     }
@@ -57036,7 +57148,7 @@ function buildStatsUrlFromBase(apiBaseUrl) {
 /*!**********************!*\
   !*** ./src/index.ts ***!
   \**********************/
-/*! exports provided: getDefaultCredentials, setDefaultCredentials, CartoLayer, _CartoTileLayer, _H3TileLayer, _QuadbinTileLayer, BASEMAP, colorBins, colorCategories, colorContinuous, FORMATS, TILE_FORMATS, MAP_TYPES, API_VERSIONS, fetchLayerData, fetchMap, _getDataV2, _mapInstantiation */
+/*! exports provided: getDefaultCredentials, setDefaultCredentials, CartoLayer, _CartoTileLayer, _H3TileLayer, _QuadbinTileLayer, BASEMAP, colorBins, colorCategories, colorContinuous, FORMATS, TILE_FORMATS, MAP_TYPES, API_VERSIONS, CartoAPIError, fetchLayerData, fetchMap, _getDataV2, _mapInstantiation */
 /***/ (function(module, __webpack_exports__, __webpack_require__) {
 
 "use strict";
@@ -57079,6 +57191,8 @@ __webpack_require__.r(__webpack_exports__);
 
 /* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "API_VERSIONS", function() { return _api__WEBPACK_IMPORTED_MODULE_9__["API_VERSIONS"]; });
 
+/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "CartoAPIError", function() { return _api__WEBPACK_IMPORTED_MODULE_9__["CartoAPIError"]; });
+
 /* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "fetchLayerData", function() { return _api__WEBPACK_IMPORTED_MODULE_9__["fetchLayerData"]; });
 
 /* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "fetchMap", function() { return _api__WEBPACK_IMPORTED_MODULE_9__["fetchMap"]; });
@@ -57828,17 +57942,19 @@ _defineProperty(QuadbinLayer, "defaultProps", defaultProps);
 /*!******************************************!*\
   !*** ./src/layers/quadbin-tile-layer.ts ***!
   \******************************************/
-/*! exports provided: default */
+/*! exports provided: renderSubLayers, default */
 /***/ (function(module, __webpack_exports__, __webpack_require__) {
 
 "use strict";
 __webpack_require__.r(__webpack_exports__);
+/* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "renderSubLayers", function() { return renderSubLayers; });
 /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "default", function() { return QuadbinTileLayer; });
 /* harmony import */ var _deck_gl_core__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! @deck.gl/core */ "@deck.gl/core");
 /* harmony import */ var _deck_gl_core__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(_deck_gl_core__WEBPACK_IMPORTED_MODULE_0__);
 /* harmony import */ var _quadbin_layer__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./quadbin-layer */ "./src/layers/quadbin-layer.ts");
 /* harmony import */ var _quadbin_tileset_2d__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./quadbin-tileset-2d */ "./src/layers/quadbin-tileset-2d.ts");
 /* harmony import */ var _spatial_index_tile_layer__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./spatial-index-tile-layer */ "./src/layers/spatial-index-tile-layer.ts");
+/* harmony import */ var quadbin__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! quadbin */ "../../node_modules/quadbin/dist/esm/index.js");
 function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 
 
@@ -57851,11 +57967,11 @@ const renderSubLayers = props => {
     data
   } = props;
   if (!data || !data.length) return null;
+  const isBigInt = typeof data[0].id === 'bigint';
   return new _quadbin_layer__WEBPACK_IMPORTED_MODULE_1__["default"](props, {
-    getQuadbin: d => d.id
+    getQuadbin: isBigInt ? d => d.id : d => Object(quadbin__WEBPACK_IMPORTED_MODULE_4__["hexToBigInt"])(d.id)
   });
 };
-
 const defaultProps = {
   aggregationResLevel: 6
 };

package/dist/es5/api/carto-api-error.js

@@ -0,0 +1,87 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.CartoAPIError = void 0;
+
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
+
+var _assertThisInitialized2 = _interopRequireDefault(require("@babel/runtime/helpers/assertThisInitialized"));
+
+var _inherits2 = _interopRequireDefault(require("@babel/runtime/helpers/inherits"));
+
+var _possibleConstructorReturn2 = _interopRequireDefault(require("@babel/runtime/helpers/possibleConstructorReturn"));
+
+var _getPrototypeOf2 = _interopRequireDefault(require("@babel/runtime/helpers/getPrototypeOf"));
+
+var _wrapNativeSuper2 = _interopRequireDefault(require("@babel/runtime/helpers/wrapNativeSuper"));
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = (0, _getPrototypeOf2.default)(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = (0, _getPrototypeOf2.default)(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return (0, _possibleConstructorReturn2.default)(this, result); }; }
+
+function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+
+var CartoAPIError = function (_Error) {
+  (0, _inherits2.default)(CartoAPIError, _Error);
+
+  var _super = _createSuper(CartoAPIError);
+
+  function CartoAPIError(error, errorContext, response) {
+    var _this;
+
+    (0, _classCallCheck2.default)(this, CartoAPIError);
+    var responseString = 'Failed to connect';
+
+    if (response) {
+      responseString = 'Server returned: ';
+
+      if (response.status === 400) {
+        responseString += 'Bad request';
+      } else if (response.status === 401 || response.status === 403) {
+        responseString += 'Unauthorized access';
+      } else if (response.status === 404) {
+        responseString += 'Not found';
+      } else {
+        responseString += 'Error';
+      }
+
+      responseString += " (".concat(response.status, "):");
+    }
+
+    responseString += " ".concat(error.message || error);
+    var message = "".concat(errorContext.requestType, " API request failed");
+    message += "\n".concat(responseString);
+
+    for (var _i = 0, _Object$keys = Object.keys(errorContext); _i < _Object$keys.length; _i++) {
+      var key = _Object$keys[_i];
+      if (key === 'requestType') continue;
+      message += "\n".concat(formatErrorKey(key), ": ").concat(errorContext[key]);
+    }
+
+    message += '\n';
+    _this = _super.call(this, message);
+    (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "error", void 0);
+    (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "errorContext", void 0);
+    (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "response", void 0);
+    _this.name = 'CartoAPIError';
+    _this.response = response;
+    _this.error = error;
+    _this.errorContext = errorContext;
+    return _this;
+  }
+
+  return CartoAPIError;
+}((0, _wrapNativeSuper2.default)(Error));
+
+exports.CartoAPIError = CartoAPIError;
+
+function formatErrorKey(key) {
+  return key.replace(/([A-Z])/g, ' $1').replace(/^./, function (s) {
+    return s.toUpperCase();
+  });
+}
+//# sourceMappingURL=carto-api-error.js.map

package/dist/es5/api/carto-api-error.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/api/carto-api-error.ts"],"names":["CartoAPIError","error","errorContext","response","responseString","status","message","requestType","Object","keys","key","formatErrorKey","name","Error","replace","s","toUpperCase"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;IAgBaA,a;;;;;AAUX,yBAAYC,KAAZ,EAA0BC,YAA1B,EAAyDC,QAAzD,EAA8E;AAAA;;AAAA;AAC5E,QAAIC,cAAc,GAAG,mBAArB;;AACA,QAAID,QAAJ,EAAc;AACZC,MAAAA,cAAc,GAAG,mBAAjB;;AACA,UAAID,QAAQ,CAACE,MAAT,KAAoB,GAAxB,EAA6B;AAC3BD,QAAAA,cAAc,IAAI,aAAlB;AACD,OAFD,MAEO,IAAID,QAAQ,CAACE,MAAT,KAAoB,GAApB,IAA2BF,QAAQ,CAACE,MAAT,KAAoB,GAAnD,EAAwD;AAC7DD,QAAAA,cAAc,IAAI,qBAAlB;AACD,OAFM,MAEA,IAAID,QAAQ,CAACE,MAAT,KAAoB,GAAxB,EAA6B;AAClCD,QAAAA,cAAc,IAAI,WAAlB;AACD,OAFM,MAEA;AACLA,QAAAA,cAAc,IAAI,OAAlB;AACD;;AAEDA,MAAAA,cAAc,gBAASD,QAAQ,CAACE,MAAlB,OAAd;AACD;;AACDD,IAAAA,cAAc,eAAQH,KAAK,CAACK,OAAN,IAAiBL,KAAzB,CAAd;AAEA,QAAIK,OAAO,aAAMJ,YAAY,CAACK,WAAnB,wBAAX;AACAD,IAAAA,OAAO,gBAASF,cAAT,CAAP;;AACA,oCAAkBI,MAAM,CAACC,IAAP,CAAYP,YAAZ,CAAlB,kCAA6C;AAAxC,UAAMQ,GAAG,mBAAT;AACH,UAAIA,GAAG,KAAK,aAAZ,EAA2B;AAC3BJ,MAAAA,OAAO,gBAASK,cAAc,CAACD,GAAD,CAAvB,eAAiCR,YAAY,CAACQ,GAAD,CAA7C,CAAP;AACD;;AACDJ,IAAAA,OAAO,IAAI,IAAX;AAEA,8BAAMA,OAAN;AA1B4E;AAAA;AAAA;AA4B5E,UAAKM,IAAL,GAAY,eAAZ;AACA,UAAKT,QAAL,GAAgBA,QAAhB;AACA,UAAKF,KAAL,GAAaA,KAAb;AACA,UAAKC,YAAL,GAAoBA,YAApB;AA/B4E;AAgC7E;;;iCA1CgCW,K;;;;AAgDnC,SAASF,cAAT,CAAwBD,GAAxB,EAA6B;AAC3B,SAAOA,GAAG,CAACI,OAAJ,CAAY,UAAZ,EAAwB,KAAxB,EAA+BA,OAA/B,CAAuC,IAAvC,EAA6C,UAAAC,CAAC;AAAA,WAAIA,CAAC,CAACC,WAAF,EAAJ;AAAA,GAA9C,CAAP;AACD","sourcesContent":["import {MapType, RequestType} from './maps-api-common';\n\nexport type APIErrorContext = {\n  requestType: RequestType;\n  mapId?: string;\n  connection?: string;\n  source?: string;\n  type?: MapType;\n};\n\n/**\n *\n * Custom error for reported errors in CARTO Maps API.\n * Provides useful debugging information in console and context for applications.\n *\n */\nexport class CartoAPIError extends Error {\n  /** Source error from server */\n  error: Error;\n\n  /** Context (API call & parameters) in which error occured */\n  errorContext: APIErrorContext;\n\n  /** Response from server */\n  response?: Response;\n\n  constructor(error: Error, errorContext: APIErrorContext, response?: Response) {\n    let responseString = 'Failed to connect';\n    if (response) {\n      responseString = 'Server returned: ';\n      if (response.status === 400) {\n        responseString += 'Bad request';\n      } else if (response.status === 401 || response.status === 403) {\n        responseString += 'Unauthorized access';\n      } else if (response.status === 404) {\n        responseString += 'Not found';\n      } else {\n        responseString += 'Error';\n      }\n\n      responseString += ` (${response.status}):`;\n    }\n    responseString += ` ${error.message || error}`;\n\n    let message = `${errorContext.requestType} API request failed`;\n    message += `\\n${responseString}`;\n    for (const key of Object.keys(errorContext)) {\n      if (key === 'requestType') continue; // eslint-disable-line no-continue\n      message += `\\n${formatErrorKey(key)}: ${errorContext[key]}`;\n    }\n    message += '\\n';\n\n    super(message);\n\n    this.name = 'CartoAPIError';\n    this.response = response;\n    this.error = error;\n    this.errorContext = errorContext;\n  }\n}\n\n/**\n * Converts camelCase to Camel Case\n */\nfunction formatErrorKey(key) {\n  return key.replace(/([A-Z])/g, ' $1').replace(/^./, s => s.toUpperCase());\n}\n"],"file":"carto-api-error.js"}