@katerai/sdk 0.1.2

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

@@ -0,0 +1,78 @@
+// 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 Tenants extends APIResource {
+  /**
+   * Add tenants to a group.
+   *
+   * Accepts a list of tenant IDs. Returns detailed results showing which tenants
+   * were added, which were already members, and which don't exist.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   *
+   * Raises: GroupNotFoundError: If group doesn't exist (404)
+   */
+  add(groupID: string, body: TenantAddParams, options?: RequestOptions): APIPromise<TenantAddResponse> {
+    return this._client.post(path`/api/v1/groups/${groupID}/tenants`, { body, ...options });
+  }
+
+  /**
+   * Remove a tenant from a group.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   *
+   * Raises: GroupNotFoundError: If group doesn't exist (404) TenantNotFoundError: If
+   * tenant is not a member of the group (404)
+   */
+  remove(tenantID: string, params: TenantRemoveParams, options?: RequestOptions): APIPromise<void> {
+    const { group_id } = params;
+    return this._client.delete(path`/api/v1/groups/${group_id}/tenants/${tenantID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+/**
+ * Response model for add tenants operation.
+ */
+export interface TenantAddResponse {
+  /**
+   * Tenant IDs that were successfully added
+   */
+  added: Array<string>;
+
+  /**
+   * Tenant IDs that were already members
+   */
+  already_in_group: Array<string>;
+
+  /**
+   * Tenant IDs that don't exist
+   */
+  not_found: Array<string>;
+}
+
+export interface TenantAddParams {
+  /**
+   * List of tenant IDs to add to the group
+   */
+  tenant_ids: Array<string>;
+}
+
+export interface TenantRemoveParams {
+  group_id: string;
+}
+
+export declare namespace Tenants {
+  export {
+    type TenantAddResponse as TenantAddResponse,
+    type TenantAddParams as TenantAddParams,
+    type TenantRemoveParams as TenantRemoveParams,
+  };
+}

package/src/resources/v1/groups.ts

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

package/src/resources/v1/index.ts

@@ -0,0 +1,43 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  APIKeys,
+  type APIKey,
+  type APIKeyCreateResponse,
+  type APIKeyListResponse,
+  type APIKeyCreateParams,
+} from './api-keys';
+export {
+  Connections,
+  type Connection,
+  type DatabaseConfig,
+  type ConnectionListResponse,
+  type ConnectionRetrieveCredentialResponse,
+  type ConnectionSyncResponse,
+  type ConnectionCreateParams,
+} from './connections/index';
+export {
+  GitHub,
+  type GitHubCheckInstallationsResponse,
+  type GitHubDisconnectResponse,
+  type GitHubGetStatusResponse,
+  type GitHubSyncResponse,
+} from './github/index';
+export {
+  Groups,
+  type GroupDetail,
+  type GroupListResponse,
+  type GroupCreateParams,
+  type GroupUpdateParams,
+} from './groups/index';
+export { Me, type ClientUser, type ClientUserRole, type MeGetConnectionsResponse } from './me';
+export { Org } from './org/index';
+export {
+  Tenants,
+  type CreateTenant,
+  type Tenant,
+  type TenantListResponse,
+  type TenantCreateParams,
+  type TenantUpdateParams,
+} from './tenants/index';
+export { V1 } from './v1';

package/src/resources/v1/me.ts

@@ -0,0 +1,78 @@
+// 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 Me extends APIResource {
+  /**
+   * Get the current authenticated user's information.
+   *
+   * Returns the user's profile within their active organization. This endpoint only
+   * requires authentication - no special permissions needed.
+   *
+   * RLS: Filtered to current user's data only (RLSDB).
+   */
+  retrieve(options?: RequestOptions): APIPromise<ClientUser> {
+    return this._client.get('/api/v1/me', options);
+  }
+
+  /**
+   * Get connections accessible to the current user.
+   *
+   * Currently returns all connections in the user's organization. All org users have
+   * access to all org connections.
+   */
+  getConnections(options?: RequestOptions): APIPromise<MeGetConnectionsResponse> {
+    return this._client.get('/api/v1/me/connection', options);
+  }
+}
+
+/**
+ * Response schema for a client user.
+ */
+export interface ClientUser {
+  id: string;
+
+  client_id: string;
+
+  created_at: string;
+
+  email: string;
+
+  email_confirmed: boolean;
+
+  /**
+   * Role of a user within a client organization.
+   */
+  role: ClientUserRole;
+
+  updated_at: string;
+
+  first_name?: string | null;
+
+  last_name?: string | null;
+
+  picture_url?: string | null;
+
+  propel_auth_created_at?: string | null;
+
+  propel_auth_last_active_at?: string | null;
+
+  username?: string | null;
+}
+
+/**
+ * Role of a user within a client organization.
+ */
+export type ClientUserRole = 'Admin' | 'Developer' | 'Viewer';
+
+export type MeGetConnectionsResponse = Array<unknown>;
+
+export declare namespace Me {
+  export {
+    type ClientUser as ClientUser,
+    type ClientUserRole as ClientUserRole,
+    type MeGetConnectionsResponse as MeGetConnectionsResponse,
+  };
+}

package/src/resources/v1/org/client.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';
+
+export class ClientResource extends APIResource {
+  /**
+   * Get the current user's organization details.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   */
+  retrieve(options?: RequestOptions): APIPromise<Client> {
+    return this._client.get('/api/v1/org/client', options);
+  }
+
+  /**
+   * Update the current user's organization details.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   */
+  update(body: ClientUpdateParams, options?: RequestOptions): APIPromise<Client> {
+    return this._client.patch('/api/v1/org/client', { body, ...options });
+  }
+}
+
+/**
+ * Response schema for a client/organization.
+ */
+export interface Client {
+  id: string;
+
+  can_auto_join_by_domain: boolean;
+
+  created_at: string;
+
+  members_must_have_matching_domain: boolean;
+
+  name: string;
+
+  /**
+   * Type of tenancy for a client.
+   */
+  tenancy_type: TenancyType;
+
+  updated_at: string;
+
+  domain?: string | null;
+
+  logo_url?: string | null;
+}
+
+/**
+ * Type of tenancy for a client.
+ */
+export type TenancyType = 'row' | 'database' | 'none';
+
+export interface ClientUpdateParams {
+  can_auto_join_by_domain?: boolean | null;
+
+  domain?: string | null;
+
+  logo_url?: string | null;
+
+  members_must_have_matching_domain?: boolean | null;
+
+  name?: string | null;
+
+  /**
+   * Type of tenancy for a client.
+   */
+  tenancy_type?: TenancyType | null;
+}
+
+export declare namespace ClientResource {
+  export {
+    type Client as Client,
+    type TenancyType as TenancyType,
+    type ClientUpdateParams as ClientUpdateParams,
+  };
+}

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

@@ -0,0 +1,11 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { ClientResource, type Client, type TenancyType, type ClientUpdateParams } from './client';
+export { Org } from './org';
+export {
+  Users,
+  type UserListResponse,
+  type UserDeleteResponse,
+  type UserCreateParams,
+  type UserUpdateParams,
+} from './users';

package/src/resources/v1/org/org.ts

@@ -0,0 +1,32 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as ClientAPI from './client';
+import { Client, ClientResource, ClientUpdateParams, TenancyType } from './client';
+import * as UsersAPI from './users';
+import { UserCreateParams, UserDeleteResponse, UserListResponse, UserUpdateParams, Users } from './users';
+
+export class Org extends APIResource {
+  client: ClientAPI.ClientResource = new ClientAPI.ClientResource(this._client);
+  users: UsersAPI.Users = new UsersAPI.Users(this._client);
+}
+
+Org.ClientResource = ClientResource;
+Org.Users = Users;
+
+export declare namespace Org {
+  export {
+    ClientResource as ClientResource,
+    type Client as Client,
+    type TenancyType as TenancyType,
+    type ClientUpdateParams as ClientUpdateParams,
+  };
+
+  export {
+    Users as Users,
+    type UserListResponse as UserListResponse,
+    type UserDeleteResponse as UserDeleteResponse,
+    type UserCreateParams as UserCreateParams,
+    type UserUpdateParams as UserUpdateParams,
+  };
+}

package/src/resources/v1/org/users.ts

@@ -0,0 +1,127 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as MeAPI from '../me';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Users extends APIResource {
+  /**
+   * Create a new user in the current organization.
+   *
+   * Creates the user in PropelAuth and adds them to this organization. The user will
+   * receive an email to confirm their email address.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   */
+  create(body: UserCreateParams, options?: RequestOptions): APIPromise<MeAPI.ClientUser> {
+    return this._client.post('/api/v1/org/users', { body, ...options });
+  }
+
+  /**
+   * Get a specific user in the current organization.
+   *
+   * RLS: Filtered to current client, can see any user (ClientRLSDB).
+   */
+  retrieve(userID: string, options?: RequestOptions): APIPromise<MeAPI.ClientUser> {
+    return this._client.get(path`/api/v1/org/users/${userID}`, options);
+  }
+
+  /**
+   * Update a user in the current organization.
+   *
+   * Different PropelAuth methods are called depending on what's being updated:
+   *
+   * - Email changes require re-confirmation
+   * - Password changes take effect immediately
+   * - Profile fields (name, username, picture) are updated together
+   * - Role changes affect organization permissions
+   *
+   * RLS: Filtered to current client, can update any user (ClientRLSDB).
+   */
+  update(userID: string, body: UserUpdateParams, options?: RequestOptions): APIPromise<MeAPI.ClientUser> {
+    return this._client.patch(path`/api/v1/org/users/${userID}`, { body, ...options });
+  }
+
+  /**
+   * List all users in the current organization.
+   *
+   * RLS: Filtered to current client, sees all users (ClientRLSDB).
+   */
+  list(options?: RequestOptions): APIPromise<UserListResponse> {
+    return this._client.get('/api/v1/org/users', options);
+  }
+
+  /**
+   * Soft delete a user from the current organization.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   */
+  delete(userID: string, options?: RequestOptions): APIPromise<UserDeleteResponse> {
+    return this._client.delete(path`/api/v1/org/users/${userID}`, options);
+  }
+}
+
+/**
+ * Response schema for listing client users.
+ */
+export interface UserListResponse {
+  total: number;
+
+  users: Array<MeAPI.ClientUser>;
+}
+
+/**
+ * Response schema for delete operations.
+ */
+export interface UserDeleteResponse {
+  message: string;
+
+  success: boolean;
+}
+
+export interface UserCreateParams {
+  email: string;
+
+  password: string;
+
+  first_name?: string | null;
+
+  last_name?: string | null;
+
+  /**
+   * Role of a user within a client organization.
+   */
+  role?: MeAPI.ClientUserRole;
+
+  username?: string | null;
+}
+
+export interface UserUpdateParams {
+  email?: string | null;
+
+  first_name?: string | null;
+
+  last_name?: string | null;
+
+  password?: string | null;
+
+  picture_url?: string | null;
+
+  /**
+   * Role of a user within a client organization.
+   */
+  role?: MeAPI.ClientUserRole | null;
+
+  username?: string | null;
+}
+
+export declare namespace Users {
+  export {
+    type UserListResponse as UserListResponse,
+    type UserDeleteResponse as UserDeleteResponse,
+    type UserCreateParams as UserCreateParams,
+    type UserUpdateParams as UserUpdateParams,
+  };
+}

package/src/resources/v1/org.ts

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

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

@@ -0,0 +1,200 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as TenantsAPI from './tenants';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+
+export class Batch extends APIResource {
+  /**
+   * Create multiple tenants in a single request.
+   *
+   * Each tenant is processed independently. If one fails, others may succeed.
+   * Returns lists of succeeded and failed operations.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   */
+  create(body: BatchCreateParams, options?: RequestOptions): APIPromise<BatchCreateResponse> {
+    return this._client.post('/api/v1/tenants/batch', { body, ...options });
+  }
+
+  /**
+   * Update multiple tenants in a single request.
+   *
+   * Each tenant is processed independently. If one fails, others may succeed.
+   * Returns lists of succeeded and failed operations.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   */
+  update(body: BatchUpdateParams, options?: RequestOptions): APIPromise<BatchUpdateResponse> {
+    return this._client.patch('/api/v1/tenants/batch', { body, ...options });
+  }
+
+  /**
+   * Delete multiple tenants in a single request.
+   *
+   * Each tenant is processed independently. If one fails, others may succeed.
+   * Returns lists of succeeded and failed operations.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   */
+  delete(body: BatchDeleteParams, options?: RequestOptions): APIPromise<BatchDeleteResponse> {
+    return this._client.delete('/api/v1/tenants/batch', { body, ...options });
+  }
+}
+
+/**
+ * Failed tenant operation in batch response.
+ */
+export interface BatchTenantError {
+  /**
+   * Error code
+   */
+  code: string;
+
+  /**
+   * Error message
+   */
+  message: string;
+
+  /**
+   * Index in request array (for create operations)
+   */
+  index?: number | null;
+
+  /**
+   * Tenant ID (for update/delete operations)
+   */
+  tenant_id?: string | null;
+
+  /**
+   * Tenant key (for create operations)
+   */
+  tenant_key?: string | null;
+}
+
+/**
+ * Successful tenant operation in batch response.
+ */
+export interface BatchTenantSuccess {
+  /**
+   * Tenant ID
+   */
+  tenant_id: string;
+
+  /**
+   * Response model for a single tenant.
+   */
+  tenant?: TenantsAPI.Tenant | null;
+}
+
+/**
+ * Response model for batch tenant creation.
+ */
+export interface BatchCreateResponse {
+  /**
+   * Failed tenant creations
+   */
+  failed: Array<BatchTenantError>;
+
+  /**
+   * Successfully created tenants
+   */
+  succeeded: Array<BatchTenantSuccess>;
+}
+
+/**
+ * Response model for batch tenant updates.
+ */
+export interface BatchUpdateResponse {
+  /**
+   * Failed tenant updates
+   */
+  failed: Array<BatchTenantError>;
+
+  /**
+   * Successfully updated tenants
+   */
+  succeeded: Array<BatchTenantSuccess>;
+}
+
+/**
+ * Response model for batch tenant deletions.
+ */
+export interface BatchDeleteResponse {
+  /**
+   * Failed tenant deletions
+   */
+  failed: Array<BatchTenantError>;
+
+  /**
+   * Successfully deleted tenants
+   */
+  succeeded: Array<BatchTenantSuccess>;
+}
+
+export interface BatchCreateParams {
+  /**
+   * List of tenants to create
+   */
+  tenants: Array<TenantsAPI.CreateTenant>;
+}
+
+export interface BatchUpdateParams {
+  /**
+   * List of tenant updates
+   */
+  tenants: Array<BatchUpdateParams.Tenant>;
+}
+
+export namespace BatchUpdateParams {
+  /**
+   * Single tenant update in a batch operation.
+   */
+  export interface Tenant {
+    /**
+     * Tenant ID to update
+     */
+    tenant_id: string;
+
+    /**
+     * Connection ID for database association (required with database_name)
+     */
+    connection_id?: string | null;
+
+    /**
+     * Database name for association (required with connection_id)
+     */
+    database_name?: string | null;
+
+    /**
+     * New list of group names (replaces all existing associations)
+     */
+    group_names?: Array<string> | null;
+
+    /**
+     * New human-readable tenant name
+     */
+    tenant_name?: string | null;
+  }
+}
+
+export interface BatchDeleteParams {
+  /**
+   * List of tenant IDs to delete
+   */
+  tenant_ids: Array<string>;
+}
+
+export declare namespace Batch {
+  export {
+    type BatchTenantError as BatchTenantError,
+    type BatchTenantSuccess as BatchTenantSuccess,
+    type BatchCreateResponse as BatchCreateResponse,
+    type BatchUpdateResponse as BatchUpdateResponse,
+    type BatchDeleteResponse as BatchDeleteResponse,
+    type BatchCreateParams as BatchCreateParams,
+    type BatchUpdateParams as BatchUpdateParams,
+    type BatchDeleteParams as BatchDeleteParams,
+  };
+}