@tetrascience-npm/tetrascience-react-ui 0.4.0-beta.8.1 → 0.4.0

package/dist/server.d.ts

@@ -1,525 +1,540 @@
-import { TDPClient } from '@tetrascience-npm/ts-connectors-sdk';
-import * as snowflake_sdk from 'snowflake-sdk';
-import * as _databricks_sql_dist_contracts_IDBSQLSession from '@databricks/sql/dist/contracts/IDBSQLSession';
-import * as _databricks_sql from '@databricks/sql';
-import * as _aws_sdk_client_athena from '@aws-sdk/client-athena';
+import { AthenaClient as AthenaClient_2 } from '@aws-sdk/client-athena';
+import { awsSdkClientAthena } from '@aws-sdk/client-athena';
+import { Connection } from 'snowflake-sdk';
+import { DBSQLClient as DBSQLClient_2 } from '@databricks/sql';
+import { default as default_2 } from '@databricks/sql/dist/contracts/IDBSQLSession';
+import { TDPClient } from '@tetrascience-npm/ts-connectors-sdk';
+
+/**
+ * Athena Data Provider
+ *
+ * TypeScript equivalent of AthenaProvider from
+ * ts-lib-ui-kit-streamlit/tetrascience/data_app_providers/provider.py
+ *
+ * @remarks
+ * This provider requires the `@aws-sdk/client-athena` package to be installed.
+ * It is an optional peer dependency - install it only if you need Athena support:
+ * ```bash
+ * npm install @aws-sdk/client-athena
+ * # or
+ * yarn add @aws-sdk/client-athena
+ * ```
+ */
+declare type AthenaClient = AthenaClient_2;
+
+/**
+ * Athena data provider
+ */
+export declare class AthenaProvider {
+    private client;
+    private sdk;
+    private workgroup;
+    private database;
+    private outputLocation?;
+    /**
+     * Initialize the Athena data provider
+     *
+     * @param client - AWS Athena client
+     * @param sdk - AWS Athena SDK module (for accessing command classes)
+     * @param workgroup - Athena workgroup to use
+     * @param database - Default database/schema
+     * @param outputLocation - Optional S3 output location
+     */
+    constructor(client: AthenaClient, sdk: AthenaSDK, workgroup: string, database: string, outputLocation?: string);
+    /**
+     * Query the Athena database
+     *
+     * @param sqlQuery - SQL query to execute
+     * @param _params - Parameters to pass to the query (currently not used - Athena doesn't support parameterized queries)
+     * @returns Promise resolving to array of row objects
+     *
+     * @remarks
+     * **Security Note:** AWS Athena does not support parameterized queries.
+     * Unlike traditional databases, there is no native way to use bind parameters
+     * with Athena. Callers are responsible for properly sanitizing any user input
+     * before constructing the SQL query string. This is a known limitation of the
+     * Athena service, not a design flaw in this implementation.
+     */
+    query(sqlQuery: string, _params?: Record<string, unknown>): Promise<Array<Record<string, unknown>>>;
+    /**
+     * Wait for query to complete
+     */
+    private waitForQueryCompletion;
+    /**
+     * Fetch all results from a completed query
+     */
+    private fetchAllResults;
+    /**
+     * Close the Athena client (no-op for AWS SDK clients)
+     */
+    close(): Promise<void>;
+}
+
+declare type AthenaSDK = awsSdkClientAthena;
+
+/**
+ * Build a Databricks data provider from the configuration
+ *
+ * @param config - Provider configuration
+ * @returns Promise resolving to Databricks data provider
+ * @throws {InvalidProviderConfigurationError} If @databricks/sql is not installed or config is invalid
+ */
+export declare function buildDatabricksProvider(config: ProviderConfiguration): Promise<DatabricksProvider>;
+
+/**
+ * Build a data provider from the configuration
+ *
+ * The return type is a union of specific provider types. More provider types
+ * may be added in the future.
+ *
+ * @param config - Provider configuration
+ * @returns Promise resolving to the appropriate data provider
+ * @throws {InvalidProviderConfigurationError} If the provider type is not supported
+ *
+ * @example
+ * ```typescript
+ * import { TDPClient } from '@tetrascience-npm/ts-connectors-sdk';
+ * import { buildProvider, getProviderConfigurations } from '@tetrascience-npm/tetrascience-react-ui/server';
+ *
+ * // Other fields (tdpEndpoint, connectorId, orgSlug) are read from environment variables
+ * const client = new TDPClient({
+ *   authToken: userJwt,
+ *   artifactType: "data-app",
+ * });
+ * await client.init();
+ * const configs = await getProviderConfigurations(client);
+ *
+ * const snowflakeConfig = configs.find(c => c.type === 'snowflake');
+ * if (snowflakeConfig) {
+ *   const provider = await buildProvider(snowflakeConfig);
+ *   const results = await provider.query('SELECT * FROM my_table');
+ * }
+ * ```
+ */
+export declare function buildProvider(config: ProviderConfiguration): Promise<DataProvider>;
+
+/**
+ * Build a Snowflake data provider from the configuration
+ *
+ * @param config - Provider configuration
+ * @returns Promise resolving to Snowflake data provider
+ * @throws {InvalidProviderConfigurationError} If snowflake-sdk is not installed or config is invalid
+ */
+export declare function buildSnowflakeProvider(config: ProviderConfiguration): Promise<SnowflakeProvider>;
+
+/**
+ * Container data app response from /dataapps/apps/container/{connectorId}
+ */
+export declare interface ContainerDataApp {
+    id: string;
+    orgSlug: string;
+    connectorId: string;
+    serviceNamespace: string;
+    serviceDiscoveryName: string;
+    createdAt: string;
+    updatedAt?: string;
+    createdBy: string;
+    updatedBy?: string;
+    port: string;
+    config: Record<string, unknown>;
+    providers: MinimalProvider[];
+}
+
+/** Cookie dictionary type - matches Express req.cookies */
+export declare interface CookieDict {
+    [key: string]: string;
+}
+
+/**
+ * Databricks data provider
+ */
+export declare class DatabricksProvider {
+    private client;
+    private session;
+    /**
+     * Initialize the Databricks data provider
+     *
+     * @param client - Databricks SQL client
+     * @param session - Databricks SQL session
+     */
+    constructor(client: DBSQLClient, session: IDBSQLSession);
+    /**
+     * Query the Databricks database
+     *
+     * @param sqlQuery - SQL query to execute
+     * @param _params - Parameters to pass to the query (currently not used)
+     * @returns Promise resolving to array of row objects
+     */
+    query(sqlQuery: string, _params?: Record<string, unknown>): Promise<Array<Record<string, unknown>>>;
+    /**
+     * Close the Databricks connection
+     */
+    close(): Promise<void>;
+}
+
+/**
+ * Union type of all supported data providers
+ */
+export declare type DataProvider = SnowflakeProvider | DatabricksProvider | AthenaProvider;
+
+declare type DBSQLClient = DBSQLClient_2;
+
+/** Express-like request interface (works with Express, Koa, etc.) */
+export declare interface ExpressRequestLike {
+    cookies?: CookieDict;
+}
+
+/**
+ * Get the provider configurations.
+ *
+ * There are two ways to get the provider configurations:
+ * 1. If the environment variable `DATA_APP_PROVIDER_CONFIG` is set or
+ *    providerConfigOverride is provided, the provider configurations are read from it.
+ * 2. If the environment variable `CONNECTOR_ID` is set or connectorId is provided,
+ *    the provider configurations are fetched from TDP. The secrets are read from
+ *    environment variables.
+ * 3. If neither of the above is set, an empty array is returned.
+ *
+ * Option 1 is used for local development to specify the provider configurations directly.
+ * Option 2 is used in production to fetch the provider configurations from TDP.
+ *
+ * @param client - Initialized TDPClient instance (call client.init() first)
+ * @param options - Optional configuration overrides
+ * @returns Array of provider configurations
+ * @throws {InvalidProviderConfigurationError} If provider config JSON is invalid
+ * @throws {Error} If TDPClient is not initialized
+ *
+ * @example
+ * ```typescript
+ * import { TDPClient } from '@tetrascience-npm/ts-connectors-sdk';
+ * import { getProviderConfigurations } from '@tetrascience-npm/tetrascience-react-ui/server';
+ *
+ * // Initialize TDPClient with user's JWT token
+ * // Other fields (tdpEndpoint, connectorId, orgSlug) are read from environment variables
+ * const client = new TDPClient({
+ *   authToken: userJwtToken, // from jwtManager.getTokenFromExpressRequest(req)
+ *   artifactType: "data-app",
+ * });
+ * await client.init();
+ *
+ * const providers = await getProviderConfigurations(client);
+ *
+ * for (const provider of providers) {
+ *   console.log(`Provider: ${provider.name} (${provider.type})`);
+ * }
+ * ```
+ */
+export declare function getProviderConfigurations(client: TDPClient, options?: GetProviderConfigurationsOptions): Promise<ProviderConfiguration[]>;
+
+/**
+ * Options for getProviderConfigurations function
+ */
+export declare interface GetProviderConfigurationsOptions {
+    /** Override provider configurations JSON (for local development) */
+    providerConfigOverride?: string;
+    /** Connector ID (defaults to CONNECTOR_ID env var) */
+    connectorId?: string;
+}
+
+/**
+ * Get the TDP Athena provider
+ *
+ * Creates an Athena provider using TDP environment configuration
+ *
+ * @returns Promise resolving to Athena data provider
+ * @throws {InvalidProviderConfigurationError} If @aws-sdk/client-athena is not installed
+ * @throws {Error} If ATHENA_S3_OUTPUT_LOCATION is not set when using the 'primary' workgroup
+ */
+export declare function getTdpAthenaProvider(): Promise<AthenaProvider>;
+
+declare type IDBSQLSession = default_2;
+
+/**
+ * Raised when the provider configuration is invalid
+ */
+export declare class InvalidProviderConfigurationError extends ProviderError {
+    constructor(message: string);
+}
+
+/**
+ * Global singleton instance.
+ *
+ * Note: This instance is created when the module is imported. Configuration
+ * that depends on environment variables (CONNECTOR_ID, ORG_SLUG, TDP_ENDPOINT)
+ * is read at module load time. Ensure these environment
+ * variables are set before importing this module.
+ *
+ * If you need different configuration at runtime, create a new JwtTokenManager
+ * instance instead of using this singleton.
+ */
+export declare const jwtManager: JwtTokenManager;
+
+/**
+ * Manages JWT token retrieval from request cookies.
+ * Supports both ts-auth-token (direct JWT) and ts-token-ref (resolved via connector store).
+ */
+export declare class JwtTokenManager {
+    private baseUrlOverride;
+    private connectorId;
+    private orgSlug;
+    private tokenCache;
+    private tokenRefreshThresholdMs;
+    private tdpClient;
+    constructor(config?: JwtTokenManagerConfig);
+    /**
+     * Get the base URL for TDP API calls.
+     * Throws an error if not configured (either via config.baseUrl or TDP_ENDPOINT env var).
+     */
+    private getBaseUrl;
+    /**
+     * Decode JWT payload without verifying signature.
+     * Used only for reading expiration times for cache invalidation.
+     * Signature verification is NOT performed here.
+     */
+    private decodeJwtPayload;
+    /** Check if payload is expiring within the refresh threshold */
+    private isPayloadExpiringSoon;
+    /** Get valid cached token if not expiring */
+    private getValidUserJwt;
+    /** Initialize or get TDP client */
+    private getTdpClient;
+    /** Retrieve JWT from connector K/V store using getValues (calls getConnectorData internally) */
+    private getJwtFromTokenRefInternal;
+    /** Resolve ts-token-ref to full JWT token (with caching) */
+    getJwtFromTokenRef(tokenRef: string): Promise<string | null>;
+    /** Get token from cookies (ts-auth-token or resolved ts-token-ref) */
+    getUserToken(cookies: CookieDict): Promise<string | null>;
+    /**
+     * Get user token from an Express request object.
+     * This is the primary method for Express middleware integration.
+     *
+     * @example
+     * ```typescript
+     * import { jwtManager } from '@tetrascience-npm/tetrascience-react-ui/server';
+     *
+     * app.use(async (req, res, next) => {
+     *   const token = await jwtManager.getTokenFromExpressRequest(req);
+     *   req.tdpAuth = { token, orgSlug: process.env.ORG_SLUG };
+     *   next();
+     * });
+     * ```
+     */
+    getTokenFromExpressRequest(req: ExpressRequestLike): Promise<string | null>;
+    /** Clear the token cache */
+    clearCache(): void;
+}
+
+/**
+ * JWT Token Manager for TetraScience Data Apps
+ *
+ * Handles authentication token retrieval from Express request cookies,
+ * supporting both direct JWT tokens (ts-auth-token) and token references
+ * (ts-token-ref) that are resolved via the connector K/V store.
+ *
+ * Note: This manager does not perform cryptographic verification of JWT signatures.
+ * Signature verification is the responsibility of the consuming application or
+ * the upstream authentication layer. The JWT payload is decoded only to read
+ * expiration times for cache invalidation.
+ */
+/** Configuration options for JwtTokenManager */
+export declare interface JwtTokenManagerConfig {
+    baseUrl?: string;
+    tokenRefreshThresholdMs?: number;
+}
+
+/**
+ * Minimal provider information as returned by the /dataapps/apps/{appId} endpoint
+ */
+export declare interface MinimalProvider {
+    id: string;
+    orgSlug: string;
+    name: string;
+    type: string;
+    iconUrl: string;
+    createdAt: string;
+    updatedAt?: string;
+    createdBy: string;
+    updatedBy?: string;
+}
+
+/**
+ * Raised when a table is missing in the database
+ */
+export declare class MissingTableError extends ProviderError {
+    constructor(message: string);
+}
+
+/**
+ * Organization API response
+ */
+export declare interface OrganizationApiResponse {
+    id: string;
+    orgSlug: string;
+    name: string;
+    emailDomain: string;
+    authType: string;
+    features: Record<string, unknown>;
+    tenantId: string;
+    createdAt: string;
+    createdBy: string;
+    modifiedAt?: string;
+    modifiedBy?: string;
+    subdomain: string;
+    ssoEnabledOnTenant: boolean;
+}
+
+/**
+ * Full provider API response including secrets
+ */
+export declare interface ProviderApiResponse {
+    id: string;
+    orgSlug: string;
+    name: string;
+    type: string;
+    iconUrl: string;
+    createdAt: string;
+    updatedAt?: string;
+    createdBy: string;
+    updatedBy?: string;
+    dataAppCount: string;
+    secrets: ProviderSecret[];
+}
+
+/**
+ * Data App Provider Types
+ *
+ * TypeScript equivalents of the Python ProviderConfiguration Pydantic models
+ * from ts-lib-ui-kit-streamlit/tetrascience/data_app_providers/provider_typing.py
+ */
+/**
+ * Configuration model for data providers.
+ *
+ * This interface represents the configuration needed to connect to various
+ * database providers (Snowflake, Databricks, Athena, Benchling, etc.)
+ * attached to a data app.
+ */
+export declare interface ProviderConfiguration {
+    /** Human-readable name of the provider */
+    name: string;
+    /** Provider type (snowflake, databricks, benchling, custom, etc.) */
+    type: string;
+    /** Optional URL to the provider's icon */
+    iconUrl?: string;
+    /** Dictionary containing connection details and credentials */
+    fields: Record<string, string | undefined>;
+}
+
+/**
+ * Raised when connecting to a provider fails
+ */
+export declare class ProviderConnectionError extends ProviderError {
+    constructor(message: string);
+}
+
+/**
+ * Provider Exceptions
+ *
+ * TypeScript equivalents of the Python exceptions from
+ * ts-lib-ui-kit-streamlit/tetrascience/data_app_providers/exceptions.py
+ */
+/**
+ * Base class for provider errors
+ */
+export declare class ProviderError extends Error {
+    constructor(message: string);
+}
+
+/**
+ * Display-friendly provider information for UI components.
+ *
+ * A simplified subset of ProviderConfiguration containing only the
+ * fields needed for displaying provider information in the UI,
+ * including the names of available connection fields without their
+ * secret values.
+ */
+export declare interface ProviderInfo {
+    /** Human-readable name of the provider */
+    name: string;
+    /** Provider type (snowflake, databricks, athena, etc.) */
+    type: string;
+    /** Optional URL to the provider's icon */
+    iconUrl?: string | null;
+    /** Names of available connection fields (without secret values) */
+    availableFields: string[];
+}
+
+/**
+ * Provider secret information from the provider API response
+ */
+export declare interface ProviderSecret {
+    name: string;
+    value?: string;
+    type: string;
+    required: boolean;
+    arn: string;
+    envName: string;
+}
+
+/**
+ * Raised when a query fails
+ */
+export declare class QueryError extends ProviderError {
+    constructor(message: string);
+}
+
+/**
+ * Standardized query result from data providers.
+ *
+ * This interface provides a consistent shape for query results across
+ * all provider types (Snowflake, Databricks, Athena), with optional
+ * metadata for API responses.
+ */
+export declare interface QueryResult {
+    /** Array of row objects returned by the query */
+    data: Array<Record<string, unknown>>;
+    /** Number of rows returned */
+    rowCount: number;
+    /** Name of the provider that executed the query */
+    provider?: string;
+    /** Whether this is mock/demo data */
+    mock?: boolean;
+    /** Optional message (e.g., for errors or warnings) */
+    message?: string;
+}
+
+declare type SnowflakeConnection = Connection;
+
+/**
+ * Snowflake data provider
+ */
+export declare class SnowflakeProvider {
+    private connection;
+    /**
+     * Initialize the Snowflake data provider
+     *
+     * @param connection - Snowflake connection
+     */
+    constructor(connection: SnowflakeConnection);
+    /**
+     * Query the Snowflake database
+     *
+     * @param sqlText - SQL query to execute
+     * @param params - Parameters to pass to the query. For positional binds, use an array.
+     *                 For named binds, use an object with keys matching the bind variable names.
+     * @returns Promise resolving to array of row objects
+     */
+    query(sqlText: string, params?: Record<string, unknown> | unknown[]): Promise<Array<Record<string, unknown>>>;
+    /**
+     * Close the Snowflake connection
+     */
+    close(): Promise<void>;
+}
+
+export { }
 
