@narrative.io/data-collaboration-sdk-ts 4.4.0 → 4.5.0

package/build/testing/fixtures/jobs.js

@@ -0,0 +1,433 @@
+/**
+ * One factory per job type the spec describes, plus one for a type it does not.
+ *
+ * Each returns a completed job whose `result` is filled in, since that is the
+ * state with the most to assert against. A job that has not finished is an
+ * override: `{ state: "pending", result: null, ended_at: null }`.
+ *
+ * Values come from the spec's own examples where it carries one, so a fixture
+ * and the documented response agree. Two places they cannot: an id the spec
+ * writes beyond `Number.MAX_SAFE_INTEGER` is shortened to a safe integer, and
+ * fields the spec types as an object with no properties are left empty — see
+ * {@link createDatasetsCalculateAffectedRowsJob}.
+ *
+ * The job a health check enqueues has its own factory, `createHealthCheckJob`,
+ * next to the data plane fixtures it is used with.
+ */
+const TIMESTAMP = "2026-01-01T00:00:00Z";
+const DATA_PLANE_ID = "5f9d1a4e-0000-4000-8000-000000000001";
+const DATASET_ID = 10736;
+/**
+ * The envelope every job shares. `operator_type` is finer-grained than the job
+ * type — several job types run as `datasets_execute_select`, for instance — so
+ * each factory passes the operator the API reports for it.
+ */
+function envelope(jobId, operatorType) {
+    return {
+        job_id: jobId,
+        company_id: 1,
+        data_plane_id: DATA_PLANE_ID,
+        compute_pool_id: null,
+        request_source: { type: "api_user", company_id: 1, user_id: 407 },
+        state: "completed",
+        operator_type: operatorType,
+        tags: [],
+        executor: "job-executor-test",
+        execution_cluster: "shared",
+        idempotency_key: `${jobId}:test`,
+        dequeued_at: TIMESTAMP,
+        created_at: TIMESTAMP,
+        updated_at: TIMESTAMP,
+        attempted_at: TIMESTAMP,
+        attempt_version: 1,
+        ended_at: TIMESTAMP,
+        workflow_id: null,
+        workflow_run_id: null,
+    };
+}
+/** Refreshes a materialized view into its target dataset. */
+export function createMaterializeViewJob(overrides = {}) {
+    return {
+        ...envelope("2a5b9ad7-0000-4000-8000-000000000001", "materialized-view-refresh"),
+        type: "materialize-view",
+        input: {
+            nql: 'CREATE MATERIALIZED VIEW "test_stats" AS SELECT "value" FROM "company_data"."10674"',
+            compiled_select: "SELECT\n  `ds_10674`.`value`\nFROM\n  narrative.datasets.ds_10674 `ds_10674`",
+            create_as_view: null,
+            dataset_id: DATASET_ID,
+            billing_enabled: null,
+            stats_enabled: true,
+            contains_delta_syntax: null,
+            first_run: false,
+            merge: true,
+            partitions: null,
+            snowflake_create_table: null,
+            snowflake_insert_statement: null,
+            chunk_metadata: null,
+            nio_last_modified_at: null,
+            delta_dataset_bounds: null,
+            write_mode: "append",
+        },
+        result: {
+            dataset_id: DATASET_ID,
+            snapshot_id: 1724919539450264,
+            recalculation_id: "abf9a2ec-426b-4751-bd16-fcb435061925",
+            row_stats: null,
+        },
+        ...overrides,
+    };
+}
+/**
+ * Estimates what a query would return and what it would cost. The result is a
+ * sum type: this one succeeds, and the failure branch is
+ * `{ failure: { msg: "…" } }`.
+ */
+export function createNqlForecastJob(overrides = {}) {
+    return {
+        ...envelope("2a5b9ad7-0000-4000-8000-000000000002", "nql-forecast"),
+        type: "nql-forecast",
+        input: {
+            nql: 'EXPLAIN SELECT narrative.rosetta_stone."age" FROM narrative.rosetta_stone WHERE narrative.rosetta_stone."age" > 50',
+            compiled_sql: "SELECT\n  `t`.`age`\nFROM\n  narrative.datasets.ds_63 `t`\nWHERE\n  `t`.`age` > 50",
+        },
+        result: {
+            success: {
+                result: { Forecast: { rows: 1643721216, cost: 136130662400 } },
+            },
+        },
+        ...overrides,
+    };
+}
+/** Reads a sample of rows. The rows are stored separately, so only the count comes back. */
+export function createDatasetsSampleJob(overrides = {}) {
+    return {
+        ...envelope("2a5b9ad7-0000-4000-8000-000000000003", "datasets_execute_select"),
+        type: "datasets_sample",
+        input: {
+            dataset_id: DATASET_ID,
+            compiled_sql: "SELECT `ds_10674`.`value` FROM narrative.datasets.ds_10674 `ds_10674` LIMIT 100",
+        },
+        result: { type: "datasets_sample", row_count: 100 },
+        ...overrides,
+    };
+}
+/**
+ * Computes per-column statistics. This one carries the V1 input, which names
+ * the columns and the statistics to collect for each. The V2 input hands the
+ * operator pre-compiled SQL instead: `{ dataset_id, compiled_sql }`.
+ */
+export function createDatasetsCalculateColumnStatsJob(overrides = {}) {
+    return {
+        ...envelope("2a5b9ad7-0000-4000-8000-000000000004", "datasets_calculate_column_stats"),
+        type: "datasets_calculate_column_stats",
+        input: {
+            dataset_id: DATASET_ID,
+            enabled_column_stats: {
+                AGE: {
+                    data_type: "long",
+                    enabled_column_stats: {
+                        nan_value_count: false,
+                        null_value_count: true,
+                        value_count: true,
+                        lower_bound: true,
+                        upper_bound: true,
+                        column_stored_bytes: true,
+                        approx_count_distinct: false,
+                        count_distinct: false,
+                        histogram: false,
+                        mean: false,
+                        standard_deviation: false,
+                        completeness: false,
+                        observed_types: false,
+                    },
+                },
+            },
+        },
+        result: { type: "datasets_calculate_column_stats" },
+        ...overrides,
+    };
+}
+/** Bills a materialized-view refresh, per access rule it read from. */
+export function createCollectAccessRulesBillingDataJob(overrides = {}) {
+    return {
+        ...envelope("2a5b9ad7-0000-4000-8000-000000000005", "materialized_views_collect_access_rules_billing_data"),
+        type: "materialized_views_collect_access_rules_billing_data",
+        input: {
+            dataset_id: DATASET_ID,
+            nio_last_modified_at: "2024-01-28T00:00:00Z",
+            compiled_query: "SELECT `t`.`_nio_access_rule_id` FROM narrative.datasets.ds_10736 `t`",
+            refresh_job_id: "2a5b9ad7-0000-4000-8000-000000000001",
+        },
+        result: {
+            type: "materialized_views_collect_access_rules_billing_data",
+            sources: [
+                {
+                    access_rule_id: 88,
+                    rows: 1200,
+                    price_per_row: { currency: "USD", microcents: 250 },
+                },
+            ],
+        },
+        ...overrides,
+    };
+}
+/** Delivers a dataset snapshot to a connected app. One job per connection. */
+export function createDatasetsDeliverDataJob(overrides = {}) {
+    return {
+        ...envelope("2a5b9ad7-0000-4000-8000-000000000006", "datasets_deliver_data"),
+        type: "datasets_deliver_data",
+        input: {
+            app_id: 142,
+            connection_id: "0f1e2d3c-4b5a-4968-9788-6a5b4c3d2e1f",
+            dataset_id: DATASET_ID,
+            external_id: "nio_10736",
+            snapshot_id: "1724919539450264600",
+            maintenance_window_predicate: null,
+        },
+        result: {},
+        ...overrides,
+    };
+}
+/**
+ * Runs one inference call against a model on the data plane.
+ *
+ * `structured_output`, `output_format_schema`, and the tool argument fields are
+ * empty here rather than carrying a payload: the spec types them as an object
+ * with no properties, so no value satisfies them.
+ */
+export function createModelInferenceRunJob(overrides = {}) {
+    return {
+        ...envelope("2a5b9ad7-0000-4000-8000-000000000007", "model_inference_run"),
+        type: "model_inference_run",
+        input: {
+            model: {
+                id: "claude-sonnet-4",
+                binding: {
+                    provider: "bedrock",
+                    model_id: "global.anthropic.claude-sonnet-4",
+                    capabilities: { structured_output_mode: "native" },
+                },
+            },
+            messages: [
+                { role: "user", content: [{ type: "text", text: "Which city?" }] },
+            ],
+            inference_config: {
+                output_format_schema: {},
+                max_tokens: 1024,
+                temperature: null,
+                top_p: null,
+                stop_sequences: null,
+                thinking: null,
+            },
+            tools: null,
+            tool_choice: null,
+        },
+        result: {
+            structured_output: {},
+            usage: {
+                completion_tokens: 907,
+                prompt_tokens: 4849,
+                total_tokens: 5756,
+            },
+            tool_calls: [],
+            stop_reason: "end_turn",
+            produced_blocks: [],
+            final_answer_from: [],
+            failed_structured_output: null,
+        },
+        ...overrides,
+    };
+}
+/** Drops a dataset's underlying table. */
+export function createDatasetsDeleteTableJob(overrides = {}) {
+    return {
+        ...envelope("2a5b9ad7-0000-4000-8000-000000000008", "datasets_delete_table"),
+        type: "datasets_delete_table",
+        input: { external_id: "nio_10736", is_narrative_managed: true },
+        result: {},
+        ...overrides,
+    };
+}
+/** Runs an NQL `DELETE` or `UPDATE` against a dataset. */
+export function createDatasetsExecuteDmlJob(overrides = {}) {
+    return {
+        ...envelope("2a5b9ad7-0000-4000-8000-000000000009", "datasets_execute_dml"),
+        type: "datasets_execute_dml",
+        input: {
+            dataset_id: DATASET_ID,
+            nql: 'DELETE FROM "company_data"."10736" WHERE "age" < 18',
+            compiled_sql: "DELETE FROM narrative.datasets.ds_10736 WHERE age < 18",
+            nio_last_modified_at: null,
+        },
+        result: {
+            type: "datasets_execute_dml",
+            affected_rows: 10,
+            inserted_rows: 0,
+            updated_rows: 0,
+            deleted_rows: 10,
+        },
+        ...overrides,
+    };
+}
+/** Creates a dataset's underlying table. */
+export function createDatasetsCreateTableJob(overrides = {}) {
+    return {
+        ...envelope("2a5b9ad7-0000-4000-8000-00000000000a", "datasets_create_table"),
+        type: "datasets_create_table",
+        input: {
+            dataset_id: DATASET_ID,
+            compiled_sql: "CREATE TABLE narrative.datasets.ds_10736 (age BIGINT)",
+        },
+        result: {},
+        ...overrides,
+    };
+}
+/** Empties a dataset's table, leaving the table itself in place. */
+export function createDatasetsTruncateTableJob(overrides = {}) {
+    return {
+        ...envelope("2a5b9ad7-0000-4000-8000-00000000000b", "datasets_truncate_table"),
+        type: "datasets_truncate_table",
+        input: { dataset_id: DATASET_ID },
+        result: {},
+        ...overrides,
+    };
+}
+/** Drops a table that has outlived its TTL retention policy. */
+export function createDatasetsEnforceTableTtlRetentionPolicyJob(overrides = {}) {
+    return {
+        ...envelope("2a5b9ad7-0000-4000-8000-00000000000c", "datasets_enforce_table_ttl_retention_policy"),
+        type: "datasets_enforce_table_ttl_retention_policy",
+        input: { dataset_id: DATASET_ID, dataset_external_id: "nio_10736" },
+        result: {},
+        ...overrides,
+    };
+}
+/** Deletes rows that have outlived their TTL retention policy. */
+export function createDatasetsEnforceRowTtlRetentionPolicyJob(overrides = {}) {
+    return {
+        ...envelope("2a5b9ad7-0000-4000-8000-00000000000d", "datasets_enforce_row_ttl_retention_policy"),
+        type: "datasets_enforce_row_ttl_retention_policy",
+        input: {
+            dataset_id: DATASET_ID,
+            sql: [
+                "DELETE FROM narrative.datasets.ds_10736 WHERE _nio_last_modified_at < 1706400000000",
+            ],
+        },
+        result: {},
+        ...overrides,
+    };
+}
+/**
+ * Counts how many rows a pending statement would touch. The result carries the
+ * type of the operator that produced it rather than the job's own.
+ *
+ * The API returns the count at `rows[0].values.affected_rows`, which this
+ * fixture cannot express: the spec types `values` as an object with no
+ * properties, so `{}` is the only value that satisfies it. A test asserting on
+ * a count needs to cast the row.
+ */
+export function createDatasetsCalculateAffectedRowsJob(overrides = {}) {
+    return {
+        ...envelope("2a5b9ad7-0000-4000-8000-00000000000e", "datasets_execute_select"),
+        type: "datasets_calculate_affected_rows",
+        input: {
+            compiled_sql: "SELECT COUNT(1) AS affected_rows FROM narrative.datasets.ds_10736",
+            dataset_id: DATASET_ID,
+        },
+        result: { type: "datasets_execute_select", rows: [{ values: {} }] },
+        ...overrides,
+    };
+}
+/**
+ * Fine-tunes a base model and publishes the result. The API stores this job's
+ * result exactly as the training operator posted it, so the spec gives it no
+ * shape and the fixture leaves it null.
+ */
+export function createModelTrainingRunJob(overrides = {}) {
+    return {
+        ...envelope("2a5b9ad7-0000-4000-8000-00000000000f", "model_training_run"),
+        type: "model_training_run",
+        input: {
+            company_id: 1,
+            connections: null,
+            custom_axolotl_config_override: null,
+            dataset_id: DATASET_ID,
+            instance_type: "ml.g5.12xlarge",
+            base_model_id: 57,
+            base_model_repository: {
+                type: "hugging_face",
+                organization: "meta-llama",
+            },
+            base_model_repo_id: "meta-llama/Llama-3.1-8B",
+            trained_model_narrative_repository_model_id: "7d2f1b3c-5e6a-4f8b-9c0d-1e2f3a4b5c6d",
+            trained_model_narrative_repo_id: "1/7d2f1b3c-5e6a-4f8b-9c0d-1e2f3a4b5c6d/1",
+            trained_model_version: 1,
+            trained_model: {
+                name: "churn-predictor",
+                collaborators: {
+                    view: { type: "none" },
+                    train: { type: "none" },
+                    deploy: { type: "none" },
+                },
+                description: null,
+                tags: null,
+                license_id: null,
+            },
+        },
+        result: null,
+        ...overrides,
+    };
+}
+/** Delivers a trained model to a connected app. */
+export function createModelsDeliverModelJob(overrides = {}) {
+    return {
+        ...envelope("2a5b9ad7-0000-4000-8000-000000000010", "models_deliver_model"),
+        type: "models_deliver_model",
+        input: {
+            company_id: 1,
+            app_id: 142,
+            connection_id: "0f1e2d3c-4b5a-4968-9788-6a5b4c3d2e1f",
+            profile_id: "9c1f0a2e-3d4b-4c5a-8e6f-7a8b9c0d1e2f",
+            model_id: "7d2f1b3c-5e6a-4f8b-9c0d-1e2f3a4b5c6d",
+            model_name: "churn-predictor",
+            model_version: 1,
+            quick_settings: null,
+        },
+        result: null,
+        ...overrides,
+    };
+}
+/**
+ * Trains a classifier. Both `input` and `result` are free-form on the wire, so
+ * the defaults here are illustrative rather than a contract.
+ */
+export function createModelsTrainClassifierJob(overrides = {}) {
+    return {
+        ...envelope("2a5b9ad7-0000-4000-8000-000000000011", "models_train_classifier"),
+        type: "models_train_classifier",
+        input: { dataset_id: DATASET_ID, label_column: "CATEGORY" },
+        result: null,
+        ...overrides,
+    };
+}
+/**
+ * A job of a type the spec has no branch for, where `input` and `result` stay
+ * free-form. This is what a job type added after the spec was generated decodes
+ * as. The default is `datasets_execute_select`, a type the backend really runs
+ * and the spec does not describe.
+ *
+ * Undescribed by the spec is not the same as unknown to the SDK: the root entry
+ * point's `isKnownJob` still recognises this default. Override `type` to get a
+ * job neither one knows.
+ */
+export function createOtherJob(overrides = {}) {
+    return {
+        ...envelope("2a5b9ad7-0000-4000-8000-000000000012", "datasets_execute_select"),
+        type: "datasets_execute_select",
+        input: {
+            compiled_sql: "SELECT `t`.`age` FROM narrative.datasets.ds_10736 `t`",
+        },
+        result: { type: "datasets_execute_select", rows: [] },
+        ...overrides,
+    };
+}

