@carto/api-client 0.4.0-alpha.1 → 0.4.0-alpha.4

package/build/index.d.ts

@@ -7,4 +7,4 @@ export * from './types.js';
 export { APIErrorContext, APIRequestType, CartoAPIError, QueryOptions, buildPublicMapUrl, // Internal, but required for fetchMap().
 buildStatsUrl, // Internal, but required for fetchMap().
 query, requestWithParameters, } from './api/index.js';
-export { GeojsonResult, JsonResult, QueryResult, QuerySourceOptions, SOURCE_DEFAULTS, SourceOptions, TableSourceOptions, TilejsonResult, TilesetSourceOptions, BoundaryQuerySourceOptions, BoundaryTableSourceOptions, H3TilesetSourceOptions, QuadbinTilesetSourceOptions, RasterSourceOptions, VectorTilesetSourceOptions, boundaryQuerySource, boundaryTableSource, h3TilesetSource, quadbinTilesetSource, rasterSource, vectorTilesetSource, } from './sources/index.js';
+export { BoundaryQuerySourceOptions, BoundaryTableSourceOptions, GeojsonResult, H3QuerySourceOptions, H3TableSourceOptions, H3TilesetSourceOptions, JsonResult, QuadbinQuerySourceOptions, QuadbinTableSourceOptions, QuadbinTilesetSourceOptions, QueryResult, QuerySourceOptions, RasterSourceOptions, SOURCE_DEFAULTS, SourceOptions, TableSourceOptions, TilejsonResult, TilesetSourceOptions, VectorQuerySourceOptions, VectorTableSourceOptions, VectorTilesetSourceOptions, boundaryQuerySource, boundaryTableSource, h3QuerySource, h3TableSource, h3TilesetSource, quadbinQuerySource, quadbinTableSource, quadbinTilesetSource, rasterSource, vectorQuerySource, vectorTableSource, vectorTilesetSource, } from './sources/index.js';

package/build/models/common.d.ts

