@narrative.io/data-collaboration-sdk-ts 2.94.1 → 2.95.0-beta.1

package/build/collaboration-policy/core/types.d.ts

@@ -1,20 +1,91 @@
-import type { CollaborationPolicyType } from "../types";
-type PolicyDefinition = CollaborationPolicyType["policy"]["definition"];
-export type StructureNode = PolicyDefinition["structure"];
-export type ExtendedAttributeNode = Extract<StructureNode, {
-    field: unknown;
-}>;
-export type PolicyFilter = NonNullable<PolicyDefinition["filters"]>[number];
-export type PathValue = NonNullable<ExtendedAttributeNode["field"]["additional_required_properties"]>[number];
+/**
+ * PathValue describes a path to a subfield, expressed as either dot notation
+ * or a JSON Pointer. Used in filter attribute references to specify which
+ * subfield of an attribute to operate on.
+ */
+export type PathValue = {
+    dot: string;
+} | {
+    pointer: string;
+};
+/**
+ * An attribute reference within a filter expression.
+ */
+export interface FilterAttributeRef {
+    type: "attribute";
+    attribute_name: string;
+    path?: PathValue;
+}
+/**
+ * A filter expression: a literal value or an attribute reference.
+ */
+export type FilterExpression = string | number | boolean | FilterAttributeRef;
+/**
+ * PolicyFilter is a single filter entry in a policy definition.
+ *
+ * This is the canonical filter type used across the codebase (JSON-Schema
+ * filters, SQL builder, etc.).
+ */
+export type PolicyFilter = PolicyFilterAndOr | PolicyFilterNot | PolicyFilterIsNull | PolicyFilterIn | PolicyFilterCompare | PolicyFilterBetween;
+interface PolicyFilterBase {
+    stage?: "generation";
+    name?: string;
+    required?: boolean;
+}
+interface PolicyFilterAndOr extends PolicyFilterBase {
+    op: "and" | "or";
+    args: FilterExpression[];
+}
+interface PolicyFilterNot extends PolicyFilterBase {
+    op: "not";
+    args: FilterExpression[];
+}
+interface PolicyFilterIsNull extends PolicyFilterBase {
+    op: "is_null" | "is_not_null";
+    left: FilterExpression;
+}
+interface PolicyFilterIn extends PolicyFilterBase {
+    op: "in" | "not in";
+    left: FilterExpression;
+    right: FilterExpression[];
+}
+interface PolicyFilterCompare extends PolicyFilterBase {
+    op: "=" | "<>" | ">" | ">=" | "<" | "<=" | "like" | "not like";
+    left: FilterExpression;
+    right: FilterExpression;
+}
+interface PolicyFilterBetween extends PolicyFilterBase {
+    op: "between";
+    operand: FilterExpression;
+    lower: FilterExpression;
+    upper: FilterExpression;
+}
+/**
+ * Map from attribute name -> set of normalized paths that must be selected
+ * for SQL generation.
+ */
 export type AttributePathIndex = Map<string, Set<string>>;
+/**
+ * A logical group of SQL fragments combined by an operation.
+ */
 export interface PolicySqlGroup {
     fragments: Array<string | PolicySqlGroup>;
     operation: "AND" | "OR";
 }
+/**
+ * Core SQL fragments required to represent a set of collaboration policies.
+ */
 export interface PolicySqlFragments {
     select: string[];
     where: Array<PolicySqlGroup | string>;
 }