package/build/testing/fixtures/model-training.d.ts

@@ -0,0 +1,8 @@
+import type { TrainClassifierResponse } from "../types";
+/**
+ * What `POST /v1/model-training/train-classifier` returns: the id of the
+ * enqueued training job. Everything else about the run — state, metrics, the
+ * trained model — comes back from the jobs API, so pair this with a job
+ * fixture when a test follows the job through.
+ */
+export declare function createTrainClassifierResponse(overrides?: Partial<TrainClassifierResponse>): TrainClassifierResponse;

package/build/testing/fixtures/model-training.js

@@ -0,0 +1,12 @@
+/**
+ * What `POST /v1/model-training/train-classifier` returns: the id of the
+ * enqueued training job. Everything else about the run — state, metrics, the
+ * trained model — comes back from the jobs API, so pair this with a job
+ * fixture when a test follows the job through.
+ */
+export function createTrainClassifierResponse(overrides = {}) {
+    return {
+        job_id: "5f9d1a4e-0000-4000-8000-00000000000b",
+        ...overrides,
+    };
+}

package/build/testing/fixtures/nql.d.ts

@@ -0,0 +1,10 @@
+import type { NqlExecuteResponse } from "../types";
+/**
+ * What `POST /v1/nql/execute` returns: an active workflow the statement was
+ * compiled into, plus the id of the run started for it.
+ *
+ * `archived_at` is present and `null` — the API sends it that way for an active
+ * workflow rather than omitting it, and a mock that left it out would let a
+ * consumer assert `undefined` and still pass.
+ */
+export declare function createNqlExecutionResponse(overrides?: Partial<NqlExecuteResponse>): NqlExecuteResponse;

