@katerai/sdk 0.4.0 → 0.6.0

package/resources/v1/connections/connections.d.mts

@@ -1,22 +1,26 @@
 import { APIResource } from "../../../core/resource.mjs";
 import * as DatabasesAPI from "./databases.mjs";
-import { DatabaseDeleteSchemaParams, DatabaseUpdateParams, DatabaseUpdateResponse, DatabaseUpdateSchemaParams, DatabaseUpdateSchemaResponse, Databases } from "./databases.mjs";
+import { DatabaseDeleteSchemaParams, Databases } from "./databases.mjs";
+import * as ViewsAPI from "./views.mjs";
+import { ViewListParams, ViewListResponse, ViewRetrieveParams, ViewRetrieveResponse, Views } from "./views.mjs";
+import * as YamlAPI from "./yaml.mjs";
+import { Yaml, YamlCommitParams, YamlCommitResponse, YamlRetrieveResponse } from "./yaml.mjs";
 import { APIPromise } from "../../../core/api-promise.mjs";
 import { RequestOptions } from "../../../internal/request-options.mjs";
 export declare class Connections extends APIResource {
     databases: DatabasesAPI.Databases;
+    views: ViewsAPI.Views;
+    yaml: YamlAPI.Yaml;
     /**
-     * Create a new warehouse connection.
+     * Create a new warehouse connection with PR approval flow.
      */
     create(body: ConnectionCreateParams, options?: RequestOptions): APIPromise<Connection>;
     /**
-     * Get a single warehouse connection by kater_id.
+     * Get a single warehouse connection by ID.
      *
-     * Returns connection from the database (source of truth) with full hierarchy.
-     * Supports content negotiation via Accept header (handled by MultiFormatRoute):
-     *
-     * - application/json (default): Returns JSON response
-     * - application/yaml: Returns YAML representation
+     * 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).
      *
@@ -34,15 +38,20 @@ export declare class Connections extends APIResource {
      */
     update(connectionID: string, body: ConnectionUpdateParams, options?: RequestOptions): APIPromise<Connection>;
     /**
-     * List all warehouse connections for the client.
+     * List warehouse connections for the client.
+     *
+     * Filter connections by approval status using the `status` query parameter:
      *
-     * Returns connections from the database joined with schema information from
-     * GitHub. Connections with pending PRs will have null GitHub fields until merged.
-     * Returns empty list if GitHub is not configured.
+     * - `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(options?: RequestOptions): APIPromise<ConnectionListResponse>;
+    list(query?: ConnectionListParams | null | undefined, options?: RequestOptions): APIPromise<ConnectionListResponse>;
     /**
      * Delete a warehouse connection.
      *
@@ -54,6 +63,18 @@ export declare class Connections extends APIResource {
      * Raises: ConnectionNotFoundError: If connection doesn't exist (404)
      */
     delete(connectionID: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Merge the PR for a pending connection to finalize it.
+     */
+    approve(connectionID: string, options?: RequestOptions): APIPromise<Connection>;
+    /**
+     * Merge the PR for a completed schema sync.
+     */
+    approveSync(syncID: string, params: ConnectionApproveSyncParams, options?: RequestOptions): APIPromise<ConnectionApproveSyncResponse>;
+    /**
+     * List all schema sync records for a connection.
+     */
+    listSyncs(connectionID: string, query?: ConnectionListSyncsParams | null | undefined, options?: RequestOptions): APIPromise<ConnectionListSyncsResponse>;
     /**
      * Get decrypted warehouse credentials for a connection.
      *
@@ -66,15 +87,38 @@ export declare class Connections extends APIResource {
      */
     retrieveCredential(connectionID: string, options?: RequestOptions): APIPromise<ConnectionRetrieveCredentialResponse>;
     /**
-     * Sync view schemas from warehouse and create a PR (or update existing).
+     * 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>;
+    /**
+     * Get the current status of a schema sync workflow.
+     */
+    retrieveSyncStatus(syncID: string, params: ConnectionRetrieveSyncStatusParams, options?: RequestOptions): APIPromise<ConnectionRetrieveSyncStatusResponse>;
+    /**
+     * Server-Sent Events stream for real-time sync progress updates.
+     */
+    streamSyncProgress(syncID: string, params: ConnectionStreamSyncProgressParams, options?: RequestOptions): APIPromise<unknown>;
+    /**
+     * Start a schema sync workflow. Returns 202 Accepted with sync_id.
      */
     sync(connectionID: string, options?: RequestOptions): APIPromise<ConnectionSyncResponse>;
+    /**
+     * Test and update warehouse credentials without modifying connection config.
+     */
+    updateCredentials(connectionID: string, body: ConnectionUpdateCredentialsParams, options?: RequestOptions): APIPromise<ConnectionUpdateCredentialsResponse>;
 }
 /**
  * Response model for a single connection.
  *
- * All data comes from the database (source of truth). JSON responses use 'id'
- * field; YAML responses transform to 'kater_id' via MultiFormatRoute.
+ * All data comes from the database (source of truth). For YAML-compatible output
+ * with 'kater_id', use the /schema endpoint instead.
  */
 export interface Connection {
     /**
@@ -104,19 +148,23 @@ export interface Connection {
     /**
      * Warehouse-specific configuration
      */
-    warehouse_metadata: Connection.SnowflakeMetadata | Connection.PostgresMetadata | Connection.DatabricksMetadata | Connection.ClickHouseMetadata | Connection.MssqlMetadata;
+    warehouse_metadata: Connection.SnowflakeMetadata | Connection.PostgresqlMetadata | Connection.DatabricksMetadata | Connection.ClickhouseMetadata | Connection.MssqlMetadata;
     /**
      * Warehouse type (snowflake, postgresql, etc.)
      */
     warehouse_type: string;
     /**
-     * Default timezone for the connection
+     * GitHub PR URL for approving the connection (None if already approved)
      */
-    database_timezone?: string | null;
+    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
      */
@@ -129,10 +177,6 @@ export interface Connection {
      * Timezone conversion mode (do_not_convert, convert_to_utc)
      */
     query_timezone_conversion?: string | null;
-    /**
-     * Sync identifier for schema sync
-     */
-    sync_id?: string | null;
 }
 export declare namespace Connection {
     /**
@@ -143,6 +187,10 @@ export declare namespace Connection {
          * Database ID
          */
         id: string;
+        /**
+         * Actual name of the database in the warehouse
+         */
+        database_object_name: string;
         /**
          * Database name
          */
@@ -173,6 +221,10 @@ export declare namespace Connection {
              * Schema ID
              */
             id: string;
+            /**
+             * Actual name of the schema in the warehouse
+             */
+            database_object_name: string;
             /**
              * Schema name
              */
@@ -187,9 +239,6 @@ export declare namespace Connection {
             label?: string | null;
         }
     }
-    /**
-     * Snowflake-specific warehouse metadata.
-     */
     interface SnowflakeMetadata {
         /**
          * Authentication method
@@ -204,80 +253,53 @@ export declare namespace Connection {
          */
         snowflake_account_id: string;
         /**
-         * Compute warehouse name
+         * Snowflake compute warehouse name
          */
         warehouse: string;
-        /**
-         * Warehouse type discriminator
-         */
         warehouse_type: 'snowflake';
     }
-    /**
-     * PostgreSQL-specific warehouse metadata.
-     */
-    interface PostgresMetadata {
+    interface PostgresqlMetadata {
         /**
-         * Database host
+         * Database host address
          */
         host: string;
         /**
-         * Database port
+         * Database port (default: 5432)
          */
         port: number;
-        /**
-         * Warehouse type discriminator
-         */
         warehouse_type: 'postgresql';
     }
-    /**
-     * Databricks-specific warehouse metadata.
-     */
     interface DatabricksMetadata {
         /**
-         * SQL warehouse HTTP path
+         * Databricks SQL warehouse HTTP path
          */
         http_path: string;
         /**
          * Databricks server hostname
          */
         server_hostname: string;
-        /**
-         * Warehouse type discriminator
-         */
         warehouse_type: 'databricks';
     }
-    /**
-     * ClickHouse-specific warehouse metadata.
-     */
-    interface ClickHouseMetadata {
+    interface ClickhouseMetadata {
         /**
-         * ClickHouse host
+         * ClickHouse host address
          */
         host: string;
         /**
-         * ClickHouse port
+         * ClickHouse port (default: 8443)
          */
         port: number;
-        /**
-         * Warehouse type discriminator
-         */
         warehouse_type: 'clickhouse';
     }
-    /**
-     * Microsoft SQL Server-specific warehouse metadata.
-     */
     interface MssqlMetadata {
         /**
-         * SQL Server host
+         * SQL Server host address
          */
         host: string;
         /**
-         * SQL Server port
+         * SQL Server port (default: 1433)
          */
         port: number;
-        /**
-         * Warehouse type discriminator
-         */
         warehouse_type: 'mssql';
     }
 }
@@ -286,7 +308,7 @@ export declare namespace Connection {
  */
 export interface DatabaseConfig {
     /**
-     * Database name
+     * Database name (also used as the warehouse object name)
      */
     name: string;
     /**
@@ -312,7 +334,7 @@ export declare namespace DatabaseConfig {
      */
     interface Schema {
         /**
-         * Schema name
+         * Schema name (also used as the warehouse object name)
          */
         name: string;
         /**
@@ -326,6 +348,225 @@ export declare namespace DatabaseConfig {
     }
 }
 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 declare namespace ConnectionApproveSyncResponse {
+    /**
+     * Response model for a single sync event.
+     */
+    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 declare namespace ConnectionListSyncsResponse {
+    /**
+     * Response for sync status endpoint.
+     *
+     * Contains full sync state including progress and results.
+     */
+    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;
+    }
+    namespace ConnectionListSyncsResponseItem {
+        /**
+         * Response model for a single sync event.
+         */
+        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.
  */
@@ -502,28 +743,331 @@ export declare namespace ConnectionRetrieveCredentialResponse {
     }
 }
 /**
- * Response for syncing views.
+ * 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 declare namespace ConnectionRetrieveSchemaResponse {
+    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';
+    }
+    interface PostgresqlMetadata {
+        /**
+         * Database host address
+         */
+        host: string;
+        /**
+         * Database port (default: 5432)
+         */
+        port: number;
+        warehouse_type: 'postgresql';
+    }
+    interface DatabricksMetadata {
+        /**
+         * Databricks SQL warehouse HTTP path
+         */
+        http_path: string;
+        /**
+         * Databricks server hostname
+         */
+        server_hostname: string;
+        warehouse_type: 'databricks';
+    }
+    interface ClickhouseMetadata {
+        /**
+         * ClickHouse host address
+         */
+        host: string;
+        /**
+         * ClickHouse port (default: 8443)
+         */
+        port: number;
+        warehouse_type: 'clickhouse';
+    }
+    interface MssqlMetadata {
+        /**
+         * SQL Server host address
+         */
+        host: string;
+        /**
+         * SQL Server port (default: 1433)
+         */
+        port: number;
+        warehouse_type: 'mssql';
+    }
+    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;
+    }
+    namespace Database {
+        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.
  *
- * Returned after successfully creating a PR with merged ViewSchema files, or
- * indicating that all views are already up to date.
+ * Contains full sync state including progress and results.
  */
-export interface ConnectionSyncResponse {
+export interface ConnectionRetrieveSyncStatusResponse {
     /**
-     * Number of views in the PR
+     * Connection ID
      */
-    views_updated: number;
+    connection_id: string;
+    /**
+     * Sync creation timestamp
+     */
+    created_at: string;
     /**
-     * Status message
+     * Workflow status: queued, running, succeeded, failed, canceled
      */
-    message?: string | null;
+    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 declare namespace ConnectionRetrieveSyncStatusResponse {
+    /**
+     * Response model for a single sync event.
+     */
+    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 {
@@ -552,10 +1096,6 @@ export declare namespace ConnectionCreateParams {
          * Warehouse type
          */
         warehouse_type: 'postgresql';
-        /**
-         * Default timezone for the connection (e.g., 'UTC', 'America/New_York')
-         */
-        database_timezone?: string | null;
         /**
          * Description of the connection
          */
@@ -610,10 +1150,6 @@ export declare namespace ConnectionCreateParams {
          * Warehouse type
          */
         warehouse_type: 'snowflake';
-        /**
-         * Default timezone for the connection (e.g., 'UTC', 'America/New_York')
-         */
-        database_timezone?: string | null;
         /**
          * Description of the connection
          */
@@ -688,10 +1224,6 @@ export declare namespace ConnectionCreateParams {
          * Warehouse type
          */
         warehouse_type: 'databricks';
-        /**
-         * Default timezone for the connection (e.g., 'UTC', 'America/New_York')
-         */
-        database_timezone?: string | null;
         /**
          * Description of the connection
          */
@@ -734,10 +1266,6 @@ export declare namespace ConnectionCreateParams {
          * Warehouse type
          */
         warehouse_type: 'clickhouse';
-        /**
-         * Default timezone for the connection (e.g., 'UTC', 'America/New_York')
-         */
-        database_timezone?: string | null;
         /**
          * Description of the connection
          */
@@ -784,10 +1312,6 @@ export declare namespace ConnectionCreateParams {
          * Warehouse type
          */
         warehouse_type: 'mssql';
-        /**
-         * Default timezone for the connection (e.g., 'UTC', 'America/New_York')
-         */
-        database_timezone?: string | null;
         /**
          * Description of the connection
          */
@@ -824,8 +1348,123 @@ export interface ConnectionUpdateParams {
      */
     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 {
+    interface PostgreSqlCredentialUpdate {
+        /**
+         * Database password
+         */
+        password: string;
+        /**
+         * Database username
+         */
+        username: string;
+        /**
+         * Warehouse type
+         */
+        warehouse_type: 'postgresql';
+    }
+    interface SnowflakeCredentialUpdate {
+        /**
+         * Authentication credentials
+         */
+        auth: SnowflakeCredentialUpdate.SnowflakePasswordCredentialAuth | SnowflakeCredentialUpdate.SnowflakePrivateKeyCredentialAuth;
+        /**
+         * Snowflake username
+         */
+        username: string;
+        /**
+         * Warehouse type
+         */
+        warehouse_type: 'snowflake';
+    }
+    namespace SnowflakeCredentialUpdate {
+        /**
+         * Snowflake password auth for credential update.
+         */
+        interface SnowflakePasswordCredentialAuth {
+            /**
+             * Authentication type
+             */
+            auth_type: 'password';
+            /**
+             * Snowflake password
+             */
+            password: string;
+        }
+        /**
+         * Snowflake private key auth for credential update.
+         */
+        interface SnowflakePrivateKeyCredentialAuth {
+            /**
+             * Authentication type
+             */
+            auth_type: 'private_key';
+            /**
+             * PEM-encoded private key
+             */
+            private_key: string;
+        }
+    }
+    interface DatabricksCredentialUpdate {
+        /**
+         * Databricks personal access token
+         */
+        access_token: string;
+        /**
+         * Warehouse type
+         */
+        warehouse_type: 'databricks';
+    }
+    interface ClickHouseCredentialUpdate {
+        /**
+         * ClickHouse password
+         */
+        password: string;
+        /**
+         * ClickHouse username
+         */
+        username: string;
+        /**
+         * Warehouse type
+         */
+        warehouse_type: 'clickhouse';
+    }
+    interface MssqlCredentialUpdate {
+        /**
+         * SQL Server password
+         */
+        password: string;
+        /**
+         * SQL Server username
+         */
+        username: string;
+        /**
+         * Warehouse type
+         */
+        warehouse_type: 'mssql';
+    }
+}
 export declare namespace Connections {
-    export { type Connection as Connection, type DatabaseConfig as DatabaseConfig, type ConnectionListResponse as ConnectionListResponse, type ConnectionRetrieveCredentialResponse as ConnectionRetrieveCredentialResponse, type ConnectionSyncResponse as ConnectionSyncResponse, type ConnectionCreateParams as ConnectionCreateParams, type ConnectionUpdateParams as ConnectionUpdateParams, };
-    export { Databases as Databases, type DatabaseUpdateResponse as DatabaseUpdateResponse, type DatabaseUpdateSchemaResponse as DatabaseUpdateSchemaResponse, type DatabaseUpdateParams as DatabaseUpdateParams, type DatabaseDeleteSchemaParams as DatabaseDeleteSchemaParams, type DatabaseUpdateSchemaParams as DatabaseUpdateSchemaParams, };
+    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, };
 }
 //# sourceMappingURL=connections.d.mts.map