@katerai/sdk 0.1.2

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

@@ -0,0 +1,42 @@
+// 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 { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Databases extends APIResource {
+  /**
+   * Delete a schema from a connection.
+   *
+   * Soft-deletes the schema record, setting deleted_at and deleted_by fields. The
+   * connection_id and database_id path parameters provide context for the resource
+   * hierarchy, though the schema_id alone uniquely identifies the record.
+   *
+   * RLS: Filtered to current client (DualClientRLSDB).
+   *
+   * Raises: SchemaNotFoundError: If schema doesn't exist (404)
+   */
+  deleteSchema(
+    schemaID: string,
+    params: DatabaseDeleteSchemaParams,
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { connection_id, database_id } = params;
+    return this._client.delete(
+      path`/api/v1/connections/${connection_id}/databases/${database_id}/schemas/${schemaID}`,
+      { ...options, headers: buildHeaders([{ Accept: '*/*' }, options?.headers]) },
+    );
+  }
+}
+
+export interface DatabaseDeleteSchemaParams {
+  connection_id: string;
+
+  database_id: string;
+}
+
+export declare namespace Databases {
+  export { type DatabaseDeleteSchemaParams as DatabaseDeleteSchemaParams };
+}

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

@@ -0,0 +1,12 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Connections,
+  type Connection,
+  type DatabaseConfig,
+  type ConnectionListResponse,
+  type ConnectionRetrieveCredentialResponse,
+  type ConnectionSyncResponse,
+  type ConnectionCreateParams,
+} from './connections';
+export { Databases, type DatabaseDeleteSchemaParams } from './databases';

package/src/resources/v1/connections.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './connections/index';

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

@@ -0,0 +1,56 @@
+// 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 Admin extends APIResource {
+  /**
+   * Returns the GitHub integration status for a specific client. Admin access
+   * required.
+   */
+  getIntegrationStatus(
+    clientID: string,
+    options?: RequestOptions,
+  ): APIPromise<AdminGetIntegrationStatusResponse> {
+    return this._client.get(path`/api/v1/github/admin/status/${clientID}`, options);
+  }
+}
+
+/**
+ * Response for client GitHub integration status.
+ */
+export interface AdminGetIntegrationStatusResponse {
+  client_id: string;
+
+  connected: boolean;
+
+  oauth_completed: boolean;
+
+  connection_status?: string | null;
+
+  created_at?: string | null;
+
+  github_username?: string | null;
+
+  installation_id?: number | null;
+
+  last_sync_at?: string | null;
+
+  repository?: string | null;
+
+  repository_selection_pending?: boolean;
+
+  scaffolding_branch?: string | null;
+
+  scaffolding_pr_url?: string | null;
+
+  scaffolding_status?: string | null;
+
+  updated_at?: string | null;
+}
+
+export declare namespace Admin {
+  export { type AdminGetIntegrationStatusResponse as AdminGetIntegrationStatusResponse };
+}

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