+/**
+ * Full result of applying collaboration policies to a dataset, including:
+ * - which policies were applied
+ * - which were skipped and why
+ * - warnings
+ * - the minimum refresh schedule across applied policies
+ */
 export interface PolicyMatchResult extends PolicySqlFragments {
     appliedPolicies: string[];
     skippedPolicies: Array<{
@@ -23,7 +94,7 @@ export interface PolicyMatchResult extends PolicySqlFragments {
         details: string[];
     }>;
     warnings: string[];
-    /** The minimum refresh schedule in milliseconds across all evaluated policies */
-    refresh_schedule: number;
+    /** The minimum refresh schedule as an ISO 8601 duration string across all evaluated policies */
+    refresh_schedule: string;
 }
 export {};

package/build/collaboration-policy/index.d.ts

@@ -1,4 +1,5 @@
-export { buildPolicySql, buildPolicySqlWithValidation, categorizePolicies, } from "./core/sql-builder";
-export type { AttributePathIndex, ExtendedAttributeNode, PathValue, PolicyFilter, PolicyMatchResult, PolicySqlFragments, PolicySqlGroup, StructureNode, } from "./core/types";
-export type { CollaborationPolicyInput, CollaborationPolicyType, } from "./types";
-export { buildCollaborationPolicyJsonSchema, CollaborationPolicy, } from "./types";
+export type { JsonSchemaConnectorPolicy } from "./core/jsonschema/json-schema-types";
+export { evaluateJsonSchemaPolicies } from "./core/jsonschema/policy-evaluator";
+export { buildPolicySql, buildPolicySqlWithJsonSchema, buildPolicySqlWithValidation, categorizePolicies, type JsonSchemaPolicyMatchResult, } from "./core/jsonschema/sql-builder";
+export type { AttributePathIndex, FilterAttributeRef, FilterExpression, PathValue, PolicyFilter, PolicyMatchResult, PolicySqlFragments, PolicySqlGroup, } from "./core/types";
+export { default as useCollaborationPolicy } from "./useCollaborationPolicy";

package/build/collaboration-policy/index.js

@@ -1,3 +1,4 @@
-// Export the main functions
-export { buildPolicySql, buildPolicySqlWithValidation, categorizePolicies, } from "./core/sql-builder";
-export { buildCollaborationPolicyJsonSchema, CollaborationPolicy, } from "./types";
+export { evaluateJsonSchemaPolicies } from "./core/jsonschema/policy-evaluator";
+export { buildPolicySql, buildPolicySqlWithJsonSchema, buildPolicySqlWithValidation, categorizePolicies, } from "./core/jsonschema/sql-builder";
+// Hook-style entrypoint
+export { default as useCollaborationPolicy } from "./useCollaborationPolicy";

package/build/collaboration-policy/useCollaborationPolicy.d.ts

@@ -1,8 +1,17 @@
 import type { Attribute } from "../attributes/types";
 import type { Dataset } from "../datasets/types";
-import type { PolicySqlFragments } from "./core/types";
-import type { CollaborationPolicyType } from "./types";
+import type { JsonSchemaConnectorPolicy } from "./core/jsonschema/json-schema-types";
+import type { PolicyMatchResult, PolicySqlFragments } from "./core/types";
+/**
+ * Hook-style wrapper that exposes collaboration policy helpers.
+ *
+ * Public API surface:
+ * - categorizePolicies
+ * - buildPolicySql
+ * - buildPolicySqlWithValidation
+ */
 export default function useCollaborationPolicy(): {
-    getEligibleConnectorsPolicies: (dataset: Dataset, policies: CollaborationPolicyType[], attributes: Attribute[]) => CollaborationPolicyType[];
-    buildPolicySqlFragments: (dataset: Dataset, policies: CollaborationPolicyType[], attributes: Attribute[]) => PolicySqlFragments;
+    getEligibleConnectorsPolicies: (dataset: Dataset, policies: JsonSchemaConnectorPolicy[], attributes: Attribute[]) => JsonSchemaConnectorPolicy[];
+    buildPolicySqlFragments: (dataset: Dataset, policies: JsonSchemaConnectorPolicy[], attributes: Attribute[]) => PolicySqlFragments;
+    buildPolicySqlWithValidationJsonSchema: (dataset: Dataset, policies: JsonSchemaConnectorPolicy[], attributes: Attribute[]) => PolicyMatchResult;
 };

package/build/collaboration-policy/useCollaborationPolicy.js

@@ -1,14 +1,36 @@
-import { buildPolicySql, categorizePolicies } from "./core/sql-builder";
+import { buildPolicySql, buildPolicySqlWithValidation, categorizePolicies, } from "./core/jsonschema/sql-builder";
+/**
+ * Hook-style wrapper that exposes collaboration policy helpers.
+ *
+ * Public API surface:
+ * - categorizePolicies
+ * - buildPolicySql
+ * - buildPolicySqlWithValidation
+ */
 export default function useCollaborationPolicy() {
+    /**
+     * Get policies that are compatible with a dataset using the JSON-Schema policy system.
+     */
     const getEligibleConnectorsPolicies = (dataset, policies, attributes) => {
         const { matching } = categorizePolicies(policies, dataset, attributes);
         return matching;
     };
+    /**
+     * Build SQL fragments using JSON-Schema policies, without per-policy validation.
+     */
     const buildPolicySqlFragments = (dataset, policies, attributes) => {
         return buildPolicySql(dataset, policies, attributes);
     };
+    /**
+     * Validate each JSON-Schema policy against the dataset and build SQL
+     * plus metadata (appliedPolicies, skippedPolicies, etc.).
+     */
+    const buildPolicySqlWithValidationJsonSchema = (dataset, policies, attributes) => {
+        return buildPolicySqlWithValidation(dataset, policies, attributes);
+    };
     return {
         getEligibleConnectorsPolicies,
         buildPolicySqlFragments,
+        buildPolicySqlWithValidationJsonSchema,
     };
 }

package/build/collaboration-policy/utils/path-helpers.d.ts

@@ -1,4 +1,8 @@
-import type { Attribute } from "../../attributes/types";
-import type { AttributePathIndex, PathValue } from "../core/types";
-export declare function markAttributePath(index: AttributePathIndex, attribute: Attribute, path: string): void;
+import type { PathValue } from "../core/types";
+/**
+ * Normalizes a PathValue (dot notation or JSON pointer) into a simple dot-notation string.
+ *
+ * @param path - A PathValue with either `{ dot: "..." }` or `{ pointer: "..." }` format.
+ * @returns Normalized dot-notation string, or empty string for undefined/null.
+ */
 export declare function normalizePathValue(path?: PathValue): string;

package/build/collaboration-policy/utils/path-helpers.js

@@ -1,25 +1,9 @@
-export function markAttributePath(index, attribute, path) {
-    const attributePaths = index.get(attribute.name) ?? new Set();
-    // Use the provided path, even if it's an empty string (which represents the root attribute)
-    const normalized = path !== undefined && path !== null
-        ? path
-        : determineDefaultPath(attribute);
-    attributePaths.add(normalized);
-    index.set(attribute.name, attributePaths);
-}
-function determineDefaultPath(attribute) {
-    if (attribute.type === "object" && "properties" in attribute) {
-        const properties = attribute.properties ?? {};
-        if ("value" in properties) {
-            return "value";
-        }
-        const [firstKey] = Object.keys(properties);
-        if (firstKey) {
-            return firstKey;
-        }
-    }
-    return "";
-}
+/**
+ * Normalizes a PathValue (dot notation or JSON pointer) into a simple dot-notation string.
+ *
+ * @param path - A PathValue with either `{ dot: "..." }` or `{ pointer: "..." }` format.
+ * @returns Normalized dot-notation string, or empty string for undefined/null.
+ */
 export function normalizePathValue(path) {
     if (!path) {
         return "";

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

@@ -18,4 +18,4 @@ declare class CompanyInfoApi extends BaseApi {
      */
     getAllProvidersCompanyInfo(): Promise<ApiRecords<CompanyInfo>>;
 }
-export { type CompanyInfo, type WhoAmI, CompanyInfoApi };
+export { type CompanyInfo, CompanyInfoApi, type WhoAmI };

package/build/connections/index.d.ts

@@ -69,4 +69,4 @@ declare class ConnectionsApi extends BaseApi {
      */
     getConnections(): Promise<ApiRecords<ConnectionV2>>;
 }
-export { type Connection, type ConnectionV2, type ConnectionStatus, ConnectionsApi, };
+export { type Connection, type ConnectionStatus, ConnectionsApi, type ConnectionV2, };

package/build/contracts/index.d.ts

@@ -36,4 +36,4 @@ declare class ContractsApi extends BaseApi {
      */
     getActiveContract(): Promise<ContractDetails>;
 }
-export { ContractsApi, type ContractDetails, type CustomerContract, type PaymentMethod, type ContractRateView, };
+export { type ContractDetails, type ContractRateView, ContractsApi, type CustomerContract, type PaymentMethod, };

package/build/data-planes/types.d.ts

@@ -15,7 +15,7 @@ export interface DataPlanePlatform {
     region: DataPlanePlatformRegion;
 }
 export interface DataPlaneCollaborators {
-    use: Participants;
+    participants: Participants;
 }
 export interface DataPlane {
     type: DataPlaneType;

package/build/data-streams/index.d.ts

@@ -24,4 +24,4 @@ declare class DataStreamsApi extends BaseApi {
     getDataStreamBySlug(slug: string, companyId: number, authenticated: boolean): Promise<DataStream>;
     private getBaseUri;
 }
-export { DataStreamsApi, type DataRules, type ColumnSet, type ColumnWithFilterAndExport, type AttributeSet, type DataStream, };
+export { type AttributeSet, type ColumnSet, type ColumnWithFilterAndExport, type DataRules, type DataStream, DataStreamsApi, };

package/build/datasets/index.d.ts

@@ -1,8 +1,10 @@
 import type { UnknownJob } from "src/jobs/types";
 import { BaseApi } from "../base-api";
 import type { ApiRecords } from "../types";
-import type { AdvancedStatistics, AdvancedStatisticsMetadata, BasicStatistics, ColumnStatistics, ColumnSummary, Columns, Configuration, CreateDatasetRefreshScheduleRequest, CreateDatasetRequest, Dataset, DatasetStatus, DatasetTableSummary, DatasetTableSummaryAPIResponse, DatasetWriteMode, FilePerSnapshotResponse, Histogram, IngestDatasetFileRequest, RecalculationInfo, RetentionPolicy, Schema, SchemaArrayItems, SchemaArrayItemsArray, SchemaArrayItemsObject, SchemaArrayItemsPrimitive, SchemaArrayProperty, SchemaFileConfig, SchemaFileConfigType, SchemaObjectProperty, SchemaPrimitiveProperty, SchemaProperties, SchemaPropertiesType, SchemaProperty, SnapshotRange, UpdateDatasetRefreshScheduleRequest, UpdateDatasetRequest, Value } from "./types";
-export type { FilePerSnapshotResponse, Dataset, RetentionPolicy, DatasetTableSummaryAPIResponse, ColumnStatistics, UpdateDatasetRequest, SchemaFileConfigType, SchemaPropertiesType, DatasetStatus, DatasetWriteMode, SchemaFileConfig, SchemaProperties, SchemaProperty, SchemaPrimitiveProperty, SchemaObjectProperty, SchemaArrayProperty, SchemaArrayItems, SchemaArrayItemsPrimitive, SchemaArrayItemsObject, SchemaArrayItemsArray, Schema, AdvancedStatisticsMetadata, SnapshotRange, Configuration, Columns, ColumnSummary, BasicStatistics, AdvancedStatistics, Histogram, Value, CreateDatasetRequest, UpdateDatasetRefreshScheduleRequest, CreateDatasetRefreshScheduleRequest, };
+import type { DatasetStatisticsConfiguration, StatisticsConfigurationResponse } from "./statistics-types";
+import type { AdvancedStatistics, AdvancedStatisticsMetadata, BasicStatistics, ColumnStatistics, ColumnSummary, Columns, Configuration, CreateDatasetRefreshScheduleRequest, CreateDatasetRequest, Dataset, DatasetInterfaceError, DatasetInterfaceRef, DatasetInterfaceValidation, DatasetStatus, DatasetTableSummary, DatasetTableSummaryAPIResponse, DatasetWriteMode, FilePerSnapshotResponse, Histogram, IngestDatasetFileRequest, JsonSchemaValidationNode, RecalculationInfo, RetentionPolicy, RetentionScheduleConfig, RowClock, RowTTLPolicy, Schema, SchemaArrayItems, SchemaArrayItemsArray, SchemaArrayItemsObject, SchemaArrayItemsPrimitive, SchemaArrayProperty, SchemaFileConfig, SchemaFileConfigType, SchemaObjectProperty, SchemaPrimitiveProperty, SchemaProperties, SchemaPropertiesType, SchemaProperty, SnapshotAgeExpression, SnapshotRange, SnapshotTTLPolicy, TableClock, TableClockKind, TableTTLPolicy, TTLPolicy, TTLPolicyKind, UpdateDatasetRefreshScheduleRequest, UpdateDatasetRequest, UpsertRetentionPoliciesRequest, Value } from "./types";
+export type { CronRefresh, DatasetFieldConfig, DatasetFieldNamespace, DatasetStatisticsConfiguration, HistogramOptions, HistogramOverflow, ManualRefresh, NestedNodeConfig, NestedPropertyConfig, NonPrimitiveNodeConfig, OnUpdateRefresh, PrimitiveNodeConfig, RefreshTrigger, RosettaStoneFieldConfig, RosettaStoneFieldNamespace, StatConfig, StatisticsConfigurationResponse, StatName, StatOptions, } from "./statistics-types";
+export type { AdvancedStatistics, AdvancedStatisticsMetadata, BasicStatistics, ColumnStatistics, ColumnSummary, Columns, Configuration, CreateDatasetRefreshScheduleRequest, CreateDatasetRequest, Dataset, DatasetInterfaceError, DatasetInterfaceRef, DatasetInterfaceValidation, DatasetStatus, DatasetTableSummaryAPIResponse, DatasetWriteMode, FilePerSnapshotResponse, Histogram, JsonSchemaValidationNode, RetentionPolicy, RetentionScheduleConfig, RowClock, RowTTLPolicy, Schema, SchemaArrayItems, SchemaArrayItemsArray, SchemaArrayItemsObject, SchemaArrayItemsPrimitive, SchemaArrayProperty, SchemaFileConfig, SchemaFileConfigType, SchemaObjectProperty, SchemaPrimitiveProperty, SchemaProperties, SchemaPropertiesType, SchemaProperty, SnapshotAgeExpression, SnapshotRange, SnapshotTTLPolicy, TableClock, TableClockKind, TableTTLPolicy, TTLPolicy, TTLPolicyKind, UpdateDatasetRefreshScheduleRequest, UpdateDatasetRequest, UpsertRetentionPoliciesRequest, Value, };
 /**
  * @module DatasetApi
  * @description This module provides methods for fetching datasets.
@@ -166,6 +168,8 @@ export declare class DatasetApi extends BaseApi {
      * @public
      */
     updateRetentionPolicy(datasetId: number, policy: RetentionPolicy): Promise<Dataset>;
+    upsertRetentionPolicies(datasetId: number, request: UpsertRetentionPoliciesRequest): Promise<Dataset>;
+    disableDatasetRetentionPolicy(datasetId: number, policy: TTLPolicy): Promise<Dataset>;
     /**
      * Configures the statistics for a specific dataset column.
      * This method sends a PUT request to the specified endpoint to update the statistics configuration.
@@ -190,7 +194,9 @@ export declare class DatasetApi extends BaseApi {
      * @throws {Error} If there is an issue with the request or the response.
      * @memberof DatasetApi
      */
-    requestDatasetSample(datasetId: number): Promise<{
+    requestDatasetSample(datasetId: number, request?: {
+        compute_pool_id?: string;
+    }): Promise<{
         job_id: string;
     }>;
     /**
@@ -215,4 +221,16 @@ export declare class DatasetApi extends BaseApi {
     createDatasetRefreshSchedule(datasetId: number, refreshSchedule: CreateDatasetRefreshScheduleRequest): Promise<void>;
     updateDatasetRefreshSchedule(datasetId: number, refreshSchedule: UpdateDatasetRefreshScheduleRequest): Promise<void>;
     deleteDatasetRefreshSchedule(datasetId: number): Promise<void>;
+    /**
+     * Validate which connector interfaces are compatible with a dataset.
+     * Filtered by the user's installed apps and optionally by tags.
+     *
+     * @param {number} datasetId - The ID of the dataset to validate interfaces against.
+     * @param {string[]} [tags] - Optional tags to filter interfaces (e.g. ["audience_delivery"]).
+     * @returns {Promise<DatasetInterfaceValidation>} - Accepted interface IDs and per-interface validation errors.
+     */
+    getDatasetInterfaces(datasetId: number, tags?: string[]): Promise<DatasetInterfaceValidation>;
+    putStatisticsConfiguration(datasetId: number, configuration: DatasetStatisticsConfiguration): Promise<StatisticsConfigurationResponse>;
+    getStatisticsConfiguration(datasetId: number): Promise<StatisticsConfigurationResponse>;
+    deleteStatisticsConfiguration(datasetId: number): Promise<StatisticsConfigurationResponse>;
 }

package/build/datasets/index.js

@@ -221,6 +221,14 @@ export class DatasetApi extends BaseApi {
     async updateRetentionPolicy(datasetId, policy) {
         return await this.put(`${resourceName}/${datasetId}/retention-policy`, policy);
     }
+    async upsertRetentionPolicies(datasetId, request) {
+        return await this.put(`${resourceName}/${datasetId}/retention-policy`, request);
+    }
+    async disableDatasetRetentionPolicy(datasetId, policy) {
+        return await this.upsertRetentionPolicies(datasetId, {
+            policies: [{ ...policy, enabled: false }],
+        });
+    }
     /**
      * Configures the statistics for a specific dataset column.
      * This method sends a PUT request to the specified endpoint to update the statistics configuration.
@@ -249,8 +257,8 @@ export class DatasetApi extends BaseApi {
      * @throws {Error} If there is an issue with the request or the response.
      * @memberof DatasetApi
      */
-    async requestDatasetSample(datasetId) {
-        return await this.post(`${resourceName}/${datasetId}/request-sample`);
+    async requestDatasetSample(datasetId, request) {
+        return await this.post(`${resourceName}/${datasetId}/request-sample`, request);
     }
     /**
      * Deletes a sample of a specified dataset by its ID.
@@ -287,4 +295,25 @@ export class DatasetApi extends BaseApi {
     async deleteDatasetRefreshSchedule(datasetId) {
         await this.delete(`${resourceName}/${datasetId}/refresh-schedule`);
     }
+    /**
+     * Validate which connector interfaces are compatible with a dataset.
+     * Filtered by the user's installed apps and optionally by tags.
+     *
+     * @param {number} datasetId - The ID of the dataset to validate interfaces against.
+     * @param {string[]} [tags] - Optional tags to filter interfaces (e.g. ["audience_delivery"]).
+     * @returns {Promise<DatasetInterfaceValidation>} - Accepted interface IDs and per-interface validation errors.
+     */
+    async getDatasetInterfaces(datasetId, tags) {
+        const queryString = this.constructQueryString(tags != null ? { tags } : undefined);
+        return await this.get(`${resourceName}/${datasetId}/interfaces${queryString}`);
+    }
+    async putStatisticsConfiguration(datasetId, configuration) {
+        return await this.put(`${resourceName}/${datasetId}/statistics-configuration`, configuration);
+    }
+    async getStatisticsConfiguration(datasetId) {
+        return await this.get(`${resourceName}/${datasetId}/statistics-configuration`);
+    }
+    async deleteStatisticsConfiguration(datasetId) {
+        return await this.base_api.delete(`${resourceName}/${datasetId}/statistics-configuration`);
+    }
 }

package/build/datasets/statistics-types.d.ts

@@ -0,0 +1,81 @@
+export type StatName = "value_count" | "null_value_count" | "nan_value_count" | "lower_bound" | "upper_bound" | "approx_count_distinct" | "count_distinct" | "histogram" | "mean" | "standard_deviation" | "completeness";
+export type HistogramOverflow = "none" | "truncate";
+export interface HistogramOptions {
+    max_bins?: number;
+    overflow?: HistogramOverflow;
+}
+export interface StatOptions {
+    histogram?: HistogramOptions;
+}
+export type StatConfig = {
+    enabled_stats: StatName[];
+    stat_options?: StatOptions;
+} | {
+    enabled_stats?: StatName[];
+    stat_options: StatOptions;
+} | {
+    enabled_stats: StatName[];
+    stat_options: StatOptions;
+};
+export interface CronRefresh {
+    trigger: "cron";
+    cron_expression: string;
+}
+export interface OnUpdateRefresh {
+    trigger: "on_update";
+}
+export interface ManualRefresh {
+    trigger: "manual";
+}
+export type RefreshTrigger = CronRefresh | OnUpdateRefresh | ManualRefresh;
+export interface PrimitiveNodeConfig {
+    enabled_stats?: StatName[];
+    stat_options?: StatOptions;
+}
+export interface NonPrimitiveNodeConfig {
+    self?: StatConfig;
+    properties?: NestedPropertyConfig[];
+    items?: NestedNodeConfig;
+}
+export type NestedNodeConfig = PrimitiveNodeConfig | NonPrimitiveNodeConfig;
+export type NestedPropertyConfig = (PrimitiveNodeConfig & {
+    path: string;
+}) | (NonPrimitiveNodeConfig & {
+    path: string;
+});
+export type DatasetFieldConfig = (PrimitiveNodeConfig & {
+    field_name: string;
+}) | (NonPrimitiveNodeConfig & {
+    field_name: string;
+}) | {
+    field_name: string;
+};
+export type RosettaStoneFieldConfig = (PrimitiveNodeConfig & {
+    attribute_name: string;
+}) | (NonPrimitiveNodeConfig & {
+    attribute_name: string;
+}) | {
+    attribute_name: string;
+};
+export interface DatasetFieldNamespace {
+    scope?: StatConfig;
+    fields?: DatasetFieldConfig[];
+}
+export interface RosettaStoneFieldNamespace {
+    scope?: StatConfig;
+    fields?: RosettaStoneFieldConfig[];
+}
+export interface DatasetStatisticsConfiguration {
+    defaults: StatConfig;
+    refresh: RefreshTrigger;
+    dataset?: DatasetFieldNamespace;
+    rosetta_stone?: RosettaStoneFieldNamespace;
+}
+export interface StatisticsConfigurationResponse {
+    id: string;
+    dataset_id: number;
+    version: number;
+    created_at: string;
+    created_by: number;
+    configuration: DatasetStatisticsConfiguration;
+}

package/build/datasets/statistics-types.js

@@ -0,0 +1 @@
+export {};

package/build/datasets/types.d.ts

@@ -22,6 +22,9 @@ export interface Dataset {
     external_id?: string;
     data_plane?: DataPlane;
     materialized_view_config?: string;
+    compute_pool_config?: {
+        default_compute_pool_id?: string;
+    };
 }
 export interface DatasetStats extends DatasetSummaryStatistics {
     last_snapshot_added_bytes: number;
@@ -78,8 +81,6 @@ export interface DatasetTableSummaryAPIResponse {
 export type SchemaPropertiesType = "string" | "boolean" | "double" | "long" | "timestamptz" | "object" | "array";
 export type DatasetStatus = "active" | "archived" | "pending";
 export type DatasetWriteMode = "append" | "overwrite";
-type ExpressionlessRetentionPolicyType = "retain_everything" | "expire_everything";
-type ExpressionedRetentionPolicyType = "retain_when" | "expire_when";
 type SchemaType = "object" | "value";
 export declare enum Operator {
     GreaterThan = ">",
@@ -87,16 +88,66 @@ export declare enum Operator {
     GreaterThanOrEqualTo = ">=",
     LessThanOrEqualTo = "<="
 }
+export interface SnapshotAgeExpression {
+    type: "snapshot_age";
+    operator: Operator;
+    period: string;
+}
 export type RetentionPolicy = {
-    type: ExpressionlessRetentionPolicyType;
+    type: "retain_everything";
 } | {
-    type: ExpressionedRetentionPolicyType;
-    expression?: {
-        type: "snapshot_age";
-        operator: Operator;
-        period: string;
-    };
+    type: "expire_everything";
+} | {
+    type: "retain_when";
+    expression?: SnapshotAgeExpression;
+} | {
+    type: "expire_when";
+    expression?: SnapshotAgeExpression;
 };
+export interface RowClock {
+    kind: "event_time";
+    attribute?: string;
+}
+export type TTLPolicyKind = "row_ttl" | "table_ttl" | "snapshot_ttl";
+export interface RowTTLPolicy {
+    type: {
+        kind: "row_ttl";
+        clock?: RowClock;
+    };
+    enabled: boolean;
+    interval: string;
+}
+export type TableClockKind = "created_at" | "max_event_time" | "static_time";
+export interface TableClock {
+    kind: TableClockKind;
+    column?: string;
+}
+export interface TableTTLPolicy {
+    type: {
+        kind: "table_ttl";
+        clock: TableClock;
+    };
+    enabled: boolean;
+    interval: string;
+}
+export interface SnapshotTTLPolicy {
+    type: {
+        kind: "snapshot_ttl";
+    };
+    enabled: boolean;
+    interval: string;
+    snapshot_retention_policy: RetentionPolicy;
+}
+export type TTLPolicy = RowTTLPolicy | TableTTLPolicy | SnapshotTTLPolicy;
+export interface RetentionScheduleConfig {
+    schedule: string;
+    schedule_zone_id?: string;
+    status?: "active" | "pending" | "archived";
+}
+export interface UpsertRetentionPoliciesRequest {
+    policies: TTLPolicy[];
+    schedule_config?: RetentionScheduleConfig;
+}
 export type SchemaFileConfigType = "flat" | "json" | "parquet";
 export interface FlatFileConfig {
     type: "flat";
@@ -244,6 +295,31 @@ export interface CreateDatasetRequest {
 export interface IngestDatasetFileRequest {
     source_file: string;
 }
+export interface DatasetInterfaceRef {
+    app_id: number;
+    interface_id: string;
+}
+/**
+ * A JSON-Schema 2020-12 "Basic" output node, used recursively in validation errors.
+ * `errors` is keyed by JSON-Schema keyword (`"required"`, `"type"`, etc.); values
+ * are human-readable strings.
+ */
+export interface JsonSchemaValidationNode {
+    valid: boolean;
+    evaluationPath: string;
+    schemaLocation: string;
+    instanceLocation: string;
+    errors?: Record<string, string>;
+    details?: JsonSchemaValidationNode[];
+}
+export interface DatasetInterfaceError extends DatasetInterfaceRef {
+    details: JsonSchemaValidationNode;
+}
+export interface DatasetInterfaceValidation {
+    dataset_id: number;
+    accepted: DatasetInterfaceRef[];
+    errors: DatasetInterfaceError[];
+}
 export interface UpdateDatasetRefreshScheduleRequest {
     cron?: string;
     cron_zone_id?: string;

package/build/datasets/types.js

@@ -1,3 +1,4 @@
+// ---- Snapshot-level retention (legacy) ----
 export var Operator;
 (function (Operator) {
     Operator["GreaterThan"] = ">";

package/build/forecast/index.d.ts

@@ -49,4 +49,4 @@ declare class ForecastApi extends BaseApi {
      */
     getPublicForecast(forecastId: string): Promise<ForecastResponse>;
 }
-export { ForecastApi, type ForecastRequest, type ForecastResponse, type CostForecastRequest, type CostForecastResponse, type ForecastResult, type CostForecastResult, type ForecastResultFailure, type JobState, };
+export { type CostForecastRequest, type CostForecastResponse, type CostForecastResult, ForecastApi, type ForecastRequest, type ForecastResponse, type ForecastResult, type ForecastResultFailure, type JobState, };

package/build/index.d.ts

@@ -15,6 +15,7 @@ export * from "./data-planes";
 export * from "./data-planes/types";
 export * from "./data-streams";
 export * from "./datasets";
+export * from "./datasets/statistics-types";
 export * from "./datasets/types";
 export * from "./encryption-materials";
 export * from "./encryption-materials/types";

package/build/index.js

@@ -15,6 +15,7 @@ export * from "./data-planes";
 export * from "./data-planes/types";
 export * from "./data-streams";
 export * from "./datasets";
+export * from "./datasets/statistics-types";
 export * from "./datasets/types";
 export * from "./encryption-materials";
 export * from "./encryption-materials/types";

package/build/installations/index.d.ts

@@ -15,4 +15,4 @@ declare class InstallationsApi extends BaseApi {
     getInstallations(appCategory?: string): Promise<ApiRecords<Installation>>;
     getInstallationProfiles(installationId: number): Promise<ApiRecords<Profile>>;
 }
-export { type Installation, type Profile, InstallationsApi };
+export { type Installation, InstallationsApi, type Profile };

package/build/jobs/index.d.ts

@@ -31,4 +31,4 @@ declare class JobsApi extends BaseApi {
      */
     cancelJob(jobId: string): Promise<void>;
 }
-export { type Job, type JobRequestSource, type JobRequestSourceApiUser, type JobRequestSourceProcess, type ForecastInput, type ForecastJob, type ExplainInput, type ExplainJob, type ExplainOutput, type MaterializedViewInput, type MaterializedViewJob, type MaterializedViewOutput, type DeleteInput, type DatasetsDeleteTableJob, type DeliverInput, type DatasetsDeliverDataJob, type SampleInput, type DatasetsSampleJob, type ColumnDetails, type StatsInput, type DatasetsCalculateColumnStatsJob, type ModelTrainingRunInput, type ModelTrainingRunJob, type ModelsDeliverModelInput, type ModelsDeliverModelJob, type ModelInferenceRunInput, type ModelInferenceRunJob, type ModelInferenceRunJobResult, type GetJobsParameters, JobsApi, };
+export { type ColumnDetails, type DatasetsCalculateColumnStatsJob, type DatasetsDeleteTableJob, type DatasetsDeliverDataJob, type DatasetsSampleJob, type DeleteInput, type DeliverInput, type ExplainInput, type ExplainJob, type ExplainOutput, type ForecastInput, type ForecastJob, type GetJobsParameters, type Job, type JobRequestSource, type JobRequestSourceApiUser, type JobRequestSourceProcess, JobsApi, type MaterializedViewInput, type MaterializedViewJob, type MaterializedViewOutput, type ModelInferenceRunInput, type ModelInferenceRunJob, type ModelInferenceRunJobResult, type ModelsDeliverModelInput, type ModelsDeliverModelJob, type ModelTrainingRunInput, type ModelTrainingRunJob, type SampleInput, type StatsInput, };

package/build/jobs/types.d.ts

@@ -19,6 +19,7 @@ interface BaseJob {
     type: JobType;
     request_source: JobRequestSource;
     data_plane_id?: string;
+    compute_pool_id?: string;
     state: JobState;
     executor?: string;
     idempotency_key: string;