package/build/testing/fixtures/nql.js

@@ -0,0 +1,37 @@
+const TIMESTAMP = "2026-01-01T00:00:00Z";
+/**
+ * What `POST /v1/nql/execute` returns: an active workflow the statement was
+ * compiled into, plus the id of the run started for it.
+ *
+ * `archived_at` is present and `null` — the API sends it that way for an active
+ * workflow rather than omitting it, and a mock that left it out would let a
+ * consumer assert `undefined` and still pass.
+ */
+export function createNqlExecutionResponse(overrides = {}) {
+    return {
+        id: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+        name: "execute-nql",
+        specification: [
+            "document:",
+            "  dsl: '1.0.0'",
+            "  namespace: nql",
+            "  name: execute-nql",
+            "  version: '1.0.0'",
+            "do:",
+            "  - execute:",
+            "      call: ExecuteDml",
+            "      with:",
+            '        nql: "INSERT INTO \\"company_data\\".\\"1\\" (\\"id\\") VALUES (1)"',
+        ].join("\n"),
+        data_plane_id: "d1e2f3a4-b5c6-7890-abcd-ef1234567890",
+        company_id: 1,
+        created_at: TIMESTAMP,
+        created_by: 1,
+        updated_at: TIMESTAMP,
+        status: "active",
+        archived_at: null,
+        tags: [],
+        run_id: "b7e3f1a2-4c5d-6e7f-8a9b-0c1d2e3f4a5b",
+        ...overrides,
+    };
+}

