@katerai/sdk 0.1.2

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

@@ -0,0 +1,158 @@
+// 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 { type Uploadable } from '../../../core/uploads';
+import { RequestOptions } from '../../../internal/request-options';
+import { multipartFormRequestOptions } from '../../../internal/uploads';
+
+export class Import 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)
+   */
+  fromCsv(body: ImportFromCsvParams, options?: RequestOptions): APIPromise<ImportTenants> {
+    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)
+   */
+  fromWarehouse(body: ImportFromWarehouseParams, options?: RequestOptions): APIPromise<ImportTenants> {
+    return this._client.post('/api/v1/tenants/import/warehouse', { body, ...options });
+  }
+}
+
+/**
+ * Response model for tenant import operation.
+ */
+export interface ImportTenants {
+  /**
+   * 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<ImportTenants.Error>;
+
+  /**
+   * Groups that were auto-created
+   */
+  groups_created?: Array<string>;
+}
+
+export namespace ImportTenants {
+  /**
+   * 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 ImportFromCsvParams {
+  /**
+   * CSV file with tenant data
+   */
+  file: Uploadable;
+}
+
+export interface ImportFromWarehouseParams {
+  /**
+   * 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 Import {
+  export {
+    type ImportTenants as ImportTenants,
+    type ImportFromCsvParams as ImportFromCsvParams,
+    type ImportFromWarehouseParams as ImportFromWarehouseParams,
+  };
+}

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

@@ -0,0 +1,27 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Batch,
+  type BatchTenantError,
+  type BatchTenantSuccess,
+  type BatchCreateResponse,
+  type BatchUpdateResponse,
+  type BatchDeleteResponse,
+  type BatchCreateParams,
+  type BatchUpdateParams,
+  type BatchDeleteParams,
+} from './batch';
+export {
+  Import,
+  type ImportTenants,
+  type ImportFromCsvParams,
+  type ImportFromWarehouseParams,
+} from './import';
+export {
+  Tenants,
+  type CreateTenant,
+  type Tenant,
+  type TenantListResponse,
+  type TenantCreateParams,
+  type TenantUpdateParams,
+} from './tenants';

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

@@ -0,0 +1,290 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as BatchAPI from './batch';
+import {
+  Batch,
+  BatchCreateParams,
+  BatchCreateResponse,
+  BatchDeleteParams,
+  BatchDeleteResponse,
+  BatchTenantError,
+  BatchTenantSuccess,
+  BatchUpdateParams,
+  BatchUpdateResponse,
+} from './batch';
+import * as ImportAPI from './import';
+import { Import, ImportFromCsvParams, ImportFromWarehouseParams, ImportTenants } from './import';
+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 {
+  batch: BatchAPI.Batch = new BatchAPI.Batch(this._client);
+  import: ImportAPI.Import = new ImportAPI.Import(this._client);
+
+  /**
+   * Create a new tenant.
+   *
+   * Validates the client's tenancy type and creates the tenant accordingly:
+   *
+   * - ROW tenancy: Creates tenant with optional group associations
+   * - DATABASE tenancy: Requires database_name, creates tenant with database
+   *   association
+   * - NONE tenancy: Returns error (tenant creation not allowed)
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   */
+  create(body: TenantCreateParams, options?: RequestOptions): APIPromise<Tenant> {
+    return this._client.post('/api/v1/tenants', { body, ...options });
+  }
+
+  /**
+   * Get a single tenant by ID.
+   *
+   * Returns the tenant with associated groups and databases.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   *
+   * Raises: TenantNotFoundError: If tenant doesn't exist (404)
+   */
+  retrieve(tenantID: string, options?: RequestOptions): APIPromise<Tenant> {
+    return this._client.get(path`/api/v1/tenants/${tenantID}`, options);
+  }
+
+  /**
+   * Update a tenant.
+   *
+   * Updates tenant metadata, group associations, and/or database associations. Group
+   * associations use replace semantics:
+   *
+   * - Omit group_names to leave existing associations unchanged
+   * - Pass empty list to remove all group associations
+   * - Pass list of names to replace all associations
+   *
+   * Database associations (DATABASE tenancy only):
+   *
+   * - Both connection_id and database_name must be provided together
+   * - Replaces existing database association
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   *
+   * Raises: TenantNotFoundError: If tenant doesn't exist (404)
+   */
+  update(tenantID: string, body: TenantUpdateParams, options?: RequestOptions): APIPromise<Tenant> {
+    return this._client.patch(path`/api/v1/tenants/${tenantID}`, { body, ...options });
+  }
+
+  /**
+   * List all tenants for the client.
+   *
+   * Returns tenants with their associated groups and databases.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   */
+  list(options?: RequestOptions): APIPromise<TenantListResponse> {
+    return this._client.get('/api/v1/tenants', options);
+  }
+
+  /**
+   * Delete a tenant.
+   *
+   * Soft-deletes the tenant and its group/database associations.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   *
+   * Raises: TenantNotFoundError: If tenant doesn't exist (404)
+   */
+  delete(tenantID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/api/v1/tenants/${tenantID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+/**
+ * Request model for creating a single tenant.
+ */
+export interface CreateTenant {
+  /**
+   * Unique tenant identifier within the client
+   */
+  tenant_key: string;
+
+  /**
+   * Connection ID (required for DATABASE tenancy type)
+   */
+  connection_id?: string | null;
+
+  /**
+   * Database name (required for DATABASE tenancy type)
+   */
+  database_name?: string | null;
+
+  /**
+   * List of group names to associate with the tenant
+   */
+  group_names?: Array<string> | null;
+
+  /**
+   * Human-readable tenant name
+   */
+  tenant_name?: string | null;
+}
+
+/**
+ * Response model for a single tenant.
+ */
+export interface Tenant {
+  /**
+   * Tenant ID
+   */
+  id: string;
+
+  /**
+   * Creation timestamp
+   */
+  created_at: string;
+
+  /**
+   * Associated databases
+   */
+  databases: Array<Tenant.Database>;
+
+  /**
+   * Associated groups
+   */
+  groups: Array<Tenant.Group>;
+
+  /**
+   * Human-readable tenant name
+   */
+  name: string | null;
+
+  /**
+   * Unique tenant identifier
+   */
+  tenant_key: string;
+
+  /**
+   * Last update timestamp
+   */
+  updated_at: string;
+}
+
+export namespace Tenant {
+  /**
+   * Database information in tenant responses.
+   */
+  export interface Database {
+    /**
+     * Database ID
+     */
+    id: string;
+
+    /**
+     * Database name
+     */
+    name: string;
+  }
+
+  /**
+   * Group information in tenant responses.
+   */
+  export interface Group {
+    /**
+     * Group ID
+     */
+    id: string;
+
+    /**
+     * Group name
+     */
+    name: string;
+  }
+}
+
+export type TenantListResponse = Array<Tenant>;
+
+export interface TenantCreateParams {
+  /**
+   * Unique tenant identifier within the client
+   */
+  tenant_key: string;
+
+  /**
+   * Connection ID (required for DATABASE tenancy type)
+   */
+  connection_id?: string | null;
+
+  /**
+   * Database name (required for DATABASE tenancy type)
+   */
+  database_name?: string | null;
+
+  /**
+   * List of group names to associate with the tenant
+   */
+  group_names?: Array<string> | null;
+
+  /**
+   * Human-readable tenant name
+   */
+  tenant_name?: string | null;
+}
+
+export interface TenantUpdateParams {
+  /**
+   * 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;
+}
+
+Tenants.Batch = Batch;
+Tenants.Import = Import;
+
+export declare namespace Tenants {
+  export {
+    type CreateTenant as CreateTenant,
+    type Tenant as Tenant,
+    type TenantListResponse as TenantListResponse,
+    type TenantCreateParams as TenantCreateParams,
+    type TenantUpdateParams as TenantUpdateParams,
+  };
+
+  export {
+    Batch as Batch,
+    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,
+  };
+
+  export {
+    Import as Import,
+    type ImportTenants as ImportTenants,
+    type ImportFromCsvParams as ImportFromCsvParams,
+    type ImportFromWarehouseParams as ImportFromWarehouseParams,
+  };
+}

package/src/resources/v1/tenants.ts

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

package/src/resources/v1/v1.ts

@@ -0,0 +1,116 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as APIKeysAPI from './api-keys';
+import { APIKey, APIKeyCreateParams, APIKeyCreateResponse, APIKeyListResponse, APIKeys } from './api-keys';
+import * as MeAPI from './me';
+import { ClientUser, ClientUserRole, Me, MeGetConnectionsResponse } from './me';
+import * as ConnectionsAPI from './connections/connections';
+import {
+  Connection,
+  ConnectionCreateParams,
+  ConnectionListResponse,
+  ConnectionRetrieveCredentialResponse,
+  ConnectionSyncResponse,
+  Connections,
+  DatabaseConfig,
+} from './connections/connections';
+import * as GitHubAPI from './github/github';
+import {
+  GitHub,
+  GitHubCheckInstallationsResponse,
+  GitHubDisconnectResponse,
+  GitHubGetStatusResponse,
+  GitHubSyncResponse,
+} 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,
+  TenantUpdateParams,
+  Tenants,
+} from './tenants/tenants';
+
+export class V1 extends APIResource {
+  apiKeys: APIKeysAPI.APIKeys = new APIKeysAPI.APIKeys(this._client);
+  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.APIKeys = APIKeys;
+V1.Connections = Connections;
+V1.GitHub = GitHub;
+V1.Groups = Groups;
+V1.Me = Me;
+V1.Org = Org;
+V1.Tenants = Tenants;
+
+export declare namespace V1 {
+  export {
+    APIKeys as APIKeys,
+    type APIKey as APIKey,
+    type APIKeyCreateResponse as APIKeyCreateResponse,
+    type APIKeyListResponse as APIKeyListResponse,
+    type APIKeyCreateParams as APIKeyCreateParams,
+  };
+
+  export {
+    Connections as Connections,
+    type Connection as Connection,
+    type DatabaseConfig as DatabaseConfig,
+    type ConnectionListResponse as ConnectionListResponse,
+    type ConnectionRetrieveCredentialResponse as ConnectionRetrieveCredentialResponse,
+    type ConnectionSyncResponse as ConnectionSyncResponse,
+    type ConnectionCreateParams as ConnectionCreateParams,
+  };
+
+  export {
+    GitHub as GitHub,
+    type GitHubCheckInstallationsResponse as GitHubCheckInstallationsResponse,
+    type GitHubDisconnectResponse as GitHubDisconnectResponse,
+    type GitHubGetStatusResponse as GitHubGetStatusResponse,
+    type GitHubSyncResponse as GitHubSyncResponse,
+  };
+
+  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,
+    type MeGetConnectionsResponse as MeGetConnectionsResponse,
+  };
+
+  export { Org as Org };
+
+  export {
+    Tenants as Tenants,
+    type CreateTenant as CreateTenant,
+    type Tenant as Tenant,
+    type TenantListResponse as TenantListResponse,
+    type TenantCreateParams as TenantCreateParams,
+    type TenantUpdateParams as TenantUpdateParams,
+  };
+}

package/src/resources/v1.ts

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

package/src/resources.ts

@@ -0,0 +1 @@
+export * from './resources/index';

package/src/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  // this config is included in the published src directory to prevent TS errors
+  // from appearing when users go to source, and VSCode opens the source .ts file
+  // via declaration maps
+  "include": ["index.ts"],
+  "compilerOptions": {
+    "target": "ES2015",
+    "lib": ["DOM", "DOM.Iterable", "ES2018"],
+    "moduleResolution": "node"
+  }
+}

package/src/uploads.ts

@@ -0,0 +1,2 @@
+/** @deprecated Import from ./core/uploads instead */
+export * from './core/uploads';

package/src/version.ts

@@ -0,0 +1 @@
+export const VERSION = '0.1.2'; // x-release-please-version

package/uploads.d.mts

@@ -0,0 +1,2 @@
+export * from "./core/uploads.mjs";
+//# sourceMappingURL=uploads.d.mts.map

package/uploads.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.d.mts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}

package/uploads.d.ts

@@ -0,0 +1,2 @@
+export * from "./core/uploads.js";
+//# sourceMappingURL=uploads.d.ts.map

package/uploads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}

package/uploads.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("./internal/tslib.js");
+/** @deprecated Import from ./core/uploads instead */
+tslib_1.__exportStar(require("./core/uploads.js"), exports);
+//# sourceMappingURL=uploads.js.map

package/uploads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.js","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":";;;AAAA,qDAAqD;AACrD,4DAA+B"}

package/uploads.mjs

@@ -0,0 +1,2 @@
+export * from "./core/uploads.mjs";
+//# sourceMappingURL=uploads.mjs.map

package/uploads.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.mjs","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}

package/version.d.mts

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

package/version.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/version.d.ts

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

package/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/version.js

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

package/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}

package/version.mjs

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

package/version.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}