@@ -1,4 +1,3 @@
-import { $TODO } from '../types-internal.js';
 /** @internalRemarks Source: @carto/react-api */
 export interface ModelRequestOptions {
     method: 'GET' | 'POST';
@@ -6,13 +5,18 @@ export interface ModelRequestOptions {
     otherOptions?: Record<string, unknown>;
     body?: string;
 }
+interface ModelErrorResponse {
+    error?: string | string[];
+    hint?: string;
+    column_name?: string;
+}
 /**
  * Return more descriptive error from API
  * @internalRemarks Source: @carto/react-api
  */
 export declare function dealWithApiError({ response, data, }: {
     response: Response;
-    data: $TODO;
+    data: ModelErrorResponse;
 }): void;
 /** @internalRemarks Source: @carto/react-api */
 export declare function makeCall({ url, accessToken, opts, }: {
@@ -20,3 +24,4 @@ export declare function makeCall({ url, accessToken, opts, }: {
     accessToken: string;
     opts: ModelRequestOptions;
 }): Promise<any>;
+export {};

package/build/sources/h3-query-source.d.ts

@@ -1,3 +1,4 @@
+import { WidgetQuerySourceResult } from '../widget-sources';
 import type { AggregationOptions, FilterOptions, QuerySourceOptions, SourceOptions, TilejsonResult } from './types';
 export type H3QuerySourceOptions = SourceOptions & QuerySourceOptions & AggregationOptions & FilterOptions;
-export declare const h3QuerySource: (options: H3QuerySourceOptions) => Promise<TilejsonResult>;
+export declare const h3QuerySource: (options: H3QuerySourceOptions) => Promise<TilejsonResult & WidgetQuerySourceResult>;

package/build/sources/h3-table-source.d.ts

@@ -1,3 +1,4 @@
+import { WidgetTableSourceResult } from '../widget-sources';
 import type { AggregationOptions, FilterOptions, SourceOptions, TableSourceOptions, TilejsonResult } from './types';
 export type H3TableSourceOptions = SourceOptions & TableSourceOptions & AggregationOptions & FilterOptions;
-export declare const h3TableSource: (options: H3TableSourceOptions) => Promise<TilejsonResult>;
+export declare const h3TableSource: (options: H3TableSourceOptions) => Promise<TilejsonResult & WidgetTableSourceResult>;

package/build/sources/quadbin-query-source.d.ts

@@ -1,3 +1,4 @@
+import { WidgetQuerySourceResult } from '../widget-sources';
 import type { AggregationOptions, FilterOptions, QuerySourceOptions, SourceOptions, TilejsonResult } from './types';
 export type QuadbinQuerySourceOptions = SourceOptions & QuerySourceOptions & AggregationOptions & FilterOptions;
-export declare const quadbinQuerySource: (options: QuadbinQuerySourceOptions) => Promise<TilejsonResult>;
+export declare const quadbinQuerySource: (options: QuadbinQuerySourceOptions) => Promise<TilejsonResult & WidgetQuerySourceResult>;

package/build/sources/quadbin-table-source.d.ts

@@ -1,3 +1,4 @@
+import { WidgetTableSourceResult } from '../widget-sources';
 import type { AggregationOptions, FilterOptions, SourceOptions, TableSourceOptions, TilejsonResult } from './types';
 export type QuadbinTableSourceOptions = SourceOptions & TableSourceOptions & AggregationOptions & FilterOptions;
-export declare const quadbinTableSource: (options: QuadbinTableSourceOptions) => Promise<TilejsonResult>;
+export declare const quadbinTableSource: (options: QuadbinTableSourceOptions) => Promise<TilejsonResult & WidgetTableSourceResult>;

package/build/sources/vector-query-source.d.ts

@@ -1,3 +1,4 @@
+import { WidgetQuerySourceResult } from '../widget-sources/index.js';
 import type { FilterOptions, SourceOptions, QuerySourceOptions, TilejsonResult, ColumnsOption } from './types';
 export type VectorQuerySourceOptions = SourceOptions & QuerySourceOptions & FilterOptions & ColumnsOption;
-export declare const vectorQuerySource: (options: VectorQuerySourceOptions) => Promise<TilejsonResult>;
+export declare const vectorQuerySource: (options: VectorQuerySourceOptions) => Promise<TilejsonResult & WidgetQuerySourceResult>;

package/build/sources/vector-table-source.d.ts

@@ -1,3 +1,4 @@
+import { WidgetTableSourceResult } from '../widget-sources/index.js';
 import type { FilterOptions, ColumnsOption, SourceOptions, TableSourceOptions, TilejsonResult } from './types';
 export type VectorTableSourceOptions = SourceOptions & TableSourceOptions & FilterOptions & ColumnsOption;
-export declare const vectorTableSource: (options: VectorTableSourceOptions) => Promise<TilejsonResult>;
+export declare const vectorTableSource: (options: VectorTableSourceOptions) => Promise<TilejsonResult & WidgetTableSourceResult>;

package/build/widget-sources/index.d.ts

@@ -1,5 +1,4 @@
 export * from './widget-base-source.js';
 export * from './widget-query-source.js';
 export * from './widget-table-source.js';
-export * from './wrappers.js';
 export * from './types.js';

package/build/widget-sources/widget-query-source.d.ts

@@ -2,6 +2,9 @@ import { H3QuerySourceOptions, QuadbinQuerySourceOptions, VectorQuerySourceOptio
 import { WidgetBaseSource, WidgetBaseSourceProps } from './widget-base-source.js';
 import { ModelSource } from '../models/model.js';
 type LayerQuerySourceOptions = Omit<VectorQuerySourceOptions, 'filters'> | Omit<H3QuerySourceOptions, 'filters'> | Omit<QuadbinQuerySourceOptions, 'filters'>;
+export type WidgetQuerySourceResult = {
+    widgetSource: WidgetQuerySource;
+};
 /**
  * Source for Widget API requests on a data source defined by a SQL query.
  *

package/build/widget-sources/widget-table-source.d.ts

@@ -2,6 +2,9 @@ import { H3TableSourceOptions, QuadbinTableSourceOptions, VectorTableSourceOptio
 import { WidgetBaseSource, WidgetBaseSourceProps } from './widget-base-source.js';
 import { ModelSource } from '../models/model.js';
 type LayerTableSourceOptions = Omit<VectorTableSourceOptions, 'filters'> | Omit<H3TableSourceOptions, 'filters'> | Omit<QuadbinTableSourceOptions, 'filters'>;
+export type WidgetTableSourceResult = {
+    widgetSource: WidgetTableSource;
+};
 /**
  * Source for Widget API requests on a data source defined as a table.
  *

package/package.json

@@ -4,7 +4,7 @@
   "repository": "github:CartoDB/carto-api-client",
   "author": "Don McCurdy <donmccurdy@carto.com>",
   "packageManager": "yarn@4.3.1",
-  "version": "0.4.0-alpha.1",
+  "version": "0.4.0-alpha.4",
   "license": "MIT",
   "publishConfig": {
     "access": "public",

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

@@ -5,7 +5,8 @@
 import {isPureObject} from '../utils';
 import {CartoAPIError, APIErrorContext} from './carto-api-error';
 import {V3_MINOR_VERSION} from '../constants-internal';
-import {DEFAULT_CLIENT, DEFAULT_MAX_LENGTH_URL} from '../constants';
+import {DEFAULT_MAX_LENGTH_URL} from '../constants-internal';
+import {getClient} from '../client';
 
 const DEFAULT_HEADERS = {
   Accept: 'application/json',
@@ -32,7 +33,7 @@ export async function requestWithParameters<T = any>({
   // user-provided parameters.
   parameters = {
     v: V3_MINOR_VERSION,
-    clientId: DEFAULT_CLIENT,
+    client: getClient(),
     ...(typeof deck !== 'undefined' &&
       deck.VERSION && {deckglVersion: deck.VERSION}),
     ...parameters,

package/src/client.ts

@@ -1,8 +1,8 @@
 /**
  * @internal
- * @internalRemarks Source: @carto/react-core
+ * @internalRemarks Source: @carto/react-core, @carto/constants, @deck.gl/carto
  */
-let client = 'carto-api-client';
+let client = 'deck-gl-carto';
 
 /**
  * Returns current client ID, used to categorize API requests. For internal use only.

package/src/constants-internal.ts

@@ -1,6 +1,5 @@
-/******************************************************************************
- * VERSIONS
- */
+/** @internalRemarks Source: @carto/constants, @deck.gl/carto */
+export const DEFAULT_API_BASE_URL = 'https://gcp-us-east1.api.carto.com';
 
 /**
  * Current version of @carto/api-client.
@@ -11,6 +10,18 @@ export const API_CLIENT_VERSION = __CARTO_API_CLIENT_VERSION;
 /** @internal */
 export const V3_MINOR_VERSION = '3.4';
 
+/** @internalRemarks Source: @carto/constants, @deck.gl/carto */
+export const DEFAULT_GEO_COLUMN = 'geom';
+
+/**
+ * Fastly default limit is 8192; leave some padding.
+ * @internalRemarks Source: @deck.gl/carto
+ */
+export const DEFAULT_MAX_LENGTH_URL = 7000;
+
+/** @internalRemarks Source: @deck.gl/carto */
+export const DEFAULT_TILE_RESOLUTION = 0.5;
+
 /**
  * @internalRemarks Source: @deck.gl/carto
  * @internal

package/src/constants.ts

@@ -28,28 +28,3 @@ export enum ApiVersion {
   V2 = 'v2',
   V3 = 'v3',
 }
-
-/******************************************************************************
- * DEFAULTS
- */
-
-/** @internalRemarks Source: @carto/constants, @deck.gl/carto */
-export const DEFAULT_API_BASE_URL = 'https://gcp-us-east1.api.carto.com';
-
-/** @internalRemarks Source: @carto/constants, @deck.gl/carto */
-export const DEFAULT_CLIENT = 'deck-gl-carto';
-
-/** @internalRemarks Source: @carto/constants, @deck.gl/carto */
-export const DEFAULT_GEO_COLUMN = 'geom';
-
-/**
- * Fastly default limit is 8192; leave some padding.
- * @internalRemarks Source: @deck.gl/carto
- */
-export const DEFAULT_MAX_LENGTH_URL = 7000;
-
-/** @internalRemarks Source: @deck.gl/carto */
-export const DEFAULT_TILE_SIZE = 512;
-
-/** @internalRemarks Source: @deck.gl/carto */
-export const DEFAULT_TILE_RESOLUTION = 0.5;

package/src/index.ts

@@ -17,27 +17,37 @@ export {
 } from './api/index.js';
 
 export {
+  BoundaryQuerySourceOptions,
+  BoundaryTableSourceOptions,
   GeojsonResult,
+  H3QuerySourceOptions,
+  H3TableSourceOptions,
+  H3TilesetSourceOptions,
   JsonResult,
+  QuadbinQuerySourceOptions,
+  QuadbinTableSourceOptions,
+  QuadbinTilesetSourceOptions,
   QueryResult,
   QuerySourceOptions,
+  RasterSourceOptions,
   SOURCE_DEFAULTS,
   SourceOptions,
   TableSourceOptions,
   TilejsonResult,
   TilesetSourceOptions,
-
-  // Sources not wrapped in './widget-sources/index.js';
-  BoundaryQuerySourceOptions,
-  BoundaryTableSourceOptions,
-  H3TilesetSourceOptions,
-  QuadbinTilesetSourceOptions,
-  RasterSourceOptions,
+  VectorQuerySourceOptions,
+  VectorTableSourceOptions,
   VectorTilesetSourceOptions,
   boundaryQuerySource,
   boundaryTableSource,
+  h3QuerySource,
+  h3TableSource,
   h3TilesetSource,
+  quadbinQuerySource,
+  quadbinTableSource,
   quadbinTilesetSource,
   rasterSource,
+  vectorQuerySource,
+  vectorTableSource,
   vectorTilesetSource,
 } from './sources/index.js';

package/src/models/common.ts

@@ -1,4 +1,3 @@
-import {$TODO} from '../types-internal.js';
 import {InvalidColumnError} from '../utils.js';
 
 /** @internalRemarks Source: @carto/react-api */
@@ -9,6 +8,12 @@ export interface ModelRequestOptions {
   body?: string;
 }
 
+interface ModelErrorResponse {
+  error?: string | string[];
+  hint?: string;
+  column_name?: string;
+}
+
 /**
  * Return more descriptive error from API
  * @internalRemarks Source: @carto/react-api
@@ -18,13 +23,16 @@ export function dealWithApiError({
   data,
 }: {
   response: Response;
-  data: $TODO;
+  data: ModelErrorResponse;
 }) {
   if (data.error === 'Column not found') {
     throw new InvalidColumnError(`${data.error} ${data.column_name}`);
   }
 
-  if (data.error?.includes('Missing columns')) {
+  if (
+    typeof data.error === 'string' &&
+    data.error?.includes('Missing columns')
+  ) {
     throw new InvalidColumnError(data.error);
   }
 

package/src/models/model.ts

@@ -1,4 +1,4 @@
-import {DEFAULT_GEO_COLUMN} from '../constants.js';
+import {DEFAULT_GEO_COLUMN} from '../constants-internal.js';
 import {
   Filter,
   FilterLogicalOperator,

package/src/sources/base-source.ts

@@ -5,9 +5,8 @@
 /* eslint-disable camelcase */
 import {
   DEFAULT_API_BASE_URL,
-  DEFAULT_CLIENT,
   DEFAULT_MAX_LENGTH_URL,
-} from '../constants';
+} from '../constants-internal';
 import {buildSourceUrl} from '../api/endpoints';
 import {requestWithParameters} from '../api/request-with-parameters';
 import type {
@@ -20,10 +19,11 @@ import type {
 } from './types';
 import {MapType} from '../types';
 import {APIErrorContext} from '../api';
+import {getClient} from '../client';
 
 export const SOURCE_DEFAULTS: SourceOptionalOptions = {
   apiBaseUrl: DEFAULT_API_BASE_URL,
-  clientId: DEFAULT_CLIENT,
+  clientId: getClient(),
   format: 'tilejson',
   headers: {},
   maxLengthURL: DEFAULT_MAX_LENGTH_URL,

package/src/sources/h3-query-source.ts

@@ -4,6 +4,7 @@
 
 /* eslint-disable camelcase */
 import {DEFAULT_AGGREGATION_RES_LEVEL_H3} from '../constants-internal';
+import {WidgetQuerySource, WidgetQuerySourceResult} from '../widget-sources';
 import {baseSource} from './base-source';
 import type {
   AggregationOptions,
@@ -30,7 +31,7 @@ type UrlParameters = {
 
 export const h3QuerySource = async function (
   options: H3QuerySourceOptions
-): Promise<TilejsonResult> {
+): Promise<TilejsonResult & WidgetQuerySourceResult> {
   const {
     aggregationExp,
     aggregationResLevel = DEFAULT_AGGREGATION_RES_LEVEL_H3,
@@ -55,9 +56,10 @@ export const h3QuerySource = async function (
   if (filters) {
     urlParameters.filters = filters;
   }
-  return baseSource<UrlParameters>(
-    'query',
-    options,
-    urlParameters
-  ) as Promise<TilejsonResult>;
+  return baseSource<UrlParameters>('query', options, urlParameters).then(
+    (result) => ({
+      ...(result as TilejsonResult),
+      widgetSource: new WidgetQuerySource(options),
+    })
+  );
 };

package/src/sources/h3-table-source.ts

@@ -4,6 +4,7 @@
 
 /* eslint-disable camelcase */
 import {DEFAULT_AGGREGATION_RES_LEVEL_H3} from '../constants-internal';
+import {WidgetTableSource, WidgetTableSourceResult} from '../widget-sources';
 import {baseSource} from './base-source';
 import type {
   AggregationOptions,
@@ -30,7 +31,7 @@ type UrlParameters = {
 
 export const h3TableSource = async function (
   options: H3TableSourceOptions
-): Promise<TilejsonResult> {
+): Promise<TilejsonResult & WidgetTableSourceResult> {
   const {
     aggregationExp,
     aggregationResLevel = DEFAULT_AGGREGATION_RES_LEVEL_H3,
@@ -51,9 +52,10 @@ export const h3TableSource = async function (
   if (filters) {
     urlParameters.filters = filters;
   }
-  return baseSource<UrlParameters>(
-    'table',
-    options,
-    urlParameters
-  ) as Promise<TilejsonResult>;
+  return baseSource<UrlParameters>('table', options, urlParameters).then(
+    (result) => ({
+      ...(result as TilejsonResult),
+      widgetSource: new WidgetTableSource(options),
+    })
+  );
 };

package/src/sources/quadbin-query-source.ts

@@ -4,6 +4,7 @@
 
 /* eslint-disable camelcase */
 import {DEFAULT_AGGREGATION_RES_LEVEL_QUADBIN} from '../constants-internal';
+import {WidgetQuerySource, WidgetQuerySourceResult} from '../widget-sources';
 import {baseSource} from './base-source';
 import type {
   AggregationOptions,
@@ -31,7 +32,7 @@ type UrlParameters = {
 
 export const quadbinQuerySource = async function (
   options: QuadbinQuerySourceOptions
-): Promise<TilejsonResult> {
+): Promise<TilejsonResult & WidgetQuerySourceResult> {
   const {
     aggregationExp,
     aggregationResLevel = DEFAULT_AGGREGATION_RES_LEVEL_QUADBIN,
@@ -56,9 +57,10 @@ export const quadbinQuerySource = async function (
   if (filters) {
     urlParameters.filters = filters;
   }
-  return baseSource<UrlParameters>(
-    'query',
-    options,
-    urlParameters
-  ) as Promise<TilejsonResult>;
+  return baseSource<UrlParameters>('query', options, urlParameters).then(
+    (result) => ({
+      ...(result as TilejsonResult),
+      widgetSource: new WidgetQuerySource(options),
+    })
+  );
 };

package/src/sources/quadbin-table-source.ts

@@ -4,6 +4,7 @@
 
 /* eslint-disable camelcase */
 import {DEFAULT_AGGREGATION_RES_LEVEL_QUADBIN} from '../constants-internal';
+import {WidgetTableSource, WidgetTableSourceResult} from '../widget-sources';
 import {baseSource} from './base-source';
 import type {
   AggregationOptions,
@@ -30,7 +31,7 @@ type UrlParameters = {
 
 export const quadbinTableSource = async function (
   options: QuadbinTableSourceOptions
-): Promise<TilejsonResult> {
+): Promise<TilejsonResult & WidgetTableSourceResult> {
   const {
     aggregationExp,
     aggregationResLevel = DEFAULT_AGGREGATION_RES_LEVEL_QUADBIN,
@@ -52,9 +53,10 @@ export const quadbinTableSource = async function (
   if (filters) {
     urlParameters.filters = filters;
   }
-  return baseSource<UrlParameters>(
-    'table',
-    options,
-    urlParameters
-  ) as Promise<TilejsonResult>;
+  return baseSource<UrlParameters>('table', options, urlParameters).then(
+    (result) => ({
+      ...(result as TilejsonResult),
+      widgetSource: new WidgetTableSource(options),
+    })
+  );
 };

package/src/sources/vector-query-source.ts

@@ -3,7 +3,11 @@
 // Copyright (c) vis.gl contributors
 
 /* eslint-disable camelcase */
-import {DEFAULT_TILE_RESOLUTION} from '../constants.js';
+import {DEFAULT_TILE_RESOLUTION} from '../constants-internal.js';
+import {
+  WidgetQuerySource,
+  WidgetQuerySourceResult,
+} from '../widget-sources/index.js';
 import {baseSource} from './base-source';
 import type {
   FilterOptions,
@@ -31,7 +35,7 @@ type UrlParameters = {
 
 export const vectorQuerySource = async function (
   options: VectorQuerySourceOptions
-): Promise<TilejsonResult> {
+): Promise<TilejsonResult & WidgetQuerySourceResult> {
   const {
     columns,
     filters,
@@ -57,9 +61,10 @@ export const vectorQuerySource = async function (
   if (queryParameters) {
     urlParameters.queryParameters = queryParameters;
   }
-  return baseSource<UrlParameters>(
-    'query',
-    options,
-    urlParameters
-  ) as Promise<TilejsonResult>;
+  return baseSource<UrlParameters>('query', options, urlParameters).then(
+    (result) => ({
+      ...(result as TilejsonResult),
+      widgetSource: new WidgetQuerySource(options),
+    })
+  );
 };

package/src/sources/vector-table-source.ts

@@ -3,7 +3,11 @@
 // Copyright (c) vis.gl contributors
 
 /* eslint-disable camelcase */
-import {DEFAULT_TILE_RESOLUTION} from '../constants.js';
+import {DEFAULT_TILE_RESOLUTION} from '../constants-internal.js';
+import {
+  WidgetTableSource,
+  WidgetTableSourceResult,
+} from '../widget-sources/index.js';
 import {baseSource} from './base-source';
 import type {
   FilterOptions,
@@ -29,7 +33,7 @@ type UrlParameters = {
 
 export const vectorTableSource = async function (
   options: VectorTableSourceOptions
-): Promise<TilejsonResult> {
+): Promise<TilejsonResult & WidgetTableSourceResult> {
   const {
     columns,
     filters,
@@ -51,9 +55,10 @@ export const vectorTableSource = async function (
   if (filters) {
     urlParameters.filters = filters;
   }
-  return baseSource<UrlParameters>(
-    'table',
-    options,
-    urlParameters
-  ) as Promise<TilejsonResult>;
+  return baseSource<UrlParameters>('table', options, urlParameters).then(
+    (result) => ({
+      ...(result as TilejsonResult),
+      widgetSource: new WidgetTableSource(options),
+    })
+  );
 };

package/src/types.ts

@@ -41,7 +41,6 @@ export interface Filters {
   [column: string]: Filter;
 }
 
-// TODO: Would `{[FilterType.IN]?: number[] | string[]}` also be valid?
 /** @internalRemarks Source: @carto/react-api, @deck.gl/carto */
 export interface Filter {
   [FilterType.IN]?: {owner?: string; values: number[] | string[]};

package/src/utils.ts

@@ -1,6 +1,5 @@
 import {Filter} from './types.js';
 import {FilterType} from './constants.js';
-import {$TODO} from './types-internal.js';
 
 const FILTER_TYPES = new Set(Object.values(FilterType));
 const isFilterType = (type: string): type is FilterType =>
@@ -26,7 +25,7 @@ export function getApplicableFilters(
       const isApplicable = !owner || !filter?.owner || filter?.owner !== owner;
       if (filter && isApplicable) {
         applicableFilters[column] ||= {};
-        applicableFilters[column][type] = filter as $TODO;
+        (applicableFilters[column][type] as typeof filter) = filter;
       }
     }
   }

package/src/widget-sources/index.ts

@@ -1,5 +1,4 @@
 export * from './widget-base-source.js';
 export * from './widget-query-source.js';
 export * from './widget-table-source.js';
-export * from './wrappers.js';
 export * from './types.js';

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

@@ -20,11 +20,11 @@ import {getApplicableFilters, normalizeObjectKeys} from '../utils.js';
 import {getClient} from '../client.js';
 import {ModelSource} from '../models/model.js';
 import {SourceOptions} from '../sources/index.js';
+import {ApiVersion} from '../constants.js';
 import {
-  ApiVersion,
   DEFAULT_API_BASE_URL,
   DEFAULT_GEO_COLUMN,
-} from '../constants.js';
+} from '../constants-internal.js';
 
 export interface WidgetBaseSourceProps extends Omit<SourceOptions, 'filters'> {
   apiVersion?: ApiVersion;

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

@@ -11,6 +11,8 @@ type LayerQuerySourceOptions =
   | Omit<H3QuerySourceOptions, 'filters'>
   | Omit<QuadbinQuerySourceOptions, 'filters'>;
 
+export type WidgetQuerySourceResult = {widgetSource: WidgetQuerySource};
+
 /**
  * Source for Widget API requests on a data source defined by a SQL query.
  *

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

@@ -11,6 +11,8 @@ type LayerTableSourceOptions =
   | Omit<H3TableSourceOptions, 'filters'>
   | Omit<QuadbinTableSourceOptions, 'filters'>;
 
+export type WidgetTableSourceResult = {widgetSource: WidgetTableSource};
+
 /**
  * Source for Widget API requests on a data source defined as a table.
  *