@katerai/sdk 0.6.0 → 0.7.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

@@ -3,50 +3,13 @@
 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,
-} from './tenants/index';
+  type ImportTenantsResponse,
+  type TenantImportFromCsvParams,
+  type TenantImportFromWarehouseParams,
+} from './tenants';
 export { V1 } from './v1';

package/src/resources/v1/tenants.ts

@@ -1,3 +1,164 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export * from './tenants/index';
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { type Uploadable } from '../../core/uploads';
+import { RequestOptions } from '../../internal/request-options';
+import { multipartFormRequestOptions } from '../../internal/uploads';
+
+export class Tenants extends APIResource {
+  /**
+   * Import tenants from a CSV file using upsert semantics.
+   *
+   * Expected CSV format:
+   *
+   * - tenant_key (required): Unique tenant identifier
+   * - tenant_name (optional): Human-readable name
+   * - group_names (optional): Comma-separated list of group names
+   *
+   * Creates new tenants and updates existing ones with new name/groups. Groups are
+   * added additively (not replaced) and auto-created if needed.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   *
+   * Raises: ValidationError: If CSV format is invalid (400)
+   * TenantCreationNotAllowedError: If tenancy type is NONE (400)
+   */
+  importFromCsv(
+    body: TenantImportFromCsvParams,
+    options?: RequestOptions,
+  ): APIPromise<ImportTenantsResponse> {
+    return this._client.post(
+      '/api/v1/tenants/import/csv',
+      multipartFormRequestOptions({ body, ...options }, this._client),
+    );
+  }
+
+  /**
+   * Import tenants from a warehouse table using upsert semantics.
+   *
+   * Creates new tenants and updates existing ones with new name/groups. Groups are
+   * added additively (not replaced).
+   *
+   * Streams data from the warehouse in batches to handle large datasets without
+   * loading everything into memory.
+   *
+   * For tenants with groups, groups are aggregated per tenant key and auto-created
+   * if they don't exist.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   *
+   * Raises: ConnectionNotFoundError: If the connection doesn't exist (404)
+   * TenantCreationNotAllowedError: If tenancy type is NONE (400)
+   */
+  importFromWarehouse(
+    body: TenantImportFromWarehouseParams,
+    options?: RequestOptions,
+  ): APIPromise<ImportTenantsResponse> {
+    return this._client.post('/api/v1/tenants/import/warehouse', { body, ...options });
+  }
+}
+
+/**
+ * Response model for tenant import operation.
+ */
+export interface ImportTenantsResponse {
+  /**
+   * Unique tenant keys found in source
+   */
+  total_found: number;
+
+  /**
+   * New tenants created
+   */
+  total_imported: number;
+
+  /**
+   * Existing tenants updated
+   */
+  total_updated: number;
+
+  /**
+   * Tenant-specific errors
+   */
+  errors?: Array<ImportTenantsResponse.Error>;
+
+  /**
+   * Groups that were auto-created
+   */
+  groups_created?: Array<string>;
+}
+
+export namespace ImportTenantsResponse {
+  /**
+   * Error for a single tenant during import.
+   */
+  export interface Error {
+    /**
+     * Error code
+     */
+    code: string;
+
+    /**
+     * Error message
+     */
+    message: string;
+
+    /**
+     * Tenant key that failed
+     */
+    tenant_key: string;
+  }
+}
+
+export interface TenantImportFromCsvParams {
+  /**
+   * CSV file with tenant data
+   */
+  file: Uploadable;
+}
+
+export interface TenantImportFromWarehouseParams {
+  /**
+   * Warehouse connection ID to query
+   */
+  connection_id: string;
+
+  /**
+   * Database name containing the tenant table
+   */
+  database: string;
+
+  /**
+   * Schema name containing the tenant table
+   */
+  schema: string;
+
+  /**
+   * Table name containing tenant data
+   */
+  table: string;
+
+  /**
+   * Column name for tenant key
+   */
+  tenant_key_column: string;
+
+  /**
+   * Column name for tenant group (optional)
+   */
+  tenant_group_column?: string | null;
+
+  /**
+   * Column name for tenant display name (optional)
+   */
+  tenant_name_column?: string | null;
+}
+
+export declare namespace Tenants {
+  export {
+    type ImportTenantsResponse as ImportTenantsResponse,
+    type TenantImportFromCsvParams as TenantImportFromCsvParams,
+    type TenantImportFromWarehouseParams as TenantImportFromWarehouseParams,
+  };
+}

package/src/resources/v1/v1.ts

