@carto/api-client 0.5.10 → 0.5.12

package/package.json

@@ -8,7 +8,7 @@
   "homepage": "https://github.com/CartoDB/carto-api-client#readme",
   "author": "Don McCurdy <donmccurdy@carto.com>",
   "packageManager": "yarn@4.3.1",
-  "version": "0.5.10",
+  "version": "0.5.12",
   "license": "MIT",
   "publishConfig": {
     "access": "public"

package/src/api/query.ts

@@ -13,7 +13,17 @@ import {requestWithParameters} from './request-with-parameters.js';
 import type {APIErrorContext} from './carto-api-error.js';
 import {getClient} from '../client.js';
 
-export type QueryOptions = SourceOptions & QuerySourceOptions;
+export 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;
+  };
 type UrlParameters = {q: string; queryParameters?: string};
 
 export const query = async function (
@@ -27,6 +37,7 @@ export const query = async function (
     connectionName,
     sqlQuery,
     queryParameters,
+    internalParameters,
   } = options;
   const urlParameters: UrlParameters = {q: sqlQuery};
 
@@ -39,7 +50,12 @@ export const query = async function (
     Authorization: `Bearer ${options.accessToken}`,
     ...options.headers,
   };
-  const parameters = {client: clientId, ...urlParameters};
+  const parameters = {
+    client: clientId,
+    ...options.tags,
+    ...internalParameters,
+    ...urlParameters,
+  };
 
   const errorContext: APIErrorContext = {
     requestType: 'SQL',
@@ -54,5 +70,6 @@ export const query = async function (
     errorContext,
     maxLengthURL,
     localCache,
+    signal: options.signal,
   });
 };

package/src/api/request-with-parameters.ts

@@ -23,6 +23,7 @@ export async function requestWithParameters<T = any>({
   errorContext,
   maxLengthURL = DEFAULT_MAX_LENGTH_URL,
   localCache,
+  signal,
 }: {
   baseUrl: string;
   parameters?: Record<string, unknown>;
@@ -30,6 +31,7 @@ export async function requestWithParameters<T = any>({
   errorContext: APIErrorContext;
   maxLengthURL?: number;
   localCache?: LocalCacheOptions;
+  signal?: AbortSignal;
 }): Promise<T> {
   // Parameters added to all requests issued with `requestWithParameters()`.
   // These parameters override parameters already in the base URL, but not
@@ -65,8 +67,9 @@ export async function requestWithParameters<T = any>({
           method: 'POST',
           body: JSON.stringify(parameters),
           headers,
+          signal,
         })
-      : fetch(url, {headers});
+      : fetch(url, {headers, signal});
 
   let response: Response | undefined;
   let responseJson: unknown;
@@ -143,10 +146,12 @@ function createURLWithParameters(
     if (isPureObject(value) || Array.isArray(value)) {
       baseUrl.searchParams.set(key, JSON.stringify(value));
     } else {
-      baseUrl.searchParams.set(
-        key,
-        (value as string | boolean | number).toString()
-      );
+      if (value !== null && value !== undefined) {
+        baseUrl.searchParams.set(
+          key,
+          (value as string | boolean | number).toString()
+        );
+      }
     }
   }
   return baseUrl.toString();

package/src/models/model.ts

@@ -43,6 +43,7 @@ export interface ModelSource {
   spatialDataColumn?: string;
   spatialDataType?: SpatialDataType;
   spatialFiltersMode?: SpatialFilterPolyfillMode;
+  tags?: Record<string, string>;
 }
 
 const {V3} = ApiVersion;
@@ -87,6 +88,7 @@ export function executeModel(props: {
     spatialDataType = 'geo',
     spatialDataColumn = DEFAULT_GEO_COLUMN,
     spatialFiltersMode = 'intersects',
+    tags,
   } = source;
 
   const queryParams: Record<string, unknown> = {
@@ -97,6 +99,7 @@ export function executeModel(props: {
     queryParameters: source.queryParameters || '',
     filters,
     filtersLogicalOperator,
+    ...(tags ?? {}),
   };
 
   queryParams.spatialDataType = spatialDataType;

package/src/sources/base-source.ts

@@ -47,7 +47,7 @@ export async function baseSource<UrlParameters extends Record<string, unknown>>(
     Authorization: `Bearer ${options.accessToken}`,
     ...options.headers,
   };
-  const parameters = {client: clientId, ...urlParameters};
+  const parameters = {client: clientId, ...options.tags, ...urlParameters};
 
   const errorContext: APIErrorContext = {
     requestType: 'Map instantiation',

package/src/sources/types.ts

@@ -75,6 +75,9 @@ export 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>;
 };
 
 export type LocalCacheOptions = {
@@ -237,7 +240,7 @@ export 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[];
 
   //
@@ -382,6 +385,13 @@ export 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
@@ -408,10 +418,11 @@ export 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;

package/src/widget-sources/widget-remote-source.ts

@@ -61,6 +61,7 @@ export abstract class WidgetRemoteSource<
       filtersLogicalOperator: props.filtersLogicalOperator,
       spatialDataType: props.spatialDataType,
       spatialDataColumn: props.spatialDataColumn,
+      tags: props.tags,
     };
   }