@narrative.io/data-collaboration-sdk-ts 3.7.0 → 4.0.0-beta.0

package/build/access-rules/index.d.ts

@@ -1,6 +1,6 @@
 import { BaseApi } from "../base-api";
 import type { ApiRecords, ApiRecordsV2, PaginationOptions } from "../types";
-import type { AccessRule, AccessRuleV2, CreateAccessRuleV2Request, OwnedAccessRule, SharedAccessRule, UpdateAccessRuleV2Request } from "./types";
+import type { AccessRule, AccessRuleMapping, AccessRuleMetadata, AccessRuleV2, CreateAccessRuleV2Request, OwnedAccessRule, SharedAccessRule, UpdateAccessRuleV2Request } from "./types";
 /**
  * Represents the parameters used to retrieve access rules.
  * This interface extends a generic record allowing for a range of value types including arrays.
@@ -127,6 +127,6 @@ declare class AccessRulesApi extends BaseApi {
      * @description This method updates an existing access rule in version 2 based on the provided access rule ID
      *              and request data. It returns a promise that resolves to the updated access rule details.
      */
-    updateccessRuleV2(accessRuleId: number, request: UpdateAccessRuleV2Request): Promise<AccessRuleV2>;
+    updateAccessRuleV2(accessRuleId: number, request: UpdateAccessRuleV2Request): Promise<AccessRuleV2>;
 }
-export { type AccessRule, AccessRulesApi, type AccessRuleV2, type CreateAccessRuleV2Request, type GetAccessRulesParameters, type OwnedAccessRule, type SharedAccessRule, type UpdateAccessRuleV2Request, };
+export { type AccessRule, type AccessRuleMapping, type AccessRuleMetadata, AccessRulesApi, type AccessRuleV2, type CreateAccessRuleV2Request, type GetAccessRulesParameters, type OwnedAccessRule, type SharedAccessRule, type UpdateAccessRuleV2Request, };

package/build/access-rules/index.js

