@katerai/sdk 0.1.2

package/resources/v1/tenants/import.js

@@ -0,0 +1,50 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Import = void 0;
+const resource_1 = require("../../../core/resource.js");
+const uploads_1 = require("../../../internal/uploads.js");
+class Import extends resource_1.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, options) {
+        return this._client.post('/api/v1/tenants/import/csv', (0, uploads_1.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, options) {
+        return this._client.post('/api/v1/tenants/import/warehouse', { body, ...options });
+    }
+}
+exports.Import = Import;
+//# sourceMappingURL=import.js.map

package/resources/v1/tenants/import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.js","sourceRoot":"","sources":["../../../src/resources/v1/tenants/import.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAIrD,0DAAwE;AAExE,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,IAAyB,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,4BAA4B,EAC5B,IAAA,qCAA2B,EAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAChE,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,aAAa,CAAC,IAA+B,EAAE,OAAwB;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kCAAkC,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;CACF;AA7CD,wBA6CC"}

package/resources/v1/tenants/import.mjs

@@ -0,0 +1,46 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../core/resource.mjs";
+import { multipartFormRequestOptions } from "../../../internal/uploads.mjs";
+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, options) {
+        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, options) {
+        return this._client.post('/api/v1/tenants/import/warehouse', { body, ...options });
+    }
+}
+//# sourceMappingURL=import.mjs.map

package/resources/v1/tenants/import.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.mjs","sourceRoot":"","sources":["../../../src/resources/v1/tenants/import.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAIf,EAAE,2BAA2B,EAAE;AAEtC,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,IAAyB,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,4BAA4B,EAC5B,2BAA2B,CAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAChE,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,aAAa,CAAC,IAA+B,EAAE,OAAwB;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kCAAkC,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;CACF"}

package/resources/v1/tenants/index.d.mts

@@ -0,0 +1,4 @@
+export { Batch, type BatchTenantError, type BatchTenantSuccess, type BatchCreateResponse, type BatchUpdateResponse, type BatchDeleteResponse, type BatchCreateParams, type BatchUpdateParams, type BatchDeleteParams, } from "./batch.mjs";
+export { Import, type ImportTenants, type ImportFromCsvParams, type ImportFromWarehouseParams, } from "./import.mjs";
+export { Tenants, type CreateTenant, type Tenant, type TenantListResponse, type TenantCreateParams, type TenantUpdateParams, } from "./tenants.mjs";
+//# sourceMappingURL=index.d.mts.map

package/resources/v1/tenants/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/resources/v1/tenants/index.ts"],"names":[],"mappings":"OAEO,EACL,KAAK,EACL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB;OACM,EACL,MAAM,EACN,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,GAC/B;OACM,EACL,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,MAAM,EACX,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB"}

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

@@ -0,0 +1,4 @@
+export { Batch, type BatchTenantError, type BatchTenantSuccess, type BatchCreateResponse, type BatchUpdateResponse, type BatchDeleteResponse, type BatchCreateParams, type BatchUpdateParams, type BatchDeleteParams, } from "./batch.js";
+export { Import, type ImportTenants, type ImportFromCsvParams, type ImportFromWarehouseParams, } from "./import.js";
+export { Tenants, type CreateTenant, type Tenant, type TenantListResponse, type TenantCreateParams, type TenantUpdateParams, } from "./tenants.js";
+//# sourceMappingURL=index.d.ts.map

package/resources/v1/tenants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resources/v1/tenants/index.ts"],"names":[],"mappings":"OAEO,EACL,KAAK,EACL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB;OACM,EACL,MAAM,EACN,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,GAC/B;OACM,EACL,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,MAAM,EACX,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB"}

package/resources/v1/tenants/index.js

@@ -0,0 +1,11 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tenants = exports.Import = exports.Batch = void 0;
+var batch_1 = require("./batch.js");
+Object.defineProperty(exports, "Batch", { enumerable: true, get: function () { return batch_1.Batch; } });
+var import_1 = require("./import.js");
+Object.defineProperty(exports, "Import", { enumerable: true, get: function () { return import_1.Import; } });
+var tenants_1 = require("./tenants.js");
+Object.defineProperty(exports, "Tenants", { enumerable: true, get: function () { return tenants_1.Tenants; } });
+//# sourceMappingURL=index.js.map

package/resources/v1/tenants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/v1/tenants/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,oCAUiB;AATf,8FAAA,KAAK,OAAA;AAUP,sCAKkB;AAJhB,gGAAA,MAAM,OAAA;AAKR,wCAOmB;AANjB,kGAAA,OAAO,OAAA"}

