@katerai/sdk 0.3.0 → 0.4.0

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

@@ -1,12 +1,37 @@
 // 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.
    *
@@ -29,6 +54,107 @@ 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 {
@@ -37,6 +163,44 @@ 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 DatabaseDeleteSchemaParams as DatabaseDeleteSchemaParams };
+  export {
+    type DatabaseUpdateResponse as DatabaseUpdateResponse,
+    type DatabaseUpdateSchemaResponse as DatabaseUpdateSchemaResponse,
+    type DatabaseUpdateParams as DatabaseUpdateParams,
+    type DatabaseDeleteSchemaParams as DatabaseDeleteSchemaParams,
+    type DatabaseUpdateSchemaParams as DatabaseUpdateSchemaParams,
+  };
 }

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

@@ -8,5 +8,13 @@ export {
   type ConnectionRetrieveCredentialResponse,
   type ConnectionSyncResponse,
   type ConnectionCreateParams,
+  type ConnectionUpdateParams,
 } from './connections';
-export { Databases, type DatabaseDeleteSchemaParams } from './databases';
+export {
+  Databases,
+  type DatabaseUpdateResponse,
+  type DatabaseUpdateSchemaResponse,
+  type DatabaseUpdateParams,
+  type DatabaseDeleteSchemaParams,
+  type DatabaseUpdateSchemaParams,
+} from './databases';

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

@@ -5,12 +5,39 @@ import * as ReposAPI from './repos';
 import { RepoListResponse, RepoSelectParams, RepoSelectResponse, Repos, Repository } from './repos';
 import * as ScaffoldAPI from './scaffold';
 import { Scaffold, ScaffoldTrigger } from './scaffold';