@@ -0,0 +1,145 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as AdminAPI from './admin';
+import { Admin, AdminGetIntegrationStatusResponse } from './admin';
+import * as ReposAPI from './repos';
+import { RepoListResponse, RepoSelectParams, RepoSelectResponse, Repos, Repository } from './repos';
+import * as ScaffoldAPI from './scaffold';
+import { Scaffold, ScaffoldGetStatusResponse, ScaffoldTrigger } from './scaffold';
+import * as WebhooksAPI from './webhooks';
+import { WebhookPingResponse, Webhooks } from './webhooks';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+
+export class GitHub extends APIResource {
+  repos: ReposAPI.Repos = new ReposAPI.Repos(this._client);
+  scaffold: ScaffoldAPI.Scaffold = new ScaffoldAPI.Scaffold(this._client);
+  webhooks: WebhooksAPI.Webhooks = new WebhooksAPI.Webhooks(this._client);
+  admin: AdminAPI.Admin = new AdminAPI.Admin(this._client);
+
+  /**
+   * Checks if the GitHub App is already installed on any organizations/accounts.
+   */
+  checkInstallations(options?: RequestOptions): APIPromise<GitHubCheckInstallationsResponse> {
+    return this._client.get('/api/v1/github/check-installations', options);
+  }
+
+  /**
+   * Disconnects the GitHub connection.
+   */
+  disconnect(options?: RequestOptions): APIPromise<GitHubDisconnectResponse> {
+    return this._client.post('/api/v1/github/disconnect', options);
+  }
+
+  /**
+   * Returns the current GitHub connection status for the client.
+   */
+  getStatus(options?: RequestOptions): APIPromise<GitHubGetStatusResponse> {
+    return this._client.get('/api/v1/github/status', options);
+  }
+
+  /**
+   * Verifies the GitHub connection and updates the last sync timestamp.
+   */
+  sync(options?: RequestOptions): APIPromise<GitHubSyncResponse> {
+    return this._client.post('/api/v1/github/sync', options);
+  }
+}
+
+/**
+ * Response for checking existing installations.
+ */
+export interface GitHubCheckInstallationsResponse {
+  has_existing_installation: boolean;
+
+  installations?: Array<GitHubCheckInstallationsResponse.Installation>;
+}
+
+export namespace GitHubCheckInstallationsResponse {
+  /**
+   * Information about an existing GitHub App installation.
+   */
+  export interface Installation {
+    account_login: string;
+
+    account_type: string;
+
+    installation_id: number;
+  }
+}
+
+/**
+ * Response for disconnecting GitHub.
+ */
+export interface GitHubDisconnectResponse {
+  message: string;
+
+  success: boolean;
+}
+
+/**
+ * Response for connection status.
+ */
+export interface GitHubGetStatusResponse {
+  connected: boolean;
+
+  default_branch?: string | null;
+
+  last_sync_at?: string | null;
+
+  last_used_at?: string | null;
+
+  owner?: string | null;
+
+  repository?: string | null;
+
+  scaffolding_pr_url?: string | null;
+
+  scaffolding_status?: string | null;
+
+  status?: string | null;
+}
+
+/**
+ * Response for sync operation.
+ */
+export interface GitHubSyncResponse {
+  last_sync_at: string;
+
+  message: string;
+
+  success: boolean;
+}
+
+GitHub.Repos = Repos;
+GitHub.Scaffold = Scaffold;
+GitHub.Webhooks = Webhooks;
+GitHub.Admin = Admin;
+
+export declare namespace GitHub {
+  export {
+    type GitHubCheckInstallationsResponse as GitHubCheckInstallationsResponse,
+    type GitHubDisconnectResponse as GitHubDisconnectResponse,
+    type GitHubGetStatusResponse as GitHubGetStatusResponse,
+    type GitHubSyncResponse as GitHubSyncResponse,
+  };
+
+  export {
+    Repos as Repos,
+    type Repository as Repository,
+    type RepoListResponse as RepoListResponse,
+    type RepoSelectResponse as RepoSelectResponse,
+    type RepoSelectParams as RepoSelectParams,
+  };
+
+  export {
+    Scaffold as Scaffold,
+    type ScaffoldTrigger as ScaffoldTrigger,
+    type ScaffoldGetStatusResponse as ScaffoldGetStatusResponse,
+  };
+
+  export { Webhooks as Webhooks, type WebhookPingResponse as WebhookPingResponse };
+
+  export { Admin as Admin, type AdminGetIntegrationStatusResponse as AdminGetIntegrationStatusResponse };
+}

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

@@ -0,0 +1,19 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Admin, type AdminGetIntegrationStatusResponse } from './admin';
+export {
+  GitHub,
+  type GitHubCheckInstallationsResponse,
+  type GitHubDisconnectResponse,
+  type GitHubGetStatusResponse,
+  type GitHubSyncResponse,
+} from './github';
+export {
+  Repos,
+  type Repository,
+  type RepoListResponse,
+  type RepoSelectResponse,
+  type RepoSelectParams,
+} from './repos';
+export { Scaffold, type ScaffoldTrigger, type ScaffoldGetStatusResponse } from './scaffold';
+export { Webhooks, type WebhookPingResponse } from './webhooks';

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