@@ -1,131 +1,41 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as MeAPI from './me';
-import { ClientUser, ClientUserRole, Me } from './me';
-import * as ConnectionsAPI from './connections/connections';
+import * as ConnectionsAPI from './connections';
 import {
   Connection,
-  ConnectionApproveSyncParams,
-  ConnectionApproveSyncResponse,
-  ConnectionCreateParams,
-  ConnectionListParams,
-  ConnectionListResponse,
-  ConnectionListSyncsParams,
-  ConnectionListSyncsResponse,
-  ConnectionRetrieveCredentialResponse,
-  ConnectionRetrieveSchemaResponse,
-  ConnectionRetrieveSyncStatusParams,
-  ConnectionRetrieveSyncStatusResponse,
-  ConnectionStreamSyncProgressParams,
-  ConnectionStreamSyncProgressResponse,
-  ConnectionSyncResponse,
-  ConnectionUpdateCredentialsParams,
-  ConnectionUpdateCredentialsResponse,
-  ConnectionUpdateParams,
+  ConnectionListConnectionsParams,
+  ConnectionListConnectionsResponse,
   Connections,
-  DatabaseConfig,
-} from './connections/connections';
-import * as GitHubAPI from './github/github';
+} from './connections';
+import * as TenantsAPI from './tenants';
 import {
-  GitHub,
-  GitHubCallbackParams,
-  GitHubCallbackResponse,
-  GitHubConnectParams,
-  GitHubConnectResponse,
-  GitHubGetInstallationLinkResponse,
-  GitHubGetStatusResponse,
-} from './github/github';
-import * as GroupsAPI from './groups/groups';
-import {
-  GroupCreateParams,
-  GroupDetail,
-  GroupListResponse,
-  GroupUpdateParams,
-  Groups,
-} from './groups/groups';
-import * as OrgAPI from './org/org';
-import { Org } from './org/org';
-import * as TenantsAPI from './tenants/tenants';
-import {
-  CreateTenant,
-  Tenant,
-  TenantCreateParams,
-  TenantListResponse,
-  TenantRetrieveSchemaResponse,
-  TenantUpdateParams,
+  ImportTenantsResponse,
+  TenantImportFromCsvParams,
+  TenantImportFromWarehouseParams,
   Tenants,
-} from './tenants/tenants';
+} from './tenants';
 
 export class V1 extends APIResource {
   connections: ConnectionsAPI.Connections = new ConnectionsAPI.Connections(this._client);
-  github: GitHubAPI.GitHub = new GitHubAPI.GitHub(this._client);
-  groups: GroupsAPI.Groups = new GroupsAPI.Groups(this._client);
-  me: MeAPI.Me = new MeAPI.Me(this._client);
-  org: OrgAPI.Org = new OrgAPI.Org(this._client);
   tenants: TenantsAPI.Tenants = new TenantsAPI.Tenants(this._client);
 }
 
 V1.Connections = Connections;
-V1.GitHub = GitHub;
-V1.Groups = Groups;
-V1.Me = Me;
-V1.Org = Org;
 V1.Tenants = Tenants;
 
 export declare namespace V1 {
   export {
     Connections as Connections,
     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 {
-    GitHub as GitHub,
-    type GitHubCallbackResponse as GitHubCallbackResponse,
-    type GitHubConnectResponse as GitHubConnectResponse,
-    type GitHubGetInstallationLinkResponse as GitHubGetInstallationLinkResponse,
-    type GitHubGetStatusResponse as GitHubGetStatusResponse,
-    type GitHubCallbackParams as GitHubCallbackParams,
-    type GitHubConnectParams as GitHubConnectParams,
+    type ConnectionListConnectionsResponse as ConnectionListConnectionsResponse,
+    type ConnectionListConnectionsParams as ConnectionListConnectionsParams,
   };
 
-  export {
-    Groups as Groups,
-    type GroupDetail as GroupDetail,
-    type GroupListResponse as GroupListResponse,
-    type GroupCreateParams as GroupCreateParams,
-    type GroupUpdateParams as GroupUpdateParams,
-  };
-
-  export { Me as Me, type ClientUser as ClientUser, type ClientUserRole as ClientUserRole };
-
-  export { Org as Org };
-
   export {
     Tenants as Tenants,
-    type CreateTenant as CreateTenant,
-    type Tenant as Tenant,
-    type TenantListResponse as TenantListResponse,
-    type TenantRetrieveSchemaResponse as TenantRetrieveSchemaResponse,
-    type TenantCreateParams as TenantCreateParams,
-    type TenantUpdateParams as TenantUpdateParams,
+    type ImportTenantsResponse as ImportTenantsResponse,
+    type TenantImportFromCsvParams as TenantImportFromCsvParams,
+    type TenantImportFromWarehouseParams as TenantImportFromWarehouseParams,
   };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.6.0'; // x-release-please-version
+export const VERSION = '0.7.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.6.0";
+export declare const VERSION = "0.7.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.6.0";
+export declare const VERSION = "0.7.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.6.0'; // x-release-please-version
+exports.VERSION = '0.7.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.6.0'; // x-release-please-version
+export const VERSION = '0.7.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map

package/resources/healthz.d.mts

@@ -1,16 +0,0 @@
-import { APIResource } from "../core/resource.mjs";
-import { APIPromise } from "../core/api-promise.mjs";
-import { RequestOptions } from "../internal/request-options.mjs";
-export declare class Healthz extends APIResource {
-    /**
-     * Returns 200 if the service is alive. Used by Kubernetes liveness probe.
-     */
-    check(options?: RequestOptions): APIPromise<HealthzCheckResponse>;
-}
-export type HealthzCheckResponse = {
-    [key: string]: string;
-};
-export declare namespace Healthz {
-    export { type HealthzCheckResponse as HealthzCheckResponse };
-}
-//# sourceMappingURL=healthz.d.mts.map

package/resources/healthz.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"healthz.d.mts","sourceRoot":"","sources":["../src/resources/healthz.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC;CAGlE;AAED,MAAM,MAAM,oBAAoB,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAE7D,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EAAE,KAAK,oBAAoB,IAAI,oBAAoB,EAAE,CAAC;CAC9D"}