@katerai/sdk 0.6.0 → 0.7.0

package/src/resources/v1/connections/connections.ts

@@ -1,1905 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { APIResource } from '../../../core/resource';
-import * as DatabasesAPI from './databases';
-import { DatabaseDeleteSchemaParams, Databases } from './databases';
-import * as ViewsAPI from './views';
-import { ViewListParams, ViewListResponse, ViewRetrieveParams, ViewRetrieveResponse, Views } from './views';
-import * as YamlAPI from './yaml';
-import { Yaml, YamlCommitParams, YamlCommitResponse, YamlRetrieveResponse } from './yaml';
-import { APIPromise } from '../../../core/api-promise';
-import { buildHeaders } from '../../../internal/headers';
-import { RequestOptions } from '../../../internal/request-options';
-import { path } from '../../../internal/utils/path';
-
-export class Connections extends APIResource {
-  databases: DatabasesAPI.Databases = new DatabasesAPI.Databases(this._client);
-  views: ViewsAPI.Views = new ViewsAPI.Views(this._client);
-  yaml: YamlAPI.Yaml = new YamlAPI.Yaml(this._client);
-
-  /**
-   * Create a new warehouse connection with PR approval flow.
-   */
-  create(body: ConnectionCreateParams, options?: RequestOptions): APIPromise<Connection> {
-    return this._client.post('/api/v1/connections', { body, ...options });
-  }
-
-  /**
-   * Get a single warehouse connection by ID.
-   *
-   * Returns connection from the database (source of truth) with full hierarchy. For
-   * YAML output compatible with repository files (using kater_id), use the GET
-   * /connections/{id}/schema endpoint instead.
-   *
-   * RLS: Filtered to current client (DualClientRLSDB).
-   *
-   * Raises: NotFoundError: If connection doesn't exist (404)
-   */
-  retrieve(connectionID: string, options?: RequestOptions): APIPromise<Connection> {
-    return this._client.get(path`/api/v1/connections/${connectionID}`, options);
-  }
-
-  /**
-   * Update a warehouse connection's metadata.
-   *
-   * Updates name, label, and/or description fields.
-   *
-   * RLS: Filtered to current client (ClientRLSDB).
-   *
-   * Raises: ConnectionNotFoundError: If connection doesn't exist (404)
-   */
-  update(
-    connectionID: string,
-    body: ConnectionUpdateParams,
-    options?: RequestOptions,
-  ): APIPromise<Connection> {
-    return this._client.patch(path`/api/v1/connections/${connectionID}`, { body, ...options });
-  }
-
-  /**
-   * List warehouse connections for the client.
-   *
-   * Filter connections by approval status using the `status` query parameter:
-   *
-   * - `approved` (default): Only approved connections (is_pending_approval=false)
-   * - `pending`: Only connections awaiting PR approval (is_pending_approval=true)
-   * - `all`: All connections regardless of approval status
-   *
-   * Pending connections include their approval PR URLs when available. Returns empty
-   * list if GitHub is not configured.
-   *
-   * RLS: Filtered to current client (DualClientRLSDB).
-   */
-  list(
-    query: ConnectionListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<ConnectionListResponse> {
-    return this._client.get('/api/v1/connections', { query, ...options });
-  }
-
-  /**
-   * Delete a warehouse connection.
-   *
-   * Soft-deletes the connection record and cascades to all associated databases and
-   * schemas, setting deleted_at and deleted_by fields.
-   *
-   * RLS: Filtered to current client (ClientRLSDB).
-   *
-   * Raises: ConnectionNotFoundError: If connection doesn't exist (404)
-   */
-  delete(connectionID: string, options?: RequestOptions): APIPromise<void> {
-    return this._client.delete(path`/api/v1/connections/${connectionID}`, {
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
-  }
-
-  /**
-   * Merge the PR for a pending connection to finalize it.
-   */
-  approve(connectionID: string, options?: RequestOptions): APIPromise<Connection> {
-    return this._client.post(path`/api/v1/connections/${connectionID}/approve`, options);
-  }
-
-  /**
-   * Merge the PR for a completed schema sync.
-   */
-  approveSync(
-    syncID: string,
-    params: ConnectionApproveSyncParams,
-    options?: RequestOptions,
-  ): APIPromise<ConnectionApproveSyncResponse> {
-    const { connection_id } = params;
-    return this._client.post(path`/api/v1/connections/${connection_id}/sync/${syncID}/approve`, options);
-  }
-
-  /**
-   * List all schema sync records for a connection.
-   */
-  listSyncs(
-    connectionID: string,
-    query: ConnectionListSyncsParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<ConnectionListSyncsResponse> {
-    return this._client.get(path`/api/v1/connections/${connectionID}/sync`, { query, ...options });
-  }
-
-  /**
-   * Get decrypted warehouse credentials for a connection.
-   *
-   * Returns the decrypted credentials for a connection. This is sensitive data and
-   * should only be used when actually needed for warehouse operations.
-   *
-   * RLS: Filtered to current client (DualClientRLSDB).
-   *
-   * Raises: NotFoundError: If connection doesn't exist (404)
-   */
-  retrieveCredential(
-    connectionID: string,
-    options?: RequestOptions,
-  ): APIPromise<ConnectionRetrieveCredentialResponse> {
-    return this._client.get(path`/api/v1/connections/${connectionID}/credential`, options);
-  }
-
-  /**
-   * Get connection as a ConnectionSchema object.
-   *
-   * Returns the connection in the YAML-compatible schema format with full
-   * database/schema hierarchy.
-   *
-   * RLS: Automatically filtered by client_id from auth context.
-   *
-   * Raises: ConnectionNotFoundError: If connection not found or deleted.
-   */
-  retrieveSchema(
-    connectionID: string,
-    options?: RequestOptions,
-  ): APIPromise<ConnectionRetrieveSchemaResponse> {
-    return this._client.get(path`/api/v1/connections/${connectionID}/schema`, options);
-  }
-
-  /**
-   * Get the current status of a schema sync workflow.
-   */
-  retrieveSyncStatus(
-    syncID: string,
-    params: ConnectionRetrieveSyncStatusParams,
-    options?: RequestOptions,
-  ): APIPromise<ConnectionRetrieveSyncStatusResponse> {
-    const { connection_id } = params;
-    return this._client.get(path`/api/v1/connections/${connection_id}/sync/${syncID}`, options);
-  }
-
-  /**
-   * Server-Sent Events stream for real-time sync progress updates.
-   */
-  streamSyncProgress(
-    syncID: string,
-    params: ConnectionStreamSyncProgressParams,
-    options?: RequestOptions,
-  ): APIPromise<unknown> {
-    const { connection_id } = params;
-    return this._client.get(path`/api/v1/connections/${connection_id}/sync/${syncID}/stream`, options);
-  }
-
-  /**
-   * Start a schema sync workflow. Returns 202 Accepted with sync_id.
-   */
-  sync(connectionID: string, options?: RequestOptions): APIPromise<ConnectionSyncResponse> {
-    return this._client.post(path`/api/v1/connections/${connectionID}/sync`, options);
-  }
-
-  /**
-   * Test and update warehouse credentials without modifying connection config.
-   */
-  updateCredentials(
-    connectionID: string,
-    body: ConnectionUpdateCredentialsParams,
-    options?: RequestOptions,
-  ): APIPromise<ConnectionUpdateCredentialsResponse> {
-    return this._client.patch(path`/api/v1/connections/${connectionID}/credentials`, { body, ...options });
-  }
-}
-
-/**
- * Response model for a single connection.
- *
- * All data comes from the database (source of truth). For YAML-compatible output
- * with 'kater_id', use the /schema endpoint instead.
- */
-export interface Connection {
-  /**
-   * Connection ID
-   */
-  id: string;
-
-  /**
-   * Creation timestamp
-   */
-  created_at: string;
-
-  /**
-   * Credential ID
-   */
-  credential_id: string;
-
-  /**
-   * Databases in this connection
-   */
-  databases: Array<Connection.Database>;
-
-  /**
-   * Connection name
-   */
-  name: string;
-
-  /**
-   * Last update timestamp
-   */
-  updated_at: string;
-
-  /**
-   * Warehouse-specific configuration
-   */
-  warehouse_metadata:
-    | Connection.SnowflakeMetadata
-    | Connection.PostgresqlMetadata
-    | Connection.DatabricksMetadata
-    | Connection.ClickhouseMetadata
-    | Connection.MssqlMetadata;
-
-  /**
-   * Warehouse type (snowflake, postgresql, etc.)
-   */
-  warehouse_type: string;
-
-  /**
-   * GitHub PR URL for approving the connection (None if already approved)
-   */
-  approval_pr_url?: string | null;
-
-  /**
-   * Connection description
-   */
-  description?: string | null;
-
-  /**
-   * True if this connection is awaiting PR approval
-   */
-  is_pending_approval?: boolean;
-
-  /**
-   * Human-readable label
-   */
-  label?: string | null;
-
-  /**
-   * Query timeout in seconds
-   */
-  query_timeout?: number | null;
-
-  /**
-   * Timezone conversion mode (do_not_convert, convert_to_utc)
-   */
-  query_timezone_conversion?: string | null;
-}
-
-export namespace Connection {
-  /**
-   * Database info from ConnectionSchema.
-   */
-  export interface Database {
-    /**
-     * Database ID
-     */
-    id: string;
-
-    /**
-     * Actual name of the database in the warehouse
-     */
-    database_object_name: string;
-
-    /**
-     * Database name
-     */
-    name: string;
-
-    /**
-     * Schemas in this database
-     */
-    schemas: Array<Database.Schema>;
-
-    /**
-     * Database description
-     */
-    description?: string | null;
-
-    /**
-     * Human-readable label
-     */
-    label?: string | null;
-
-    /**
-     * Timezone for the database
-     */
-    timezone?: string | null;
-  }
-
-  export namespace Database {
-    /**
-     * Schema info from ConnectionSchema.
-     */
-    export interface Schema {
-      /**
-       * Schema ID
-       */
-      id: string;
-
-      /**
-       * Actual name of the schema in the warehouse
-       */
-      database_object_name: string;
-
-      /**
-       * Schema name
-       */
-      name: string;
-
-      /**
-       * Schema description
-       */
-      description?: string | null;
-
-      /**
-       * Human-readable label
-       */
-      label?: string | null;
-    }
-  }
-
-  export interface SnowflakeMetadata {
-    /**
-     * Authentication method
-     */
-    auth_method: 'username_password' | 'key_pair';
-
-    /**
-     * Snowflake role
-     */
-    role: string;
-
-    /**
-     * Snowflake account identifier
-     */
-    snowflake_account_id: string;
-
-    /**
-     * Snowflake compute warehouse name
-     */
-    warehouse: string;
-
-    warehouse_type: 'snowflake';
-  }
-
-  export interface PostgresqlMetadata {
-    /**
-     * Database host address
-     */
-    host: string;
-
-    /**
-     * Database port (default: 5432)
-     */
-    port: number;
-
-    warehouse_type: 'postgresql';
-  }
-
-  export interface DatabricksMetadata {
-    /**
-     * Databricks SQL warehouse HTTP path
-     */
-    http_path: string;
-
-    /**
-     * Databricks server hostname
-     */
-    server_hostname: string;
-
-    warehouse_type: 'databricks';
-  }
-
-  export interface ClickhouseMetadata {
-    /**
-     * ClickHouse host address
-     */
-    host: string;
-
-    /**
-     * ClickHouse port (default: 8443)
-     */
-    port: number;
-
-    warehouse_type: 'clickhouse';
-  }
-
-  export interface MssqlMetadata {
-    /**
-     * SQL Server host address
-     */
-    host: string;
-
-    /**
-     * SQL Server port (default: 1433)
-     */
-    port: number;
-
-    warehouse_type: 'mssql';
-  }
-}
-
-/**
- * Database configuration for connection creation request.
- */
-export interface DatabaseConfig {
-  /**
-   * Database name (also used as the warehouse object name)
-   */
-  name: string;
-
-  /**
-   * Description of the database
-   */
-  description?: string | null;
-
-  /**
-   * Human-readable label for the database (defaults to name if not set)
-   */
-  label?: string | null;
-
-  /**
-   * Schema configurations to include (empty = discover all schemas)
-   */
-  schemas?: Array<DatabaseConfig.Schema>;
-
-  /**
-   * Timezone for the database (e.g., 'UTC', 'America/New_York')
-   */
-  timezone?: string | null;
-}
-
-export namespace DatabaseConfig {
-  /**
-   * Schema configuration for connection creation request.
-   */
-  export interface Schema {
-    /**
-     * Schema name (also used as the warehouse object name)
-     */
-    name: string;
-
-    /**
-     * Description of the schema
-     */
-    description?: string | null;
-
-    /**
-     * Human-readable label for the schema (defaults to name if not set)
-     */
-    label?: string | null;
-  }
-}
-
-export type ConnectionListResponse = Array<Connection>;
-
-/**
- * Response for sync status endpoint.
- *
- * Contains full sync state including progress and results.
- */
-export interface ConnectionApproveSyncResponse {
-  /**
-   * Connection ID
-   */
-  connection_id: string;
-
-  /**
-   * Sync creation timestamp
-   */
-  created_at: string;
-
-  /**
-   * Workflow status: queued, running, succeeded, failed, canceled
-   */
-  run_status: string;
-
-  /**
-   * Schema sync record ID
-   */
-  sync_id: string;
-
-  /**
-   * Workflow completion timestamp
-   */
-  completed_at?: string | null;
-
-  /**
-   * Current workflow step
-   */
-  current_step?: string | null;
-
-  /**
-   * Error message if failed
-   */
-  error_message?: string | null;
-
-  /**
-   * Sync event history
-   */
-  events?: Array<ConnectionApproveSyncResponse.Event>;
-
-  /**
-   * Hatchet workflow run ID
-   */
-  hatchet_run_id?: string | null;
-
-  /**
-   * GitHub PR number
-   */
-  pr_number?: number | null;
-
-  /**
-   * PR status: open, merged, closed
-   */
-  pr_status?: string | null;
-
-  /**
-   * GitHub PR URL
-   */
-  pr_url?: string | null;
-
-  /**
-   * Workflow start timestamp
-   */
-  started_at?: string | null;
-
-  /**
-   * Number of views deleted
-   */
-  views_deleted?: number | null;
-
-  /**
-   * Number of new views added
-   */
-  views_inserted?: number | null;
-
-  /**
-   * Number of views renamed (subset of updated)
-   */
-  views_renamed?: number | null;
-
-  /**
-   * Number of views updated (dimension changes or renames)
-   */
-  views_updated?: number | null;
-}
-
-export namespace ConnectionApproveSyncResponse {
-  /**
-   * Response model for a single sync event.
-   */
-  export interface Event {
-    /**
-     * Event ID
-     */
-    id: string;
-
-    /**
-     * Event timestamp
-     */
-    created_at: string;
-
-    /**
-     * Event type: step_started, step_completed, progress, warning, error
-     */
-    event_type: string;
-
-    /**
-     * Human-readable event message
-     */
-    message: string;
-
-    /**
-     * Additional event data
-     */
-    metadata?: { [key: string]: unknown };
-
-    /**
-     * Step name if applicable
-     */
-    step_name?: string | null;
-  }
-}
-
-export type ConnectionListSyncsResponse = Array<ConnectionListSyncsResponse.ConnectionListSyncsResponseItem>;
-
-export namespace ConnectionListSyncsResponse {
-  /**
-   * Response for sync status endpoint.
-   *
-   * Contains full sync state including progress and results.
-   */
-  export interface ConnectionListSyncsResponseItem {
-    /**
-     * Connection ID
-     */
-    connection_id: string;
-
-    /**
-     * Sync creation timestamp
-     */
-    created_at: string;
-
-    /**
-     * Workflow status: queued, running, succeeded, failed, canceled
-     */
-    run_status: string;
-
-    /**
-     * Schema sync record ID
-     */
-    sync_id: string;
-
-    /**
-     * Workflow completion timestamp
-     */
-    completed_at?: string | null;
-
-    /**
-     * Current workflow step
-     */
-    current_step?: string | null;
-
-    /**
-     * Error message if failed
-     */
-    error_message?: string | null;
-
-    /**
-     * Sync event history
-     */
-    events?: Array<ConnectionListSyncsResponseItem.Event>;
-
-    /**
-     * Hatchet workflow run ID
-     */
-    hatchet_run_id?: string | null;
-
-    /**
-     * GitHub PR number
-     */
-    pr_number?: number | null;
-
-    /**
-     * PR status: open, merged, closed
-     */
-    pr_status?: string | null;
-
-    /**
-     * GitHub PR URL
-     */
-    pr_url?: string | null;
-
-    /**
-     * Workflow start timestamp
-     */
-    started_at?: string | null;
-
-    /**
-     * Number of views deleted
-     */
-    views_deleted?: number | null;
-
-    /**
-     * Number of new views added
-     */
-    views_inserted?: number | null;
-
-    /**
-     * Number of views renamed (subset of updated)
-     */
-    views_renamed?: number | null;
-
-    /**
-     * Number of views updated (dimension changes or renames)
-     */
-    views_updated?: number | null;
-  }
-
-  export namespace ConnectionListSyncsResponseItem {
-    /**
-     * Response model for a single sync event.
-     */
-    export interface Event {
-      /**
-       * Event ID
-       */
-      id: string;
-
-      /**
-       * Event timestamp
-       */
-      created_at: string;
-
-      /**
-       * Event type: step_started, step_completed, progress, warning, error
-       */
-      event_type: string;
-
-      /**
-       * Human-readable event message
-       */
-      message: string;
-
-      /**
-       * Additional event data
-       */
-      metadata?: { [key: string]: unknown };
-
-      /**
-       * Step name if applicable
-       */
-      step_name?: string | null;
-    }
-  }
-}
-
-/**
- * PostgreSQL credential response.
- */
-export type ConnectionRetrieveCredentialResponse =
-  | ConnectionRetrieveCredentialResponse.PostgresCredentialResponse
-  | ConnectionRetrieveCredentialResponse.SnowflakeCredentialResponse
-  | ConnectionRetrieveCredentialResponse.DatabricksCredentialResponse
-  | ConnectionRetrieveCredentialResponse.ClickHouseCredentialResponse
-  | ConnectionRetrieveCredentialResponse.MssqlCredentialResponse;
-
-export namespace ConnectionRetrieveCredentialResponse {
-  /**
-   * PostgreSQL credential response.
-   */
-  export interface PostgresCredentialResponse {
-    /**
-     * Database name
-     */
-    database: string;
-
-    /**
-     * Database host
-     */
-    host: string;
-
-    /**
-     * Decrypted password
-     */
-    password: string;
-
-    /**
-     * Database port
-     */
-    port: number;
-
-    /**
-     * Database username
-     */
-    username: string;
-
-    /**
-     * Warehouse type
-     */
-    warehouse_type: 'postgresql';
-  }
-
-  /**
-   * Snowflake credential response.
-   */
-  export interface SnowflakeCredentialResponse {
-    /**
-     * Snowflake account identifier
-     */
-    account: string;
-
-    /**
-     * Authentication credentials
-     */
-    auth:
-      | SnowflakeCredentialResponse.SnowflakePasswordAuthResponse
-      | SnowflakeCredentialResponse.SnowflakePrivateKeyAuthResponse;
-
-    /**
-     * Snowflake role
-     */
-    role: string;
-
-    /**
-     * Snowflake username
-     */
-    username: string;
-
-    /**
-     * Compute warehouse name
-     */
-    warehouse: string;
-
-    /**
-     * Warehouse type
-     */
-    warehouse_type: 'snowflake';
-  }
-
-  export namespace SnowflakeCredentialResponse {
-    /**
-     * Snowflake password authentication response.
-     */
-    export interface SnowflakePasswordAuthResponse {
-      /**
-       * Authentication type
-       */
-      auth_type: 'password';
-
-      /**
-       * Decrypted password
-       */
-      password: string;
-    }
-
-    /**
-     * Snowflake private key authentication response.
-     */
-    export interface SnowflakePrivateKeyAuthResponse {
-      /**
-       * Authentication type
-       */
-      auth_type: 'private_key';
-
-      /**
-       * PEM-encoded private key
-       */
-      private_key: string;
-
-      /**
-       * Passphrase if key is encrypted
-       */
-      private_key_passphrase?: string | null;
-    }
-  }
-
-  /**
-   * Databricks credential response.
-   */
-  export interface DatabricksCredentialResponse {
-    /**
-     * Databricks personal access token
-     */
-    access_token: string;
-
-    /**
-     * SQL warehouse HTTP path
-     */
-    http_path: string;
-
-    /**
-     * Databricks server hostname
-     */
-    server_hostname: string;
-
-    /**
-     * Warehouse type
-     */
-    warehouse_type: 'databricks';
-  }
-
-  /**
-   * ClickHouse credential response.
-   */
-  export interface ClickHouseCredentialResponse {
-    /**
-     * ClickHouse host
-     */
-    host: string;
-
-    /**
-     * Decrypted password
-     */
-    password: string;
-
-    /**
-     * ClickHouse port
-     */
-    port: number;
-
-    /**
-     * ClickHouse username
-     */
-    username: string;
-
-    /**
-     * Warehouse type
-     */
-    warehouse_type: 'clickhouse';
-
-    /**
-     * Database name
-     */
-    database?: string | null;
-  }
-
-  /**
-   * Microsoft SQL Server credential response.
-   */
-  export interface MssqlCredentialResponse {
-    /**
-     * SQL Server host
-     */
-    host: string;
-
-    /**
-     * Decrypted password
-     */
-    password: string;
-
-    /**
-     * SQL Server port
-     */
-    port: number;
-
-    /**
-     * SQL Server username
-     */
-    username: string;
-
-    /**
-     * Warehouse type
-     */
-    warehouse_type: 'mssql';
-
-    /**
-     * Database name
-     */
-    database?: string | null;
-  }
-}
-
-/**
- * Schema for Kater connection configuration files
- */
-export interface ConnectionRetrieveSchemaResponse {
-  /**
-   * Unique identifier for the connection
-   */
-  kater_id: string;
-
-  /**
-   * Name of the connection
-   */
-  name: string;
-
-  /**
-   * Warehouse-specific configuration (non-sensitive)
-   */
-  warehouse_metadata:
-    | ConnectionRetrieveSchemaResponse.SnowflakeMetadata
-    | ConnectionRetrieveSchemaResponse.PostgresqlMetadata
-    | ConnectionRetrieveSchemaResponse.DatabricksMetadata
-    | ConnectionRetrieveSchemaResponse.ClickhouseMetadata
-    | ConnectionRetrieveSchemaResponse.MssqlMetadata;
-
-  /**
-   * Additional context for AI processing
-   */
-  ai_context?: string | null;
-
-  /**
-   * Custom properties
-   */
-  custom_properties?: { [key: string]: unknown } | null;
-
-  /**
-   * List of databases in this connection
-   */
-  databases?: Array<ConnectionRetrieveSchemaResponse.Database> | null;
-
-  /**
-   * Description of the connection
-   */
-  description?: string | null;
-
-  /**
-   * Human-readable label for the connection
-   */
-  label?: string | null;
-
-  /**
-   * Query timeout in seconds
-   */
-  query_timeout?: number;
-
-  /**
-   * Timezone conversion mode for queries
-   */
-  query_timezone_conversion?: 'do_not_convert' | 'convert_to_utc';
-}
-
-export namespace ConnectionRetrieveSchemaResponse {
-  export interface SnowflakeMetadata {
-    /**
-     * Authentication method
-     */
-    auth_method: 'username_password' | 'key_pair';
-
-    /**
-     * Snowflake role
-     */
-    role: string;
-
-    /**
-     * Snowflake account identifier
-     */
-    snowflake_account_id: string;
-
-    /**
-     * Snowflake compute warehouse name
-     */
-    warehouse: string;
-
-    warehouse_type: 'snowflake';
-  }
-
-  export interface PostgresqlMetadata {
-    /**
-     * Database host address
-     */
-    host: string;
-
-    /**
-     * Database port (default: 5432)
-     */
-    port: number;
-
-    warehouse_type: 'postgresql';
-  }
-
-  export interface DatabricksMetadata {
-    /**
-     * Databricks SQL warehouse HTTP path
-     */
-    http_path: string;
-
-    /**
-     * Databricks server hostname
-     */
-    server_hostname: string;
-
-    warehouse_type: 'databricks';
-  }
-
-  export interface ClickhouseMetadata {
-    /**
-     * ClickHouse host address
-     */
-    host: string;
-
-    /**
-     * ClickHouse port (default: 8443)
-     */
-    port: number;
-
-    warehouse_type: 'clickhouse';
-  }
-
-  export interface MssqlMetadata {
-    /**
-     * SQL Server host address
-     */
-    host: string;
-
-    /**
-     * SQL Server port (default: 1433)
-     */
-    port: number;
-
-    warehouse_type: 'mssql';
-  }
-
-  export interface Database {
-    /**
-     * The actual name of the database object in the warehouse
-     */
-    database_object_name: string;
-
-    /**
-     * Unique identifier for the database
-     */
-    kater_id: string;
-
-    /**
-     * Name of the database
-     */
-    name: string;
-
-    /**
-     * Additional context for AI processing
-     */
-    ai_context?: string | null;
-
-    /**
-     * Custom properties
-     */
-    custom_properties?: { [key: string]: unknown } | null;
-
-    /**
-     * Description of the database
-     */
-    description?: string | null;
-
-    /**
-     * Human-readable label for the database
-     */
-    label?: string | null;
-
-    /**
-     * List of schemas in this database
-     */
-    schemas?: Array<Database.Schema> | null;
-
-    /**
-     * Timezone for the database
-     */
-    timezone?: string | null;
-  }
-
-  export namespace Database {
-    export interface Schema {
-      /**
-       * The actual name of the schema object in the warehouse
-       */
-      database_object_name: string;
-
-      /**
-       * Unique identifier for the schema
-       */
-      kater_id: string;
-
-      /**
-       * Name of the schema
-       */
-      name: string;
-
-      /**
-       * Additional context for AI processing
-       */
-      ai_context?: string | null;
-
-      /**
-       * Custom properties
-       */
-      custom_properties?: { [key: string]: unknown } | null;
-
-      /**
-       * Description of the schema
-       */
-      description?: string | null;
-
-      /**
-       * Human-readable label for the schema
-       */
-      label?: string | null;
-    }
-  }
-}
-
-/**
- * Response for sync status endpoint.
- *
- * Contains full sync state including progress and results.
- */
-export interface ConnectionRetrieveSyncStatusResponse {
-  /**
-   * Connection ID
-   */
-  connection_id: string;
-
-  /**
-   * Sync creation timestamp
-   */
-  created_at: string;
-
-  /**
-   * Workflow status: queued, running, succeeded, failed, canceled
-   */
-  run_status: string;
-
-  /**
-   * Schema sync record ID
-   */
-  sync_id: string;
-
-  /**
-   * Workflow completion timestamp
-   */
-  completed_at?: string | null;
-
-  /**
-   * Current workflow step
-   */
-  current_step?: string | null;
-
-  /**
-   * Error message if failed
-   */
-  error_message?: string | null;
-
-  /**
-   * Sync event history
-   */
-  events?: Array<ConnectionRetrieveSyncStatusResponse.Event>;
-
-  /**
-   * Hatchet workflow run ID
-   */
-  hatchet_run_id?: string | null;
-
-  /**
-   * GitHub PR number
-   */
-  pr_number?: number | null;
-
-  /**
-   * PR status: open, merged, closed
-   */
-  pr_status?: string | null;
-
-  /**
-   * GitHub PR URL
-   */
-  pr_url?: string | null;
-
-  /**
-   * Workflow start timestamp
-   */
-  started_at?: string | null;
-
-  /**
-   * Number of views deleted
-   */
-  views_deleted?: number | null;
-
-  /**
-   * Number of new views added
-   */
-  views_inserted?: number | null;
-
-  /**
-   * Number of views renamed (subset of updated)
-   */
-  views_renamed?: number | null;
-
-  /**
-   * Number of views updated (dimension changes or renames)
-   */
-  views_updated?: number | null;
-}
-
-export namespace ConnectionRetrieveSyncStatusResponse {
-  /**
-   * Response model for a single sync event.
-   */
-  export interface Event {
-    /**
-     * Event ID
-     */
-    id: string;
-
-    /**
-     * Event timestamp
-     */
-    created_at: string;
-
-    /**
-     * Event type: step_started, step_completed, progress, warning, error
-     */
-    event_type: string;
-
-    /**
-     * Human-readable event message
-     */
-    message: string;
-
-    /**
-     * Additional event data
-     */
-    metadata?: { [key: string]: unknown };
-
-    /**
-     * Step name if applicable
-     */
-    step_name?: string | null;
-  }
-}
-
-export type ConnectionStreamSyncProgressResponse = unknown;
-
-/**
- * Response for starting a schema sync.
- *
- * Returned with 202 Accepted when sync workflow is successfully queued.
- */
-export interface ConnectionSyncResponse {
-  /**
-   * Schema sync record ID
-   */
-  sync_id: string;
-
-  /**
-   * Hatchet workflow run ID
-   */
-  hatchet_run_id?: string | null;
-
-  /**
-   * Current sync status
-   */
-  status?: string;
-}
-
-/**
- * Response for credential update.
- */
-export interface ConnectionUpdateCredentialsResponse {
-  /**
-   * Connection ID
-   */
-  connection_id: string;
-
-  /**
-   * Whether the credential update was successful
-   */
-  success: boolean;
-}
-
-export type ConnectionCreateParams =
-  | ConnectionCreateParams.PostgresConnectionConfig
-  | ConnectionCreateParams.SnowflakeConnectionConfig
-  | ConnectionCreateParams.DatabricksConnectionConfig
-  | ConnectionCreateParams.ClickHouseConnectionConfig
-  | ConnectionCreateParams.MssqlConnectionConfig;
-
-export declare namespace ConnectionCreateParams {
-  export interface PostgresConnectionConfig {
-    /**
-     * Databases to include in the connection (at least one required)
-     */
-    databases: Array<DatabaseConfig>;
-
-    /**
-     * Database host
-     */
-    host: string;
-
-    /**
-     * Name of the connection (snake_case: lowercase letters, numbers, underscores)
-     */
-    name: string;
-
-    /**
-     * Database password
-     */
-    password: string;
-
-    /**
-     * Database username
-     */
-    username: string;
-
-    /**
-     * Warehouse type
-     */
-    warehouse_type: 'postgresql';
-
-    /**
-     * Description of the connection
-     */
-    description?: string | null;
-
-    /**
-     * Human-readable label for the connection (defaults to name if not set)
-     */
-    label?: string | null;
-
-    /**
-     * Database port
-     */
-    port?: number;
-
-    /**
-     * Query timeout in seconds (1-3600)
-     */
-    query_timeout?: number | null;
-
-    /**
-     * Timezone conversion mode: 'do_not_convert' or 'convert_to_utc'
-     */
-    query_timezone_conversion?: string | null;
-  }
-
-  export interface SnowflakeConnectionConfig {
-    /**
-     * Snowflake account identifier (e.g., 'xy12345.us-east-1')
-     */
-    account: string;
-
-    /**
-     * Authentication configuration
-     */
-    auth: SnowflakeConnectionConfig.SnowflakePasswordAuth | SnowflakeConnectionConfig.SnowflakePrivateKeyAuth;
-
-    /**
-     * Databases to include in the connection (at least one required)
-     */
-    databases: Array<DatabaseConfig>;
-
-    /**
-     * Name of the connection (snake_case: lowercase letters, numbers, underscores)
-     */
-    name: string;
-
-    /**
-     * Snowflake role
-     */
-    role: string;
-
-    /**
-     * Snowflake username
-     */
-    username: string;
-
-    /**
-     * Compute warehouse name
-     */
-    warehouse: string;
-
-    /**
-     * Warehouse type
-     */
-    warehouse_type: 'snowflake';
-
-    /**
-     * Description of the connection
-     */
-    description?: string | null;
-
-    /**
-     * Human-readable label for the connection (defaults to name if not set)
-     */
-    label?: string | null;
-
-    /**
-     * Query timeout in seconds (1-3600)
-     */
-    query_timeout?: number | null;
-
-    /**
-     * Timezone conversion mode: 'do_not_convert' or 'convert_to_utc'
-     */
-    query_timezone_conversion?: string | null;
-  }
-
-  export namespace SnowflakeConnectionConfig {
-    /**
-     * Snowflake password authentication.
-     */
-    export interface SnowflakePasswordAuth {
-      /**
-       * Authentication type
-       */
-      auth_type: 'password';
-
-      /**
-       * Snowflake password
-       */
-      password: string;
-    }
-
-    /**
-     * Snowflake private key authentication.
-     */
-    export interface SnowflakePrivateKeyAuth {
-      /**
-       * Authentication type
-       */
-      auth_type: 'private_key';
-
-      /**
-       * PEM-encoded private key
-       */
-      private_key: string;
-
-      /**
-       * Passphrase if key is encrypted
-       */
-      private_key_passphrase?: string | null;
-    }
-  }
-
-  export interface DatabricksConnectionConfig {
-    /**
-     * Databricks personal access token
-     */
-    access_token: string;
-
-    /**
-     * Databases to include in the connection (at least one required)
-     */
-    databases: Array<DatabaseConfig>;
-
-    /**
-     * SQL warehouse HTTP path (e.g., '/sql/1.0/warehouses/xxx')
-     */
-    http_path: string;
-
-    /**
-     * Name of the connection (snake_case: lowercase letters, numbers, underscores)
-     */
-    name: string;
-
-    /**
-     * Databricks server hostname (e.g., 'dbc-xxx.cloud.databricks.com')
-     */
-    server_hostname: string;
-
-    /**
-     * Warehouse type
-     */
-    warehouse_type: 'databricks';
-
-    /**
-     * Description of the connection
-     */
-    description?: string | null;
-
-    /**
-     * Human-readable label for the connection (defaults to name if not set)
-     */
-    label?: string | null;
-
-    /**
-     * Query timeout in seconds (1-3600)
-     */
-    query_timeout?: number | null;
-
-    /**
-     * Timezone conversion mode: 'do_not_convert' or 'convert_to_utc'
-     */
-    query_timezone_conversion?: string | null;
-  }
-
-  export interface ClickHouseConnectionConfig {
-    /**
-     * Databases to include in the connection (at least one required)
-     */
-    databases: Array<DatabaseConfig>;
-
-    /**
-     * ClickHouse host
-     */
-    host: string;
-
-    /**
-     * Name of the connection (snake_case: lowercase letters, numbers, underscores)
-     */
-    name: string;
-
-    /**
-     * ClickHouse password
-     */
-    password: string;
-
-    /**
-     * ClickHouse username
-     */
-    username: string;
-
-    /**
-     * Warehouse type
-     */
-    warehouse_type: 'clickhouse';
-
-    /**
-     * Description of the connection
-     */
-    description?: string | null;
-
-    /**
-     * Human-readable label for the connection (defaults to name if not set)
-     */
-    label?: string | null;
-
-    /**
-     * ClickHouse port
-     */
-    port?: number;
-
-    /**
-     * Query timeout in seconds (1-3600)
-     */
-    query_timeout?: number | null;
-
-    /**
-     * Timezone conversion mode: 'do_not_convert' or 'convert_to_utc'
-     */
-    query_timezone_conversion?: string | null;
-  }
-
-  export interface MssqlConnectionConfig {
-    /**
-     * Databases to include in the connection (at least one required)
-     */
-    databases: Array<DatabaseConfig>;
-
-    /**
-     * SQL Server host
-     */
-    host: string;
-
-    /**
-     * Name of the connection (snake_case: lowercase letters, numbers, underscores)
-     */
-    name: string;
-
-    /**
-     * SQL Server password
-     */
-    password: string;
-
-    /**
-     * SQL Server username
-     */
-    username: string;
-
-    /**
-     * Warehouse type
-     */
-    warehouse_type: 'mssql';
-
-    /**
-     * Description of the connection
-     */
-    description?: string | null;
-
-    /**
-     * Human-readable label for the connection (defaults to name if not set)
-     */
-    label?: string | null;
-
-    /**
-     * SQL Server port
-     */
-    port?: number;
-
-    /**
-     * Query timeout in seconds (1-3600)
-     */
-    query_timeout?: number | null;
-
-    /**
-     * Timezone conversion mode: 'do_not_convert' or 'convert_to_utc'
-     */
-    query_timezone_conversion?: string | null;
-  }
-}
-
-export interface ConnectionUpdateParams {
-  /**
-   * Connection description
-   */
-  description?: string | null;
-
-  /**
-   * Human-readable display label
-   */
-  label?: string | null;
-
-  /**
-   * Connection name (snake_case identifier)
-   */
-  name?: string | null;
-}
-
-export interface ConnectionListParams {
-  status?: 'approved' | 'pending' | 'all';
-}
-
-export interface ConnectionApproveSyncParams {
-  connection_id: string;
-}
-
-export interface ConnectionListSyncsParams {
-  limit?: number;
-
-  offset?: number;
-}
-
-export interface ConnectionRetrieveSyncStatusParams {
-  connection_id: string;
-}
-
-export interface ConnectionStreamSyncProgressParams {
-  connection_id: string;
-}
-
-export type ConnectionUpdateCredentialsParams =
-  | ConnectionUpdateCredentialsParams.PostgreSqlCredentialUpdate
-  | ConnectionUpdateCredentialsParams.SnowflakeCredentialUpdate
-  | ConnectionUpdateCredentialsParams.DatabricksCredentialUpdate
-  | ConnectionUpdateCredentialsParams.ClickHouseCredentialUpdate
-  | ConnectionUpdateCredentialsParams.MssqlCredentialUpdate;
-
-export declare namespace ConnectionUpdateCredentialsParams {
-  export interface PostgreSqlCredentialUpdate {
-    /**
-     * Database password
-     */
-    password: string;
-
-    /**
-     * Database username
-     */
-    username: string;
-
-    /**
-     * Warehouse type
-     */
-    warehouse_type: 'postgresql';
-  }
-
-  export interface SnowflakeCredentialUpdate {
-    /**
-     * Authentication credentials
-     */
-    auth:
-      | SnowflakeCredentialUpdate.SnowflakePasswordCredentialAuth
-      | SnowflakeCredentialUpdate.SnowflakePrivateKeyCredentialAuth;
-
-    /**
-     * Snowflake username
-     */
-    username: string;
-
-    /**
-     * Warehouse type
-     */
-    warehouse_type: 'snowflake';
-  }
-
-  export namespace SnowflakeCredentialUpdate {
-    /**
-     * Snowflake password auth for credential update.
-     */
-    export interface SnowflakePasswordCredentialAuth {
-      /**
-       * Authentication type
-       */
-      auth_type: 'password';
-
-      /**
-       * Snowflake password
-       */
-      password: string;
-    }
-
-    /**
-     * Snowflake private key auth for credential update.
-     */
-    export interface SnowflakePrivateKeyCredentialAuth {
-      /**
-       * Authentication type
-       */
-      auth_type: 'private_key';
-
-      /**
-       * PEM-encoded private key
-       */
-      private_key: string;
-    }
-  }
-
-  export interface DatabricksCredentialUpdate {
-    /**
-     * Databricks personal access token
-     */
-    access_token: string;
-
-    /**
-     * Warehouse type
-     */
-    warehouse_type: 'databricks';
-  }
-
-  export interface ClickHouseCredentialUpdate {
-    /**
-     * ClickHouse password
-     */
-    password: string;
-
-    /**
-     * ClickHouse username
-     */
-    username: string;
-
-    /**
-     * Warehouse type
-     */
-    warehouse_type: 'clickhouse';
-  }
-
-  export interface MssqlCredentialUpdate {
-    /**
-     * SQL Server password
-     */
-    password: string;
-
-    /**
-     * SQL Server username
-     */
-    username: string;
-
-    /**
-     * Warehouse type
-     */
-    warehouse_type: 'mssql';
-  }
-}
-
-Connections.Databases = Databases;
-Connections.Views = Views;
-Connections.Yaml = Yaml;
-
-export declare namespace Connections {
-  export {
-    type Connection as Connection,
-    type DatabaseConfig as DatabaseConfig,
-    type ConnectionListResponse as ConnectionListResponse,
-    type ConnectionApproveSyncResponse as ConnectionApproveSyncResponse,
-    type ConnectionListSyncsResponse as ConnectionListSyncsResponse,
-    type ConnectionRetrieveCredentialResponse as ConnectionRetrieveCredentialResponse,
-    type ConnectionRetrieveSchemaResponse as ConnectionRetrieveSchemaResponse,
-    type ConnectionRetrieveSyncStatusResponse as ConnectionRetrieveSyncStatusResponse,
-    type ConnectionStreamSyncProgressResponse as ConnectionStreamSyncProgressResponse,
-    type ConnectionSyncResponse as ConnectionSyncResponse,
-    type ConnectionUpdateCredentialsResponse as ConnectionUpdateCredentialsResponse,
-    type ConnectionCreateParams as ConnectionCreateParams,
-    type ConnectionUpdateParams as ConnectionUpdateParams,
-    type ConnectionListParams as ConnectionListParams,
-    type ConnectionApproveSyncParams as ConnectionApproveSyncParams,
-    type ConnectionListSyncsParams as ConnectionListSyncsParams,
-    type ConnectionRetrieveSyncStatusParams as ConnectionRetrieveSyncStatusParams,
-    type ConnectionStreamSyncProgressParams as ConnectionStreamSyncProgressParams,
-    type ConnectionUpdateCredentialsParams as ConnectionUpdateCredentialsParams,
-  };
-
-  export { Databases as Databases, type DatabaseDeleteSchemaParams as DatabaseDeleteSchemaParams };
-
-  export {
-    Views as Views,
-    type ViewRetrieveResponse as ViewRetrieveResponse,
-    type ViewListResponse as ViewListResponse,
-    type ViewRetrieveParams as ViewRetrieveParams,
-    type ViewListParams as ViewListParams,
-  };
-
-  export {
-    Yaml as Yaml,
-    type YamlRetrieveResponse as YamlRetrieveResponse,
-    type YamlCommitResponse as YamlCommitResponse,
-    type YamlCommitParams as YamlCommitParams,
-  };
-}