-/**
- * JWT Token Manager for TetraScience Data Apps
- *
- * Handles authentication token retrieval from Express request cookies,
- * supporting both direct JWT tokens (ts-auth-token) and token references
- * (ts-token-ref) that are resolved via the connector K/V store.
- *
- * Note: This manager does not perform cryptographic verification of JWT signatures.
- * Signature verification is the responsibility of the consuming application or
- * the upstream authentication layer. The JWT payload is decoded only to read
- * expiration times for cache invalidation.
- */
-/** Configuration options for JwtTokenManager */
-interface JwtTokenManagerConfig {
-    baseUrl?: string;
-    tokenRefreshThresholdMs?: number;
-}
-/** Cookie dictionary type - matches Express req.cookies */
-interface CookieDict {
-    [key: string]: string;
-}
-/** Express-like request interface (works with Express, Koa, etc.) */
-interface ExpressRequestLike {
-    cookies?: CookieDict;
-}
-/**
- * Manages JWT token retrieval from request cookies.
- * Supports both ts-auth-token (direct JWT) and ts-token-ref (resolved via connector store).
- */
-declare class JwtTokenManager {
-    private baseUrlOverride;
-    private connectorId;
-    private orgSlug;
-    private tokenCache;
-    private tokenRefreshThresholdMs;
-    private tdpClient;
-    constructor(config?: JwtTokenManagerConfig);
-    /**
-     * Get the base URL for TDP API calls.
-     * Throws an error if not configured (either via config.baseUrl or TDP_ENDPOINT env var).
-     */
-    private getBaseUrl;
-    /**
-     * Decode JWT payload without verifying signature.
-     * Used only for reading expiration times for cache invalidation.
-     * Signature verification is NOT performed here.
-     */
-    private decodeJwtPayload;
-    /** Check if payload is expiring within the refresh threshold */
-    private isPayloadExpiringSoon;
-    /** Get valid cached token if not expiring */
-    private getValidUserJwt;
-    /** Initialize or get TDP client */
-    private getTdpClient;
-    /** Retrieve JWT from connector K/V store using getValues (calls getConnectorData internally) */
-    private getJwtFromTokenRefInternal;
-    /** Resolve ts-token-ref to full JWT token (with caching) */
-    getJwtFromTokenRef(tokenRef: string): Promise<string | null>;
-    /** Get token from cookies (ts-auth-token or resolved ts-token-ref) */
-    getUserToken(cookies: CookieDict): Promise<string | null>;
-    /**
-     * Get user token from an Express request object.
-     * This is the primary method for Express middleware integration.
-     *
-     * @example
-     * ```typescript
-     * import { jwtManager } from '@tetrascience-npm/tetrascience-react-ui/server';
-     *
-     * app.use(async (req, res, next) => {
-     *   const token = await jwtManager.getTokenFromExpressRequest(req);
-     *   req.tdpAuth = { token, orgSlug: process.env.ORG_SLUG };
-     *   next();
-     * });
-     * ```
-     */
-    getTokenFromExpressRequest(req: ExpressRequestLike): Promise<string | null>;
-    /** Clear the token cache */
-    clearCache(): void;
-}
-/**
- * Global singleton instance.
- *
- * Note: This instance is created when the module is imported. Configuration
- * that depends on environment variables (CONNECTOR_ID, ORG_SLUG, TDP_ENDPOINT)
- * is read at module load time. Ensure these environment
- * variables are set before importing this module.
- *
- * If you need different configuration at runtime, create a new JwtTokenManager
- * instance instead of using this singleton.
- */
-declare const jwtManager: JwtTokenManager;
 