@@ -0,0 +1,85 @@
+// 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 Repos extends APIResource {
+  /**
+   * List repositories accessible to the GitHub App installation.
+   */
+  list(options?: RequestOptions): APIPromise<RepoListResponse> {
+    return this._client.get('/api/v1/github/repos', options);
+  }
+
+  /**
+   * Select a repository for the Kater workspace.
+   */
+  select(repoID: number, body: RepoSelectParams, options?: RequestOptions): APIPromise<RepoSelectResponse> {
+    return this._client.post(path`/api/v1/github/repos/${repoID}/select`, { body, ...options });
+  }
+}
+
+/**
+ * Repository information response.
+ */
+export interface Repository {
+  id: number;
+
+  default_branch: string;
+
+  full_name: string;
+
+  has_kater_structure: boolean;
+
+  html_url: string;
+
+  is_empty: boolean;
+
+  name: string;
+
+  owner: string;
+
+  private: boolean;
+}
+
+/**
+ * List of repositories response.
+ */
+export interface RepoListResponse {
+  repositories: Array<Repository>;
+
+  total_count: number;
+}
+
+/**
+ * Repository selection response.
+ */
+export interface RepoSelectResponse {
+  has_existing_structure: boolean;
+
+  message: string;
+
+  needs_scaffolding: boolean;
+
+  /**
+   * Repository information response.
+   */
+  repository: Repository;
+
+  success: boolean;
+}
+
+export interface RepoSelectParams {
+  use_existing_structure?: boolean;
+}
+
+export declare namespace Repos {
+  export {
+    type Repository as Repository,
+    type RepoListResponse as RepoListResponse,
+    type RepoSelectResponse as RepoSelectResponse,
+    type RepoSelectParams as RepoSelectParams,
+  };
+}

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

@@ -0,0 +1,71 @@
+// 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 Scaffold extends APIResource {
+  /**
+   * Get the current scaffolding status for the connected repository.
+   */
+  getStatus(options?: RequestOptions): APIPromise<ScaffoldGetStatusResponse> {
+    return this._client.get('/api/v1/github/scaffold/status', options);
+  }
+
+  /**
+   * Clean up partial state and retry scaffolding from scratch.
+   */
+  retry(options?: RequestOptions): APIPromise<ScaffoldTrigger> {
+    return this._client.post('/api/v1/github/scaffold/retry', options);
+  }
+
+  /**
+   * Create the Kater folder structure and PR in the selected repository.
+   */
+  trigger(options?: RequestOptions): APIPromise<ScaffoldTrigger> {
+    return this._client.post('/api/v1/github/scaffold', options);
+  }
+}
+
+/**
+ * Response from triggering scaffolding.
+ */
+export interface ScaffoldTrigger {
+  message: string;
+
+  status: string;
+
+  success: boolean;
+
+  branch?: string | null;
+
+  error?: string | null;
+
+  pr_number?: number | null;
+
+  pr_url?: string | null;
+}
+
+/**
+ * Response from scaffolding status check.
+ */
+export interface ScaffoldGetStatusResponse {
+  status: string;
+
+  branch?: string | null;
+
+  error?: string | null;
+
+  pr_number?: number | null;
+
+  pr_url?: string | null;
+
+  scaffolded_at?: string | null;
+}
+
+export declare namespace Scaffold {
+  export {
+    type ScaffoldTrigger as ScaffoldTrigger,
+    type ScaffoldGetStatusResponse as ScaffoldGetStatusResponse,
+  };
+}

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

@@ -0,0 +1,20 @@
+// 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 Webhooks extends APIResource {
+  /**
+   * Simple health check for the webhook receiver.
+   */
+  ping(options?: RequestOptions): APIPromise<WebhookPingResponse> {
+    return this._client.get('/api/v1/github/webhooks/ping', options);
+  }
+}
+
+export type WebhookPingResponse = { [key: string]: string };
+
+export declare namespace Webhooks {
+  export { type WebhookPingResponse as WebhookPingResponse };
+}

package/src/resources/v1/github.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './github/index';

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