package/build/testing/index.d.ts

@@ -19,8 +19,20 @@
  * 	}),
  * );
  * ```
+ *
+ * The job factories are standalone: there are no job handlers yet, so a test
+ * seeds one into a handler of its own.
+ *
+ * ```ts
+ * import { http, HttpResponse } from "msw";
+ * import { createMaterializeViewJob } from "@narrative.io/data-collaboration-sdk-ts/testing";
+ *
+ * http.get("*\/jobs/:id", () =>
+ * 	HttpResponse.json(createMaterializeViewJob({ state: "failed" })),
+ * );
+ * ```
  */
-export { createHealthCheckJob, createOwnedDataPlane, createSharedDataPlane, } from "./fixtures";
+export { createCollectAccessRulesBillingDataJob, createDatasetsCalculateAffectedRowsJob, createDatasetsCalculateColumnStatsJob, createDatasetsCreateTableJob, createDatasetsDeleteTableJob, createDatasetsDeliverDataJob, createDatasetsEnforceRowTtlRetentionPolicyJob, createDatasetsEnforceTableTtlRetentionPolicyJob, createDatasetsExecuteDmlJob, createDatasetsSampleJob, createDatasetsTruncateTableJob, createDerivation, createHealthCheckJob, createMaterializeViewJob, createModelInferenceRunJob, createModelsDeliverModelJob, createModelsTrainClassifierJob, createModelTrainingRunJob, createNqlExecutionResponse, createNqlForecastJob, createOtherJob, createOwnedDataPlane, createSharedDataPlane, createTrainClassifierResponse, } from "./fixtures";
 export { createHandlers } from "./handlers";
 export { createDataPlaneHandlers } from "./handlers/data-planes";
-export type { AuthGuard, AuthGuardContext, CreateHandlersOptions, DataPlaneOwnedResponse, DataPlanePlatform, DataPlaneResponse, DataPlaneSharedPlatform, DataPlaneSharedResponse, JobResponse, } from "./types";
+export type { AuthGuard, AuthGuardContext, CollectAccessRulesBillingDataJobResponse, CreateHandlersOptions, DataPlaneOwnedResponse, DataPlanePlatform, DataPlaneResponse, DataPlaneSharedPlatform, DataPlaneSharedResponse, DatasetsCalculateAffectedRowsJobResponse, DatasetsCalculateColumnStatsJobResponse, DatasetsCreateTableJobResponse, DatasetsDeleteTableJobResponse, DatasetsDeliverDataJobResponse, DatasetsEnforceRowTtlRetentionPolicyJobResponse, DatasetsEnforceTableTtlRetentionPolicyJobResponse, DatasetsExecuteDmlJobResponse, DatasetsSampleJobResponse, DatasetsTruncateTableJobResponse, DerivationResponse, HealthCheckJobResponse, JobEnvelope, JobResponse, MaterializeViewJobResponse, ModelInferenceRunJobResponse, ModelsDeliverModelJobResponse, ModelsTrainClassifierJobResponse, ModelTrainingRunJobResponse, NqlExecuteResponse, NqlForecastJobResponse, OtherJobResponse, TrainClassifierResponse, } from "./types";

package/build/testing/index.js

@@ -19,7 +19,19 @@
  * 	}),
  * );
  * ```