-/**
- * Provider Exceptions
- *
- * TypeScript equivalents of the Python exceptions from
- * ts-lib-ui-kit-streamlit/tetrascience/data_app_providers/exceptions.py
- */
-/**
- * Base class for provider errors
- */
-declare class ProviderError extends Error {
-    constructor(message: string);
-}
-/**
- * Raised when a table is missing in the database
- */
-declare class MissingTableError extends ProviderError {
-    constructor(message: string);
-}
-/**
- * Raised when a query fails
- */
-declare class QueryError extends ProviderError {
-    constructor(message: string);
-}
-/**
- * Raised when connecting to a provider fails
- */
-declare class ProviderConnectionError extends ProviderError {
-    constructor(message: string);
-}
-/**
- * Raised when the provider configuration is invalid
- */
-declare class InvalidProviderConfigurationError extends ProviderError {
-    constructor(message: string);
-}
-
-/**
- * Data App Provider Types
- *
- * TypeScript equivalents of the Python ProviderConfiguration Pydantic models
- * from ts-lib-ui-kit-streamlit/tetrascience/data_app_providers/provider_typing.py
- */
-/**
- * Configuration model for data providers.
- *
- * This interface represents the configuration needed to connect to various
- * database providers (Snowflake, Databricks, Athena, Benchling, etc.)
- * attached to a data app.
- */
-interface ProviderConfiguration {
-    /** Human-readable name of the provider */
-    name: string;
-    /** Provider type (snowflake, databricks, benchling, custom, etc.) */
-    type: string;
-    /** Optional URL to the provider's icon */
-    iconUrl?: string;
-    /** Dictionary containing connection details and credentials */
-    fields: Record<string, string | undefined>;
-}
-/**
- * Minimal provider information as returned by the /dataapps/apps/{appId} endpoint
- */
-interface MinimalProvider {
-    id: string;
-    orgSlug: string;
-    name: string;
-    type: string;
-    iconUrl: string;
-    createdAt: string;
-    updatedAt?: string;
-    createdBy: string;
-    updatedBy?: string;
-}
-/**
- * Provider secret information from the provider API response
- */
-interface ProviderSecret {
-    name: string;
-    value?: string;
-    type: string;
-    required: boolean;
-    arn: string;
-    envName: string;
-}
-/**
- * Full provider API response including secrets
- */
-interface ProviderApiResponse {
-    id: string;
-    orgSlug: string;
-    name: string;
-    type: string;
-    iconUrl: string;
-    createdAt: string;
-    updatedAt?: string;
-    createdBy: string;
-    updatedBy?: string;
-    dataAppCount: string;
-    secrets: ProviderSecret[];
-}
-/**
- * Container data app response from /dataapps/apps/container/{connectorId}
- */
-interface ContainerDataApp {
-    id: string;
-    orgSlug: string;
-    connectorId: string;
-    serviceNamespace: string;
-    serviceDiscoveryName: string;
-    createdAt: string;
-    updatedAt?: string;
-    createdBy: string;
-    updatedBy?: string;
-    port: string;
-    config: Record<string, unknown>;
-    providers: MinimalProvider[];
-}
-/**
- * Organization API response
- */
-interface OrganizationApiResponse {
-    id: string;
-    orgSlug: string;
-    name: string;
-    emailDomain: string;
-    authType: string;
-    features: Record<string, unknown>;
-    tenantId: string;
-    createdAt: string;
-    createdBy: string;
-    modifiedAt?: string;
-    modifiedBy?: string;
-    subdomain: string;
-    ssoEnabledOnTenant: boolean;
+declare module "styled-components" {
+    interface DefaultTheme {
+        position: ToastPosition;
+    }
 }
-/**
- * Options for getProviderConfigurations function
- */
-interface GetProviderConfigurationsOptions {
-    /** Override provider configurations JSON (for local development) */
-    providerConfigOverride?: string;
-    /** Connector ID (defaults to CONNECTOR_ID env var) */
-    connectorId?: string;
-}
-/**
- * Display-friendly provider information for UI components.
- *
- * A simplified subset of ProviderConfiguration containing only the
- * fields needed for displaying provider information in the UI,
- * including the names of available connection fields without their
- * secret values.
- */
-interface ProviderInfo {
-    /** Human-readable name of the provider */
-    name: string;
-    /** Provider type (snowflake, databricks, athena, etc.) */
-    type: string;
-    /** Optional URL to the provider's icon */
-    iconUrl?: string | null;
-    /** Names of available connection fields (without secret values) */
-    availableFields: string[];
-}
-/**
- * Standardized query result from data providers.
- *
- * This interface provides a consistent shape for query results across
- * all provider types (Snowflake, Databricks, Athena), with optional
- * metadata for API responses.
- */
-interface QueryResult {
-    /** Array of row objects returned by the query */
-    data: Array<Record<string, unknown>>;
-    /** Number of rows returned */
-    rowCount: number;
-    /** Name of the provider that executed the query */
-    provider?: string;
-    /** Whether this is mock/demo data */
-    mock?: boolean;
-    /** Optional message (e.g., for errors or warnings) */
-    message?: string;
-}
-
-/**
- * Get Provider Configurations
- *
- * TypeScript equivalent of get_provider_configurations from
- * ts-lib-ui-kit-streamlit/tetrascience/data_app_providers/provider.py
- *
- * Retrieves data app provider configurations either from environment variable
- * override or by fetching from the TDP API.
- */
-
-/**
- * Get the provider configurations.
- *
- * There are two ways to get the provider configurations:
- * 1. If the environment variable `DATA_APP_PROVIDER_CONFIG` is set or
- *    providerConfigOverride is provided, the provider configurations are read from it.
- * 2. If the environment variable `CONNECTOR_ID` is set or connectorId is provided,
- *    the provider configurations are fetched from TDP. The secrets are read from
- *    environment variables.
- * 3. If neither of the above is set, an empty array is returned.
- *
- * Option 1 is used for local development to specify the provider configurations directly.
- * Option 2 is used in production to fetch the provider configurations from TDP.
- *
- * @param client - Initialized TDPClient instance (call client.init() first)
- * @param options - Optional configuration overrides
- * @returns Array of provider configurations
- * @throws {InvalidProviderConfigurationError} If provider config JSON is invalid
- * @throws {Error} If TDPClient is not initialized
- *
- * @example
- * ```typescript
- * import { TDPClient } from '@tetrascience-npm/ts-connectors-sdk';
- * import { getProviderConfigurations } from '@tetrascience-npm/tetrascience-react-ui/server';
- *
- * // Initialize TDPClient with user's JWT token
- * // Other fields (tdpEndpoint, connectorId, orgSlug) are read from environment variables
- * const client = new TDPClient({
- *   authToken: userJwtToken, // from jwtManager.getTokenFromExpressRequest(req)
- *   artifactType: "data-app",
- * });
- * await client.init();
- *
- * const providers = await getProviderConfigurations(client);
- *
- * for (const provider of providers) {
- *   console.log(`Provider: ${provider.name} (${provider.type})`);
- * }
- * ```
- */
-declare function getProviderConfigurations(client: TDPClient, options?: GetProviderConfigurationsOptions): Promise<ProviderConfiguration[]>;
-
-type SnowflakeConnection = snowflake_sdk.Connection;
-/**
- * Snowflake data provider
- */
-declare class SnowflakeProvider {
-    private connection;
-    /**
-     * Initialize the Snowflake data provider
-     *
-     * @param connection - Snowflake connection
-     */
-    constructor(connection: SnowflakeConnection);
-    /**
-     * Query the Snowflake database
-     *
-     * @param sqlText - SQL query to execute
-     * @param params - Parameters to pass to the query. For positional binds, use an array.
-     *                 For named binds, use an object with keys matching the bind variable names.
-     * @returns Promise resolving to array of row objects
-     */
-    query(sqlText: string, params?: Record<string, unknown> | unknown[]): Promise<Array<Record<string, unknown>>>;
-    /**
-     * Close the Snowflake connection
-     */
-    close(): Promise<void>;
-}
-/**
- * Build a Snowflake data provider from the configuration
- *
- * @param config - Provider configuration
- * @returns Promise resolving to Snowflake data provider
- * @throws {InvalidProviderConfigurationError} If snowflake-sdk is not installed or config is invalid
- */
-declare function buildSnowflakeProvider(config: ProviderConfiguration): Promise<SnowflakeProvider>;
-
-type DBSQLClient = _databricks_sql.DBSQLClient;
-type IDBSQLSession = _databricks_sql_dist_contracts_IDBSQLSession.default;
-/**
- * Databricks data provider
- */
-declare class DatabricksProvider {
-    private client;
-    private session;
-    /**
-     * Initialize the Databricks data provider
-     *
-     * @param client - Databricks SQL client
-     * @param session - Databricks SQL session
-     */
-    constructor(client: DBSQLClient, session: IDBSQLSession);
-    /**
-     * Query the Databricks database
-     *
-     * @param sqlQuery - SQL query to execute
-     * @param _params - Parameters to pass to the query (currently not used)
-     * @returns Promise resolving to array of row objects
-     */
-    query(sqlQuery: string, _params?: Record<string, unknown>): Promise<Array<Record<string, unknown>>>;
-    /**
-     * Close the Databricks connection
-     */
-    close(): Promise<void>;
-}
-/**
- * Build a Databricks data provider from the configuration
- *
- * @param config - Provider configuration
- * @returns Promise resolving to Databricks data provider
- * @throws {InvalidProviderConfigurationError} If @databricks/sql is not installed or config is invalid
- */
-declare function buildDatabricksProvider(config: ProviderConfiguration): Promise<DatabricksProvider>;
-
-/**
- * Athena Data Provider
- *
- * TypeScript equivalent of AthenaProvider from
- * ts-lib-ui-kit-streamlit/tetrascience/data_app_providers/provider.py
- *
- * @remarks
- * This provider requires the `@aws-sdk/client-athena` package to be installed.
- * It is an optional peer dependency - install it only if you need Athena support:
- * ```bash
- * npm install @aws-sdk/client-athena
- * # or
- * yarn add @aws-sdk/client-athena
- * ```
- */
-type AthenaClient = _aws_sdk_client_athena.AthenaClient;
-type AthenaSDK = typeof _aws_sdk_client_athena;
-/**
- * Athena data provider
- */
-declare class AthenaProvider {
-    private client;
-    private sdk;
-    private workgroup;
-    private database;
-    private outputLocation?;
-    /**
-     * Initialize the Athena data provider
-     *
-     * @param client - AWS Athena client
-     * @param sdk - AWS Athena SDK module (for accessing command classes)
-     * @param workgroup - Athena workgroup to use
-     * @param database - Default database/schema
-     * @param outputLocation - Optional S3 output location
-     */
-    constructor(client: AthenaClient, sdk: AthenaSDK, workgroup: string, database: string, outputLocation?: string);
-    /**
-     * Query the Athena database
-     *
-     * @param sqlQuery - SQL query to execute
-     * @param _params - Parameters to pass to the query (currently not used - Athena doesn't support parameterized queries)
-     * @returns Promise resolving to array of row objects
-     *
-     * @remarks
-     * **Security Note:** AWS Athena does not support parameterized queries.
-     * Unlike traditional databases, there is no native way to use bind parameters
-     * with Athena. Callers are responsible for properly sanitizing any user input
-     * before constructing the SQL query string. This is a known limitation of the
-     * Athena service, not a design flaw in this implementation.
-     */
-    query(sqlQuery: string, _params?: Record<string, unknown>): Promise<Array<Record<string, unknown>>>;
-    /**
-     * Wait for query to complete
-     */
-    private waitForQueryCompletion;
-    /**
-     * Fetch all results from a completed query
-     */
-    private fetchAllResults;
-    /**
-     * Close the Athena client (no-op for AWS SDK clients)
-     */
-    close(): Promise<void>;
-}
-/**
- * Get the TDP Athena provider
- *
- * Creates an Athena provider using TDP environment configuration
- *
- * @returns Promise resolving to Athena data provider
- * @throws {InvalidProviderConfigurationError} If @aws-sdk/client-athena is not installed
- * @throws {Error} If ATHENA_S3_OUTPUT_LOCATION is not set when using the 'primary' workgroup
- */
-declare function getTdpAthenaProvider(): Promise<AthenaProvider>;
-
-/**
- * Build Provider Factory
- *
- * TypeScript equivalent of build_provider from
- * ts-lib-ui-kit-streamlit/tetrascience/data_app_providers/provider.py
- */
-
-/**
- * Union type of all supported data providers
- */
-type DataProvider = SnowflakeProvider | DatabricksProvider | AthenaProvider;
-/**
- * Build a data provider from the configuration
- *
- * The return type is a union of specific provider types. More provider types
- * may be added in the future.
- *
- * @param config - Provider configuration
- * @returns Promise resolving to the appropriate data provider
- * @throws {InvalidProviderConfigurationError} If the provider type is not supported
- *
- * @example
- * ```typescript
- * import { TDPClient } from '@tetrascience-npm/ts-connectors-sdk';
- * import { buildProvider, getProviderConfigurations } from '@tetrascience-npm/tetrascience-react-ui/server';
- *
- * // Other fields (tdpEndpoint, connectorId, orgSlug) are read from environment variables
- * const client = new TDPClient({
- *   authToken: userJwt,
- *   artifactType: "data-app",
- * });
- * await client.init();
- * const configs = await getProviderConfigurations(client);
- *
- * const snowflakeConfig = configs.find(c => c.type === 'snowflake');
- * if (snowflakeConfig) {
- *   const provider = await buildProvider(snowflakeConfig);
- *   const results = await provider.query('SELECT * FROM my_table');
- * }
- * ```
- */
-declare function buildProvider(config: ProviderConfiguration): Promise<DataProvider>;
-
-export { AthenaProvider, DatabricksProvider, InvalidProviderConfigurationError, JwtTokenManager, MissingTableError, ProviderConnectionError, ProviderError, QueryError, SnowflakeProvider, buildDatabricksProvider, buildProvider, buildSnowflakeProvider, getProviderConfigurations, getTdpAthenaProvider, jwtManager };
-export type { ContainerDataApp, CookieDict, DataProvider, ExpressRequestLike, GetProviderConfigurationsOptions, JwtTokenManagerConfig, MinimalProvider, OrganizationApiResponse, ProviderApiResponse, ProviderConfiguration, ProviderInfo, ProviderSecret, QueryResult };