@@ -0,0 +1,218 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as TenantsAPI from './tenants';
+import { TenantAddParams, TenantAddResponse, TenantRemoveParams, Tenants } from './tenants';
+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 Groups extends APIResource {
+  tenants: TenantsAPI.Tenants = new TenantsAPI.Tenants(this._client);
+
+  /**
+   * Create a new group.
+   *
+   * Group names must be unique within the client.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   *
+   * Raises: GroupNameExistsError: If a group with this name already exists (409)
+   */
+  create(body: GroupCreateParams, options?: RequestOptions): APIPromise<GroupDetail> {
+    return this._client.post('/api/v1/groups', { body, ...options });
+  }
+
+  /**
+   * Get a single group by ID.
+   *
+   * Returns the group with its full tenant list.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   *
+   * Raises: GroupNotFoundError: If group doesn't exist (404)
+   */
+  retrieve(groupID: string, options?: RequestOptions): APIPromise<GroupDetail> {
+    return this._client.get(path`/api/v1/groups/${groupID}`, options);
+  }
+
+  /**
+   * Update a group.
+   *
+   * Update group name and/or description. Name must remain unique within client.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   *
+   * Raises: GroupNotFoundError: If group doesn't exist (404) GroupNameExistsError:
+   * If new name conflicts with existing group (409)
+   */
+  update(groupID: string, body: GroupUpdateParams, options?: RequestOptions): APIPromise<GroupDetail> {
+    return this._client.patch(path`/api/v1/groups/${groupID}`, { body, ...options });
+  }
+
+  /**
+   * List all groups for the client.
+   *
+   * Returns groups with their tenant counts for efficient display.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   */
+  list(options?: RequestOptions): APIPromise<GroupListResponse> {
+    return this._client.get('/api/v1/groups', options);
+  }
+
+  /**
+   * Delete a group.
+   *
+   * Soft-deletes the group and removes all tenant associations.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   *
+   * Raises: GroupNotFoundError: If group doesn't exist (404)
+   */
+  delete(groupID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/api/v1/groups/${groupID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+/**
+ * Response model for a single group (with full tenant list).
+ */
+export interface GroupDetail {
+  /**
+   * Group ID
+   */
+  id: string;
+
+  /**
+   * Creation timestamp
+   */
+  created_at: string;
+
+  /**
+   * Group description
+   */
+  description: string | null;
+
+  /**
+   * Group name
+   */
+  name: string;
+
+  /**
+   * Tenants in this group
+   */
+  tenants: Array<GroupDetail.Tenant>;
+
+  /**
+   * Last update timestamp
+   */
+  updated_at: string;
+}
+
+export namespace GroupDetail {
+  /**
+   * Tenant information in group responses.
+   */
+  export interface Tenant {
+    /**
+     * Tenant ID
+     */
+    id: string;
+
+    /**
+     * Human-readable tenant name
+     */
+    name: string | null;
+
+    /**
+     * Unique tenant identifier
+     */
+    tenant_key: string;
+  }
+}
+
+export type GroupListResponse = Array<GroupListResponse.GroupListResponseItem>;
+
+export namespace GroupListResponse {
+  /**
+   * Response model for a group in list responses (with tenant count).
+   */
+  export interface GroupListResponseItem {
+    /**
+     * Group ID
+     */
+    id: string;
+
+    /**
+     * Creation timestamp
+     */
+    created_at: string;
+
+    /**
+     * Group description
+     */
+    description: string | null;
+
+    /**
+     * Group name
+     */
+    name: string;
+
+    /**
+     * Number of tenants in this group
+     */
+    tenant_count: number;
+
+    /**
+     * Last update timestamp
+     */
+    updated_at: string;
+  }
+}
+
+export interface GroupCreateParams {
+  /**
+   * Unique group name within the client
+   */
+  name: string;
+
+  /**
+   * Human-readable group description
+   */
+  description?: string | null;
+}
+
+export interface GroupUpdateParams {
+  /**
+   * New group description
+   */
+  description?: string | null;
+
+  /**
+   * New group name
+   */
+  name?: string | null;
+}
+
+Groups.Tenants = Tenants;
+
+export declare namespace Groups {
+  export {
+    type GroupDetail as GroupDetail,
+    type GroupListResponse as GroupListResponse,
+    type GroupCreateParams as GroupCreateParams,
+    type GroupUpdateParams as GroupUpdateParams,
+  };
+
+  export {
+    Tenants as Tenants,
+    type TenantAddResponse as TenantAddResponse,
+    type TenantAddParams as TenantAddParams,
+    type TenantRemoveParams as TenantRemoveParams,
+  };
+}

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

@@ -0,0 +1,10 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Groups,
+  type GroupDetail,
+  type GroupListResponse,
+  type GroupCreateParams,
+  type GroupUpdateParams,
+} from './groups';
+export { Tenants, type TenantAddResponse, type TenantAddParams, type TenantRemoveParams } from './tenants';