+ *
+ * The job factories are standalone: there are no job handlers yet, so a test
+ * seeds one into a handler of its own.
+ *
+ * ```ts
+ * import { http, HttpResponse } from "msw";
+ * import { createMaterializeViewJob } from "@narrative.io/data-collaboration-sdk-ts/testing";
+ *
+ * http.get("*\/jobs/:id", () =>
+ * 	HttpResponse.json(createMaterializeViewJob({ state: "failed" })),
+ * );
+ * ```
  */
-export { createHealthCheckJob, createOwnedDataPlane, createSharedDataPlane, } from "./fixtures";
+export { createCollectAccessRulesBillingDataJob, createDatasetsCalculateAffectedRowsJob, createDatasetsCalculateColumnStatsJob, createDatasetsCreateTableJob, createDatasetsDeleteTableJob, createDatasetsDeliverDataJob, createDatasetsEnforceRowTtlRetentionPolicyJob, createDatasetsEnforceTableTtlRetentionPolicyJob, createDatasetsExecuteDmlJob, createDatasetsSampleJob, createDatasetsTruncateTableJob, createDerivation, createHealthCheckJob, createMaterializeViewJob, createModelInferenceRunJob, createModelsDeliverModelJob, createModelsTrainClassifierJob, createModelTrainingRunJob, createNqlExecutionResponse, createNqlForecastJob, createOtherJob, createOwnedDataPlane, createSharedDataPlane, createTrainClassifierResponse, } from "./fixtures";
 export { createHandlers } from "./handlers";
 export { createDataPlaneHandlers } from "./handlers/data-planes";

