@deck.gl/carto 8.8.0-alpha.5 → 8.8.0-alpha.6

package/package.json

@@ -2,7 +2,7 @@
   "name": "@deck.gl/carto",
   "description": "CARTO official integration with Deck.gl. Build geospatial applications using CARTO and Deck.gl.",
   "license": "MIT",
-  "version": "8.8.0-alpha.5",
+  "version": "8.8.0-alpha.6",
   "publishConfig": {
     "access": "public"
   },
@@ -37,12 +37,13 @@
     "@loaders.gl/mvt": "^3.2.0-alpha.4",
     "@loaders.gl/tiles": "^3.2.0-alpha.4",
     "@luma.gl/constants": "^8.5.13",
-    "@math.gl/web-mercator": "3.6.0-alpha.5",
+    "@math.gl/web-mercator": "3.6.0-alpha.8",
     "cartocolor": "^4.0.2",
     "d3-array": "^2.8.0",
     "d3-color": "^2.0.0",
     "d3-format": "^2.0.0",
     "d3-scale": "^3.2.3",
+    "h3-js": "^3.6.0",
     "moment-timezone": "^0.5.33",
     "pbf": "^3.2.1"
   },
@@ -60,5 +61,5 @@
     "@deck.gl/layers": "^8.0.0",
     "@loaders.gl/core": "^3.0.0"
   },
-  "gitHead": "a5e210f62321ab78b7cacbcd0614e0ffcdf6bca7"
+  "gitHead": "6885ccab01c91a7632385f566c9377f8ae387e7c"
 }

package/src/api/layer-map.ts

