@katerai/sdk 0.6.0 → 0.8.0

package/src/resources/v1/connections.ts

@@ -1,3 +1,279 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export * from './connections/index';
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+
+export class Connections extends APIResource {
+  /**
+   * 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).
+   */
+  listConnections(
+    query: ConnectionListConnectionsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ConnectionListConnectionsResponse> {
+    return this._client.get('/api/v1/connections', { query, ...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';
+  }
+}
+
+export type ConnectionListConnectionsResponse = Array<Connection>;
+
+export interface ConnectionListConnectionsParams {
+  status?: 'approved' | 'pending' | 'all';
+}
+
+export declare namespace Connections {
+  export {
+    type Connection as Connection,
+    type ConnectionListConnectionsResponse as ConnectionListConnectionsResponse,
+    type ConnectionListConnectionsParams as ConnectionListConnectionsParams,
+  };
+}

package/src/resources/v1/index.ts

@@ -1,52 +1,32 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export {
+  Compiler,
+  type ChartConfig,
+  type CompilerErrorItem,
+  type InlineField,
+  type Manifest,
+  type ManifestEntry,
+  type RefWithLabel,
+  type SubqueryCondition,
+  type CompilerCompileResponse,
+  type CompilerResolveResponse,
+  type CompilerValidateResponse,
+  type CompilerCompileParams,
+  type CompilerResolveParams,
+  type CompilerValidateParams,
+} from './compiler';
 export {
   Connections,
   type Connection,
-  type DatabaseConfig,
-  type ConnectionListResponse,
-  type ConnectionApproveSyncResponse,
-  type ConnectionListSyncsResponse,
-  type ConnectionRetrieveCredentialResponse,
-  type ConnectionRetrieveSchemaResponse,
-  type ConnectionRetrieveSyncStatusResponse,
-  type ConnectionStreamSyncProgressResponse,
-  type ConnectionSyncResponse,
-  type ConnectionUpdateCredentialsResponse,
-  type ConnectionCreateParams,
-  type ConnectionUpdateParams,
-  type ConnectionListParams,
-  type ConnectionApproveSyncParams,
-  type ConnectionListSyncsParams,
-  type ConnectionRetrieveSyncStatusParams,
-  type ConnectionStreamSyncProgressParams,
-  type ConnectionUpdateCredentialsParams,
-} from './connections/index';
-export {
-  GitHub,
-  type GitHubCallbackResponse,
-  type GitHubConnectResponse,
-  type GitHubGetInstallationLinkResponse,
-  type GitHubGetStatusResponse,
-  type GitHubCallbackParams,
-  type GitHubConnectParams,
-} from './github/index';
-export {
-  Groups,
-  type GroupDetail,
-  type GroupListResponse,
-  type GroupCreateParams,
-  type GroupUpdateParams,
-} from './groups/index';
-export { Me, type ClientUser, type ClientUserRole } from './me';
-export { Org } from './org/index';
+  type ConnectionListConnectionsResponse,
+  type ConnectionListConnectionsParams,
+} from './connections';
 export {
   Tenants,
-  type CreateTenant,
-  type Tenant,
-  type TenantListResponse,
-  type TenantRetrieveSchemaResponse,
-  type TenantCreateParams,
-  type TenantUpdateParams,
+  type ImportTenantsResponse,
+  type TenantGetTenantsSchemaResponse,
+  type TenantImportFromCsvParams,
+  type TenantImportFromWarehouseParams,
 } from './tenants/index';
 export { V1 } from './v1';

package/src/resources/v1/tenants/groups.ts

@@ -13,7 +13,7 @@ export class Groups extends APIResource {
    *
    * RLS: Filtered to current client (ClientRLSDB).
    */
-  retrieveSchema(options?: RequestOptions): APIPromise<GroupRetrieveSchemaResponse> {
+  getTenantGroupsSchema(options?: RequestOptions): APIPromise<GroupGetTenantGroupsSchemaResponse> {
     return this._client.get('/api/v1/tenants/groups/schema', options);
   }
 }
@@ -21,14 +21,14 @@ export class Groups extends APIResource {
 /**
  * Schema for tenant group configuration files
  */
-export interface GroupRetrieveSchemaResponse {
+export interface GroupGetTenantGroupsSchemaResponse {
   /**
    * Array of tenant group configurations
    */
-  tenant_groups: Array<GroupRetrieveSchemaResponse.TenantGroup>;
+  tenant_groups: Array<GroupGetTenantGroupsSchemaResponse.TenantGroup>;
 }
 
-export namespace GroupRetrieveSchemaResponse {
+export namespace GroupGetTenantGroupsSchemaResponse {
   export interface TenantGroup {
     /**
      * Unique Kater identifier
@@ -48,5 +48,5 @@ export namespace GroupRetrieveSchemaResponse {
 }
 
 export declare namespace Groups {
-  export { type GroupRetrieveSchemaResponse as GroupRetrieveSchemaResponse };
+  export { type GroupGetTenantGroupsSchemaResponse as GroupGetTenantGroupsSchemaResponse };
 }

package/src/resources/v1/tenants/index.ts

@@ -1,29 +1,10 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export {
-  Batch,
-  type BatchTenantError,
-  type BatchTenantSuccess,
-  type BatchCreateResponse,
-  type BatchUpdateResponse,
-  type BatchDeleteResponse,
-  type BatchCreateParams,
-  type BatchUpdateParams,
-  type BatchDeleteParams,
-} from './batch';
-export { Groups, type GroupRetrieveSchemaResponse } from './groups';
-export {
-  Import,
-  type ImportTenants,
-  type ImportFromCsvParams,
-  type ImportFromWarehouseParams,
-} from './import';
+export { Groups, type GroupGetTenantGroupsSchemaResponse } from './groups';
 export {
   Tenants,
-  type CreateTenant,
-  type Tenant,
-  type TenantListResponse,
-  type TenantRetrieveSchemaResponse,
-  type TenantCreateParams,
-  type TenantUpdateParams,
+  type ImportTenantsResponse,
+  type TenantGetTenantsSchemaResponse,
+  type TenantImportFromCsvParams,
+  type TenantImportFromWarehouseParams,
 } from './tenants';