package/build/testing/types.d.ts

@@ -31,6 +31,49 @@ export type DataPlanePlatform = components["schemas"]["Platform"];
 export type DataPlaneSharedPlatform = components["schemas"]["PlatformSharedResponse"];
 /** A job as the API returns it, including the one a health check enqueues. */
 export type JobResponse = components["schemas"]["JobResponse"];
+/**
+ * The fields every job carries, whatever its type. Exported so a test can build
+ * a job type the fixtures do not cover without restating the envelope.
+ */
+export type JobEnvelope = components["schemas"]["JobBase"];
+export type MaterializeViewJobResponse = components["schemas"]["MaterializeViewJobResponse"];
+export type NqlForecastJobResponse = components["schemas"]["NqlForecastJobResponse"];
+export type DatasetsSampleJobResponse = components["schemas"]["DatasetsSampleJobResponse"];
+export type DatasetsCalculateColumnStatsJobResponse = components["schemas"]["DatasetsCalculateColumnStatsJobResponse"];
+export type CollectAccessRulesBillingDataJobResponse = components["schemas"]["CollectAccessRulesBillingDataJobResponse"];
+export type DatasetsDeliverDataJobResponse = components["schemas"]["DatasetsDeliverDataJobResponse"];
+export type ModelInferenceRunJobResponse = components["schemas"]["ModelInferenceRunJobResponse"];
+export type DatasetsDeleteTableJobResponse = components["schemas"]["DatasetsDeleteTableJobResponse"];
+export type DatasetsExecuteDmlJobResponse = components["schemas"]["DatasetsExecuteDmlJobResponse"];
+export type DatasetsCreateTableJobResponse = components["schemas"]["DatasetsCreateTableJobResponse"];
+export type DatasetsTruncateTableJobResponse = components["schemas"]["DatasetsTruncateTableJobResponse"];
+export type DatasetsEnforceTableTtlRetentionPolicyJobResponse = components["schemas"]["DatasetsEnforceTableTtlRetentionPolicyJobResponse"];
+export type DatasetsEnforceRowTtlRetentionPolicyJobResponse = components["schemas"]["DatasetsEnforceRowTtlRetentionPolicyJobResponse"];
+export type DatasetsCalculateAffectedRowsJobResponse = components["schemas"]["DatasetsCalculateAffectedRowsJobResponse"];
+export type ModelTrainingRunJobResponse = components["schemas"]["ModelTrainingRunJobResponse"];
+export type ModelsDeliverModelJobResponse = components["schemas"]["ModelsDeliverModelJobResponse"];
+export type ModelsTrainClassifierJobResponse = components["schemas"]["ModelsTrainClassifierJobResponse"];
+export type HealthCheckJobResponse = components["schemas"]["HealthCheckJobResponse"];
+/**
+ * A job whose type the spec does not describe a branch for. Job types are free
+ * strings on the server, so this is what a type added after the spec was
+ * generated decodes as, with `input` and `result` left free-form.
+ */
+export type OtherJobResponse = components["schemas"]["OtherJobResponse"];
+/**
+ * A derivation rule as the API returns it. `warnings` is populated on create
+ * and update responses and empty on reads.
+ */
+export type DerivationResponse = components["schemas"]["DerivationResponse"];
+/**
+ * What `POST /v1/nql/execute` returns — the workflow the statement compiled to,
+ * plus the id of its run. Named after the root entry point's
+ * `NqlExecuteResponse` rather than the generated schema's
+ * `CreateWorkflowResponseWithRunId`, so the two entry points read the same way.
+ */
+export type NqlExecuteResponse = components["schemas"]["CreateWorkflowResponseWithRunId"];
+/** What `POST /v1/model-training/train-classifier` returns. */
+export type TrainClassifierResponse = components["schemas"]["TrainClassifierResponse"];
 export interface AuthGuardContext {
     request: Request;
     /** Cookies msw parsed off the request. */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@narrative.io/data-collaboration-sdk-ts",
-	"version": "4.4.0",
+	"version": "4.5.0",
 	"main": "build/index.js",
 	"repository": "github:narrative-io/data-collaboration-sdk-ts",
 	"source": "src/index.ts",
@@ -29,6 +29,7 @@
 		"./build/data-planes": "./build/data-planes/index.js",
 		"./build/data-streams": "./build/data-streams/index.js",
 		"./build/datasets": "./build/datasets/index.js",
+		"./build/derivations": "./build/derivations/index.js",
 		"./build/encryption-materials": "./build/encryption-materials/index.js",
 		"./build/forecast": "./build/forecast/index.js",
 		"./build/health": "./build/health/index.js",
@@ -60,7 +61,7 @@
 		"./package.json": "./package.json"
 	},
 	"description": "",
-	"packageManager": "bun@1.2.21",
+	"packageManager": "bun@1.3.14",
 	"scripts": {
 		"build": "tsc",
 		"lint": "bunx @biomejs/biome check --write ./src",