+import * as WebhooksAPI from './webhooks';
+import { WebhookReceiveParams, WebhookReceiveResponse, 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);
+
+  /**
+   * Handles the OAuth callback from GitHub after user authorization.
+   */
+  callback(query: GitHubCallbackParams, options?: RequestOptions): APIPromise<unknown> {
+    return this._client.get('/api/v1/github/callback', { query, ...options });
+  }
+
+  /**
+   * Initiates the GitHub App installation flow.
+   */
+  connect(
+    query: GitHubConnectParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<GitHubConnectResponse> {
+    return this._client.get('/api/v1/github/connect', { query, ...options });
+  }
+
+  /**
+   * Generates a shareable GitHub App installation link.
+   */
+  getInstallationLink(options?: RequestOptions): APIPromise<GitHubGetInstallationLinkResponse> {
+    return this._client.get('/api/v1/github/installation-link', options);
+  }
 
   /**
    * Returns the current GitHub connection status for the client.
@@ -20,6 +47,26 @@ export class GitHub extends APIResource {
   }
 }
 
+export type GitHubCallbackResponse = unknown;
+
+/**
+ * Response for starting OAuth flow.
+ */
+export interface GitHubConnectResponse {
+  authorization_url: string;
+
+  state: string;
+}
+
+/**
+ * Response for installation link generation.
+ */
+export interface GitHubGetInstallationLinkResponse {
+  app_name: string;
+
+  installation_url: string;
+}
+
 /**
  * Response for connection status.
  */
@@ -43,11 +90,54 @@ export interface GitHubGetStatusResponse {
   status?: string | null;
 }
 
+export interface GitHubCallbackParams {
+  /**
+   * State token for CSRF validation
+   */
+  state: string;
+
+  /**
+   * OAuth authorization code
+   */
+  code?: string | null;
+
+  /**
+   * OAuth error code from GitHub
+   */
+  error?: string | null;
+
+  /**
+   * OAuth error description
+   */
+  error_description?: string | null;
+
+  /**
+   * GitHub App installation ID
+   */
+  installation_id?: number | null;
+}
+
+export interface GitHubConnectParams {
+  /**
+   * Frontend path to redirect to after OAuth success (e.g., '/' or
+   * '/settings/github')
+   */
+  return_to?: string | null;
+}
+
 GitHub.Repos = Repos;
 GitHub.Scaffold = Scaffold;
+GitHub.Webhooks = Webhooks;
 
 export declare namespace GitHub {
-  export { type GitHubGetStatusResponse as GitHubGetStatusResponse };
+  export {
+    type GitHubCallbackResponse as GitHubCallbackResponse,
+    type GitHubConnectResponse as GitHubConnectResponse,
+    type GitHubGetInstallationLinkResponse as GitHubGetInstallationLinkResponse,
+    type GitHubGetStatusResponse as GitHubGetStatusResponse,
+    type GitHubCallbackParams as GitHubCallbackParams,
+    type GitHubConnectParams as GitHubConnectParams,
+  };
 
   export {
     Repos as Repos,
@@ -58,4 +148,10 @@ export declare namespace GitHub {
   };
 
   export { Scaffold as Scaffold, type ScaffoldTrigger as ScaffoldTrigger };
+
+  export {
+    Webhooks as Webhooks,
+    type WebhookReceiveResponse as WebhookReceiveResponse,
+    type WebhookReceiveParams as WebhookReceiveParams,
+  };
 }

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

@@ -1,6 +1,14 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { GitHub, type GitHubGetStatusResponse } from './github';
+export {
+  GitHub,
+  type GitHubCallbackResponse,
+  type GitHubConnectResponse,
+  type GitHubGetInstallationLinkResponse,
+  type GitHubGetStatusResponse,
+  type GitHubCallbackParams,
+  type GitHubConnectParams,
+} from './github';
 export {
   Repos,
   type Repository,
@@ -9,3 +17,4 @@ export {
   type RepoSelectParams,
 } from './repos';
 export { Scaffold, type ScaffoldTrigger } from './scaffold';
+export { Webhooks, type WebhookReceiveResponse, type WebhookReceiveParams } from './webhooks';

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

@@ -0,0 +1,60 @@
+// 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';
+
+export class Webhooks extends APIResource {
+  /**
+   * Receives and processes webhook events from GitHub.
+   */
+  receive(params: WebhookReceiveParams, options?: RequestOptions): APIPromise<WebhookReceiveResponse> {
+    const {
+      'X-GitHub-Delivery': xGitHubDelivery,
+      'X-GitHub-Event': xGitHubEvent,
+      'X-Hub-Signature-256': xHubSignature256,
+    } = params;
+    return this._client.post('/api/v1/github/webhooks/receiver', {
+      ...options,
+      headers: buildHeaders([
+        {
+          'X-GitHub-Delivery': xGitHubDelivery,
+          'X-GitHub-Event': xGitHubEvent,
+          'X-Hub-Signature-256': xHubSignature256,
+        },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+/**
+ * Response for successful webhook receipt.
+ */
+export interface WebhookReceiveResponse {
+  delivery_id: string;
+
+  event_type: string;
+
+  received: boolean;
+
+  message?: string | null;
+
+  processed?: boolean;
+}
+
+export interface WebhookReceiveParams {
+  'X-GitHub-Delivery': string;
+
+  'X-GitHub-Event': string;
+
+  'X-Hub-Signature-256': string;
+}
+
+export declare namespace Webhooks {
+  export {
+    type WebhookReceiveResponse as WebhookReceiveResponse,
+    type WebhookReceiveParams as WebhookReceiveParams,
+  };
+}

package/src/resources/v1/index.ts

@@ -8,8 +8,17 @@ export {
   type ConnectionRetrieveCredentialResponse,
   type ConnectionSyncResponse,
   type ConnectionCreateParams,
+  type ConnectionUpdateParams,
 } from './connections/index';
-export { GitHub, type GitHubGetStatusResponse } from './github/index';
+export {
+  GitHub,
+  type GitHubCallbackResponse,
+  type GitHubConnectResponse,
+  type GitHubGetInstallationLinkResponse,
+  type GitHubGetStatusResponse,
+  type GitHubCallbackParams,
+  type GitHubConnectParams,
+} from './github/index';
 export {
   Groups,
   type GroupDetail,

package/src/resources/v1/v1.ts

@@ -10,11 +10,20 @@ import {
   ConnectionListResponse,
   ConnectionRetrieveCredentialResponse,
   ConnectionSyncResponse,
+  ConnectionUpdateParams,
   Connections,
   DatabaseConfig,
 } from './connections/connections';
 import * as GitHubAPI from './github/github';
-import { GitHub, GitHubGetStatusResponse } from './github/github';
+import {
+  GitHub,
+  GitHubCallbackParams,
+  GitHubCallbackResponse,
+  GitHubConnectParams,
+  GitHubConnectResponse,
+  GitHubGetInstallationLinkResponse,
+  GitHubGetStatusResponse,
+} from './github/github';
 import * as GroupsAPI from './groups/groups';
 import {
   GroupCreateParams,
@@ -60,9 +69,18 @@ export declare namespace V1 {
     type ConnectionRetrieveCredentialResponse as ConnectionRetrieveCredentialResponse,
     type ConnectionSyncResponse as ConnectionSyncResponse,
     type ConnectionCreateParams as ConnectionCreateParams,
+    type ConnectionUpdateParams as ConnectionUpdateParams,
   };
 
-  export { GitHub as GitHub, type GitHubGetStatusResponse as GitHubGetStatusResponse };
+  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,
+  };
 
   export {
     Groups as Groups,

package/src/version.ts

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

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.3.0";
+export declare const VERSION = "0.4.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.3.0'; // x-release-please-version
+exports.VERSION = '0.4.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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