@katerai/sdk 0.4.0 → 0.6.0

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

@@ -1,37 +1,12 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../core/resource';
-import * as ConnectionsAPI from './connections';
 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 Databases extends APIResource {
-  /**
-   * Update a database's metadata.
-   *
-   * Updates label and/or description fields directly. If a name change is requested,
-   * a GitHub PR is created to update view YAML files. The name change is applied to
-   * the DB when the PR merges (or immediately if auto_merge is true or no views are
-   * affected).
-   *
-   * RLS: Filtered to current client (DualClientRLSDB).
-   *
-   * Raises: DatabaseNotFoundError: If database doesn't exist (404)
-   */
-  update(
-    databaseID: string,
-    params: DatabaseUpdateParams,
-    options?: RequestOptions,
-  ): APIPromise<DatabaseUpdateResponse> {
-    const { connection_id, ...body } = params;
-    return this._client.patch(path`/api/v1/connections/${connection_id}/databases/${databaseID}`, {
-      body,
-      ...options,
-    });
-  }
-
   /**
    * Delete a schema from a connection.
    *
@@ -54,107 +29,6 @@ export class Databases extends APIResource {
       { ...options, headers: buildHeaders([{ Accept: '*/*' }, options?.headers]) },
     );
   }
-
-  /**
-   * Update a schema's metadata.
-   *
-   * Updates label and/or description fields directly. If a name change is requested,
-   * a GitHub PR is created to update view YAML files. The name change is applied to
-   * the DB when the PR merges (or immediately if auto_merge is true or no views are
-   * affected).
-   *
-   * RLS: Filtered to current client (DualClientRLSDB).
-   *
-   * Raises: SchemaNotFoundError: If schema doesn't exist (404)
-   */
-  updateSchema(
-    schemaID: string,
-    params: DatabaseUpdateSchemaParams,
-    options?: RequestOptions,
-  ): APIPromise<DatabaseUpdateSchemaResponse> {
-    const { connection_id, database_id, ...body } = params;
-    return this._client.patch(
-      path`/api/v1/connections/${connection_id}/databases/${database_id}/schemas/${schemaID}`,
-      { body, ...options },
-    );
-  }
-}
-
-/**
- * Response for database/schema updates that may involve a rename PR.
- */
-export interface DatabaseUpdateResponse {
-  /**
-   * Updated connection
-   */
-  connection: ConnectionsAPI.Connection;
-
-  /**
-   * GitHub PR number
-   */
-  pr_number?: number | null;
-
-  /**
-   * PR status: 'open' or 'merged'
-   */
-  pr_status?: string | null;
-
-  /**
-   * GitHub PR URL (if rename PR created)
-   */
-  pr_url?: string | null;
-}
-
-/**
- * Response for database/schema updates that may involve a rename PR.
- */
-export interface DatabaseUpdateSchemaResponse {
-  /**
-   * Updated connection
-   */
-  connection: ConnectionsAPI.Connection;
-
-  /**
-   * GitHub PR number
-   */
-  pr_number?: number | null;
-
-  /**
-   * PR status: 'open' or 'merged'
-   */
-  pr_status?: string | null;
-
-  /**
-   * GitHub PR URL (if rename PR created)
-   */
-  pr_url?: string | null;
-}
-
-export interface DatabaseUpdateParams {
-  /**
-   * Path param
-   */
-  connection_id: string;
-
-  /**
-   * Body param: If true and a name change requires a PR, auto-merge it
-   */
-  auto_merge?: boolean;
-
-  /**
-   * Body param: Database description
-   */
-  description?: string | null;
-
-  /**
-   * Body param: Human-readable display label
-   */
-  label?: string | null;
-
-  /**
-   * Body param: Database name
-   */
-  name?: string | null;
 }
 
 export interface DatabaseDeleteSchemaParams {
@@ -163,44 +37,6 @@ export interface DatabaseDeleteSchemaParams {
   database_id: string;
 }
 
-export interface DatabaseUpdateSchemaParams {
-  /**
-   * Path param
-   */
-  connection_id: string;
-
-  /**
-   * Path param
-   */
-  database_id: string;
-
-  /**
-   * Body param: If true and a name change requires a PR, auto-merge it
-   */
-  auto_merge?: boolean;
-
-  /**
-   * Body param: Schema description
-   */
-  description?: string | null;
-
-  /**
-   * Body param: Human-readable display label
-   */
-  label?: string | null;
-
-  /**
-   * Body param: Schema name
-   */
-  name?: string | null;
-}
-
 export declare namespace Databases {
-  export {
-    type DatabaseUpdateResponse as DatabaseUpdateResponse,
-    type DatabaseUpdateSchemaResponse as DatabaseUpdateSchemaResponse,
-    type DatabaseUpdateParams as DatabaseUpdateParams,
-    type DatabaseDeleteSchemaParams as DatabaseDeleteSchemaParams,
-    type DatabaseUpdateSchemaParams as DatabaseUpdateSchemaParams,
-  };
+  export { type DatabaseDeleteSchemaParams as DatabaseDeleteSchemaParams };
 }

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

@@ -5,16 +5,29 @@ export {
   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';
+export { Databases, type DatabaseDeleteSchemaParams } from './databases';
 export {
-  Databases,
-  type DatabaseUpdateResponse,
-  type DatabaseUpdateSchemaResponse,
-  type DatabaseUpdateParams,
-  type DatabaseDeleteSchemaParams,
-  type DatabaseUpdateSchemaParams,
-} from './databases';
+  Views,
+  type ViewRetrieveResponse,
+  type ViewListResponse,
+  type ViewRetrieveParams,
+  type ViewListParams,
+} from './views';
+export { Yaml, type YamlRetrieveResponse, type YamlCommitResponse, type YamlCommitParams } from './yaml';

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

@@ -0,0 +1,112 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Views extends APIResource {
+  /**
+   * Get the YAML content of a specific view file.
+   */
+  retrieve(
+    fileName: string,
+    params: ViewRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<ViewRetrieveResponse> {
+    const { connection_id, sync_id } = params;
+    return this._client.get(
+      path`/api/v1/connections/${connection_id}/sync/${sync_id}/views/${fileName}`,
+      options,
+    );
+  }
+
+  /**
+   * List all view YAML files created by a schema sync.
+   */
+  list(syncID: string, params: ViewListParams, options?: RequestOptions): APIPromise<ViewListResponse> {
+    const { connection_id } = params;
+    return this._client.get(path`/api/v1/connections/${connection_id}/sync/${syncID}/views`, options);
+  }
+}
+
+/**
+ * Response for a single view file's content.
+ */
+export interface ViewRetrieveResponse {
+  /**
+   * Branch the file was read from
+   */
+  branch: string;
+
+  /**
+   * YAML file content
+   */
+  content: string;
+
+  /**
+   * File name (e.g., 'customers.yaml')
+   */
+  name: string;
+
+  /**
+   * Full path relative to connection folder
+   */
+  path: string;
+}
+
+/**
+ * Response for listing view files in a sync.
+ */
+export interface ViewListResponse {
+  /**
+   * Branch the files were read from
+   */
+  branch: string;
+
+  /**
+   * List of view files
+   */
+  files: Array<ViewListResponse.File>;
+
+  /**
+   * True if reading from PR branch, False if from main
+   */
+  is_pr_branch: boolean;
+}
+
+export namespace ViewListResponse {
+  /**
+   * A single view file in the sync.
+   */
+  export interface File {
+    /**
+     * File name (e.g., 'customers.yaml')
+     */
+    name: string;
+
+    /**
+     * Full path relative to connection folder
+     */
+    path: string;
+  }
+}
+
+export interface ViewRetrieveParams {
+  connection_id: string;
+
+  sync_id: string;
+}
+
+export interface ViewListParams {
+  connection_id: string;
+}
+
+export declare namespace Views {
+  export {
+    type ViewRetrieveResponse as ViewRetrieveResponse,
+    type ViewListResponse as ViewListResponse,
+    type ViewRetrieveParams as ViewRetrieveParams,
+    type ViewListParams as ViewListParams,
+  };
+}

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

@@ -0,0 +1,81 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Yaml extends APIResource {
+  /**
+   * Read connection.yaml from the main branch of the repo.
+   */
+  retrieve(connectionID: string, options?: RequestOptions): APIPromise<YamlRetrieveResponse> {
+    return this._client.get(path`/api/v1/connections/${connectionID}/yaml`, options);
+  }
+
+  /**
+   * Commit updated YAML to a new branch and create a PR.
+   */
+  commit(
+    connectionID: string,
+    body: YamlCommitParams,
+    options?: RequestOptions,
+  ): APIPromise<YamlCommitResponse> {
+    return this._client.post(path`/api/v1/connections/${connectionID}/yaml`, { body, ...options });
+  }
+}
+
+/**
+ * Response for reading connection.yaml from repo.
+ */
+export interface YamlRetrieveResponse {
+  /**
+   * Folder name in the repo (e.g. 'prod_db_connection')
+   */
+  folder_name: string;
+
+  /**
+   * Raw YAML content of connection.yaml
+   */
+  yaml_content: string;
+}
+
+/**
+ * Response for YAML commit endpoint.
+ */
+export interface YamlCommitResponse {
+  /**
+   * Whether the PR was auto-merged
+   */
+  merged: boolean;
+
+  /**
+   * GitHub PR number
+   */
+  pr_number: number;
+
+  /**
+   * GitHub PR URL
+   */
+  pr_url: string;
+}
+
+export interface YamlCommitParams {
+  /**
+   * Updated YAML content
+   */
+  yaml_content: string;
+
+  /**
+   * If true, auto-merge the PR after creation
+   */
+  auto_merge?: boolean;
+}
+
+export declare namespace Yaml {
+  export {
+    type YamlRetrieveResponse as YamlRetrieveResponse,
+    type YamlCommitResponse as YamlCommitResponse,
+    type YamlCommitParams as YamlCommitParams,
+  };
+}

package/src/resources/v1/github/github.ts

@@ -83,6 +83,14 @@ export interface GitHubGetStatusResponse {
 
   repository?: string | null;
 
+  scaffolding_pr_author?: string | null;
+
+  scaffolding_pr_created_at?: string | null;
+
+  scaffolding_pr_state?: string | null;
+
+  scaffolding_pr_title?: string | null;
+
   scaffolding_pr_url?: string | null;
 
   scaffolding_status?: string | null;

package/src/resources/v1/index.ts

@@ -5,10 +5,22 @@ export {
   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,
@@ -33,6 +45,7 @@ export {
   type CreateTenant,
   type Tenant,
   type TenantListResponse,
+  type TenantRetrieveSchemaResponse,
   type TenantCreateParams,
   type TenantUpdateParams,
 } from './tenants/index';

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

@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+
+export class Groups extends APIResource {
+  /**
+   * Get all tenant groups as a TenantGroupSchema object.
+   *
+   * Returns tenant groups in the YAML-compatible schema format. Supports content
+   * negotiation: JSON by default, YAML with Accept: application/yaml.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   */
+  retrieveSchema(options?: RequestOptions): APIPromise<GroupRetrieveSchemaResponse> {
+    return this._client.get('/api/v1/tenants/groups/schema', options);
+  }
+}
+
+/**
+ * Schema for tenant group configuration files
+ */
+export interface GroupRetrieveSchemaResponse {
+  /**
+   * Array of tenant group configurations
+   */
+  tenant_groups: Array<GroupRetrieveSchemaResponse.TenantGroup>;
+}
+
+export namespace GroupRetrieveSchemaResponse {
+  export interface TenantGroup {
+    /**
+     * Unique Kater identifier
+     */
+    kater_id: string;
+
+    /**
+     * Name identifier
+     */
+    name: string;
+
+    /**
+     * Description text
+     */
+    description?: string | null;
+  }
+}
+
+export declare namespace Groups {
+  export { type GroupRetrieveSchemaResponse as GroupRetrieveSchemaResponse };
+}

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

@@ -11,6 +11,7 @@ export {
   type BatchUpdateParams,
   type BatchDeleteParams,
 } from './batch';
+export { Groups, type GroupRetrieveSchemaResponse } from './groups';
 export {
   Import,
   type ImportTenants,
@@ -22,6 +23,7 @@ export {
   type CreateTenant,
   type Tenant,
   type TenantListResponse,
+  type TenantRetrieveSchemaResponse,
   type TenantCreateParams,
   type TenantUpdateParams,
 } from './tenants';

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

@@ -13,6 +13,8 @@ import {
   BatchUpdateParams,
   BatchUpdateResponse,
 } from './batch';
+import * as GroupsAPI from './groups';
+import { GroupRetrieveSchemaResponse, Groups } from './groups';
 import * as ImportAPI from './import';
 import { Import, ImportFromCsvParams, ImportFromWarehouseParams, ImportTenants } from './import';
 import { APIPromise } from '../../../core/api-promise';
@@ -23,6 +25,7 @@ import { path } from '../../../internal/utils/path';
 export class Tenants extends APIResource {
   batch: BatchAPI.Batch = new BatchAPI.Batch(this._client);
   import: ImportAPI.Import = new ImportAPI.Import(this._client);
+  groups: GroupsAPI.Groups = new GroupsAPI.Groups(this._client);
 
   /**
    * Create a new tenant.
@@ -102,6 +105,19 @@ export class Tenants extends APIResource {
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
+
+  /**
+   * Get all tenants as a TenantSchema object.
+   *
+   * Returns tenants in the YAML-compatible schema format with group references.
+   * Supports content negotiation: JSON by default, YAML with Accept:
+   * application/yaml.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   */
+  retrieveSchema(options?: RequestOptions): APIPromise<TenantRetrieveSchemaResponse> {
+    return this._client.get('/api/v1/tenants/schema', options);
+  }
 }
 
 /**
@@ -208,6 +224,40 @@ export namespace Tenant {
 
 export type TenantListResponse = Array<Tenant>;
 
+/**
+ * Schema for tenant configuration files
+ */
+export interface TenantRetrieveSchemaResponse {
+  /**
+   * Array of tenant configurations
+   */
+  tenants: Array<TenantRetrieveSchemaResponse.Tenant>;
+}
+
+export namespace TenantRetrieveSchemaResponse {
+  export interface Tenant {
+    /**
+     * Unique Kater identifier
+     */
+    kater_id: string;
+
+    /**
+     * Unique key identifier for the tenant (e.g., 'acme_corp')
+     */
+    tenant_key: string;
+
+    /**
+     * References to tenant groups this tenant belongs to
+     */
+    groups?: Array<string> | null;
+
+    /**
+     * Human-readable display name for the tenant
+     */
+    name?: string | null;
+  }
+}
+
 export interface TenantCreateParams {
   /**
    * Unique tenant identifier within the client
@@ -259,12 +309,14 @@ export interface TenantUpdateParams {
 
 Tenants.Batch = Batch;
 Tenants.Import = Import;
+Tenants.Groups = Groups;
 
 export declare namespace Tenants {
   export {
     type CreateTenant as CreateTenant,
     type Tenant as Tenant,
     type TenantListResponse as TenantListResponse,
+    type TenantRetrieveSchemaResponse as TenantRetrieveSchemaResponse,
     type TenantCreateParams as TenantCreateParams,
     type TenantUpdateParams as TenantUpdateParams,
   };
@@ -287,4 +339,6 @@ export declare namespace Tenants {
     type ImportFromCsvParams as ImportFromCsvParams,
     type ImportFromWarehouseParams as ImportFromWarehouseParams,
   };
+
+  export { Groups as Groups, type GroupRetrieveSchemaResponse as GroupRetrieveSchemaResponse };
 }

package/src/resources/v1/v1.ts

@@ -6,10 +6,22 @@ import { ClientUser, ClientUserRole, Me } from './me';
 import * as ConnectionsAPI from './connections/connections';
 import {
   Connection,
+  ConnectionApproveSyncParams,
+  ConnectionApproveSyncResponse,
   ConnectionCreateParams,
+  ConnectionListParams,
   ConnectionListResponse,
+  ConnectionListSyncsParams,
+  ConnectionListSyncsResponse,
   ConnectionRetrieveCredentialResponse,
+  ConnectionRetrieveSchemaResponse,
+  ConnectionRetrieveSyncStatusParams,
+  ConnectionRetrieveSyncStatusResponse,
+  ConnectionStreamSyncProgressParams,
+  ConnectionStreamSyncProgressResponse,
   ConnectionSyncResponse,
+  ConnectionUpdateCredentialsParams,
+  ConnectionUpdateCredentialsResponse,
   ConnectionUpdateParams,
   Connections,
   DatabaseConfig,
@@ -40,6 +52,7 @@ import {
   Tenant,
   TenantCreateParams,
   TenantListResponse,
+  TenantRetrieveSchemaResponse,
   TenantUpdateParams,
   Tenants,
 } from './tenants/tenants';
@@ -66,10 +79,22 @@ export declare namespace V1 {
     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 {
@@ -99,6 +124,7 @@ export declare namespace V1 {
     type CreateTenant as CreateTenant,
     type Tenant as Tenant,
     type TenantListResponse as TenantListResponse,
+    type TenantRetrieveSchemaResponse as TenantRetrieveSchemaResponse,
     type TenantCreateParams as TenantCreateParams,
     type TenantUpdateParams as TenantUpdateParams,
   };

package/src/version.ts

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

package/version.d.mts

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