@tetrascience-npm/tetrascience-react-ui 0.7.0 → 1.0.0

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

@@ -0,0 +1,38 @@
+import { ProviderConfiguration } from './types';
+type DBSQLClient = import('@databricks/sql').DBSQLClient;
+type IDBSQLSession = import('@databricks/sql/dist/contracts/IDBSQLSession').default;
+/**
+ * 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>;
+}
+/**
+ * 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>;
+export {};

package/dist/server/providers/SnowflakeProvider.cjs

@@ -1,2 +1,2 @@
-"use strict";var f=Object.create;var u=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var k=Object.getOwnPropertyNames;var m=Object.getPrototypeOf,S=Object.prototype.hasOwnProperty;var p=(e,n,o,s)=>{if(n&&typeof n=="object"||typeof n=="function")for(let t of k(n))!S.call(e,t)&&t!==o&&u(e,t,{get:()=>n[t],enumerable:!(s=h(n,t))||s.enumerable});return e};var v=(e,n,o)=>(o=e!=null?f(m(e)):{},p(n||!e||!e.__esModule?u(o,"default",{value:e,enumerable:!0}):o,e));Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./exceptions.cjs");async function y(){try{const e=await import("snowflake-sdk");return e.default||e}catch{throw new a.InvalidProviderConfigurationError("The 'snowflake-sdk' package is required to use the Snowflake provider. Please install it: npm install snowflake-sdk")}}class w{connection;constructor(n){this.connection=n}async query(n,o={}){const s=(Array.isArray(o),o);return new Promise((t,i)=>{this.connection.execute({sqlText:n,binds:s,complete:(c,l,r)=>{if(c){i(new a.QueryError(`Snowflake provider failed to query the database. Reason: ${c.message}`));return}t(r??[])}})})}async close(){return new Promise((n,o)=>{this.connection.destroy(s=>{if(s){o(s);return}n()})})}}async function P(e){const n=await y(),o=["user","password","account","warehouse","database","schema","role"];for(const t of o)if(!e.fields[t])throw new a.InvalidProviderConfigurationError(`Missing field '${t}' in the provider '${e.name}' to connect to Snowflake using password based authentication.`);const s={account:e.fields.account,username:e.fields.user,password:e.fields.password,warehouse:e.fields.warehouse,database:e.fields.database,schema:e.fields.schema,role:e.fields.role};return new Promise((t,i)=>{n.createConnection(s).connect((l,r)=>{if(l){i(new a.ProviderConnectionError(`Unable to connect to Snowflake. Reason: ${l.message}`));return}r.execute({sqlText:"ALTER SESSION SET TIMEZONE = 'UTC'",complete:d=>{d&&console.warn(`Warning: Failed to set timezone to UTC: ${d.message}`),t(new w(r))}})})})}exports.SnowflakeProvider=w;exports.buildSnowflakeProvider=P;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./exceptions.cjs");function f(e){const o=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const n in e)if(n!=="default"){const t=Object.getOwnPropertyDescriptor(e,n);Object.defineProperty(o,n,t.get?t:{enumerable:!0,get:()=>e[n]})}}return o.default=e,Object.freeze(o)}async function w(){try{const e=await Promise.resolve().then(()=>f(require("snowflake-sdk")));return e.default||e}catch{throw new a.InvalidProviderConfigurationError("The 'snowflake-sdk' package is required to use the Snowflake provider. Please install it: npm install snowflake-sdk")}}class u{connection;constructor(o){this.connection=o}async query(o,n={}){const t=(Array.isArray(n),n);return new Promise((r,i)=>{this.connection.execute({sqlText:o,binds:t,complete:(c,l,s)=>{if(c){i(new a.QueryError(`Snowflake provider failed to query the database. Reason: ${c.message}`));return}r(s??[])}})})}async close(){return new Promise((o,n)=>{this.connection.destroy(t=>{if(t){n(t);return}o()})})}}async function m(e){const o=await w(),n=["user","password","account","warehouse","database","schema","role"];for(const r of n)if(!e.fields[r])throw new a.InvalidProviderConfigurationError(`Missing field '${r}' in the provider '${e.name}' to connect to Snowflake using password based authentication.`);const t={account:e.fields.account,username:e.fields.user,password:e.fields.password,warehouse:e.fields.warehouse,database:e.fields.database,schema:e.fields.schema,role:e.fields.role};return new Promise((r,i)=>{o.createConnection(t).connect((l,s)=>{if(l){i(new a.ProviderConnectionError(`Unable to connect to Snowflake. Reason: ${l.message}`));return}s.execute({sqlText:"ALTER SESSION SET TIMEZONE = 'UTC'",complete:d=>{d&&console.warn(`Warning: Failed to set timezone to UTC: ${d.message}`),r(new u(s))}})})})}exports.SnowflakeProvider=u;exports.buildSnowflakeProvider=m;
 //# sourceMappingURL=SnowflakeProvider.cjs.map

package/dist/server/providers/SnowflakeProvider.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"SnowflakeProvider.cjs","sources":["../../../src/server/providers/SnowflakeProvider.ts"],"sourcesContent":["/**\n * Snowflake Data Provider\n *\n * TypeScript equivalent of SnowflakeProvider from\n * ts-lib-ui-kit-streamlit/tetrascience/data_app_providers/provider.py\n *\n * @remarks\n * This provider requires the `snowflake-sdk` package to be installed.\n * It is an optional peer dependency - install it only if you need Snowflake support:\n * ```bash\n * npm install snowflake-sdk\n * # or\n * yarn add snowflake-sdk\n * ```\n */\n\nimport {\n  QueryError,\n  ProviderConnectionError,\n  InvalidProviderConfigurationError,\n} from \"./exceptions\";\n\nimport type { ProviderConfiguration } from \"./types\";\n\n// Type imports for snowflake-sdk (these don't require the package at runtime)\ntype SnowflakeSDK = typeof import(\"snowflake-sdk\");\ntype SnowflakeConnection = import(\"snowflake-sdk\").Connection;\ntype SnowflakeBinds = import(\"snowflake-sdk\").Binds;\ntype SnowflakeError = import(\"snowflake-sdk\").SnowflakeError;\ntype SnowflakeConnectionOptions = import(\"snowflake-sdk\").ConnectionOptions;\ntype SnowflakeRowStatement = import(\"snowflake-sdk\").RowStatement;\ntype SnowflakeFileAndStageBindStatement =\n  import(\"snowflake-sdk\").FileAndStageBindStatement;\n\n/**\n * Dynamically import snowflake-sdk\n * @throws {InvalidProviderConfigurationError} If snowflake-sdk is not installed\n */\nasync function getSnowflakeSDK(): Promise<SnowflakeSDK> {\n  try {\n    const snowflake = await import(\"snowflake-sdk\");\n    return snowflake.default || snowflake;\n  } catch {\n    throw new InvalidProviderConfigurationError(\n      \"The 'snowflake-sdk' package is required to use the Snowflake provider. \" +\n        \"Please install it: npm install snowflake-sdk\",\n    );\n  }\n}\n\n/**\n * Snowflake data provider\n */\nexport class SnowflakeProvider {\n  private connection: SnowflakeConnection;\n\n  /**\n   * Initialize the Snowflake data provider\n   *\n   * @param connection - Snowflake connection\n   */\n  constructor(connection: SnowflakeConnection) {\n    this.connection = connection;\n  }\n\n  /**\n   * Query the Snowflake database\n   *\n   * @param sqlText - SQL query to execute\n   * @param params - Parameters to pass to the query. For positional binds, use an array.\n   *                 For named binds, use an object with keys matching the bind variable names.\n   * @returns Promise resolving to array of row objects\n   */\n  async query(\n    sqlText: string,\n    params: Record<string, unknown> | unknown[] = {},\n  ): Promise<Array<Record<string, unknown>>> {\n    // Snowflake SDK supports both positional binds (array) and named binds (object)\n    // Pass params directly to preserve named bind semantics\n    const binds = Array.isArray(params)\n      ? (params as unknown as SnowflakeBinds)\n      : (params as unknown as SnowflakeBinds);\n\n    return new Promise((resolve, reject) => {\n      this.connection.execute({\n        sqlText,\n        binds,\n        complete: (\n          err: SnowflakeError | undefined,\n          _stmt: SnowflakeRowStatement | SnowflakeFileAndStageBindStatement,\n          rows?: Array<Record<string, unknown>>,\n        ) => {\n          if (err) {\n            reject(\n              new QueryError(\n                `Snowflake provider failed to query the database. Reason: ${err.message}`,\n              ),\n            );\n            return;\n          }\n          resolve(rows ?? []);\n        },\n      });\n    });\n  }\n\n  /**\n   * Close the Snowflake connection\n   */\n  async close(): Promise<void> {\n    return new Promise((resolve, reject) => {\n      this.connection.destroy((err: SnowflakeError | undefined) => {\n        if (err) {\n          reject(err);\n          return;\n        }\n        resolve();\n      });\n    });\n  }\n}\n\n/**\n * Build a Snowflake data provider from the configuration\n *\n * @param config - Provider configuration\n * @returns Promise resolving to Snowflake data provider\n * @throws {InvalidProviderConfigurationError} If snowflake-sdk is not installed or config is invalid\n */\nexport async function buildSnowflakeProvider(\n  config: ProviderConfiguration,\n): Promise<SnowflakeProvider> {\n  // Dynamically import snowflake-sdk\n  const snowflake = await getSnowflakeSDK();\n\n  const requiredFields = [\n    \"user\",\n    \"password\",\n    \"account\",\n    \"warehouse\",\n    \"database\",\n    \"schema\",\n    \"role\",\n  ] as const;\n\n  for (const field of requiredFields) {\n    if (!config.fields[field]) {\n      throw new InvalidProviderConfigurationError(\n        `Missing field '${field}' in the provider '${config.name}' to connect to Snowflake ` +\n          \"using password based authentication.\",\n      );\n    }\n  }\n\n  const connectionOptions: SnowflakeConnectionOptions = {\n    account: config.fields[\"account\"]!,\n    username: config.fields[\"user\"]!,\n    password: config.fields[\"password\"]!,\n    warehouse: config.fields[\"warehouse\"]!,\n    database: config.fields[\"database\"]!,\n    schema: config.fields[\"schema\"]!,\n    role: config.fields[\"role\"]!,\n  };\n\n  return new Promise((resolve, reject) => {\n    const connection = snowflake.createConnection(connectionOptions);\n\n    connection.connect(\n      (err: SnowflakeError | undefined, conn: SnowflakeConnection) => {\n        if (err) {\n          reject(\n            new ProviderConnectionError(\n              `Unable to connect to Snowflake. Reason: ${err.message}`,\n            ),\n          );\n          return;\n        }\n\n        // Set timezone to UTC after connection.\n        // The default timezone is America/Los_Angeles. Timestamps from delta tables will be\n        // returned with the timezone `timezone`. NOTE, this is not a timezone conversion.\n        // The timezone is replaced without translating the clock time. `timezone` is set UTC\n        // to match the timezone of delta table timestamps.\n        conn.execute({\n          sqlText: \"ALTER SESSION SET TIMEZONE = 'UTC'\",\n          complete: (tzErr: SnowflakeError | undefined) => {\n            if (tzErr) {\n              // Log warning but don't fail - timezone setting is not critical\n              console.warn(\n                `Warning: Failed to set timezone to UTC: ${tzErr.message}`,\n              );\n            }\n            resolve(new SnowflakeProvider(conn));\n          },\n        });\n      },\n    );\n  });\n}\n\n"],"names":["getSnowflakeSDK","snowflake","InvalidProviderConfigurationError","SnowflakeProvider","connection","sqlText","params","binds","resolve","reject","err","_stmt","rows","QueryError","buildSnowflakeProvider","config","requiredFields","field","connectionOptions","conn","ProviderConnectionError","tzErr"],"mappings":"+jBAsCA,eAAeA,GAAyC,CACtD,GAAI,CACF,MAAMC,EAAY,KAAM,QAAO,eAAe,EAC9C,OAAOA,EAAU,SAAWA,CAC9B,MAAQ,CACN,MAAM,IAAIC,EAAAA,kCACR,qHAAA,CAGJ,CACF,CAKO,MAAMC,CAAkB,CACrB,WAOR,YAAYC,EAAiC,CAC3C,KAAK,WAAaA,CACpB,CAUA,MAAM,MACJC,EACAC,EAA8C,GACL,CAGzC,MAAMC,GAAQ,MAAM,QAAQD,CAAM,EAC7BA,GAGL,OAAO,IAAI,QAAQ,CAACE,EAASC,IAAW,CACtC,KAAK,WAAW,QAAQ,CACtB,QAAAJ,EACA,MAAAE,EACA,SAAU,CACRG,EACAC,EACAC,IACG,CACH,GAAIF,EAAK,CACPD,EACE,IAAII,EAAAA,WACF,4DAA4DH,EAAI,OAAO,EAAA,CACzE,EAEF,MACF,CACAF,EAAQI,GAAQ,EAAE,CACpB,CAAA,CACD,CACH,CAAC,CACH,CAKA,MAAM,OAAuB,CAC3B,OAAO,IAAI,QAAQ,CAACJ,EAASC,IAAW,CACtC,KAAK,WAAW,QAASC,GAAoC,CAC3D,GAAIA,EAAK,CACPD,EAAOC,CAAG,EACV,MACF,CACAF,EAAA,CACF,CAAC,CACH,CAAC,CACH,CACF,CASA,eAAsBM,EACpBC,EAC4B,CAE5B,MAAMd,EAAY,MAAMD,EAAA,EAElBgB,EAAiB,CACrB,OACA,WACA,UACA,YACA,WACA,SACA,MAAA,EAGF,UAAWC,KAASD,EAClB,GAAI,CAACD,EAAO,OAAOE,CAAK,EACtB,MAAM,IAAIf,EAAAA,kCACR,kBAAkBe,CAAK,sBAAsBF,EAAO,IAAI,gEAAA,EAM9D,MAAMG,EAAgD,CACpD,QAASH,EAAO,OAAO,QACvB,SAAUA,EAAO,OAAO,KACxB,SAAUA,EAAO,OAAO,SACxB,UAAWA,EAAO,OAAO,UACzB,SAAUA,EAAO,OAAO,SACxB,OAAQA,EAAO,OAAO,OACtB,KAAMA,EAAO,OAAO,IAAM,EAG5B,OAAO,IAAI,QAAQ,CAACP,EAASC,IAAW,CACnBR,EAAU,iBAAiBiB,CAAiB,EAEpD,QACT,CAACR,EAAiCS,IAA8B,CAC9D,GAAIT,EAAK,CACPD,EACE,IAAIW,EAAAA,wBACF,2CAA2CV,EAAI,OAAO,EAAA,CACxD,EAEF,MACF,CAOAS,EAAK,QAAQ,CACX,QAAS,qCACT,SAAWE,GAAsC,CAC3CA,GAEF,QAAQ,KACN,2CAA2CA,EAAM,OAAO,EAAA,EAG5Db,EAAQ,IAAIL,EAAkBgB,CAAI,CAAC,CACrC,CAAA,CACD,CACH,CAAA,CAEJ,CAAC,CACH"}
+{"version":3,"file":"SnowflakeProvider.cjs","sources":["../../../src/server/providers/SnowflakeProvider.ts"],"sourcesContent":["/**\n * Snowflake Data Provider\n *\n * TypeScript equivalent of SnowflakeProvider from\n * ts-lib-ui-kit-streamlit/tetrascience/data_app_providers/provider.py\n *\n * @remarks\n * This provider requires the `snowflake-sdk` package to be installed.\n * It is an optional peer dependency - install it only if you need Snowflake support:\n * ```bash\n * npm install snowflake-sdk\n * # or\n * yarn add snowflake-sdk\n * ```\n */\n\nimport {\n  QueryError,\n  ProviderConnectionError,\n  InvalidProviderConfigurationError,\n} from \"./exceptions\";\n\nimport type { ProviderConfiguration } from \"./types\";\n\n// Type imports for snowflake-sdk (these don't require the package at runtime)\ntype SnowflakeSDK = typeof import(\"snowflake-sdk\");\ntype SnowflakeConnection = import(\"snowflake-sdk\").Connection;\ntype SnowflakeBinds = import(\"snowflake-sdk\").Binds;\ntype SnowflakeError = import(\"snowflake-sdk\").SnowflakeError;\ntype SnowflakeConnectionOptions = import(\"snowflake-sdk\").ConnectionOptions;\ntype SnowflakeRowStatement = import(\"snowflake-sdk\").RowStatement;\ntype SnowflakeFileAndStageBindStatement =\n  import(\"snowflake-sdk\").FileAndStageBindStatement;\n\n/**\n * Dynamically import snowflake-sdk\n * @throws {InvalidProviderConfigurationError} If snowflake-sdk is not installed\n */\nasync function getSnowflakeSDK(): Promise<SnowflakeSDK> {\n  try {\n    const snowflake = await import(\"snowflake-sdk\");\n    return snowflake.default || snowflake;\n  } catch {\n    throw new InvalidProviderConfigurationError(\n      \"The 'snowflake-sdk' package is required to use the Snowflake provider. \" +\n        \"Please install it: npm install snowflake-sdk\",\n    );\n  }\n}\n\n/**\n * Snowflake data provider\n */\nexport class SnowflakeProvider {\n  private connection: SnowflakeConnection;\n\n  /**\n   * Initialize the Snowflake data provider\n   *\n   * @param connection - Snowflake connection\n   */\n  constructor(connection: SnowflakeConnection) {\n    this.connection = connection;\n  }\n\n  /**\n   * Query the Snowflake database\n   *\n   * @param sqlText - SQL query to execute\n   * @param params - Parameters to pass to the query. For positional binds, use an array.\n   *                 For named binds, use an object with keys matching the bind variable names.\n   * @returns Promise resolving to array of row objects\n   */\n  async query(\n    sqlText: string,\n    params: Record<string, unknown> | unknown[] = {},\n  ): Promise<Array<Record<string, unknown>>> {\n    // Snowflake SDK supports both positional binds (array) and named binds (object)\n    // Pass params directly to preserve named bind semantics\n    const binds = Array.isArray(params)\n      ? (params as unknown as SnowflakeBinds)\n      : (params as unknown as SnowflakeBinds);\n\n    return new Promise((resolve, reject) => {\n      this.connection.execute({\n        sqlText,\n        binds,\n        complete: (\n          err: SnowflakeError | undefined,\n          _stmt: SnowflakeRowStatement | SnowflakeFileAndStageBindStatement,\n          rows?: Array<Record<string, unknown>>,\n        ) => {\n          if (err) {\n            reject(\n              new QueryError(\n                `Snowflake provider failed to query the database. Reason: ${err.message}`,\n              ),\n            );\n            return;\n          }\n          resolve(rows ?? []);\n        },\n      });\n    });\n  }\n\n  /**\n   * Close the Snowflake connection\n   */\n  async close(): Promise<void> {\n    return new Promise((resolve, reject) => {\n      this.connection.destroy((err: SnowflakeError | undefined) => {\n        if (err) {\n          reject(err);\n          return;\n        }\n        resolve();\n      });\n    });\n  }\n}\n\n/**\n * Build a Snowflake data provider from the configuration\n *\n * @param config - Provider configuration\n * @returns Promise resolving to Snowflake data provider\n * @throws {InvalidProviderConfigurationError} If snowflake-sdk is not installed or config is invalid\n */\nexport async function buildSnowflakeProvider(\n  config: ProviderConfiguration,\n): Promise<SnowflakeProvider> {\n  // Dynamically import snowflake-sdk\n  const snowflake = await getSnowflakeSDK();\n\n  const requiredFields = [\n    \"user\",\n    \"password\",\n    \"account\",\n    \"warehouse\",\n    \"database\",\n    \"schema\",\n    \"role\",\n  ] as const;\n\n  for (const field of requiredFields) {\n    if (!config.fields[field]) {\n      throw new InvalidProviderConfigurationError(\n        `Missing field '${field}' in the provider '${config.name}' to connect to Snowflake ` +\n          \"using password based authentication.\",\n      );\n    }\n  }\n\n  const connectionOptions: SnowflakeConnectionOptions = {\n    account: config.fields[\"account\"]!,\n    username: config.fields[\"user\"]!,\n    password: config.fields[\"password\"]!,\n    warehouse: config.fields[\"warehouse\"]!,\n    database: config.fields[\"database\"]!,\n    schema: config.fields[\"schema\"]!,\n    role: config.fields[\"role\"]!,\n  };\n\n  return new Promise((resolve, reject) => {\n    const connection = snowflake.createConnection(connectionOptions);\n\n    connection.connect(\n      (err: SnowflakeError | undefined, conn: SnowflakeConnection) => {\n        if (err) {\n          reject(\n            new ProviderConnectionError(\n              `Unable to connect to Snowflake. Reason: ${err.message}`,\n            ),\n          );\n          return;\n        }\n\n        // Set timezone to UTC after connection.\n        // The default timezone is America/Los_Angeles. Timestamps from delta tables will be\n        // returned with the timezone `timezone`. NOTE, this is not a timezone conversion.\n        // The timezone is replaced without translating the clock time. `timezone` is set UTC\n        // to match the timezone of delta table timestamps.\n        conn.execute({\n          sqlText: \"ALTER SESSION SET TIMEZONE = 'UTC'\",\n          complete: (tzErr: SnowflakeError | undefined) => {\n            if (tzErr) {\n              // Log warning but don't fail - timezone setting is not critical\n              console.warn(\n                `Warning: Failed to set timezone to UTC: ${tzErr.message}`,\n              );\n            }\n            resolve(new SnowflakeProvider(conn));\n          },\n        });\n      },\n    );\n  });\n}\n\n"],"names":["getSnowflakeSDK","snowflake","_interopNamespaceDefault","InvalidProviderConfigurationError","SnowflakeProvider","connection","sqlText","params","binds","resolve","reject","err","_stmt","rows","QueryError","buildSnowflakeProvider","config","requiredFields","field","connectionOptions","conn","ProviderConnectionError","tzErr"],"mappings":"iYAsCA,eAAeA,GAAyC,CACtD,GAAI,CACF,MAAMC,EAAY,MAAM,QAAA,QAAA,EAAA,KAAA,IAAAC,EAAA,QAAO,eAAe,CAAA,CAAA,EAC9C,OAAOD,EAAU,SAAWA,CAC9B,MAAQ,CACN,MAAM,IAAIE,EAAAA,kCACR,qHAAA,CAGJ,CACF,CAKO,MAAMC,CAAkB,CACrB,WAOR,YAAYC,EAAiC,CAC3C,KAAK,WAAaA,CACpB,CAUA,MAAM,MACJC,EACAC,EAA8C,GACL,CAGzC,MAAMC,GAAQ,MAAM,QAAQD,CAAM,EAC7BA,GAGL,OAAO,IAAI,QAAQ,CAACE,EAASC,IAAW,CACtC,KAAK,WAAW,QAAQ,CACtB,QAAAJ,EACA,MAAAE,EACA,SAAU,CACRG,EACAC,EACAC,IACG,CACH,GAAIF,EAAK,CACPD,EACE,IAAII,EAAAA,WACF,4DAA4DH,EAAI,OAAO,EAAA,CACzE,EAEF,MACF,CACAF,EAAQI,GAAQ,EAAE,CACpB,CAAA,CACD,CACH,CAAC,CACH,CAKA,MAAM,OAAuB,CAC3B,OAAO,IAAI,QAAQ,CAACJ,EAASC,IAAW,CACtC,KAAK,WAAW,QAASC,GAAoC,CAC3D,GAAIA,EAAK,CACPD,EAAOC,CAAG,EACV,MACF,CACAF,EAAA,CACF,CAAC,CACH,CAAC,CACH,CACF,CASA,eAAsBM,EACpBC,EAC4B,CAE5B,MAAMf,EAAY,MAAMD,EAAA,EAElBiB,EAAiB,CACrB,OACA,WACA,UACA,YACA,WACA,SACA,MAAA,EAGF,UAAWC,KAASD,EAClB,GAAI,CAACD,EAAO,OAAOE,CAAK,EACtB,MAAM,IAAIf,EAAAA,kCACR,kBAAkBe,CAAK,sBAAsBF,EAAO,IAAI,gEAAA,EAM9D,MAAMG,EAAgD,CACpD,QAASH,EAAO,OAAO,QACvB,SAAUA,EAAO,OAAO,KACxB,SAAUA,EAAO,OAAO,SACxB,UAAWA,EAAO,OAAO,UACzB,SAAUA,EAAO,OAAO,SACxB,OAAQA,EAAO,OAAO,OACtB,KAAMA,EAAO,OAAO,IAAM,EAG5B,OAAO,IAAI,QAAQ,CAACP,EAASC,IAAW,CACnBT,EAAU,iBAAiBkB,CAAiB,EAEpD,QACT,CAACR,EAAiCS,IAA8B,CAC9D,GAAIT,EAAK,CACPD,EACE,IAAIW,EAAAA,wBACF,2CAA2CV,EAAI,OAAO,EAAA,CACxD,EAEF,MACF,CAOAS,EAAK,QAAQ,CACX,QAAS,qCACT,SAAWE,GAAsC,CAC3CA,GAEF,QAAQ,KACN,2CAA2CA,EAAM,OAAO,EAAA,EAG5Db,EAAQ,IAAIL,EAAkBgB,CAAI,CAAC,CACrC,CAAA,CACD,CACH,CAAA,CAEJ,CAAC,CACH"}

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

