@carto/api-client 0.5.10 → 0.5.12

package/build/api-client.d.cts

@@ -388,6 +388,8 @@ type SourceOptionalOptions = {
      * By default, local in-memory caching is enabled.
      */
     localCache?: LocalCacheOptions;
+    /** Additional tags appended to HTTP requests, available for analytics and audits. */
+    tags?: Record<string, string>;
 };
 type LocalCacheOptions = {
     /**
@@ -523,7 +525,7 @@ interface Tilejson {
     minzoom: number;
     maxzoom: number;
     bounds: [left: number, bottom: number, right: number, top: number];
-    center: [longitute: number, latitude: number, zoom: number];
+    center: [longitude: number, latitude: number, zoom: number];
     vector_layers: VectorLayer[];
     minresolution: number;
     maxresolution: number;
@@ -635,6 +637,11 @@ type RasterMetadataBand = {
     type: RasterBandType;
     name: string;
     stats: RasterMetadataBandStats;
+    /**
+     * Optional table of mappings from (integer) band values to (string) human
+     * readable labels. Values found in tiles are NOT guaranteed to have labels.
+     */
+    valuelabels?: Record<string, string>;
     /**
      * Known values:
      *  * `palette`: use unique value and `colortable` ad default mapping
@@ -658,10 +665,11 @@ type RasterMetadata = {
     block_resolution: number;
     minresolution: number;
     maxresolution: number;
+    /** @deprecated Use {@link RasterMetadataBand.nodata} from {@link RasterMetadata.bands}. */
     nodata: number | string;
     bands: RasterMetadataBand[];
     bounds: [left: number, bottom: number, right: number, top: number];
-    center: [longitute: number, latitude: number, zoom: number];
+    center: [longitude: number, latitude: number, zoom: number];
     width: number;
     height: number;
     block_width: number;
@@ -687,16 +695,26 @@ type QueryResult = {
     }[];
 };
 
-type QueryOptions = SourceOptions & QuerySourceOptions;
+type QueryOptions = SourceOptions & QuerySourceOptions & {
+    /**
+     * @internal
+     * @experimental
+     * Used to append additional parameters to the SQL API request for features specific to providers or integrations.
+     */
+    internalParameters?: Record<string, string | boolean | number>;
+    /** Used to abort the request. */
+    signal?: AbortSignal;
+};
 declare const query: (options: QueryOptions) => Promise<QueryResult>;
 
