@narrative.io/data-collaboration-sdk-ts 3.5.1 → 3.7.0

package/build/agents/types.d.ts

@@ -16,7 +16,7 @@ export type RunId = string;
 export type ClientOpId = string;
 export type ConversationVersion = number;
 export type ToolUseId = string;
-export type AgentModel = "anthropic.claude-haiku-4.5" | "anthropic.claude-sonnet-4.5" | "anthropic.claude-sonnet-4.6" | "anthropic.claude-sonnet-5.0" | "anthropic.claude-opus-4.5" | "anthropic.claude-opus-4.6" | "anthropic.claude-opus-4.7" | "anthropic.claude-opus-4.8" | "openai.gpt-oss-120b" | "openai.gpt-4.1" | "openai.o4-mini" | (string & {});
+export type AgentModel = "anthropic.claude-haiku-4.5" | "anthropic.claude-sonnet-4.5" | "anthropic.claude-sonnet-4.6" | "anthropic.claude-sonnet-5.0" | "anthropic.claude-opus-4.5" | "anthropic.claude-opus-4.6" | "anthropic.claude-opus-4.7" | "anthropic.claude-opus-4.8" | "anthropic.claude-opus-5.0" | "openai.gpt-oss-120b" | "openai.gpt-4.1" | "openai.o4-mini" | (string & {});
 export type ExecutionCluster = "shared" | "dedicated";
 /** Subset of JSON Schema Draft 2020-12 accepted by Bedrock structured output. */
 export type JsonSchemaObject = Record<string, unknown>;

package/build/mappings/index.d.ts

@@ -1,7 +1,7 @@
 import { BaseApi } from "../base-api";
 import { CompanyInfoApi } from "../company-info";
 import type { ApiRecords, Config } from "../types";
-import type { CreateMapping, Mapping, MappingExpressionDependencies, MappingTestResult, MappingTestResults, ObjectMapping, PropertyMapping, RawMappingDefinition, RawObjectMapping, RawPropertyMapping, RawValueMapping, ValueMapping } from "./types";
+import type { CachedMapping, CreateMapping, Mapping, MappingDefinition, MappingExpressionDependencies, MappingTestResult, MappingTestResults, ObjectMapping, PropertyMapping, RawCachedMapping, RawMappingDefinition, RawObjectMapping, RawPropertyMapping, RawValueMapping, ValueMapping } from "./types";
 /**
  * Class representing the Mappings API.
  * Extends the BaseApi to provide functionalities specific to mappings.
@@ -111,4 +111,4 @@ declare class MappingsApi extends BaseApi {
      */
     getMapping(mappingId: string): Promise<Mapping>;
 }
-export { type CreateMapping, type Mapping, type MappingExpressionDependencies, MappingsApi, type MappingTestResult, type MappingTestResults, type ObjectMapping, type PropertyMapping, type RawMappingDefinition, type RawObjectMapping, type RawPropertyMapping, type RawValueMapping, type ValueMapping, };
+export { type CachedMapping, type CreateMapping, type Mapping, type MappingDefinition, type MappingExpressionDependencies, MappingsApi, type MappingTestResult, type MappingTestResults, type ObjectMapping, type PropertyMapping, type RawCachedMapping, type RawMappingDefinition, type RawObjectMapping, type RawPropertyMapping, type RawValueMapping, type ValueMapping, };

package/build/mappings/types.d.ts

@@ -3,7 +3,7 @@ export interface Mapping {
     attribute_id: number;
     created_at: string;
     dataset_id: number;
-    mapping: ObjectMapping | ValueMapping;
+    mapping: MappingDefinition;
     status: MappingStatus;
     updated_at: string;
     created_by: number;
@@ -33,6 +33,16 @@ export interface RawValueMapping {
     type: "value_mapping";
     expression: string;
 }
+/**
+ * Create/update shape for cached mappings.
+ * `cache_dataset_id` is assigned server-side and returned on the read shape (`CachedMapping`).
+ * Only valid on company-scoped create endpoints (e.g. `POST /mappings/companies/{company_id}`).
+ */
+export interface RawCachedMapping {
+    type: "cached_mapping";
+    /** One or more SQL expressions evaluated against the source dataset to build the join key. */
+    input_expressions: string[];
+}
 export interface PropertyMapping {
     path: string;
     expression: string;
@@ -47,7 +57,17 @@ export interface ValueMapping {
     expression: string;
     dependencies: MappingExpressionDependencies;
 }
-export type RawMappingDefinition = RawObjectMapping | RawValueMapping;
+/** Read shape for cached mappings. See `RawCachedMapping` for create/update requests. */
+export interface CachedMapping {
+    type: "cached_mapping";
+    /** Dataset that stores the input → mapped_value lookup rows for this mapping. */
+    cache_dataset_id: number;
+    /** One or more SQL expressions evaluated against the source dataset to build the join key. */
+    input_expressions: string[];
+    dependencies?: MappingExpressionDependencies;
+}
+export type MappingDefinition = ObjectMapping | ValueMapping | CachedMapping;
+export type RawMappingDefinition = RawObjectMapping | RawValueMapping | RawCachedMapping;
 export interface CreateMapping {
     attribute_id: number;
     dataset_id: number;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@narrative.io/data-collaboration-sdk-ts",
-	"version": "3.5.1",
+	"version": "3.7.0",
 	"main": "build/index.js",
 	"repository": "github:narrative-io/data-collaboration-sdk-ts",
 	"source": "src/index.ts",
@@ -30,14 +30,14 @@
 		"@babel/core": "8.0.1",
 		"@babel/preset-env": "8.0.2",
 		"@babel/preset-typescript": "8.0.1",
-		"@biomejs/biome": "2.5.2",
-		"@commitlint/cli": "21.2.0",
+		"@biomejs/biome": "2.5.4",
+		"@commitlint/cli": "21.2.1",
 		"@commitlint/config-conventional": "21.2.0",
 		"@types/jest": "30.0.0",
 		"@types/json-schema": "7.0.15",
 		"babel-jest": "30.4.1",
 		"jest": "30.4.2",
-		"lefthook": "2.1.9",
+		"lefthook": "2.1.10",
 		"ts-jest": "29.4.11",
 		"typescript": "6.0.0-dev.20260416"
 	},