@@ -0,0 +1,36 @@
+import { ProviderConfiguration } from './types';
+type SnowflakeConnection = import('snowflake-sdk').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>;
+}
+/**
+ * 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>;
+export {};

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

@@ -0,0 +1,39 @@
+import { AthenaProvider } from './AthenaProvider';
+import { DatabricksProvider } from './DatabricksProvider';
+import { SnowflakeProvider } from './SnowflakeProvider';
+import { ProviderConfiguration } from './types';
+/**
+ * Union type of all supported data providers
+ */
+export 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');
+ * }
+ * ```
+ */
+export declare function buildProvider(config: ProviderConfiguration): Promise<DataProvider>;

package/dist/server/providers/entries/athena.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Athena Provider Entry Point
+ *
+ * Standalone entry point for the Athena provider.
+ * Import from '@tetrascience-npm/tetrascience-react-ui/server/providers/athena'
+ * to only include Athena-related code in your bundle.
+ *
+ * @example
+ * ```typescript
+ * import { AthenaProvider, getTdpAthenaProvider } from '@tetrascience-npm/tetrascience-react-ui/server/providers/athena';
+ *
+ * const provider = await getTdpAthenaProvider(config);
+ * const result = await provider.query('SELECT * FROM my_table');
+ * ```
+ *
+ * @remarks
+ * Requires `@aws-sdk/client-athena` to be installed:
+ * ```bash
+ * npm install @aws-sdk/client-athena
+ * ```
+ */
+export { AthenaProvider, getTdpAthenaProvider } from '../AthenaProvider';
+export { ProviderError, MissingTableError, QueryError, ProviderConnectionError, InvalidProviderConfigurationError, } from '../exceptions';
+export type { ProviderConfiguration, QueryResult } from '../types';

package/dist/server/providers/entries/databricks.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Databricks Provider Entry Point
+ *
+ * Standalone entry point for the Databricks provider.
+ * Import from '@tetrascience-npm/tetrascience-react-ui/server/providers/databricks'
+ * to only include Databricks-related code in your bundle.
+ *
+ * @example
+ * ```typescript
+ * import { DatabricksProvider, buildDatabricksProvider } from '@tetrascience-npm/tetrascience-react-ui/server/providers/databricks';
+ *
+ * const provider = await buildDatabricksProvider(config);
+ * const result = await provider.query('SELECT * FROM my_table');
+ * await provider.close();
+ * ```
+ *
+ * @remarks
+ * Requires `@databricks/sql` to be installed:
+ * ```bash
+ * npm install @databricks/sql
+ * ```
+ */
+export { DatabricksProvider, buildDatabricksProvider, } from '../DatabricksProvider';
+export { ProviderError, MissingTableError, QueryError, ProviderConnectionError, InvalidProviderConfigurationError, } from '../exceptions';
+export type { ProviderConfiguration, QueryResult } from '../types';

package/dist/server/providers/entries/snowflake.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Snowflake Provider Entry Point
+ *
+ * Standalone entry point for the Snowflake provider.
+ * Import from '@tetrascience-npm/tetrascience-react-ui/server/providers/snowflake'
+ * to only include Snowflake-related code in your bundle.
+ *
+ * @example
+ * ```typescript
+ * import { SnowflakeProvider, buildSnowflakeProvider } from '@tetrascience-npm/tetrascience-react-ui/server/providers/snowflake';
+ *
+ * const provider = await buildSnowflakeProvider(config);
+ * const result = await provider.query('SELECT * FROM my_table');
+ * await provider.close();
+ * ```
+ *
+ * @remarks
+ * Requires `snowflake-sdk` to be installed:
+ * ```bash
+ * npm install snowflake-sdk
+ * ```
+ */
+export { SnowflakeProvider, buildSnowflakeProvider } from '../SnowflakeProvider';
+export { ProviderError, MissingTableError, QueryError, ProviderConnectionError, InvalidProviderConfigurationError, } from '../exceptions';
+export type { ProviderConfiguration, QueryResult } from '../types';

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

@@ -0,0 +1,36 @@
+/**
+ * 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);
+}
+/**
+ * Raised when a table is missing in the database
+ */
+export declare class MissingTableError extends ProviderError {
+    constructor(message: string);
+}
+/**
+ * Raised when a query fails
+ */
+export declare class QueryError extends ProviderError {
+    constructor(message: string);
+}
+/**
+ * Raised when connecting to a provider fails
+ */
+export declare class ProviderConnectionError extends ProviderError {
+    constructor(message: string);
+}
+/**
+ * Raised when the provider configuration is invalid
+ */
+export declare class InvalidProviderConfigurationError extends ProviderError {
+    constructor(message: string);
+}

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

@@ -0,0 +1,45 @@
+import { InvalidProviderConfigurationError } from './exceptions';
+import { GetProviderConfigurationsOptions, ProviderConfiguration } from './types';
+import { TDPClient } from '@tetrascience-npm/ts-connectors-sdk';
+export { InvalidProviderConfigurationError };
+/**
+ * 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[]>;

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

@@ -0,0 +1,31 @@
+/**
+ * Data App Provider utilities for TetraScience data apps
+ *
+ * TypeScript equivalents of the Python helpers from ts-lib-ui-kit-streamlit
+ * for retrieving data app provider configurations and database providers.
+ *
+ * Note: This module uses TDPClient from @tetrascience-npm/ts-connectors-sdk
+ * for TDP API calls. Initialize TDPClient with the user's JWT token:
+ *
+ * @example
+ * ```typescript
+ * import { TDPClient } from '@tetrascience-npm/ts-connectors-sdk';
+ * import { 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 providers = await getProviderConfigurations(client);
+ * ```
+ */
+export { getProviderConfigurations } from './getProviderConfigurations';
+export { getProviderInfoList, getProviderByName, getProvidersByType, getProviderNames, getProviderTypes, } from './providerDiscovery';
+export { ProviderError, MissingTableError, QueryError, ProviderConnectionError, InvalidProviderConfigurationError, } from './exceptions';
+export { SnowflakeProvider, buildSnowflakeProvider } from './SnowflakeProvider';
+export { DatabricksProvider, buildDatabricksProvider, } from './DatabricksProvider';
+export { AthenaProvider, getTdpAthenaProvider } from './AthenaProvider';
+export { buildProvider, type DataProvider } from './buildProvider';
+export type { ProviderConfiguration, MinimalProvider, ProviderSecret, ProviderApiResponse, ContainerDataApp, OrganizationApiResponse, GetProviderConfigurationsOptions, ProviderInfo, QueryResult, } from './types';

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';