-declare function requestWithParameters<T = any>({ baseUrl, parameters, headers: customHeaders, errorContext, maxLengthURL, localCache, }: {
+declare function requestWithParameters<T = any>({ baseUrl, parameters, headers: customHeaders, errorContext, maxLengthURL, localCache, signal, }: {
     baseUrl: string;
     parameters?: Record<string, unknown>;
     headers?: Record<string, string>;
     errorContext: APIErrorContext;
     maxLengthURL?: number;
     localCache?: LocalCacheOptions;
+    signal?: AbortSignal;
 }): Promise<T>;
 /**
  * Clears the HTTP response cache for all requests using the default cache.
@@ -1457,6 +1475,7 @@ interface ModelSource {
     spatialDataColumn?: string;
     spatialDataType?: SpatialDataType;
     spatialFiltersMode?: SpatialFilterPolyfillMode;
+    tags?: Record<string, string>;
 }
 
 type WidgetRemoteSourceProps = WidgetSourceProps;

package/build/api-client.d.ts

@@ -388,6 +388,8 @@ type SourceOptionalOptions = {
      * By default, local in-memory caching is enabled.
      */
     localCache?: LocalCacheOptions;
+    /** Additional tags appended to HTTP requests, available for analytics and audits. */
+    tags?: Record<string, string>;
 };
 type LocalCacheOptions = {
     /**
@@ -523,7 +525,7 @@ interface Tilejson {
     minzoom: number;
     maxzoom: number;
     bounds: [left: number, bottom: number, right: number, top: number];
-    center: [longitute: number, latitude: number, zoom: number];
+    center: [longitude: number, latitude: number, zoom: number];
     vector_layers: VectorLayer[];
     minresolution: number;
     maxresolution: number;
@@ -635,6 +637,11 @@ type RasterMetadataBand = {
     type: RasterBandType;
     name: string;
     stats: RasterMetadataBandStats;
+    /**
+     * Optional table of mappings from (integer) band values to (string) human
+     * readable labels. Values found in tiles are NOT guaranteed to have labels.
+     */
+    valuelabels?: Record<string, string>;
     /**
      * Known values:
      *  * `palette`: use unique value and `colortable` ad default mapping
@@ -658,10 +665,11 @@ type RasterMetadata = {
     block_resolution: number;
     minresolution: number;
     maxresolution: number;
+    /** @deprecated Use {@link RasterMetadataBand.nodata} from {@link RasterMetadata.bands}. */
     nodata: number | string;
     bands: RasterMetadataBand[];
     bounds: [left: number, bottom: number, right: number, top: number];
-    center: [longitute: number, latitude: number, zoom: number];
+    center: [longitude: number, latitude: number, zoom: number];
     width: number;
     height: number;
     block_width: number;
@@ -687,16 +695,26 @@ type QueryResult = {
     }[];
 };
 
-type QueryOptions = SourceOptions & QuerySourceOptions;
+type QueryOptions = SourceOptions & QuerySourceOptions & {
+    /**
+     * @internal
+     * @experimental
+     * Used to append additional parameters to the SQL API request for features specific to providers or integrations.
+     */
+    internalParameters?: Record<string, string | boolean | number>;
+    /** Used to abort the request. */
+    signal?: AbortSignal;
+};
 declare const query: (options: QueryOptions) => Promise<QueryResult>;
 
-declare function requestWithParameters<T = any>({ baseUrl, parameters, headers: customHeaders, errorContext, maxLengthURL, localCache, }: {
+declare function requestWithParameters<T = any>({ baseUrl, parameters, headers: customHeaders, errorContext, maxLengthURL, localCache, signal, }: {
     baseUrl: string;
     parameters?: Record<string, unknown>;
     headers?: Record<string, string>;
     errorContext: APIErrorContext;
     maxLengthURL?: number;
     localCache?: LocalCacheOptions;
+    signal?: AbortSignal;
 }): Promise<T>;
 /**
  * Clears the HTTP response cache for all requests using the default cache.
@@ -1457,6 +1475,7 @@ interface ModelSource {
     spatialDataColumn?: string;
     spatialDataType?: SpatialDataType;
     spatialFiltersMode?: SpatialFilterPolyfillMode;
+    tags?: Record<string, string>;
 }
 
 type WidgetRemoteSourceProps = WidgetSourceProps;

package/build/api-client.js

@@ -5839,7 +5839,8 @@ async function requestWithParameters({
   headers: customHeaders = {},
   errorContext,
   maxLengthURL = DEFAULT_MAX_LENGTH_URL,
-  localCache
+  localCache,
+  signal
 }) {
   parameters = {
     v: V3_MINOR_VERSION,
@@ -5862,8 +5863,9 @@ async function requestWithParameters({
   const fetchPromise = url.length > maxLengthURL ? fetch(baseUrl, {
     method: "POST",
     body: JSON.stringify(parameters),
-    headers
-  }) : fetch(url, { headers });
+    headers,
+    signal
+  }) : fetch(url, { headers, signal });
   let response;
   let responseJson;
   const jsonPromise = fetchPromise.then((_response) => {
@@ -5915,10 +5917,12 @@ function createURLWithParameters(baseUrlString, parameters) {
     if (isPureObject(value) || Array.isArray(value)) {
       baseUrl.searchParams.set(key, JSON.stringify(value));
     } else {
-      baseUrl.searchParams.set(
-        key,
-        value.toString()
-      );
+      if (value !== null && value !== void 0) {
+        baseUrl.searchParams.set(
+          key,
+          value.toString()
+        );
+      }
     }
   }
   return baseUrl.toString();
@@ -5962,7 +5966,7 @@ async function baseSource(endpoint, options, urlParameters) {
     Authorization: `Bearer ${options.accessToken}`,
     ...options.headers
   };
-  const parameters = { client: clientId, ...urlParameters };
+  const parameters = { client: clientId, ...options.tags, ...urlParameters };
   const errorContext = {
     requestType: "Map instantiation",
     connection: options.connectionName,
@@ -6164,7 +6168,8 @@ function executeModel(props) {
     filtersLogicalOperator = "and",
     spatialDataType = "geo",
     spatialDataColumn = DEFAULT_GEO_COLUMN,
-    spatialFiltersMode = "intersects"
+    spatialFiltersMode = "intersects",
+    tags
   } = source;
   const queryParams = {
     type,
@@ -6173,7 +6178,8 @@ function executeModel(props) {
     params,
     queryParameters: source.queryParameters || "",
     filters,
-    filtersLogicalOperator
+    filtersLogicalOperator,
+    ...tags ?? {}
   };
   queryParams.spatialDataType = spatialDataType;
   queryParams.spatialDataColumn = spatialDataColumn;
@@ -6306,7 +6312,8 @@ var WidgetRemoteSource = class extends WidgetSource {
       filters: getApplicableFilters(filterOwner, filters || props.filters),
       filtersLogicalOperator: props.filtersLogicalOperator,
       spatialDataType: props.spatialDataType,
-      spatialDataColumn: props.spatialDataColumn
+      spatialDataColumn: props.spatialDataColumn,
+      tags: props.tags
     };
   }
   async getCategories(options) {
@@ -8112,7 +8119,8 @@ var query = async function(options) {
     localCache,
     connectionName,
     sqlQuery,
-    queryParameters
+    queryParameters,
+    internalParameters
   } = options;
   const urlParameters = { q: sqlQuery };
   if (queryParameters) {
@@ -8123,7 +8131,12 @@ var query = async function(options) {
     Authorization: `Bearer ${options.accessToken}`,
     ...options.headers
   };
-  const parameters = { client: clientId, ...urlParameters };
+  const parameters = {
+    client: clientId,
+    ...options.tags,
+    ...internalParameters,
+    ...urlParameters
+  };
   const errorContext = {
     requestType: "SQL",
     connection: options.connectionName,
@@ -8136,7 +8149,8 @@ var query = async function(options) {
     headers,
     errorContext,
     maxLengthURL,
-    localCache
+    localCache,
+    signal: options.signal
   });
 };