@@ -13,6 +13,7 @@ import {
 import {format as d3Format} from 'd3-format';
 import moment from 'moment-timezone';
 
+import {Layer, _ConstructorOf as ConstructorOf} from '@deck.gl/core';
 import {CPUGridLayer, HeatmapLayer, HexagonLayer} from '@deck.gl/aggregation-layers';
 import {GeoJsonLayer} from '@deck.gl/layers';
 import {H3HexagonLayer, MVTLayer} from '@deck.gl/geo-layers';
@@ -101,7 +102,7 @@ const defaultProps = {
   wrapLongitude: false
 };
 
-function mergePropMaps(a = {}, b = {}) {
+function mergePropMaps(a: Record<string, any> = {}, b: Record<string, any> = {}) {
   return {...a, ...b, visConfig: {...a.visConfig, ...b.visConfig}};
 }
 
@@ -109,7 +110,7 @@ export function getLayer(
   type: string,
   config,
   dataset
-): {Layer: any; propMap: any; defaultProps: any} {
+): {Layer: ConstructorOf<Layer>; propMap: any; defaultProps: any} {
   if (type === 'mvt' || type === 'tileset') {
     return getTileLayer(dataset);
   }
@@ -118,7 +119,11 @@ export function getLayer(
   const getPosition = d => d[geoColumn].coordinates;
 
   const hexagonId = config.columns?.hex_id;
-  const layer = {
+
+  const layerTypeDefs: Record<
+    string,
+    {Layer: ConstructorOf<Layer>; propMap?: any; defaultProps?: any}
+  > = {
     point: {
       Layer: GeoJsonLayer,
       propMap: {visConfig: {outline: 'stroked'}}
@@ -146,12 +151,16 @@ export function getLayer(
       propMap: {visConfig: {coverage: 'coverage'}},
       defaultProps: {getHexagon: d => d[hexagonId], stroked: false}
     }
-  }[type];
+  };
+
+  const layer = layerTypeDefs[type];
 
   assert(layer, `Unsupported layer type: ${type}`);
-  layer.propMap = mergePropMaps(sharedPropMap, layer.propMap);
-  layer.defaultProps = {...defaultProps, ...layer.defaultProps};
-  return layer;
+  return {
+    ...layer,
+    propMap: mergePropMaps(sharedPropMap, layer.propMap),
+    defaultProps: {...defaultProps, ...layer.defaultProps}
+  };
 }
 
 function getTileLayer(dataset) {

package/src/layers/carto-layer.ts

@@ -66,7 +66,11 @@ const defaultProps = {
   aggregationResLevel: null
 };
 
-export interface CartoLayerProps<DataT = any> extends CompositeLayerProps<DataT> {
+/** All properties supported by CartoLayer. */
+export type CartoLayerProps<DataT = any> = _CartoLayerProps & CompositeLayerProps<DataT>;
+
+/** Properties added by CartoLayer. */
+type _CartoLayerProps = {
   /**
    * Either a SQL query or a name of dataset/tileset.
    */
@@ -147,9 +151,11 @@ export interface CartoLayerProps<DataT = any> extends CompositeLayerProps<DataT>
   onDataError?: (err: unknown) => void;
 
   clientId?: string;
-}
+};
 
-export default class CartoLayer<DataT = any> extends CompositeLayer<CartoLayerProps<DataT>> {
+export default class CartoLayer<ExtraProps = {}> extends CompositeLayer<
+  Required<_CartoLayerProps> & ExtraProps
+> {
   static layerName = 'CartoLayer';
   static defaultProps = defaultProps as any;
 
@@ -237,7 +243,7 @@ export default class CartoLayer<DataT = any> extends CompositeLayer<CartoLayerPr
       const localConfig = {...getDefaultCredentials(), ...credentials};
       const {apiVersion} = localConfig;
 
-      let result: FetchLayerDataResult;
+      let result: Partial<FetchLayerDataResult>;
       if (apiVersion === API_VERSIONS.V1 || apiVersion === API_VERSIONS.V2) {
         result = {
           data: await getDataV2({type, source, credentials: credentials as ClassicCredentials})
@@ -276,6 +282,7 @@ export default class CartoLayer<DataT = any> extends CompositeLayer<CartoLayerPr
     const {uniqueIdProperty} = defaultProps;
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     const {data: _notUsed, ...propsNoData} = this.props;
+    // @ts-expect-error 'uniqueIdProperty' is specified more than once, so this usage will be overwritten.
     const props = {uniqueIdProperty, ...propsNoData};
 
     if (apiVersion === API_VERSIONS.V1 || apiVersion === API_VERSIONS.V2) {

package/src/layers/carto-tile-layer.ts

@@ -1,6 +1,6 @@
 /* global TextDecoder */
 import Protobuf from 'pbf';
-import {Layer, LayersList, log} from '@deck.gl/core';
+import {log} from '@deck.gl/core';
 import {ClipExtension} from '@deck.gl/extensions';
 import {
   MVTLayer,
@@ -96,7 +96,7 @@ type _CartoTileLayerProps = {
    * Possible values are: `TILE_FORMATS.BINARY`, `TILE_FORMATS.GEOJSON` and `TILE_FORMATS.MVT`.
    *
    * Only supported when `apiVersion` is `API_VERSIONS.V3` and `format` is `FORMATS.TILEJSON`.
-   * */
+   */
   formatTiles?: TileFormat;
 };
 

package/src/layers/h3-tile-layer.ts

@@ -0,0 +1,78 @@
+import {
+  CompositeLayer,
+  CompositeLayerProps,
+  Layer,
+  LayersList,
+  UpdateParameters
+} from '@deck.gl/core';
+import {H3HexagonLayer} from '@deck.gl/geo-layers';
+import H3Tileset2D from './h3-tileset-2d';
+import SpatialIndexTileLayer from './spatial-index-tile-layer';
+
+const renderSubLayers = props => {
+  const {data} = props;
+  const {index} = props.tile;
+  if (!data || !data.length) return null;
+
+  return new H3HexagonLayer(props, {
+    getHexagon: d => d.id,
+    centerHexagon: index,
+    highPrecision: true
+  });
+};
+
+const defaultProps = {
+  aggregationResLevel: 4
+};
+
+/** All properties supported by H3TileLayer. */
+export type H3TileLayerProps<DataT = any> = _H3TileLayerProps<DataT> & CompositeLayerProps<DataT>;
+
+// TODO: use type from h3-hexagon-layer when available
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+type H3HexagonLayerProps<DataT = any> = Record<string, any>;
+
+/** Properties added by H3TileLayer. */
+type _H3TileLayerProps<DataT = any> = H3HexagonLayerProps<DataT> & {
+  aggregationResLevel?: number;
+};
+
+export default class H3TileLayer<DataT = any, ExtraPropsT = {}> extends CompositeLayer<
+  ExtraPropsT & Required<_H3TileLayerProps<DataT>>
+> {
+  static layerName = 'H3TileLayer';
+  static defaultProps = defaultProps;
+
+  state!: {
+    tileJSON: any;
+    data: any;
+  };
+
+  initializeState(): void {
+    this.setState({data: null, tileJSON: null});
+  }
+
+  updateState({changeFlags}: UpdateParameters<this>): void {
+    if (changeFlags.dataChanged) {
+      let {data} = this.props;
+      const tileJSON = data;
+      data = (tileJSON as any).tiles;
+      this.setState({data, tileJSON});
+    }
+  }
+
+  renderLayers(): Layer | null | LayersList {
+    const {data, tileJSON} = this.state;
+    const maxZoom = parseInt(tileJSON.maxresolution);
+    return [
+      new SpatialIndexTileLayer(this.props, {
+        id: `h3-tile-layer-${this.props.id}`,
+        data,
+        // @ts-expect-error Tileset2D should be generic over TileIndex
+        TilesetClass: H3Tileset2D,
+        renderSubLayers,
+        maxZoom
+      })
+    ];
+  }
+}

package/src/layers/{h3-tileset-2d.js → h3-tileset-2d.ts}

@@ -1,4 +1,4 @@
-import {_Tileset2D as Tileset2D} from '@deck.gl/geo-layers';
+import {_Tileset2D as Tileset2D, GeoBoundingBox} from '@deck.gl/geo-layers';
 import {
   polyfill,
   getRes0Indexes,
@@ -9,7 +9,12 @@ import {
   kRing
 } from 'h3-js';
 
-function getHexagonsInBoundingBox({west, north, east, south}, resolution) {
+export type H3TileIndex = {i: string};
+
+function getHexagonsInBoundingBox(
+  {west, north, east, south}: GeoBoundingBox,
+  resolution: number
+): string[] {
   if (resolution === 0) {
     return getRes0Indexes();
   }
@@ -41,7 +46,7 @@ function getHexagonsInBoundingBox({west, north, east, south}, resolution) {
   return oversample ? [...new Set(h3Indices.map(i => h3ToParent(i, resolution)))] : h3Indices;
 }
 
-function tileToBoundingBox(index) {
+function tileToBoundingBox(index: string): GeoBoundingBox {
   const coordinates = h3ToGeoBoundary(index);
   const latitudes = coordinates.map(c => c[0]);
   const longitudes = coordinates.map(c => c[1]);
@@ -57,7 +62,7 @@ function tileToBoundingBox(index) {
 // similar
 // Relative scale factor (0 = no biasing, 2 = a few hexagons cover view)
 const BIAS = 2;
-function getHexagonResolution(viewport) {
+function getHexagonResolution(viewport): number {
   const hexagonScaleFactor = (2 / 3) * viewport.zoom;
   const latitudeScaleFactor = Math.log(1 / Math.cos((Math.PI * viewport.latitude) / 180));
 
@@ -66,11 +71,12 @@ function getHexagonResolution(viewport) {
 }
 
 export default class H3Tileset2D extends Tileset2D {
-  getTileIndices({viewport, minZoom, maxZoom}) {
+  // @ts-expect-error Tileset2D should be generic over TileIndex
+  getTileIndices({viewport, minZoom, maxZoom}): H3TileIndex[] {
     const [east, south, west, north] = viewport.getBounds();
 
     let z = getHexagonResolution(viewport);
-    let indices = [];
+    let indices: string[];
     if (typeof minZoom === 'number' && Number.isFinite(minZoom) && z < minZoom) {
       z = minZoom;
     }
@@ -88,19 +94,23 @@ export default class H3Tileset2D extends Tileset2D {
     return indices.map(i => ({i}));
   }
 
-  getTileId({i}) {
+  // @ts-expect-error Tileset2D should be generic over TileIndex
+  getTileId({i}: H3TileIndex): string {
     return i;
   }
 
-  getTileMetadata({i}) {
+  // @ts-expect-error Tileset2D should be generic over TileIndex
+  getTileMetadata({i}: H3TileIndex) {
     return {bbox: tileToBoundingBox(i)};
   }
 
-  getTileZoom({i}) {
+  // @ts-expect-error Tileset2D should be generic over TileIndex
+  getTileZoom({i}: H3TileIndex): number {
     return h3GetResolution(i);
   }
 
-  getParentIndex(index) {
+  // @ts-expect-error Tileset2D should be generic over TileIndex
+  getParentIndex(index: H3TileIndex): H3TileIndex {
     const resolution = h3GetResolution(index.i);
     const i = h3ToParent(index.i, resolution - 1);
     return {i};

package/src/layers/quadkey-tile-layer.ts

@@ -0,0 +1,68 @@
+import {
+  CompositeLayer,
+  CompositeLayerProps,
+  Layer,
+  LayersList,
+  UpdateParameters
+} from '@deck.gl/core';
+import {QuadkeyLayer, QuadkeyLayerProps} from '@deck.gl/geo-layers';
+import QuadkeyTileset2D from './quadkey-tileset-2d';
+import SpatialIndexTileLayer from './spatial-index-tile-layer';
+
+const renderSubLayers = props => {
+  const {data} = props;
+  if (!data || !data.length) return null;
+  return new QuadkeyLayer(props, {getQuadkey: d => d.id});
+};
+
+const defaultProps = {
+  aggregationResLevel: 6
+};
+
+/** All properties supported by QuadkeyTileLayer. */
+export type QuadkeyTileLayerProps<DataT = any> = _QuadkeyTileLayerProps<DataT> &
+  CompositeLayerProps<DataT>;
+
+/** Properties added by QuadkeyTileLayer. */
+type _QuadkeyTileLayerProps<DataT> = QuadkeyLayerProps<DataT> & {
+  aggregationResLevel?: number;
+};
+
+export default class QuadkeyTileLayer<DataT = any, ExtraProps = {}> extends CompositeLayer<
+  ExtraProps & Required<_QuadkeyTileLayerProps<DataT>>
+> {
+  static layerName = 'QuadkeyTileLayer';
+  static defaultProps = defaultProps;
+
+  state!: {
+    tileJSON: any;
+    data: any;
+  };
+  initializeState(): void {
+    this.setState({data: null, tileJSON: null});
+  }
+
+  updateState({changeFlags}: UpdateParameters<this>): void {
+    if (changeFlags.dataChanged) {
+      let {data} = this.props;
+      const tileJSON = data;
+      data = (tileJSON as any).tiles;
+      this.setState({data, tileJSON});
+    }
+  }
+
+  renderLayers(): Layer | null | LayersList {
+    const {data, tileJSON} = this.state;
+    const maxZoom = parseInt(tileJSON?.maxresolution);
+    return [
+      new SpatialIndexTileLayer(this.props, {
+        id: `quadkey-tile-layer-${this.props.id}`,
+        data,
+        // TODO: Tileset2D should be generic over TileIndex type
+        TilesetClass: QuadkeyTileset2D as any,
+        renderSubLayers,
+        maxZoom
+      })
+    ];
+  }
+}

package/src/layers/{quadkey-tileset-2d.js → quadkey-tileset-2d.ts}

@@ -1,6 +1,7 @@
 import {_Tileset2D as Tileset2D} from '@deck.gl/geo-layers';
 
-function tileToQuadkey(tile) {
+type QuadkeyTileIndex = {i: string};
+function tileToQuadkey(tile): QuadkeyTileIndex {
   let index = '';
   for (let z = tile.z; z > 0; z--) {
     let b = 0;
@@ -13,11 +14,13 @@ function tileToQuadkey(tile) {
 }
 
 export default class QuadkeyTileset2D extends Tileset2D {
-  getTileIndices(opts) {
+  // @ts-expect-error for spatial indices, TileSet2d should be parametrized by TileIndexT
+  getTileIndices(opts): QuadkeyTileIndex[] {
     return super.getTileIndices(opts).map(tileToQuadkey);
   }
 
-  getTileId({i}) {
+  // @ts-expect-error TileIndex must be generic
+  getTileId({i}: QuadkeyTileIndex) {
     return i;
   }
 
@@ -25,11 +28,13 @@ export default class QuadkeyTileset2D extends Tileset2D {
     return {};
   }
 
-  getTileZoom({i}) {
+  // @ts-expect-error TileIndex must be generic
+  getTileZoom({i}: QuadkeyTileIndex) {
     return i.length;
   }
 
-  getParentIndex(index) {
+  // @ts-expect-error TileIndex must be generic
+  getParentIndex(index: QuadkeyTileIndex) {
     const i = index.i.slice(0, -1);
     return {i};
   }

package/src/layers/{spatial-index-tile-layer.js → spatial-index-tile-layer.ts}

@@ -1,11 +1,12 @@
-import {TileLayer} from '@deck.gl/geo-layers';
+import {PickingInfo} from '@deck.gl/core';
+import {TileLayer, _Tile2DHeader as Tile2DHeader} from '@deck.gl/geo-layers';
 
-function isFeatureIdDefined(value) {
+function isFeatureIdDefined(value: unknown): boolean {
   return value !== undefined && value !== null && value !== '';
 }
 
-export default class SpatialIndexTileLayer extends TileLayer {
-  _updateAutoHighlight(info) {
+export default class SpatialIndexTileLayer<ExtraProps = {}> extends TileLayer<any, ExtraProps> {
+  protected _updateAutoHighlight(info: PickingInfo): void {
     const {hoveredFeatureId} = this.state;
     const hoveredFeature = info.object;
     let newHoveredFeatureId;
@@ -27,14 +28,14 @@ export default class SpatialIndexTileLayer extends TileLayer {
     }
   }
 
-  getSubLayerPropsByTile(tile) {
+  getSubLayerPropsByTile(tile: Tile2DHeader) {
     return {
       highlightedObjectIndex: this.getHighlightedObjectIndex(tile),
       highlightColor: this.state.highlightColor
     };
   }
 
-  getHighlightedObjectIndex(tile) {
+  getHighlightedObjectIndex(tile: Tile2DHeader) {
     const {hoveredFeatureId} = this.state;
     const data = tile.content;
 

package/typed/api/index.d.ts

@@ -0,0 +1,4 @@
+export { FORMATS, TILE_FORMATS, MAP_TYPES, API_VERSIONS } from './maps-api-common';
+export { getDataV2, CONNECTIONS } from './maps-client';
+export { fetchLayerData, fetchMap, getData, mapInstantiation } from './maps-v3-client';
+//# sourceMappingURL=index.d.ts.map

package/typed/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAC,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAC,SAAS,EAAE,WAAW,EAAC,MAAM,eAAe,CAAC;AACrD,OAAO,EAAC,cAAc,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAC,MAAM,kBAAkB,CAAC"}

package/typed/api/layer-map.d.ts

@@ -0,0 +1,54 @@
+import { scaleLinear, scaleOrdinal, scaleLog, scalePoint, scaleQuantile, scaleQuantize, scaleSqrt, scaleThreshold } from 'd3-scale';
+import { Layer, _ConstructorOf as ConstructorOf } from '@deck.gl/core/typed';
+declare const SCALE_FUNCS: {
+    linear: typeof scaleLinear;
+    ordinal: typeof scaleOrdinal;
+    log: typeof scaleLog;
+    point: typeof scalePoint;
+    quantile: typeof scaleQuantile;
+    quantize: typeof scaleQuantize;
+    sqrt: typeof scaleSqrt;
+    custom: typeof scaleThreshold;
+};
+export declare type SCALE_TYPE = keyof typeof SCALE_FUNCS;
+export declare const AGGREGATION: {
+    average: string;
+    maximum: string;
+    minimum: string;
+    sum: string;
+};
+export declare const OPACITY_MAP: {
+    getFillColor: string;
+    getLineColor: string;
+    getTextColor: string;
+};
+export declare function getLayer(type: string, config: any, dataset: any): {
+    Layer: ConstructorOf<Layer>;
+    propMap: any;
+    defaultProps: any;
+};
+declare function domainFromValues(values: any, scaleType: SCALE_TYPE): any;
+export declare function opacityToAlpha(opacity: any): number;
+export declare function getColorValueAccessor({ name }: {
+    name: any;
+}, colorAggregation: any, data: any): any;
+export declare function getColorAccessor({ name }: {
+    name: any;
+}, scaleType: SCALE_TYPE, { colors, colorMap }: {
+    colors: any;
+    colorMap: any;
+}, opacity: number | undefined, data: any): any;
+export declare function getSizeAccessor({ name }: {
+    name: any;
+}, scaleType: SCALE_TYPE, range: Iterable<Range>, data: any): any;
+export declare function getTextAccessor({ name, type }: {
+    name: any;
+    type: any;
+}, data: any): any;
+export declare function getTextPixelOffsetAccessor({ alignment, anchor, size }: {
+    alignment: any;
+    anchor: any;
+    size: any;
+}, radius: any): number[] | ((d: any) => number[]);
+export { domainFromValues as _domainFromValues };
+//# sourceMappingURL=layer-map.d.ts.map

package/typed/api/layer-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer-map.d.ts","sourceRoot":"","sources":["../../src/api/layer-map.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,aAAa,EACb,aAAa,EACb,SAAS,EACT,cAAc,EACf,MAAM,UAAU,CAAC;AAIlB,OAAO,EAAC,KAAK,EAAE,cAAc,IAAI,aAAa,EAAC,MAAM,eAAe,CAAC;AASrE,QAAA,MAAM,WAAW;;;;;;;;;CAShB,CAAC;AACF,oBAAY,UAAU,GAAG,MAAM,OAAO,WAAW,CAAC;AAIlD,eAAO,MAAM,WAAW;;;;;CAKvB,CAAC;AAEF,eAAO,MAAM,WAAW;;;;CAIvB,CAAC;AA2DF,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,MAAM,KAAA,EACN,OAAO,KAAA,GACN;IAAC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAAC,OAAO,EAAE,GAAG,CAAC;IAAC,YAAY,EAAE,GAAG,CAAA;CAAC,CAmDhE;AAkCD,iBAAS,gBAAgB,CAAC,MAAM,KAAA,EAAE,SAAS,EAAE,UAAU,OActD;AA8BD,wBAAgB,cAAc,CAAC,OAAO,KAAA,UAErC;AAED,wBAAgB,qBAAqB,CAAC,EAAC,IAAI,EAAC;;CAAA,EAAE,gBAAgB,KAAA,EAAE,IAAI,EAAE,GAAG,OAIxE;AAED,wBAAgB,gBAAgB,CAC9B,EAAC,IAAI,EAAC;;CAAA,EACN,SAAS,EAAE,UAAU,EACrB,EAAC,MAAM,EAAE,QAAQ,EAAC;;;CAAA,EAClB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,GAAG,OA+BV;AAED,wBAAgB,eAAe,CAAC,EAAC,IAAI,EAAC;;CAAA,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,OAS/F;AAUD,wBAAgB,eAAe,CAAC,EAAC,IAAI,EAAE,IAAI,EAAC;;;CAAA,EAAE,IAAI,KAAA,OAMjD;AAED,wBAAgB,0BAA0B,CAAC,EAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAC;;;;CAAA,EAAE,MAAM,KAAA,qCAa3E;AAED,OAAO,EAAC,gBAAgB,IAAI,iBAAiB,EAAC,CAAC"}

package/typed/api/maps-api-common.d.ts

@@ -0,0 +1,65 @@
+export declare const DEFAULT_USER_COMPONENT_IN_URL = "{user}";
+export declare const DEFAULT_REGION_COMPONENT_IN_URL = "{region}";
+export declare type ValuesOf<T extends {}> = T[keyof T];
+export declare const API_VERSIONS: {
+    readonly V1: "v1";
+    readonly V2: "v2";
+    readonly V3: "v3";
+};
+export declare type ApiVersion = ValuesOf<typeof API_VERSIONS>;
+export declare const DEFAULT_MAPS_URL_FORMAT: {
+    readonly v1: "https://{user}.carto.com/api/v1/map";
+    readonly v2: "https://maps-api-v2.{region}.carto.com/user/{user}";
+};
+export declare const MAP_TYPES: {
+    readonly QUERY: "query";
+    readonly TABLE: "table";
+    readonly TILESET: "tileset";
+};
+export declare type MapType = ValuesOf<typeof MAP_TYPES>;
+export declare const COLUMNS_SUPPORT: MapType[];
+export declare const GEO_COLUMN_SUPPORT: MapType[];
+export declare const FORMATS: {
+    readonly GEOJSON: "geojson";
+    readonly NDJSON: "ndjson";
+    readonly TILEJSON: "tilejson";
+    readonly JSON: "json";
+};
+export declare type Format = ValuesOf<typeof FORMATS>;
+export declare const TILE_FORMATS: {
+    readonly MVT: "mvt";
+    readonly JSON: "json";
+    readonly GEOJSON: "geojson";
+    readonly BINARY: "binary";
+};
+export declare type TileFormat = ValuesOf<typeof TILE_FORMATS>;
+export declare enum SchemaFieldType {
+    Number = "number",
+    Bigint = "bigint",
+    String = "string",
+    Geometry = "geometry",
+    Timestamp = "timestamp",
+    Object = "object",
+    Boolean = "boolean",
+    Variant = "variant",
+    Unknown = "unknown"
+}
+export interface SchemaField {
+    name: string;
+    type: SchemaFieldType;
+}
+export interface MapInstantiation extends MapInstantiationFormats {
+    nrows: number;
+    size?: number;
+    schema: SchemaField[];
+}
+declare type MapInstantiationFormats = Record<Format, {
+    url: string[];
+    error?: any;
+}>;
+/**
+ * Simple encode parameter
+ */
+export declare function encodeParameter(name: string, value: string | boolean | number): string;
+export {};
+//# sourceMappingURL=maps-api-common.d.ts.map

package/typed/api/maps-api-common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maps-api-common.d.ts","sourceRoot":"","sources":["../../src/api/maps-api-common.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,6BAA6B,WAAW,CAAC;AACtD,eAAO,MAAM,+BAA+B,aAAa,CAAC;AAE1D,oBAAY,QAAQ,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAChD,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AACX,oBAAY,UAAU,GAAG,QAAQ,CAAC,OAAO,YAAY,CAAC,CAAC;AAEvD,eAAO,MAAM,uBAAuB;;;CAG1B,CAAC;AAEX,eAAO,MAAM,SAAS;;;;CAIZ,CAAC;AACX,oBAAY,OAAO,GAAG,QAAQ,CAAC,OAAO,SAAS,CAAC,CAAC;AACjD,eAAO,MAAM,eAAe,EAAE,OAAO,EAAsB,CAAC;AAC5D,eAAO,MAAM,kBAAkB,EAAE,OAAO,EAAuC,CAAC;AAGhF,eAAO,MAAM,OAAO;;;;;CAKV,CAAC;AACX,oBAAY,MAAM,GAAG,QAAQ,CAAC,OAAO,OAAO,CAAC,CAAC;AAG9C,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AACX,oBAAY,UAAU,GAAG,QAAQ,CAAC,OAAO,YAAY,CAAC,CAAC;AAEvD,oBAAY,eAAe;IACzB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AACD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,WAAW,gBAAiB,SAAQ,uBAAuB;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,aAAK,uBAAuB,GAAG,MAAM,CACnC,MAAM,EACN;IACE,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,KAAK,CAAC,EAAE,GAAG,CAAC;CACb,CACF,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAEtF"}

package/typed/api/maps-client.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Maps API Client for Maps API v1 and Maps API v2
+ */
+import { ClassicCredentials } from '../config';
+import { MapType } from './maps-api-common';
+export declare const CONNECTIONS: {
+    BIGQUERY: string;
+    CARTO: string;
+};
+/**
+ * Obtain a TileJson from Maps API v1 and v2
+ */
+export declare function getDataV2({ type, source, credentials }: {
+    type: MapType;
+    source: string;
+    credentials?: Partial<ClassicCredentials>;
+}): Promise<any>;
+//# sourceMappingURL=maps-client.d.ts.map

package/typed/api/maps-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maps-client.d.ts","sourceRoot":"","sources":["../../src/api/maps-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,kBAAkB,EAInB,MAAM,WAAW,CAAC;AACnB,OAAO,EAML,OAAO,EAER,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,WAAW;;;CAGvB,CAAC;AAKF;;GAEG;AACH,wBAAsB,SAAS,CAAC,EAC9B,IAAI,EACJ,MAAM,EACN,WAAW,EACZ,EAAE;IACD,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC3C,gBAkCA"}

package/typed/api/maps-v3-client.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Maps API Client for Carto 3
+ */
+import { CloudNativeCredentials } from '../config';
+import { Format, MapInstantiation, MapType, SchemaField, TileFormat } from './maps-api-common';
+declare type FetchLayerDataParams = {
+    type: MapType;
+    source: string;
+    connection: string;
+    credentials: CloudNativeCredentials;
+    geoColumn?: string;
+    columns?: string[];
+    clientId?: string;
+    format?: Format;
+    formatTiles?: TileFormat;
+    aggregationExp?: string;
+    aggregationResLevel?: number;
+};
+export declare function mapInstantiation({ type, source, connection, credentials, geoColumn, columns, clientId, aggregationExp, aggregationResLevel }: FetchLayerDataParams): Promise<MapInstantiation>;
+export interface FetchLayerDataResult {
+    data: any;
+    format?: Format;
+    schema: SchemaField[];
+}
+export declare function fetchLayerData({ type, source, connection, credentials, geoColumn, columns, format, formatTiles, clientId, aggregationExp, aggregationResLevel }: FetchLayerDataParams): Promise<FetchLayerDataResult>;
+export declare function getData({ type, source, connection, credentials, geoColumn, columns, format, clientId }: FetchLayerDataParams): Promise<any>;
+export declare function fetchMap({ cartoMapId, clientId, credentials, autoRefresh, onNewData }: {
+    cartoMapId: string;
+    clientId: string;
+    credentials?: CloudNativeCredentials;
+    autoRefresh?: number;
+    onNewData?: (map: any) => void;
+}): Promise<{
+    stopAutoRefresh: (() => void) | undefined;
+    id: any;
+    title: any;
+    description: any;
+    createdAt: any;
+    updatedAt: any;
+    initialViewState: any;
+    mapStyle: any;
+    layers: (import("@deck.gl/core").Layer<any> | undefined)[];
+}>;
+export {};
+//# sourceMappingURL=maps-v3-client.d.ts.map

package/typed/api/maps-v3-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maps-v3-client.d.ts","sourceRoot":"","sources":["../../src/api/maps-v3-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAA8C,sBAAsB,EAAC,MAAM,WAAW,CAAC;AAC9F,OAAO,EAIL,MAAM,EAGN,gBAAgB,EAChB,OAAO,EAEP,WAAW,EACX,UAAU,EAEX,MAAM,mBAAmB,CAAC;AA0F3B,aAAK,oBAAoB,GAAG;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,sBAAsB,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAmCF,wBAAsB,gBAAgB,CAAC,EACrC,IAAI,EACJ,MAAM,EACN,UAAU,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,QAAQ,EACR,cAAc,EACd,mBAAmB,EACpB,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuBlD;AAsDD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,GAAG,CAAC;IACV,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AACD,wBAAsB,cAAc,CAAC,EACnC,IAAI,EACJ,MAAM,EACN,UAAU,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,MAAM,EACN,WAAW,EACX,QAAQ,EACR,cAAc,EACd,mBAAmB,EACpB,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAoBtD;AAgFD,wBAAsB,OAAO,CAAC,EAC5B,IAAI,EACJ,MAAM,EACN,UAAU,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,MAAM,EACN,QAAQ,EACT,EAAE,oBAAoB,gBAatB;AA4CD,wBAAsB,QAAQ,CAAC,EAC7B,UAAU,EACV,QAAQ,EACR,WAAW,EACX,WAAW,EACX,SAAS,EACV,EAAE;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;CAChC;4BA8B6B,IAAI;;;;;;;;;GA8BjC"}