@tetrascience-npm/tetrascience-react-ui 0.7.0-beta.129.1 → 0.7.0-beta.131.1

package/dist/server/providers/providerDiscovery.d.ts

@@ -0,0 +1,81 @@
+import { ProviderConfiguration, ProviderInfo } from './types';
+/**
+ * Extract display-friendly provider information from full configurations.
+ *
+ * Returns a list of {@link ProviderInfo} objects containing name, type,
+ * iconUrl, and the names of available connection fields — suitable for
+ * populating UI dropdowns and selection lists without exposing secret values.
+ *
+ * @param configs - Array of provider configurations from getProviderConfigurations()
+ * @returns Array of display-friendly provider info objects
+ *
+ * @example
+ * ```typescript
+ * const configs = await getProviderConfigurations(client);
+ * const providerList = getProviderInfoList(configs);
+ * // [{ name: "my-snowflake", type: "snowflake", iconUrl: "...", availableFields: ["user", "password", "account"] }, ...]
+ * ```
+ */
+export declare function getProviderInfoList(configs: ProviderConfiguration[]): ProviderInfo[];
+/**
+ * Find a provider configuration by name.
+ *
+ * @param configs - Array of provider configurations from getProviderConfigurations()
+ * @param name - The provider name to search for (case-sensitive)
+ * @returns The matching provider configuration, or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const configs = await getProviderConfigurations(client);
+ * const snowflake = getProviderByName(configs, "my-snowflake-provider");
+ * if (snowflake) {
+ *   const provider = await buildProvider(snowflake);
+ * }
+ * ```
+ */
+export declare function getProviderByName(configs: ProviderConfiguration[], name: string): ProviderConfiguration | undefined;
+/**
+ * Find all provider configurations of a given type.
+ *
+ * @param configs - Array of provider configurations from getProviderConfigurations()
+ * @param type - The provider type to filter by (e.g., "snowflake", "databricks", "athena")
+ * @returns Array of matching provider configurations (may be empty)
+ *
+ * @example
+ * ```typescript
+ * const configs = await getProviderConfigurations(client);
+ * const snowflakeProviders = getProvidersByType(configs, "snowflake");
+ * for (const config of snowflakeProviders) {
+ *   console.log(`Found Snowflake provider: ${config.name}`);
+ * }
+ * ```
+ */
+export declare function getProvidersByType(configs: ProviderConfiguration[], type: string): ProviderConfiguration[];
+/**
+ * Get the names of all attached providers.
+ *
+ * @param configs - Array of provider configurations from getProviderConfigurations()
+ * @returns Array of provider names
+ *
+ * @example
+ * ```typescript
+ * const configs = await getProviderConfigurations(client);
+ * const names = getProviderNames(configs);
+ * // ["my-snowflake", "my-databricks", "my-athena"]
+ * ```
+ */
+export declare function getProviderNames(configs: ProviderConfiguration[]): string[];
+/**
+ * Get the unique provider types available.
+ *
+ * @param configs - Array of provider configurations from getProviderConfigurations()
+ * @returns Array of unique provider type strings
+ *
+ * @example
+ * ```typescript
+ * const configs = await getProviderConfigurations(client);
+ * const types = getProviderTypes(configs);
+ * // ["snowflake", "databricks"]
+ * ```
+ */
+export declare function getProviderTypes(configs: ProviderConfiguration[]): string[];

package/dist/server/providers/types.d.ts

@@ -0,0 +1,145 @@
+/**
+ * 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 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
+ */
+export 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
+ */
+export interface ProviderSecret {
+    name: string;
+    value?: string;
+    type: string;
+    required: boolean;
+    arn: string;
+    envName: string;
+}
+/**
+ * Full provider API response including secrets
+ */
+export 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}
+ */
+export 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
+ */
+export 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;
+}
+/**
+ * Options for getProviderConfigurations function
+ */
+export 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.
+ */
+export 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.
+ */
+export 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;
+}

package/dist/server/search/TdpSearchManager.d.ts

@@ -0,0 +1,40 @@
+import { ExpressRequestLike, JwtTokenManager } from '../auth/JwtTokenManager';
+import { SearchEqlRequest, SearchEqlResponse } from '@tetrascience-npm/ts-connectors-sdk';
+/** Configuration options for TdpSearchManager */
+export interface TdpSearchManagerConfig {
+    /** TDP API base URL. Defaults to TDP_ENDPOINT env var */
+    baseUrl?: string;
+    /** Organization slug. Defaults to ORG_SLUG env var */
+    orgSlug?: string;
+    /** Optional custom JwtTokenManager instance. Defaults to the shared jwtManager */
+    jwtManager?: JwtTokenManager;
+}
+/**
+ * Manages TDP search requests on the server: resolves auth from request cookies,
+ * creates a TDPClient with that token, and runs searchEql.
+ */
+export declare class TdpSearchManager {
+    private baseUrlOverride;
+    private orgSlugOverride;
+    private tokenManager;
+    constructor(config?: TdpSearchManagerConfig);
+    private getBaseUrl;
+    private getOrgSlug;
+    /** Strip undefined values; convert searchTerm to ES query so TDP API accepts the body. */
+    private toSearchEqlRequest;
+    /**
+     * Handle a search request: resolves the JWT from request cookies via
+     * jwtManager, calls TDP searchEql, and returns the response.
+     *
+     * @param req - Express-like request (cookies must carry a valid JWT)
+     * @param body - Search request body (searchTerm, from, size, sort, order, …)
+     * @returns Search response from TDP
+     * @throws Error if auth or config is missing, or TDP request fails
+     */
+    handleSearchRequest<TSource = Record<string, unknown>>(req: ExpressRequestLike, body: SearchEqlRequest): Promise<SearchEqlResponse<TSource>>;
+}
+/**
+ * Default singleton instance (uses TDP_ENDPOINT and ORG_SLUG from env,
+ * and the shared jwtManager for token resolution).
+ */
+export declare const tdpSearchManager: TdpSearchManager;

package/dist/server/search/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * TDP Search utilities for TetraScience data apps
+ */
+export { TdpSearchManager, tdpSearchManager } from './TdpSearchManager';
+export type { TdpSearchManagerConfig } from './TdpSearchManager';