@@ -115,7 +115,7 @@ class AccessRulesApi extends BaseApi {
      * @description This method updates an existing access rule in version 2 based on the provided access rule ID
      *              and request data. It returns a promise that resolves to the updated access rule details.
      */
-    async updateccessRuleV2(accessRuleId, request) {
+    async updateAccessRuleV2(accessRuleId, request) {
         return await this.put(`v2/${resourceName}/${accessRuleId}`, request);
     }
 }

package/build/access-rules/types.d.ts

@@ -28,27 +28,37 @@ interface AccessRulePolicy {
 type AccessRuleConstraints = string[];
 type AccessRuleDescription = string;
 type AccessRulePricing = number;
-interface AccessRuleMetadata {
+export interface AccessRuleMetadata {
     created_at: string;
     updated_at: string;
 }
 export type AccessRuleSchema = Partial<Schema>;
 export type AccessRuleStatus = "active" | "archived";
 export type AccessRuleShareType = "implicit_share" | "explicit_share";
+/** An attribute mapped to columns referenced by an access rule. */
+export interface AccessRuleMapping {
+    attribute_id: number;
+    attribute_name: string;
+    /** Dot-separated paths of attribute properties exposed by the access rule. Empty for scalar attributes. */
+    properties: string[];
+}
 export interface SharedAccessRule {
     name?: string;
     id: number;
     company_id: number;
     company_name: string;
     company_slug?: string;
+    data_plane_id: string;
     display_name?: string;
     description?: string;
     image?: string;
     tags?: string[];
-    schema: AccessRuleSchema;
+    schema?: AccessRuleSchema;
     price_cpm_usd: number;
     metadata: AccessRuleMetadata;
     type: AccessRuleShareType;
+    is_owned: boolean;
+    mappings: AccessRuleMapping[];
 }
 export interface OwnedAccessRule {
     name?: string;
@@ -56,18 +66,21 @@ export interface OwnedAccessRule {
     company_id: number;
     company_name: string;
     company_slug?: string;
+    data_plane_id: string;
     display_name?: string;
     description?: string;
     image?: string;
     status: AccessRuleStatus;
     tags?: string[];
     nql?: string;
-    schema: AccessRuleSchema;
+    schema?: AccessRuleSchema;
     collaborators: CollaboratorsConfig;
     price_cpm_usd: number;
     metadata: AccessRuleMetadata;
     type: "owned";
     dataset_ids: number[];
+    is_owned: boolean;
+    mappings: AccessRuleMapping[];
 }
 export interface CreateAccessRuleV2Request {
     name: string;
@@ -87,6 +100,7 @@ export interface UpdateAccessRuleV2Request {
     image?: string;
     collaborators?: CollaboratorsConfig;
     price_cpm_usd?: number;
+    status?: AccessRuleStatus;
 }
 export type AccessRuleV2 = OwnedAccessRule | SharedAccessRule;
 export {};

package/build/access-tokens/index.d.ts

@@ -5,7 +5,7 @@ import { BaseApi } from "../base-api";
  * This class includes methods to get, create, update, and delete access tokens.
  */
 import type { ApiRecords } from "../types";
-import type { AccessTokenMetadata, CreateSystemAccessTokenRequest, CreateSystemAccessTokenResponse, UpdateSystemAccessTokenRequest } from "./types";
+import type { Access, AccessTokenMetadata, CreateSystemAccessTokenRequest, CreateSystemAccessTokenResponse, Permission, Resource, UpdateSystemAccessTokenRequest } from "./types";
 declare class AccessTokensApi extends BaseApi {
     /**
      * Retrieves a list of access tokens.
@@ -44,7 +44,7 @@ declare class AccessTokensApi extends BaseApi {
      * Updates an existing access token by ID with the provided data.
      * @param {string} id - The unique identifier for the access token to update.
      * @param {UpdateSystemAccessTokenRequest} data - The data to update the access token with.
-     * @returns {Promise<CreateSystemAccessTokenResponse>} A promise that resolves with the response containing the updated access token details.
+     * @returns {Promise<AccessTokenMetadata>} A promise that resolves with the response containing the updated access token details.
      * @example
      * const accessTokensApi = new AccessTokensApi();
      * const updateTokenData = {
@@ -54,7 +54,7 @@ declare class AccessTokensApi extends BaseApi {
      * const updatedToken = await accessTokensApi.updateAccessToken('your-token-id', updateTokenData);
      * console.log(updatedToken);
      */
-    updateAccessToken(id: string, data: UpdateSystemAccessTokenRequest): Promise<CreateSystemAccessTokenResponse>;
+    updateAccessToken(id: string, data: UpdateSystemAccessTokenRequest): Promise<AccessTokenMetadata>;
     /**
      * Deletes an access token by its ID.
      * @param {string} id - The unique identifier for the access token to delete.
@@ -66,4 +66,4 @@ declare class AccessTokensApi extends BaseApi {
      */
     deleteAccessToken(id: string): Promise<void>;
 }
-export { type AccessTokenMetadata, AccessTokensApi, type CreateSystemAccessTokenRequest, type CreateSystemAccessTokenResponse, type UpdateSystemAccessTokenRequest, };
+export { type Access, type AccessTokenMetadata, AccessTokensApi, type CreateSystemAccessTokenRequest, type CreateSystemAccessTokenResponse, type Permission as AccessTokenPermission, type Resource as AccessTokenResource, type UpdateSystemAccessTokenRequest, };

package/build/access-tokens/index.js

@@ -22,7 +22,8 @@ class AccessTokensApi extends BaseApi {
      * console.log(tokenMetadata);
      */
     async getAccessToken(id) {
-        return await this.get(`${resourceName}/tokens/${id}`);
+        const response = await this.get(`${resourceName}/tokens/${id}`);
+        return response.record;
     }
     /**
      * Creates a new access token with the provided data.
@@ -44,7 +45,7 @@ class AccessTokensApi extends BaseApi {
      * Updates an existing access token by ID with the provided data.
      * @param {string} id - The unique identifier for the access token to update.
      * @param {UpdateSystemAccessTokenRequest} data - The data to update the access token with.
-     * @returns {Promise<CreateSystemAccessTokenResponse>} A promise that resolves with the response containing the updated access token details.
+     * @returns {Promise<AccessTokenMetadata>} A promise that resolves with the response containing the updated access token details.
      * @example
      * const accessTokensApi = new AccessTokensApi();
      * const updateTokenData = {

package/build/access-tokens/types.d.ts

@@ -1,4 +1,4 @@
-export type Access = string;
+export type Access = "admin" | "read" | "write" | "create" | "revise";
 export declare const resources: {
     readonly access_tokens: "Access Tokens";
     readonly agent_conversations: "Agent Conversations";
@@ -51,14 +51,16 @@ export interface AccessTokenMetadata {
     name: string;
     permissions: Permission[];
     expires_at: string;
+    /** Not normally populated on list/get responses; present on the create response. */
+    access_token?: string;
 }
 export interface GetSystemAccessTokenResponse {
-    access_token: AccessTokenMetadata;
+    record: AccessTokenMetadata;
 }
 export interface CreateSystemAccessTokenRequest {
     name: string;
     permissions?: Permission[];
-    expires_at: string;
+    expires_at?: string;
 }
 export interface CreateSystemAccessTokenResponse {
     id: string;

package/build/agents/types.d.ts

@@ -149,15 +149,22 @@ export interface LiveRunTurn {
     turn_index: number;
     role: AgentMessageRole;
     content_blocks: ContentBlock[];
-    created_at: string;
 }
 /**
- * In-flight progress for a non-terminal run. Empty (or omitted) once the run
- * reaches a terminal state — at that point the same content is available on
+ * The conversation's current, still-mutating state. Always present on a run
+ * response (independent of `status`). `messages` streams the run's produced
+ * turns while non-terminal and is empty once the run reaches a terminal
+ * state — at that point the same content is available on
  * `GET /agents/conversations/{id}/messages?since={version}` as committed
  * turns with `sequence_no`.
  */
 export interface RunLiveProgress {
+    /**
+     * The conversation's current display name, or `null`/absent if it has
+     * none yet. The platform auto-generates one from the first user message
+     * shortly after the first run is created.
+     */
+    current_name?: string | null;
     messages: LiveRunTurn[];
 }
 export interface RunResponse {
@@ -174,16 +181,25 @@ export interface RunResponse {
     submitted_inference_job_ids: string[];
     pending_tool_calls: PendingToolCall[];
     final_text?: string | null;
+    /**
+     * The model's final answer as a JSON value conforming to the caller's
+     * `output_format_schema`. Populated on `status: completed` when the
+     * caller supplied an `output_format_schema` (structured mode). Mutually
+     * exclusive with `final_text`.
+     */
+    final_structured_output?: unknown;
     error?: RunError | null;
     started_at: string;
     completed_at?: string | null;
     /**
-     * In-flight tool-loop progress while the run is non-terminal. Empty
-     * (or absent) after finalize; consumers must then fall back to
+     * The conversation's current, still-mutating state (e.g. its
+     * auto-generated name) plus in-flight tool-loop progress while the run
+     * is non-terminal. Always present on a run response; `messages` is
+     * empty after finalize, at which point consumers should fall back to
      * `listAgentConversationMessages({ since: version-at-run-start })` for
      * the committed turns.
      */
-    live?: RunLiveProgress | null;
+    live: RunLiveProgress;
 }
 export type AgentMessageRole = "user" | "assistant" | "tool";
 export interface TextContentBlock {

package/build/apps/index.d.ts

@@ -1,6 +1,6 @@
 import { BaseApi } from "../base-api";
 import type { JsonSchemaConnectorPolicy } from "../collaboration-policy/core/jsonschema/json-schema-types";
-import type { ApiRecords } from "../types";
+import type { ApiRecords, ApiRecordsV2 } from "../types";
 import type { App, Installation } from "./types";
 /**
  * @module AppsApi
@@ -9,12 +9,25 @@ import type { App, Installation } from "./types";
  */
 declare class AppsApi extends BaseApi {
     /**
-     * Get all installations for the current user
-     * @param {number} appCategory - An optional filter for app categories.
-     * @returns {Promise<ApiRecords<Installation>>} - Promise resolving with the list of installations.
+     * List apps available on the platform.
+     * @param {string | string[]} [appCategory] - Optional filter for app categories
+     *   (`category` query param; repeatable).
+     * @returns {Promise<ApiRecords<App>>} - Promise resolving with the list of apps.
      */
-    getApps(appCategory?: string): Promise<ApiRecords<App>>;
-    getInstalledApps(appCategory?: string): Promise<ApiRecords<Installation>>;
+    getApps(appCategory?: string | string[]): Promise<ApiRecords<App>>;
+    /**
+     * List installations for the authenticated company (or, with an app
+     * client-credentials token, for the authenticated app across all
+     * companies). Delegates to the same paginated `/installations` endpoint as
+     * `InstallationsApi.getInstallations`.
+     * @param {string | string[]} [appCategory] - Optional filter for app categories
+     *   (`app_category` query param; repeatable).
+     * @param {number} [companyId] - Optional company filter (`company_id` query
+     *   param), only meaningful with an app client-credentials token.
+     * @returns {Promise<ApiRecordsV2<Installation>>} - Promise resolving with the
+     *   paginated list of installations.
+     */
+    getInstalledApps(appCategory?: string | string[], companyId?: number): Promise<ApiRecordsV2<Installation>>;
     /**
      * Get all interfaces for the current user's installed connectors.
      * @param {string[]} [tags] - Optional tags to filter interfaces (e.g. ["audience_delivery"]).

package/build/apps/index.js

@@ -7,19 +7,35 @@ const resourceName = "apps";
  */
 class AppsApi extends BaseApi {
     /**
-     * Get all installations for the current user
-     * @param {number} appCategory - An optional filter for app categories.
-     * @returns {Promise<ApiRecords<Installation>>} - Promise resolving with the list of installations.
+     * List apps available on the platform.
+     * @param {string | string[]} [appCategory] - Optional filter for app categories
+     *   (`category` query param; repeatable).
+     * @returns {Promise<ApiRecords<App>>} - Promise resolving with the list of apps.
      */
     async getApps(appCategory) {
-        const appCategoryQuery = appCategory !== undefined ? `?app_category=${appCategory}` : "";
-        const url = `${resourceName}${appCategoryQuery}`;
-        return await this.get(url);
+        return appCategory === undefined
+            ? await this.get(resourceName)
+            : await this.get(resourceName, {
+                category: appCategory,
+            });
     }
-    async getInstalledApps(appCategory) {
-        const appCategoryQuery = appCategory !== undefined ? `?app_category=${appCategory}` : "";
-        const url = `installations${appCategoryQuery}`;
-        return await this.get(url);
+    /**
+     * List installations for the authenticated company (or, with an app
+     * client-credentials token, for the authenticated app across all
+     * companies). Delegates to the same paginated `/installations` endpoint as
+     * `InstallationsApi.getInstallations`.
+     * @param {string | string[]} [appCategory] - Optional filter for app categories
+     *   (`app_category` query param; repeatable).
+     * @param {number} [companyId] - Optional company filter (`company_id` query
+     *   param), only meaningful with an app client-credentials token.
+     * @returns {Promise<ApiRecordsV2<Installation>>} - Promise resolving with the
+     *   paginated list of installations.
+     */
+    async getInstalledApps(appCategory, companyId) {
+        return await this.get("installations", {
+            app_category: appCategory,
+            company_id: companyId,
+        });
     }
     /**
      * Get all interfaces for the current user's installed connectors.

package/build/apps/types.d.ts

@@ -1,5 +1,5 @@
 interface Permission {
-    access: "read" | "write";
+    access: "admin" | "read" | "write" | "create" | "revise";
     resource: string;
 }
 export interface Installation {

package/build/attributes/index.d.ts

@@ -1,6 +1,6 @@
 import { BaseApi } from "../base-api";
-import type { ApiRecords, ApiRecordsV2, PaginationOptions, SearchParams } from "../types";
-import type { ArrayAttribute, Attribute, ObjectAttribute, PrimitiveAttribute, RefAttribute, ShallowAttribute, SubAttribute } from "./types";
+import type { ApiRecords, PaginationOptions, SearchParams } from "../types";
+import type { ArrayAttribute, Attribute, AttributeSearchOptions, ObjectAttribute, PrimitiveAttribute, RefAttribute, ShallowAttribute, SubAttribute } from "./types";
 /**
  * A class for accessing the Attribute API.
  * @extends BaseApi
@@ -19,27 +19,30 @@ declare class AttributeApi extends BaseApi {
  */
 declare class AttributeApiV2 extends BaseApi {
     /**
-     * Gets a list of attributes from the API.
+     * Gets a list of attributes from the API. Note: the API does not return
+     * pagination metadata for this endpoint (only `records`), so the response
+     * is not further paginated beyond what `page`/`per_page` select.
      *
      * @param {PaginationOptions} [paginationOptions] - Optional pagination parameters.
      * @param {SearchParams} [searchParams] - Optional search parameters.
-     * @returns {Promise<ApiRecordsV2<Attribute>>} A promise that resolves with the list of attributes.
+     * @param {AttributeSearchOptions} [options] - Optional `resolve`/`min_score` filters.
+     * @returns {Promise<ApiRecords<Attribute>>} A promise that resolves with the list of attributes.
      */
-    getAttributesV2(paginationOptions?: PaginationOptions, searchParams?: SearchParams): Promise<ApiRecordsV2<Attribute>>;
+    getAttributesV2(paginationOptions?: PaginationOptions, searchParams?: SearchParams, options?: AttributeSearchOptions): Promise<ApiRecords<Attribute>>;
     /**
-     * Gets a single attribute from the API by its ID.
+     * Gets a single attribute from the API by its ID or name.
      *
-     * @param {number} attributeId - The ID of the attribute to retrieve.
+     * @param {number | string} attributeId - The ID or unique name of the attribute to retrieve.
      * @returns {Promise<Attribute>} A promise that resolves with the attribute.
      */
-    getAttribute(attributeId: number): Promise<Attribute>;
+    getAttribute(attributeId: number | string): Promise<Attribute>;
     /**
-     * Deletes a single attribute from the API by its ID.
+     * Deletes a single attribute from the API by its ID or name.
      *
-     * @param {number} attributeId - The ID of the attribute to delete.
+     * @param {number | string} attributeId - The ID or unique name of the attribute to delete.
      * @returns {Promise<void>} A promise that resolves when the delete operation is complete.
      */
-    deleteAttribute(attributeId: number): Promise<void>;
+    deleteAttribute(attributeId: number | string): Promise<void>;
     /**
      * Creates a new attribute on the API.
      *
@@ -48,4 +51,4 @@ declare class AttributeApiV2 extends BaseApi {
      */
     createAttribute(data: Attribute): Promise<Attribute>;
 }
-export { type ArrayAttribute, type Attribute, AttributeApi, AttributeApiV2, type ObjectAttribute, type PrimitiveAttribute, type RefAttribute, type ShallowAttribute, type SubAttribute, };
+export { type ArrayAttribute, type Attribute, AttributeApi, AttributeApiV2, type AttributeSearchOptions, type ObjectAttribute, type PrimitiveAttribute, type RefAttribute, type ShallowAttribute, type SubAttribute, };

package/build/attributes/index.js

@@ -26,13 +26,16 @@ class AttributeApi extends BaseApi {
  */
 class AttributeApiV2 extends BaseApi {
     /**
-     * Gets a list of attributes from the API.
+     * Gets a list of attributes from the API. Note: the API does not return
+     * pagination metadata for this endpoint (only `records`), so the response
+     * is not further paginated beyond what `page`/`per_page` select.
      *
      * @param {PaginationOptions} [paginationOptions] - Optional pagination parameters.
      * @param {SearchParams} [searchParams] - Optional search parameters.
-     * @returns {Promise<ApiRecordsV2<Attribute>>} A promise that resolves with the list of attributes.
+     * @param {AttributeSearchOptions} [options] - Optional `resolve`/`min_score` filters.
+     * @returns {Promise<ApiRecords<Attribute>>} A promise that resolves with the list of attributes.
      */
-    async getAttributesV2(paginationOptions, searchParams) {
+    async getAttributesV2(paginationOptions, searchParams, options) {
         const queryParams = new URLSearchParams();
         if (paginationOptions?.page) {
             queryParams.append("page", paginationOptions.page.toString());
@@ -43,22 +46,28 @@ class AttributeApiV2 extends BaseApi {
         if (searchParams?.q) {
             queryParams.append("q", searchParams.q);
         }
+        if (options?.resolve !== undefined) {
+            queryParams.append("resolve", options.resolve.toString());
+        }
+        if (options?.min_score !== undefined) {
+            queryParams.append("min_score", options.min_score.toString());
+        }
         const url = `${resourceName}?${queryParams.toString()}`;
         return await this.get(url);
     }
     /**
-     * Gets a single attribute from the API by its ID.
+     * Gets a single attribute from the API by its ID or name.
      *
-     * @param {number} attributeId - The ID of the attribute to retrieve.
+     * @param {number | string} attributeId - The ID or unique name of the attribute to retrieve.
      * @returns {Promise<Attribute>} A promise that resolves with the attribute.
      */
     async getAttribute(attributeId) {
         return await this.get(`${resourceName}/${attributeId}`);
     }
     /**
-     * Deletes a single attribute from the API by its ID.
+     * Deletes a single attribute from the API by its ID or name.
      *
-     * @param {number} attributeId - The ID of the attribute to delete.
+     * @param {number | string} attributeId - The ID or unique name of the attribute to delete.
      * @returns {Promise<void>} A promise that resolves when the delete operation is complete.
      */
     async deleteAttribute(attributeId) {

package/build/attributes/types.d.ts

@@ -8,7 +8,7 @@ export type ParticipantsNone = {
 };
 export type ParticipantsInclusion = {
     type: "inclusion";
-    company_ids: number[];
+    companies: number[];
 };
 export type Participants = ParticipantsAll | ParticipantsNone | ParticipantsInclusion;
 export interface AttributeCollaborators {
@@ -18,11 +18,14 @@ export interface AttributeCollaborators {
 export interface BaseAttribute {
     id: number;
     name: string;
-    display_name?: string;
+    display_name: string;
     description?: string;
     type: string;
     validations?: string[];
     metadata?: AttributeMetadata;
+    /** Present only when the requesting company owns the attribute. */
+    company_id?: number;
+    /** Present only when the requesting company owns the attribute. */
     collaborators?: AttributeCollaborators;
 }
 export interface PrimitiveAttribute extends BaseAttribute {
@@ -54,3 +57,16 @@ export interface AttributeCooccurrence {
     attribute: Attribute;
     cooccurrence_pct: number;
 }
+/**
+ * Options accepted by `GET /attributes` in addition to pagination and keyword search.
+ */
+export interface AttributeSearchOptions {
+    /** Resolve `$ref` attribute references. Defaults to `true` server-side. */
+    resolve?: boolean;
+    /**
+     * Minimum relevance score in `(0, 1]`, restricting results to matches at or
+     * above this threshold. Only meaningful together with `searchParams.q`;
+     * supplying it without `q` is a 400 server-side.
+     */
+    min_score?: number;
+}

package/build/authentication/types.d.ts

@@ -8,7 +8,7 @@ export interface LoginResponse {
         name: string;
         company_id: number;
         company_name: string;
-        role: UserRole;
+        role?: UserRole;
     };
     api_token: ApiToken;
 }
@@ -45,11 +45,11 @@ export interface RegistrationStatusRequest {
 }
 export interface RegistrationStatusB2bRequest {
     stytch_token: string;
-    session_duration_minutes: number;
+    session_duration_minutes?: number;
 }
 export interface RegistrationStatusResponse {
     status: RegistrationStatus;
-    email: string;
+    email?: string;
     stytch_session_token: string;
     stytch_session_jwt: string;
 }

package/build/companies/index.d.ts

@@ -12,9 +12,12 @@ export * from "./types";
  */
 export declare class CompaniesApi extends BaseApi {
     /**
-     * List all active and pending companies, newest filter applied server-side
-     * (archived excluded). Returns the `records` envelope only — no pagination
-     * metadata is provided by the backend for this endpoint.
+     * List all active and pending companies (archived excluded server-side).
+     * Returns the `records` envelope only — no pagination metadata is provided
+     * by the backend for this endpoint.
+     *
+     * @param {string} [nameLike] - Optional case-insensitive substring filter
+     *   applied server-side to the company name (`name_like` query param).
      */
-    getCompanies(): Promise<ApiRecords<CompanyAdminResponse>>;
+    getCompanies(nameLike?: string): Promise<ApiRecords<CompanyAdminResponse>>;
 }

package/build/companies/index.js

@@ -11,11 +11,16 @@ const resourceName = "admin/companies";
  */
 export class CompaniesApi extends BaseApi {
     /**
-     * List all active and pending companies, newest filter applied server-side
-     * (archived excluded). Returns the `records` envelope only — no pagination
-     * metadata is provided by the backend for this endpoint.
+     * List all active and pending companies (archived excluded server-side).
+     * Returns the `records` envelope only — no pagination metadata is provided
+     * by the backend for this endpoint.
+     *
+     * @param {string} [nameLike] - Optional case-insensitive substring filter
+     *   applied server-side to the company name (`name_like` query param).
      */
-    async getCompanies() {
-        return await this.get(resourceName);
+    async getCompanies(nameLike) {
+        return await this.get(resourceName, {
+            name_like: nameLike,
+        });
     }
 }

package/build/company-info/types.d.ts

@@ -14,4 +14,14 @@ export interface CompanyInfo {
 export interface WhoAmI {
     id: number;
     userId?: number;
+    /**
+     * The company's credit limit in USD. Emitted camelCase (the route uses a
+     * plain `deriveEncoder`), always present.
+     */
+    creditLimitUSD: number;
+    /**
+     * Whether datashops credit limits are enforced for the company. Emitted
+     * camelCase, always present.
+     */
+    checkDatashopsCreditLimit: boolean;
 }

package/build/compute-pools/types.d.ts

@@ -2,7 +2,12 @@ export type ComputePoolType = "owned" | "shared";
 export type ComputePoolStatus = "active" | "archived";
 export type ComputePoolSize = "x_small" | "small" | "medium" | "large" | "x_large" | "2x_large" | "3x_large" | "4x_large" | "5x_large" | "6x_large";
 export type SnowflakeWarehouseSize = ComputePoolSize;
-export type AwsEmrSize = ComputePoolSize;
+/**
+ * EMR compute pool size. Includes every {@link ComputePoolSize} plus a `*_storage` variant of each
+ * (e.g. `medium_storage`) — same memory budget, but running on instances with local NVMe SSD
+ * storage for shuffle-/scratch-heavy jobs.
+ */
+export type AwsEmrSize = ComputePoolSize | "x_small_storage" | "small_storage" | "medium_storage" | "large_storage" | "x_large_storage" | "2x_large_storage" | "3x_large_storage" | "4x_large_storage" | "5x_large_storage" | "6x_large_storage";
 export type SnowflakeWarehouseType = "standard" | "snowpark_optimized";
 export type ScalingPolicy = "standard" | "economy";
 export interface SnowflakeWarehouseExternalId {
@@ -35,7 +40,17 @@ export interface SnowflakeWarehouseProvider {
 export interface AwsEmrProvider {
     type: "aws_emr";
     size: AwsEmrSize;
+    /**
+     * EMR cluster auto-termination idle timeout, in seconds. Tri-state: omitted/`null` resets to the
+     * default (900s) on both create and update; `-1` disables idle termination; otherwise must be
+     * between 60 and 604800 (7 days).
+     */
     idle_timeout_seconds?: number;
+    /**
+     * Maximum time, in seconds, a single job's EMR step may stay `RUNNING` before it's cancelled.
+     * Omitted/`null` resets to the default (14400s) on both create and update; otherwise must be
+     * between 60 and 604800 (7 days).
+     */
     job_execution_timeout_seconds?: number;
 }
 export type ComputePoolProvider = SnowflakeWarehouseProvider | AwsEmrProvider;
@@ -45,11 +60,17 @@ export interface ParticipantsAll {
 export interface ParticipantsNone {
     type: "none";
 }
+/** Only these companies. `company_ids` must be non-empty. */
 export interface ParticipantsInclusion {
     type: "inclusion";
     company_ids: number[];
 }
-export type Participants = ParticipantsAll | ParticipantsNone | ParticipantsInclusion;
+/** Every company except these. `company_ids` must be non-empty. */
+export interface ParticipantsExclusion {
+    type: "exclusion";
+    company_ids: number[];
+}
+export type Participants = ParticipantsAll | ParticipantsNone | ParticipantsInclusion | ParticipantsExclusion;
 export interface ComputePoolCollaborators {
     use: Participants;
 }