package/resources/v1/tenants/index.mjs

@@ -0,0 +1,5 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { Batch, } from "./batch.mjs";
+export { Import, } from "./import.mjs";
+export { Tenants, } from "./tenants.mjs";
+//# sourceMappingURL=index.mjs.map

package/resources/v1/tenants/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/resources/v1/tenants/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,KAAK,GASN;OACM,EACL,MAAM,GAIP;OACM,EACL,OAAO,GAMR"}

package/resources/v1/tenants/tenants.d.mts

@@ -0,0 +1,205 @@
+import { APIResource } from "../../../core/resource.mjs";
+import * as BatchAPI from "./batch.mjs";
+import { Batch, BatchCreateParams, BatchCreateResponse, BatchDeleteParams, BatchDeleteResponse, BatchTenantError, BatchTenantSuccess, BatchUpdateParams, BatchUpdateResponse } from "./batch.mjs";
+import * as ImportAPI from "./import.mjs";
+import { Import, ImportFromCsvParams, ImportFromWarehouseParams, ImportTenants } from "./import.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+export declare class Tenants extends APIResource {
+    batch: BatchAPI.Batch;
+    import: ImportAPI.Import;
+    /**
+     * 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>;
+    /**
+     * 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>;
+    /**
+     * 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>;
+    /**
+     * 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>;
+    /**
+     * 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>;
+}
+/**
+ * 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 declare namespace Tenant {
+    /**
+     * Database information in tenant responses.
+     */
+    interface Database {
+        /**
+         * Database ID
+         */
+        id: string;
+        /**
+         * Database name
+         */
+        name: string;
+    }
+    /**
+     * Group information in tenant responses.
+     */
+    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;
+}
+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, };
+}
+//# sourceMappingURL=tenants.d.mts.map

package/resources/v1/tenants/tenants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenants.d.mts","sourceRoot":"","sources":["../../../src/resources/v1/tenants/tenants.ts"],"names":[],"mappings":"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"}

package/resources/v1/tenants/tenants.d.ts

@@ -0,0 +1,205 @@
+import { APIResource } from "../../../core/resource.js";
+import * as BatchAPI from "./batch.js";
+import { Batch, BatchCreateParams, BatchCreateResponse, BatchDeleteParams, BatchDeleteResponse, BatchTenantError, BatchTenantSuccess, BatchUpdateParams, BatchUpdateResponse } from "./batch.js";
+import * as ImportAPI from "./import.js";
+import { Import, ImportFromCsvParams, ImportFromWarehouseParams, ImportTenants } from "./import.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+export declare class Tenants extends APIResource {
+    batch: BatchAPI.Batch;
+    import: ImportAPI.Import;
+    /**
+     * 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>;
+    /**
+     * 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>;
+    /**
+     * 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>;
+    /**
+     * 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>;
+    /**
+     * 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>;
+}
+/**
+ * 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 declare namespace Tenant {
+    /**
+     * Database information in tenant responses.
+     */
+    interface Database {
+        /**
+         * Database ID
+         */
+        id: string;
+        /**
+         * Database name
+         */
+        name: string;
+    }
+    /**
+     * Group information in tenant responses.
+     */
+    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;
+}
+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, };
+}
+//# sourceMappingURL=tenants.d.ts.map

package/resources/v1/tenants/tenants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenants.d.ts","sourceRoot":"","sources":["../../../src/resources/v1/tenants/tenants.ts"],"names":[],"mappings":"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"}

package/resources/v1/tenants/tenants.js

@@ -0,0 +1,97 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tenants = void 0;
+const tslib_1 = require("../../../internal/tslib.js");
+const resource_1 = require("../../../core/resource.js");
+const BatchAPI = tslib_1.__importStar(require("./batch.js"));
+const batch_1 = require("./batch.js");
+const ImportAPI = tslib_1.__importStar(require("./import.js"));
+const import_1 = require("./import.js");
+const headers_1 = require("../../../internal/headers.js");
+const path_1 = require("../../../internal/utils/path.js");
+class Tenants extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.batch = new BatchAPI.Batch(this._client);
+        this.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, options) {
+        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, options) {
+        return this._client.get((0, path_1.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, body, options) {
+        return this._client.patch((0, path_1.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) {
+        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, options) {
+        return this._client.delete((0, path_1.path) `/api/v1/tenants/${tenantID}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.Tenants = Tenants;
+Tenants.Batch = batch_1.Batch;
+Tenants.Import = import_1.Import;
+//# sourceMappingURL=tenants.js.map