@katerai/sdk 0.9.0 → 0.11.0

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

@@ -1 +1 @@
-{"version":3,"file":"tenants.js","sourceRoot":"","sources":["../../../src/resources/v1/tenants/tenants.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,wDAAqD;AACrD,+DAAsC;AACtC,wCAAsE;AAItE,0DAAwE;AAExE,MAAa,OAAQ,SAAQ,sBAAW;IAAxC;;QACE,WAAM,GAAqB,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAiEhE,CAAC;IA/DC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,OAAwB;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,aAAa,CACX,IAA+B,EAC/B,OAAwB;QAExB,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,mBAAmB,CACjB,IAAqC,EACrC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kCAAkC,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;CACF;AAlED,0BAkEC;AAoID,OAAO,CAAC,MAAM,GAAG,eAAM,CAAC"}
+{"version":3,"file":"tenants.js","sourceRoot":"","sources":["../../../src/resources/v1/tenants/tenants.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,wDAAqD;AACrD,+DAAsC;AACtC,wCAAsE;AAGtE,0DAAyD;AAEzD,0DAAwE;AAExE,MAAa,OAAQ,SAAQ,sBAAW;IAAxC;;QACE,WAAM,GAAqB,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA0FhE,CAAC;IAxFC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,OAAwB;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,aAAa,CACX,MAAiC,EACjC,OAAwB;QAExB,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,4BAA4B,EAC5B,IAAA,qCAA2B,EACzB;YACE,KAAK,EAAE,EAAE,MAAM,EAAE;YACjB,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBAC5E,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,EACD,IAAI,CAAC,OAAO,CACb,CACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,mBAAmB,CACjB,MAAuC,EACvC,OAAwB;QAExB,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kCAAkC,EAAE;YAC3D,KAAK,EAAE,EAAE,MAAM,EAAE;YACjB,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBAC5E,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF;AA3FD,0BA2FC;AAiMD,OAAO,CAAC,MAAM,GAAG,eAAM,CAAC"}

package/resources/v1/tenants/tenants.mjs

@@ -2,6 +2,7 @@
 import { APIResource } from "../../../core/resource.mjs";
 import * as GroupsAPI from "./groups.mjs";
 import { Groups } from "./groups.mjs";
+import { buildHeaders } from "../../../internal/headers.mjs";
 import { multipartFormRequestOptions } from "../../../internal/uploads.mjs";
 export class Tenants extends APIResource {
     constructor() {
@@ -28,17 +29,30 @@ export class Tenants extends APIResource {
      * - tenant_key (required): Unique tenant identifier
      * - tenant_name (optional): Human-readable name
      * - group_names (optional): Comma-separated list of group names
+     * - Additional columns can be mapped to attributes via attribute_columns
      *
      * Creates new tenants and updates existing ones with new name/groups. Groups are
      * added additively (not replaced) and auto-created if needed.
      *
+     * Optionally processes attribute columns: values are validated against
+     * attributes.yaml, stored additively, and validation errors are non-fatal.
+     *
      * RLS: Filtered to current client (ClientRLSDB).
      *
      * Raises: ValidationError: If CSV format is invalid (400)
      * TenantCreationNotAllowedError: If tenancy type is NONE (400)
      */
-    importFromCsv(body, options) {
-        return this._client.post('/api/v1/tenants/import/csv', multipartFormRequestOptions({ body, ...options }, this._client));
+    importFromCsv(params, options) {
+        const { source, 'X-Kater-CLI-ID': xKaterCliID, ...body } = params;
+        return this._client.post('/api/v1/tenants/import/csv', multipartFormRequestOptions({
+            query: { source },
+            body,
+            ...options,
+            headers: buildHeaders([
+                { ...(xKaterCliID != null ? { 'X-Kater-CLI-ID': xKaterCliID } : undefined) },
+                options?.headers,
+            ]),
+        }, this._client));
     }
     /**
      * Import tenants from a warehouse table using upsert semantics.
@@ -57,8 +71,17 @@ export class Tenants extends APIResource {
      * Raises: ConnectionNotFoundError: If the connection doesn't exist (404)
      * TenantCreationNotAllowedError: If tenancy type is NONE (400)
      */
-    importFromWarehouse(body, options) {
-        return this._client.post('/api/v1/tenants/import/warehouse', { body, ...options });
+    importFromWarehouse(params, options) {
+        const { source, 'X-Kater-CLI-ID': xKaterCliID, ...body } = params;
+        return this._client.post('/api/v1/tenants/import/warehouse', {
+            query: { source },
+            body,
+            ...options,
+            headers: buildHeaders([
+                { ...(xKaterCliID != null ? { 'X-Kater-CLI-ID': xKaterCliID } : undefined) },
+                options?.headers,
+            ]),
+        });
     }
 }
 Tenants.Groups = Groups;

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

@@ -1 +1 @@
-{"version":3,"file":"tenants.mjs","sourceRoot":"","sources":["../../../src/resources/v1/tenants/tenants.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,SAAS;OACd,EAAsC,MAAM,EAAE;OAI9C,EAAE,2BAA2B,EAAE;AAEtC,MAAM,OAAO,OAAQ,SAAQ,WAAW;IAAxC;;QACE,WAAM,GAAqB,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAiEhE,CAAC;IA/DC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,OAAwB;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,aAAa,CACX,IAA+B,EAC/B,OAAwB;QAExB,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,mBAAmB,CACjB,IAAqC,EACrC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kCAAkC,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;CACF;AAoID,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC"}
+{"version":3,"file":"tenants.mjs","sourceRoot":"","sources":["../../../src/resources/v1/tenants/tenants.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,SAAS;OACd,EAAsC,MAAM,EAAE;OAG9C,EAAE,YAAY,EAAE;OAEhB,EAAE,2BAA2B,EAAE;AAEtC,MAAM,OAAO,OAAQ,SAAQ,WAAW;IAAxC;;QACE,WAAM,GAAqB,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA0FhE,CAAC;IAxFC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,OAAwB;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,aAAa,CACX,MAAiC,EACjC,OAAwB;QAExB,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,4BAA4B,EAC5B,2BAA2B,CACzB;YACE,KAAK,EAAE,EAAE,MAAM,EAAE;YACjB,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBAC5E,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,EACD,IAAI,CAAC,OAAO,CACb,CACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,mBAAmB,CACjB,MAAuC,EACvC,OAAwB;QAExB,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kCAAkC,EAAE;YAC3D,KAAK,EAAE,EAAE,MAAM,EAAE;YACjB,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBAC5E,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF;AAiMD,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC"}

package/resources/v1/v1.d.mts

@@ -1,8 +1,8 @@
 import { APIResource } from "../../core/resource.mjs";
-import * as CompilerAPI from "./compiler.mjs";
-import { ChartConfig, Compiler, CompilerCompileParams, CompilerCompileResponse, CompilerErrorItem, CompilerResolveParams, CompilerResolveResponse, CompilerValidateParams, CompilerValidateResponse, InlineField, Manifest, ManifestEntry, RefWithLabel, SubqueryCondition } from "./compiler.mjs";
 import * as ConnectionsAPI from "./connections.mjs";
 import { Connection, ConnectionListConnectionsParams, ConnectionListConnectionsResponse, Connections } from "./connections.mjs";
+import * as CompilerAPI from "./compiler/compiler.mjs";
+import { ChartConfig, Compiler, CompilerCompileDashboardParams, CompilerCompileDashboardResponse, CompilerCompileParams, CompilerCompileResponse, CompilerEnumerateParams, CompilerEnumerateResponse, CompilerErrorItem, CompilerExecuteParams, CompilerExecuteResponse, CompilerResolveParams, CompilerResolveResponse, CompilerValidateParams, CompilerValidateResponse, InlineField, Manifest, ManifestEntry, RefWithLabel, SubqueryCondition } from "./compiler/compiler.mjs";
 import * as TenantsAPI from "./tenants/tenants.mjs";
 import { ImportTenantsResponse, TenantGetTenantsSchemaResponse, TenantImportFromCsvParams, TenantImportFromWarehouseParams, Tenants } from "./tenants/tenants.mjs";
 export declare class V1 extends APIResource {
@@ -11,7 +11,7 @@ export declare class V1 extends APIResource {
     tenants: TenantsAPI.Tenants;
 }
 export declare namespace V1 {
-    export { Compiler as Compiler, type ChartConfig as ChartConfig, type CompilerErrorItem as CompilerErrorItem, type InlineField as InlineField, type Manifest as Manifest, type ManifestEntry as ManifestEntry, type RefWithLabel as RefWithLabel, type SubqueryCondition as SubqueryCondition, type CompilerCompileResponse as CompilerCompileResponse, type CompilerResolveResponse as CompilerResolveResponse, type CompilerValidateResponse as CompilerValidateResponse, type CompilerCompileParams as CompilerCompileParams, type CompilerResolveParams as CompilerResolveParams, type CompilerValidateParams as CompilerValidateParams, };
+    export { Compiler as Compiler, type ChartConfig as ChartConfig, type CompilerErrorItem as CompilerErrorItem, type InlineField as InlineField, type Manifest as Manifest, type ManifestEntry as ManifestEntry, type RefWithLabel as RefWithLabel, type SubqueryCondition as SubqueryCondition, type CompilerCompileResponse as CompilerCompileResponse, type CompilerCompileDashboardResponse as CompilerCompileDashboardResponse, type CompilerEnumerateResponse as CompilerEnumerateResponse, type CompilerExecuteResponse as CompilerExecuteResponse, type CompilerResolveResponse as CompilerResolveResponse, type CompilerValidateResponse as CompilerValidateResponse, type CompilerCompileParams as CompilerCompileParams, type CompilerCompileDashboardParams as CompilerCompileDashboardParams, type CompilerEnumerateParams as CompilerEnumerateParams, type CompilerExecuteParams as CompilerExecuteParams, type CompilerResolveParams as CompilerResolveParams, type CompilerValidateParams as CompilerValidateParams, };
     export { Connections as Connections, type Connection as Connection, type ConnectionListConnectionsResponse as ConnectionListConnectionsResponse, type ConnectionListConnectionsParams as ConnectionListConnectionsParams, };
     export { Tenants as Tenants, type ImportTenantsResponse as ImportTenantsResponse, type TenantGetTenantsSchemaResponse as TenantGetTenantsSchemaResponse, type TenantImportFromCsvParams as TenantImportFromCsvParams, type TenantImportFromWarehouseParams as TenantImportFromWarehouseParams, };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"v1.d.mts","sourceRoot":"","sources":["../../src/resources/v1/v1.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,WAAW;OAChB,EACL,WAAW,EACX,QAAQ,EACR,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,WAAW,EACX,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,iBAAiB,EAClB;OACM,KAAK,cAAc;OACnB,EACL,UAAU,EACV,+BAA+B,EAC/B,iCAAiC,EACjC,WAAW,EACZ;OACM,KAAK,UAAU;OACf,EACL,qBAAqB,EACrB,8BAA8B,EAC9B,yBAAyB,EACzB,+BAA+B,EAC/B,OAAO,EACR;AAED,qBAAa,EAAG,SAAQ,WAAW;IACjC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAA0C;IACxE,WAAW,EAAE,cAAc,CAAC,WAAW,CAAgD;IACvF,OAAO,EAAE,UAAU,CAAC,OAAO,CAAwC;CACpE;AAMD,MAAM,CAAC,OAAO,WAAW,EAAE,CAAC;IAC1B,OAAO,EACL,QAAQ,IAAI,QAAQ,EACpB,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,QAAQ,IAAI,QAAQ,EACzB,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,YAAY,IAAI,YAAY,EACjC,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;IAEF,OAAO,EACL,WAAW,IAAI,WAAW,EAC1B,KAAK,UAAU,IAAI,UAAU,EAC7B,KAAK,iCAAiC,IAAI,iCAAiC,EAC3E,KAAK,+BAA+B,IAAI,+BAA+B,GACxE,CAAC;IAEF,OAAO,EACL,OAAO,IAAI,OAAO,EAClB,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,+BAA+B,IAAI,+BAA+B,GACxE,CAAC;CACH"}
+{"version":3,"file":"v1.d.mts","sourceRoot":"","sources":["../../src/resources/v1/v1.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,cAAc;OACnB,EACL,UAAU,EACV,+BAA+B,EAC/B,iCAAiC,EACjC,WAAW,EACZ;OACM,KAAK,WAAW;OAChB,EACL,WAAW,EACX,QAAQ,EACR,8BAA8B,EAC9B,gCAAgC,EAChC,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,WAAW,EACX,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,iBAAiB,EAClB;OACM,KAAK,UAAU;OACf,EACL,qBAAqB,EACrB,8BAA8B,EAC9B,yBAAyB,EACzB,+BAA+B,EAC/B,OAAO,EACR;AAED,qBAAa,EAAG,SAAQ,WAAW;IACjC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAA0C;IACxE,WAAW,EAAE,cAAc,CAAC,WAAW,CAAgD;IACvF,OAAO,EAAE,UAAU,CAAC,OAAO,CAAwC;CACpE;AAMD,MAAM,CAAC,OAAO,WAAW,EAAE,CAAC;IAC1B,OAAO,EACL,QAAQ,IAAI,QAAQ,EACpB,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,QAAQ,IAAI,QAAQ,EACzB,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,YAAY,IAAI,YAAY,EACjC,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,gCAAgC,IAAI,gCAAgC,EACzE,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;IAEF,OAAO,EACL,WAAW,IAAI,WAAW,EAC1B,KAAK,UAAU,IAAI,UAAU,EAC7B,KAAK,iCAAiC,IAAI,iCAAiC,EAC3E,KAAK,+BAA+B,IAAI,+BAA+B,GACxE,CAAC;IAEF,OAAO,EACL,OAAO,IAAI,OAAO,EAClB,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,+BAA+B,IAAI,+BAA+B,GACxE,CAAC;CACH"}

package/resources/v1/v1.d.ts

@@ -1,8 +1,8 @@
 import { APIResource } from "../../core/resource.js";
-import * as CompilerAPI from "./compiler.js";
-import { ChartConfig, Compiler, CompilerCompileParams, CompilerCompileResponse, CompilerErrorItem, CompilerResolveParams, CompilerResolveResponse, CompilerValidateParams, CompilerValidateResponse, InlineField, Manifest, ManifestEntry, RefWithLabel, SubqueryCondition } from "./compiler.js";
 import * as ConnectionsAPI from "./connections.js";
 import { Connection, ConnectionListConnectionsParams, ConnectionListConnectionsResponse, Connections } from "./connections.js";
+import * as CompilerAPI from "./compiler/compiler.js";
+import { ChartConfig, Compiler, CompilerCompileDashboardParams, CompilerCompileDashboardResponse, CompilerCompileParams, CompilerCompileResponse, CompilerEnumerateParams, CompilerEnumerateResponse, CompilerErrorItem, CompilerExecuteParams, CompilerExecuteResponse, CompilerResolveParams, CompilerResolveResponse, CompilerValidateParams, CompilerValidateResponse, InlineField, Manifest, ManifestEntry, RefWithLabel, SubqueryCondition } from "./compiler/compiler.js";
 import * as TenantsAPI from "./tenants/tenants.js";
 import { ImportTenantsResponse, TenantGetTenantsSchemaResponse, TenantImportFromCsvParams, TenantImportFromWarehouseParams, Tenants } from "./tenants/tenants.js";
 export declare class V1 extends APIResource {
@@ -11,7 +11,7 @@ export declare class V1 extends APIResource {
     tenants: TenantsAPI.Tenants;
 }
 export declare namespace V1 {
-    export { Compiler as Compiler, type ChartConfig as ChartConfig, type CompilerErrorItem as CompilerErrorItem, type InlineField as InlineField, type Manifest as Manifest, type ManifestEntry as ManifestEntry, type RefWithLabel as RefWithLabel, type SubqueryCondition as SubqueryCondition, type CompilerCompileResponse as CompilerCompileResponse, type CompilerResolveResponse as CompilerResolveResponse, type CompilerValidateResponse as CompilerValidateResponse, type CompilerCompileParams as CompilerCompileParams, type CompilerResolveParams as CompilerResolveParams, type CompilerValidateParams as CompilerValidateParams, };
+    export { Compiler as Compiler, type ChartConfig as ChartConfig, type CompilerErrorItem as CompilerErrorItem, type InlineField as InlineField, type Manifest as Manifest, type ManifestEntry as ManifestEntry, type RefWithLabel as RefWithLabel, type SubqueryCondition as SubqueryCondition, type CompilerCompileResponse as CompilerCompileResponse, type CompilerCompileDashboardResponse as CompilerCompileDashboardResponse, type CompilerEnumerateResponse as CompilerEnumerateResponse, type CompilerExecuteResponse as CompilerExecuteResponse, type CompilerResolveResponse as CompilerResolveResponse, type CompilerValidateResponse as CompilerValidateResponse, type CompilerCompileParams as CompilerCompileParams, type CompilerCompileDashboardParams as CompilerCompileDashboardParams, type CompilerEnumerateParams as CompilerEnumerateParams, type CompilerExecuteParams as CompilerExecuteParams, type CompilerResolveParams as CompilerResolveParams, type CompilerValidateParams as CompilerValidateParams, };
     export { Connections as Connections, type Connection as Connection, type ConnectionListConnectionsResponse as ConnectionListConnectionsResponse, type ConnectionListConnectionsParams as ConnectionListConnectionsParams, };
     export { Tenants as Tenants, type ImportTenantsResponse as ImportTenantsResponse, type TenantGetTenantsSchemaResponse as TenantGetTenantsSchemaResponse, type TenantImportFromCsvParams as TenantImportFromCsvParams, type TenantImportFromWarehouseParams as TenantImportFromWarehouseParams, };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"v1.d.ts","sourceRoot":"","sources":["../../src/resources/v1/v1.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,WAAW;OAChB,EACL,WAAW,EACX,QAAQ,EACR,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,WAAW,EACX,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,iBAAiB,EAClB;OACM,KAAK,cAAc;OACnB,EACL,UAAU,EACV,+BAA+B,EAC/B,iCAAiC,EACjC,WAAW,EACZ;OACM,KAAK,UAAU;OACf,EACL,qBAAqB,EACrB,8BAA8B,EAC9B,yBAAyB,EACzB,+BAA+B,EAC/B,OAAO,EACR;AAED,qBAAa,EAAG,SAAQ,WAAW;IACjC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAA0C;IACxE,WAAW,EAAE,cAAc,CAAC,WAAW,CAAgD;IACvF,OAAO,EAAE,UAAU,CAAC,OAAO,CAAwC;CACpE;AAMD,MAAM,CAAC,OAAO,WAAW,EAAE,CAAC;IAC1B,OAAO,EACL,QAAQ,IAAI,QAAQ,EACpB,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,QAAQ,IAAI,QAAQ,EACzB,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,YAAY,IAAI,YAAY,EACjC,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;IAEF,OAAO,EACL,WAAW,IAAI,WAAW,EAC1B,KAAK,UAAU,IAAI,UAAU,EAC7B,KAAK,iCAAiC,IAAI,iCAAiC,EAC3E,KAAK,+BAA+B,IAAI,+BAA+B,GACxE,CAAC;IAEF,OAAO,EACL,OAAO,IAAI,OAAO,EAClB,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,+BAA+B,IAAI,+BAA+B,GACxE,CAAC;CACH"}
+{"version":3,"file":"v1.d.ts","sourceRoot":"","sources":["../../src/resources/v1/v1.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,cAAc;OACnB,EACL,UAAU,EACV,+BAA+B,EAC/B,iCAAiC,EACjC,WAAW,EACZ;OACM,KAAK,WAAW;OAChB,EACL,WAAW,EACX,QAAQ,EACR,8BAA8B,EAC9B,gCAAgC,EAChC,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,WAAW,EACX,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,iBAAiB,EAClB;OACM,KAAK,UAAU;OACf,EACL,qBAAqB,EACrB,8BAA8B,EAC9B,yBAAyB,EACzB,+BAA+B,EAC/B,OAAO,EACR;AAED,qBAAa,EAAG,SAAQ,WAAW;IACjC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAA0C;IACxE,WAAW,EAAE,cAAc,CAAC,WAAW,CAAgD;IACvF,OAAO,EAAE,UAAU,CAAC,OAAO,CAAwC;CACpE;AAMD,MAAM,CAAC,OAAO,WAAW,EAAE,CAAC;IAC1B,OAAO,EACL,QAAQ,IAAI,QAAQ,EACpB,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,QAAQ,IAAI,QAAQ,EACzB,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,YAAY,IAAI,YAAY,EACjC,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,gCAAgC,IAAI,gCAAgC,EACzE,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;IAEF,OAAO,EACL,WAAW,IAAI,WAAW,EAC1B,KAAK,UAAU,IAAI,UAAU,EAC7B,KAAK,iCAAiC,IAAI,iCAAiC,EAC3E,KAAK,+BAA+B,IAAI,+BAA+B,GACxE,CAAC;IAEF,OAAO,EACL,OAAO,IAAI,OAAO,EAClB,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,+BAA+B,IAAI,+BAA+B,GACxE,CAAC;CACH"}

package/resources/v1/v1.js

@@ -4,10 +4,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.V1 = void 0;
 const tslib_1 = require("../../internal/tslib.js");
 const resource_1 = require("../../core/resource.js");
-const CompilerAPI = tslib_1.__importStar(require("./compiler.js"));
-const compiler_1 = require("./compiler.js");
 const ConnectionsAPI = tslib_1.__importStar(require("./connections.js"));
 const connections_1 = require("./connections.js");
+const CompilerAPI = tslib_1.__importStar(require("./compiler/compiler.js"));
+const compiler_1 = require("./compiler/compiler.js");
 const TenantsAPI = tslib_1.__importStar(require("./tenants/tenants.js"));
 const tenants_1 = require("./tenants/tenants.js");
 class V1 extends resource_1.APIResource {

package/resources/v1/v1.js.map

@@ -1 +1 @@
-{"version":3,"file":"v1.js","sourceRoot":"","sources":["../../src/resources/v1/v1.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,mEAA0C;AAC1C,4CAeoB;AACpB,yEAAgD;AAChD,kDAKuB;AACvB,yEAAgD;AAChD,kDAM2B;AAE3B,MAAa,EAAG,SAAQ,sBAAW;IAAnC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvF,YAAO,GAAuB,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;CAAA;AAJD,gBAIC;AAED,EAAE,CAAC,QAAQ,GAAG,mBAAQ,CAAC;AACvB,EAAE,CAAC,WAAW,GAAG,yBAAW,CAAC;AAC7B,EAAE,CAAC,OAAO,GAAG,iBAAO,CAAC"}
+{"version":3,"file":"v1.js","sourceRoot":"","sources":["../../src/resources/v1/v1.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,yEAAgD;AAChD,kDAKuB;AACvB,4EAAmD;AACnD,qDAqB6B;AAC7B,yEAAgD;AAChD,kDAM2B;AAE3B,MAAa,EAAG,SAAQ,sBAAW;IAAnC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvF,YAAO,GAAuB,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;CAAA;AAJD,gBAIC;AAED,EAAE,CAAC,QAAQ,GAAG,mBAAQ,CAAC;AACvB,EAAE,CAAC,WAAW,GAAG,yBAAW,CAAC;AAC7B,EAAE,CAAC,OAAO,GAAG,iBAAO,CAAC"}

package/resources/v1/v1.mjs

@@ -1,9 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from "../../core/resource.mjs";
-import * as CompilerAPI from "./compiler.mjs";
-import { Compiler, } from "./compiler.mjs";
 import * as ConnectionsAPI from "./connections.mjs";
 import { Connections, } from "./connections.mjs";
+import * as CompilerAPI from "./compiler/compiler.mjs";
+import { Compiler, } from "./compiler/compiler.mjs";
 import * as TenantsAPI from "./tenants/tenants.mjs";
 import { Tenants, } from "./tenants/tenants.mjs";
 export class V1 extends APIResource {

package/resources/v1/v1.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"v1.mjs","sourceRoot":"","sources":["../../src/resources/v1/v1.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,WAAW;OAChB,EAEL,QAAQ,GAaT;OACM,KAAK,cAAc;OACnB,EAIL,WAAW,GACZ;OACM,KAAK,UAAU;OACf,EAKL,OAAO,GACR;AAED,MAAM,OAAO,EAAG,SAAQ,WAAW;IAAnC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvF,YAAO,GAAuB,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;CAAA;AAED,EAAE,CAAC,QAAQ,GAAG,QAAQ,CAAC;AACvB,EAAE,CAAC,WAAW,GAAG,WAAW,CAAC;AAC7B,EAAE,CAAC,OAAO,GAAG,OAAO,CAAC"}
+{"version":3,"file":"v1.mjs","sourceRoot":"","sources":["../../src/resources/v1/v1.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,cAAc;OACnB,EAIL,WAAW,GACZ;OACM,KAAK,WAAW;OAChB,EAEL,QAAQ,GAmBT;OACM,KAAK,UAAU;OACf,EAKL,OAAO,GACR;AAED,MAAM,OAAO,EAAG,SAAQ,WAAW;IAAnC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvF,YAAO,GAAuB,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;CAAA;AAED,EAAE,CAAC,QAAQ,GAAG,QAAQ,CAAC;AACvB,EAAE,CAAC,WAAW,GAAG,WAAW,CAAC;AAC7B,EAAE,CAAC,OAAO,GAAG,OAAO,CAAC"}

package/src/client.ts

@@ -483,7 +483,7 @@ export class Kater {
       loggerFor(this).info(`${responseInfo} - ${retryMessage}`);
 
       const errText = await response.text().catch((err: any) => castToError(err).message);
-      const errJSON = safeJSON(errText);
+      const errJSON = safeJSON(errText) as any;
       const errMessage = errJSON ? undefined : errText;
 
       loggerFor(this).debug(
@@ -732,6 +732,14 @@ export class Kater {
         (Symbol.iterator in body && 'next' in body && typeof body.next === 'function'))
     ) {
       return { bodyHeaders: undefined, body: Shims.ReadableStreamFrom(body as AsyncIterable<Uint8Array>) };
+    } else if (
+      typeof body === 'object' &&
+      headers.values.get('content-type') === 'application/x-www-form-urlencoded'
+    ) {
+      return {
+        bodyHeaders: { 'content-type': 'application/x-www-form-urlencoded' },
+        body: this.stringifyQuery(body as Record<string, unknown>),
+      };
     } else {
       return this.#encoder({ body, headers });
     }

package/src/resources/v1/compiler/cache.ts

@@ -0,0 +1,5 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+
+export class Cache extends APIResource {}

package/src/resources/v1/compiler/combination.ts

@@ -0,0 +1,157 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as CompilerAPI from './compiler';
+import { APIPromise } from '../../../core/api-promise';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+
+export class Combination extends APIResource {
+  /**
+   * Preview a single combination: resolve, compile, execute, and build config.
+   *
+   * Chains existing services to provide a single-call preview for the query gallery.
+   * Returns data + WidgetConfig for immediate rendering.
+   *
+   * RLS: Filtered to current client (ClientRLSDB).
+   */
+  preview(
+    params: CombinationPreviewParams,
+    options?: RequestOptions,
+  ): APIPromise<CombinationPreviewResponse> {
+    const { source, 'X-Kater-CLI-ID': xKaterCliID, ...body } = params;
+    return this._client.post('/api/v1/compiler/combination/preview', {
+      query: { source },
+      body,
+      ...options,
+      headers: buildHeaders([
+        { ...(xKaterCliID != null ? { 'X-Kater-CLI-ID': xKaterCliID } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+/**
+ * Response from combination preview with data + resolved config.
+ */
+export interface CombinationPreviewResponse {
+  /**
+   * Whether preview succeeded
+   */
+  success: boolean;
+
+  /**
+   * Auto-generated title
+   */
+  auto_title?: string | null;
+
+  /**
+   * Whether the result was served from cache
+   */
+  cache_hit?: boolean;
+
+  /**
+   * Enriched column metadata
+   */
+  column_map?: Array<CombinationPreviewResponse.ColumnMap>;
+
+  /**
+   * Resolved WidgetConfig (from config builder)
+   */
+  config?: { [key: string]: unknown };
+
+  /**
+   * Query result rows
+   */
+  data?: Array<{ [key: string]: unknown }>;
+
+  /**
+   * Compilation errors (if any)
+   */
+  errors?: Array<CompilerAPI.CompilerErrorItem>;
+
+  /**
+   * Total execution time in milliseconds
+   */
+  execution_time_ms?: number;
+
+  /**
+   * Resolved widget type (e.g. 'axis_metric_by_dimensiondate')
+   */
+  widget_type?: string | null;
+}
+
+export namespace CombinationPreviewResponse {
+  /**
+   * Maps a UUID column alias to its human-readable name and type.
+   */
+  export interface ColumnMap {
+    /**
+     * Field type: dimension, measure, or calculation
+     */
+    field_type: string;
+
+    /**
+     * UUID string used as SQL column alias
+     */
+    kater_id: string;
+
+    /**
+     * Human-readable column name
+     */
+    name: string;
+
+    /**
+     * Aggregation type for measures: sum, count, min, max, avg, unknown. None for
+     * non-measures.
+     */
+    aggregation?: string | null;
+
+    /**
+     * Display label
+     */
+    label?: string | null;
+  }
+}
+
+export interface CombinationPreviewParams {
+  /**
+   * Body param: Comma-separated slot selections, same format as
+   * ResolveRequest.combination. Example:
+   * 'dimension=due_month,measure=compliance_rate'
+   */
+  combination: string;
+
+  /**
+   * Body param: Connection to preview against
+   */
+  connection_id: string;
+
+  /**
+   * Body param: Query template reference (e.g. 'q:compliance_trend.\_base')
+   */
+  query_ref: string;
+
+  /**
+   * Query param
+   */
+  source?: string | null;
+
+  /**
+   * Body param: Optional tenant key for multi-tenant execution
+   */
+  tenant_key?: string | null;
+
+  /**
+   * Header param
+   */
+  'X-Kater-CLI-ID'?: string;
+}
+
+export declare namespace Combination {
+  export {
+    type CombinationPreviewResponse as CombinationPreviewResponse,
+    type CombinationPreviewParams as CombinationPreviewParams,
+  };
+}