dataiku-sdk 3.3.0 → 3.5.0

package/dist/src/resources/recipes.js

@@ -1,6 +1,6 @@
 import { writeFile, } from "node:fs/promises";
 import { resolve, } from "node:path";
-import { DataikuError, } from "../errors.js";
+import { ClientValidationError, DataikuError, nonJsonResponseBody, unexpectedResponseError, } from "../errors.js";
 import { ProjectMetadataSchema, RecipeSummaryArraySchema, } from "../schemas.js";
 import { deepMerge, } from "../utils/deep-merge.js";
 import { sanitizeFileName, } from "../utils/sanitize.js";
@@ -25,7 +25,13 @@ function asRecord(value) {
 function parseRecipePayload(payload) {
     if (!payload)
         return {};
-    const parsed = JSON.parse(payload);
+    let parsed;
+    try {
+        parsed = JSON.parse(payload);
+    }
+    catch {
+        throw new DataikuError(200, "Invalid JSON response", nonJsonResponseBody(payload));
+    }
     return asRecord(parsed) ?? {};
 }
 function parseJoinKeyPairs(values, optionName = "joinOn") {
@@ -41,8 +47,9 @@ function parseJoinKeyPairs(values, optionName = "joinOn") {
         }
         const left = token.slice(0, eq).trim();
         const right = token.slice(eq + 1).trim();
-        if (!left || !right)
-            throw new Error(`${optionName} values must use COL or LEFT=RIGHT.`);
+        if (!left || !right) {
+            throw new ClientValidationError(`${optionName} values must use COL or LEFT=RIGHT.`, "validation_failed");
+        }
         pairs.push({ left, right, });
     }
     return pairs;
@@ -57,7 +64,7 @@ function normalizeFuzzyDistance(value) {
         || normalized === "EUCLIDEAN") {
         return normalized;
     }
-    throw new Error("fuzzyDistance must be one of DAMERAU_LEVENSHTEIN, HAMMING, JACCARD, COSINE, or EUCLIDEAN.");
+    throw new ClientValidationError("fuzzyDistance must be one of DAMERAU_LEVENSHTEIN, HAMMING, JACCARD, COSINE, or EUCLIDEAN.", "validation_failed");
 }
 function normalizeJoinType(value) {
     const normalized = typeof value === "string" && value.trim().length > 0
@@ -67,7 +74,7 @@ function normalizeJoinType(value) {
         || normalized === "FULL") {
         return normalized;
     }
-    throw new Error("joinType must be one of LEFT, INNER, RIGHT, or FULL.");
+    throw new ClientValidationError("joinType must be one of LEFT, INNER, RIGHT, or FULL.", "validation_failed");
 }
 function recipeVirtualInputs(payload, inputCount) {
     const current = Array.isArray(payload.virtualInputs) ? payload.virtualInputs : [];
@@ -208,7 +215,7 @@ function rewriteSqlTableReferences(payload, rewrites) {
                 return `${keyword}${space}[${escapedTo}]`;
             }
             if (!bareIdentifierPattern.test(to)) {
-                throw new Error(`Unsafe SQL rewrite target for ${from}: ${to}`);
+                throw new ClientValidationError(`Unsafe SQL rewrite target for ${from}: ${to}`, "validation_failed");
             }
             return `${keyword}${space}${to}`;
         });
@@ -292,6 +299,96 @@ function shouldRetryRecipeCreateWithOutputProvisioning(error) {
 // ---------------------------------------------------------------------------
 // Resource
 // ---------------------------------------------------------------------------
+/**
+ * Pure request construction for POST /recipes/ (no DSS calls). Shared with
+ * `recipe create --plan` so the plan equals the request the command sends.
+ */
+export function buildRecipeCreateRequest(opts, pk) {
+    const { type, payload, outputConnection: rawConnection, joinType: rawJoinType, } = opts;
+    const outputFolder = asString(opts.outputFolder);
+    // Build inputs/outputs from simple form (inputDatasets + outputDataset) or
+    // advanced form (inputs + outputs); both may coexist — simple form wins when
+    // the advanced form is absent.
+    const inputDatasets = asStringArray(opts.inputDatasets);
+    const requestedOutputDataset = asString(opts.outputDataset);
+    let inputs = asRecord(opts.inputs);
+    let outputs = asRecord(opts.outputs);
+    if (!inputs) {
+        inputs = {
+            main: {
+                items: inputDatasets?.map((ref) => ({ ref, deps: [], })) ?? [],
+            },
+        };
+    }
+    // Auto-generate name if not provided
+    const outputNameForDefaultRecipe = requestedOutputDataset ?? outputFolder;
+    const name = opts.name ?? (type && outputNameForDefaultRecipe
+        ? `${type}_${outputNameForDefaultRecipe}`
+        : undefined);
+    const temporaryOutputDataset = outputFolder && !requestedOutputDataset && name
+        ? `${name}_folder_output_marker`
+        : undefined;
+    const outputDataset = requestedOutputDataset ?? temporaryOutputDataset;
+    if (!outputs && outputDataset) {
+        outputs = {
+            main: {
+                items: [{ ref: outputDataset, appendMode: false, },],
+            },
+        };
+    }
+    if (!type || !name || !outputs) {
+        throw new ClientValidationError("type and outputDataset/outputFolder or (name + outputs) are required for create.", "validation_failed");
+    }
+    const joinCols = typeof opts.joinOn === "string" ? [opts.joinOn,] : asStringArray(opts.joinOn);
+    const joinKeys = type === "join" && joinCols?.length
+        ? parseJoinKeyPairs(joinCols)
+        : undefined;
+    const fuzzyOn = opts.fuzzyOn ?? (type === "fuzzyjoin" ? opts.joinOn : undefined);
+    const fuzzyCols = typeof fuzzyOn === "string" ? [fuzzyOn,] : asStringArray(fuzzyOn);
+    const fuzzyKeys = type === "fuzzyjoin" && fuzzyCols?.length
+        ? parseJoinKeyPairs(fuzzyCols, "fuzzyOn")
+        : undefined;
+    const normalizedJoinType = joinKeys?.length || fuzzyKeys?.length
+        ? normalizeJoinType(rawJoinType)
+        : undefined;
+    const fuzzyDistance = fuzzyKeys?.length ? normalizeFuzzyDistance(opts.fuzzyDistance) : undefined;
+    const fuzzyThreshold = opts.fuzzyThreshold ?? 1;
+    if (!Number.isFinite(fuzzyThreshold)) {
+        throw new ClientValidationError("fuzzyThreshold must be a finite number.", "validation_failed");
+    }
+    const recipePrototype = {
+        type,
+        name,
+        projectKey: pk,
+        ...(type === "fuzzyjoin" ? {} : { inputs, }),
+        outputs,
+    };
+    const creationSettings = {};
+    if (payload !== undefined) {
+        creationSettings.script = payload;
+    }
+    if (type === "fuzzyjoin") {
+        creationSettings.virtualInputs = recipeInputItems({ inputs, }).map((item) => item.ref);
+    }
+    return {
+        creationSettings,
+        fuzzyDistance,
+        fuzzyKeys,
+        fuzzyThreshold,
+        inputDatasets,
+        inputs,
+        joinKeys,
+        name,
+        normalizedJoinType,
+        outputFolder,
+        outputs,
+        payload,
+        rawConnection,
+        recipePrototype,
+        temporaryOutputDataset,
+        type,
+    };
+}
 export class RecipesResource extends BaseResource {
     /** List all recipes in a project. */
     async list(projectKey) {
@@ -433,7 +530,7 @@ export class RecipesResource extends BaseResource {
         const { recipe, } = await this.get(recipeName, { projectKey: pk, });
         const outputItems = recipeOutputItems(recipe);
         if (outputItems.length === 0) {
-            throw new Error(`Recipe "${recipeName}" has no output items to build.`);
+            throw new ClientValidationError(`Recipe "${recipeName}" has no output items to build.`, "validation_failed");
         }
         const [datasets, folders,] = await Promise.all([
             this.client.datasets.list(pk),
@@ -483,7 +580,7 @@ export class RecipesResource extends BaseResource {
             }
             const isDataset = datasetNames.has(item.ref);
             if (isDataset && folderId) {
-                throw new Error(`Recipe "${recipeName}" output "${item.ref}" matches both a dataset and a managed folder. Add an explicit output type to the recipe definition or build the target directly with --target-type.`);
+                throw new ClientValidationError(`Recipe "${recipeName}" output "${item.ref}" matches both a dataset and a managed folder. Add an explicit output type to the recipe definition or build the target directly with --target-type.`, "validation_failed");
             }
             if (folderId) {
                 return {
@@ -505,7 +602,7 @@ export class RecipesResource extends BaseResource {
                     partition: opts?.partition,
                 };
             }
-            throw new Error(`Recipe "${recipeName}" output "${item.ref}" was not found as a dataset or managed folder in project "${pk}".`);
+            throw new ClientValidationError(`Recipe "${recipeName}" output "${item.ref}" was not found as a dataset or managed folder in project "${pk}".`, "validation_failed");
         });
     }
     /** Run a recipe by building its resolved outputs. */
@@ -543,72 +640,7 @@ export class RecipesResource extends BaseResource {
     async create(opts) {
         const pk = this.resolveProjectKey(opts.projectKey);
         const enc = encodeURIComponent(pk);
-        const { type, payload, outputConnection: rawConnection, joinType: rawJoinType, } = opts;
-        const outputFolder = asString(opts.outputFolder);
-        // Build inputs/outputs from simple form (inputDatasets + outputDataset) or
-        // advanced form (inputs + outputs); both may coexist — simple form wins when
-        // the advanced form is absent.
-        const inputDatasets = asStringArray(opts.inputDatasets);
-        const requestedOutputDataset = asString(opts.outputDataset);
-        let inputs = asRecord(opts.inputs);
-        let outputs = asRecord(opts.outputs);
-        if (!inputs) {
-            inputs = {
-                main: {
-                    items: inputDatasets?.map((ref) => ({ ref, deps: [], })) ?? [],
-                },
-            };
-        }
-        // Auto-generate name if not provided
-        const outputNameForDefaultRecipe = requestedOutputDataset ?? outputFolder;
-        const name = opts.name ?? (type && outputNameForDefaultRecipe
-            ? `${type}_${outputNameForDefaultRecipe}`
-            : undefined);
-        const temporaryOutputDataset = outputFolder && !requestedOutputDataset && name
-            ? `${name}_folder_output_marker`
-            : undefined;
-        const outputDataset = requestedOutputDataset ?? temporaryOutputDataset;
-        if (!outputs && outputDataset) {
-            outputs = {
-                main: {
-                    items: [{ ref: outputDataset, appendMode: false, },],
-                },
-            };
-        }
-        if (!type || !name || !outputs) {
-            throw new Error("type and outputDataset/outputFolder or (name + outputs) are required for create.");
-        }
-        const joinCols = typeof opts.joinOn === "string" ? [opts.joinOn,] : asStringArray(opts.joinOn);
-        const joinKeys = type === "join" && joinCols?.length
-            ? parseJoinKeyPairs(joinCols)
-            : undefined;
-        const fuzzyOn = opts.fuzzyOn ?? (type === "fuzzyjoin" ? opts.joinOn : undefined);
-        const fuzzyCols = typeof fuzzyOn === "string" ? [fuzzyOn,] : asStringArray(fuzzyOn);
-        const fuzzyKeys = type === "fuzzyjoin" && fuzzyCols?.length
-            ? parseJoinKeyPairs(fuzzyCols, "fuzzyOn")
-            : undefined;
-        const normalizedJoinType = joinKeys?.length || fuzzyKeys?.length
-            ? normalizeJoinType(rawJoinType)
-            : undefined;
-        const fuzzyDistance = fuzzyKeys?.length ? normalizeFuzzyDistance(opts.fuzzyDistance) : undefined;
-        const fuzzyThreshold = opts.fuzzyThreshold ?? 1;
-        if (!Number.isFinite(fuzzyThreshold)) {
-            throw new Error("fuzzyThreshold must be a finite number.");
-        }
-        const recipePrototype = {
-            type,
-            name,
-            projectKey: pk,
-            ...(type === "fuzzyjoin" ? {} : { inputs, }),
-            outputs,
-        };
-        const creationSettings = {};
-        if (payload !== undefined) {
-            creationSettings.script = payload;
-        }
-        if (type === "fuzzyjoin") {
-            creationSettings.virtualInputs = recipeInputItems({ inputs, }).map((item) => item.ref);
-        }
+        const { creationSettings, fuzzyDistance, fuzzyKeys, fuzzyThreshold, inputDatasets, inputs, joinKeys, name, normalizedJoinType, outputFolder, outputs, rawConnection, recipePrototype, temporaryOutputDataset, type, } = buildRecipeCreateRequest(opts, pk);
         const createRecipe = () => this.client.post(`/public/api/projects/${enc}/recipes/`, {
             recipePrototype,
             creationSettings,
@@ -695,7 +727,7 @@ export class RecipesResource extends BaseResource {
             const created = await createRecipe();
             const receivedName = asString(created?.["name"]);
             if (!receivedName) {
-                throw new Error('DSS create-recipe response did not include the final recipe name (documented body: {"name": ...}).');
+                throw unexpectedResponseError('DSS create-recipe response did not include the final recipe name (documented body: {"name": ...}).');
             }
             finalRecipeName = receivedName;
         }
@@ -708,7 +740,7 @@ export class RecipesResource extends BaseResource {
             const retryCreated = await createRecipe();
             const retryName = asString(retryCreated?.["name"]);
             if (!retryName) {
-                throw new Error('DSS create-recipe response did not include the final recipe name (documented body: {"name": ...}).', { cause: error, });
+                throw unexpectedResponseError('DSS create-recipe response did not include the final recipe name (documented body: {"name": ...}).');
             }
             finalRecipeName = retryName;
         }
@@ -869,11 +901,11 @@ export class RecipesResource extends BaseResource {
         const current = await this.client.get(`/public/api/projects/${enc}/recipes/${rnEnc}`);
         const currentRecipe = asRecord(current.recipe);
         if (!currentRecipe) {
-            throw new Error(`Recipe "${recipeName}" was not found or returned an empty definition.`);
+            throw new ClientValidationError(`Recipe "${recipeName}" was not found or returned an empty definition.`, "validation_failed");
         }
         const misplacedRecipeFields = rootRecipeDefinitionFields(data);
         if (misplacedRecipeFields.length > 0) {
-            throw new Error(`Recipe fields ${misplacedRecipeFields.join(", ")} must be nested under "recipe". Example: {"recipe":{"outputs":{...},"params":{...}}}`);
+            throw new ClientValidationError(`Recipe fields ${misplacedRecipeFields.join(", ")} must be nested under "recipe". Example: {"recipe":{"outputs":{...},"params":{...}}}`, "validation_failed");
         }
         const mergedRecipe = deepMerge(currentRecipe, asRecord(data.recipe) ?? {});
         const merged = { ...current, ...data, recipe: mergedRecipe, };
@@ -895,7 +927,7 @@ export class RecipesResource extends BaseResource {
         if (opts.outputDataset !== undefined) {
             const outputs = recipeOutputItems(source.recipe).filter((item) => item.type !== "MANAGED_FOLDER");
             if (outputs.length !== 1 && Object.keys(outputRewrites).length === 0) {
-                throw new Error(`Recipe "${sourceName}" has ${outputs.length} dataset outputs; pass explicit outputRewrites instead of outputDataset.`);
+                throw new ClientValidationError(`Recipe "${sourceName}" has ${outputs.length} dataset outputs; pass explicit outputRewrites instead of outputDataset.`, "validation_failed");
             }
             if (outputs[0])
                 outputRewrites[outputs[0].ref] = opts.outputDataset;
@@ -910,7 +942,7 @@ export class RecipesResource extends BaseResource {
         if (opts.copyOutputSettings === true
             && Object.keys(outputRewrites).length > 1
             && (opts.outputPath !== undefined || opts.metastoreTableName !== undefined)) {
-            throw new Error("Cannot reuse --path or --metastore-table for multiple cloned output datasets; pass per-output settings in a separate step.");
+            throw new ClientValidationError("Cannot reuse --path or --metastore-table for multiple cloned output datasets; pass per-output settings in a separate step.", "validation_failed");
         }
         const payloadTextRewrites = {};
         if (opts.payloadTextRewrites)
@@ -956,7 +988,7 @@ export class RecipesResource extends BaseResource {
             projectKey: opts?.projectKey,
         });
         if (!result.payload) {
-            throw new Error(`Recipe "${recipeName}" has no code payload.`);
+            throw new ClientValidationError(`Recipe "${recipeName}" has no code payload.`, "validation_failed");
         }
         const safeRecipeName = sanitizeFileName(recipeName, "recipe");
         const filePath = opts?.outputPath ?? resolve(process.cwd(), `${safeRecipeName}${inferRecipeCodeExtension(result.recipe.type)}`);
@@ -970,7 +1002,7 @@ export class RecipesResource extends BaseResource {
             projectKey: opts?.projectKey,
         });
         if (!result.payload) {
-            throw new Error(`Recipe "${recipeName}" has no code payload.`);
+            throw new ClientValidationError(`Recipe "${recipeName}" has no code payload.`, "validation_failed");
         }
         return result.payload;
     }

package/dist/src/resources/sql.js

@@ -1,4 +1,4 @@
-import { ClientValidationError, DataikuError, } from "../errors.js";
+import { ClientValidationError, DataikuError, nonJsonResponseBody, SQL_QUERY_FAILED_MARKER, } from "../errors.js";
 import { BaseResource, } from "./base.js";
 const UNSUPPORTED_SQL_DATASET_CONNECTION_DETAIL = "neither of sql nor hdfs type";
 /**
@@ -159,7 +159,12 @@ export class SqlResource extends BaseResource {
         if (truncated) {
             throw new DataikuError(0, "Response Too Large", `SQL stream results exceeded the ${maxBytes}-byte response limit and were not parsed.`);
         }
-        return JSON.parse(text);
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            throw new DataikuError(200, "Invalid JSON response", nonJsonResponseBody(text));
+        }
     }
     /**
      * Verify that a query finished successfully server-side.
@@ -173,7 +178,7 @@ export class SqlResource extends BaseResource {
             throw new DataikuError(0, "Response Too Large", `SQL finish-streaming response exceeded the ${maxBytes}-byte response limit.`);
         }
         if (text.length > 0) {
-            throw new Error(`SQL query ${queryId} failed: ${text}`);
+            throw new DataikuError(200, "SQL Query Failed", `${SQL_QUERY_FAILED_MARKER} (${queryId}): ${text}`);
         }
     }
     async executeQuery(opts) {

package/dist/src/resources/statistics.js

@@ -1,4 +1,5 @@
 import { UsageError, } from "../cli/usage.js";
+import { ClientValidationError, } from "../errors.js";
 import { BaseResource, } from "./base.js";
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -36,7 +37,7 @@ export class StatisticsResource extends BaseResource {
     async runWorksheet(datasetName, worksheetId, projectKey) {
         const worksheet = await this.getWorksheet(datasetName, worksheetId, projectKey);
         if (!isRecord(worksheet.rootCard)) {
-            throw new Error("statistics.runWorksheet requires worksheet.rootCard");
+            throw new ClientValidationError("statistics.runWorksheet requires worksheet.rootCard", "validation_failed");
         }
         return this.runCard(datasetName, worksheetId, worksheet.rootCard, projectKey);
     }

package/dist/src/resources/variables.js

@@ -1,3 +1,4 @@
+import { ClientValidationError, } from "../errors.js";
 import { ProjectVariablesSchema, } from "../schemas.js";
 import { BaseResource, } from "./base.js";
 export class VariablesResource extends BaseResource {
@@ -17,7 +18,7 @@ export class VariablesResource extends BaseResource {
             return replaced;
         }
         if (opts.standard === undefined && opts.local === undefined) {
-            throw new Error("At least one of standard or local must be provided");
+            throw new ClientValidationError("At least one of standard or local must be provided", "validation_failed");
         }
         const existing = await this.get(opts.projectKey);
         const merged = {

package/dist/src/resources/webapps.js

@@ -1,10 +1,9 @@
 import { ClientValidationError, } from "../errors.js";
 import { deepMerge, } from "../utils/deep-merge.js";
-import { stableHash, } from "../utils/stable-hash.js";
+import { SHA256_HEX_PATTERN, stableHash, } from "../utils/stable-hash.js";
 import { BaseResource, } from "./base.js";
-const EXPECT_HASH_PATTERN = /^[0-9a-fA-F]{64}$/;
 function assertExpectedHash(id, expectHash, current, projectKey) {
-    if (!EXPECT_HASH_PATTERN.test(expectHash)) {
+    if (!SHA256_HEX_PATTERN.test(expectHash)) {
         throw new ClientValidationError("Expected webapp hash must be a 64-character SHA-256 hex digest.", "validation_failed", "Use the hash value returned by a previous read.", { projectKey, id, });
     }
     const actual = stableHash(current);

package/dist/src/schemas.d.ts

@@ -3,5 +3,4 @@
  * The types package (packages/types/) owns the TypeBox schema definitions.
  * SDK consumers get everything through this re-export.
  */
-export { BuildModeSchema, CodeEnvActionResultSchema, CodeEnvCreateOptionsSchema, CodeEnvDetailsSchema, CodeEnvGetLogOptionsSchema, CodeEnvLogResultSchema, CodeEnvLogSummaryArraySchema, CodeEnvLogSummarySchema, CodeEnvPackageListSchema, CodeEnvSetPackagesOptionsSchema, CodeEnvSummaryArraySchema, CodeEnvSummarySchema, CodeEnvUpdateImagesOptionsSchema, CodeEnvUpdatePackagesOptionsSchema, CodeEnvUsageArraySchema, CodeEnvVersionForProjectSchema, CodeEnvWaitOptionsSchema, ConnectionSummarySchema, DashboardDetailsSchema, DashboardSummaryArraySchema, DashboardSummarySchema, DataQualityComputeResultSchema, DataQualityProjectStatusSchema, DataQualityRuleArraySchema, DataQualityRuleResultArraySchema, DataQualityRuleResultSchema, DataQualityRuleSchema, DataQualityRulesSchema, DataQualityStatusByPartitionSchema, DataQualityStatusSchema, DataQualityTimelineEntrySchema, DataQualityTimelineSchema, DatasetCreateOptionsSchema, DatasetDetailsSchema, DatasetSchemaSchema, DatasetSummaryArraySchema, DatasetSummarySchema, FlowMapOptionsSchema, FlowZoneArraySchema, FlowZoneCreateOptionsSchema, FlowZoneItemSchema, FlowZoneObjectTypeSchema, FlowZonePositionSchema, FlowZoneSchema, FlowZoneUpdateOptionsSchema, FolderCreateOptionsSchema, FolderDetailsSchema, FolderItemArraySchema, FolderItemSchema, FolderSummaryArraySchema, FolderSummarySchema, FutureStateSchema, FutureWaitResultSchema, InsightDetailsSchema, InsightSummaryArraySchema, InsightSummarySchema, JobSummaryArraySchema, JobSummarySchema, JobWaitResultSchema, JupyterCellSchema, JupyterNotebookContentSchema, JupyterNotebookSummaryArraySchema, JupyterNotebookSummarySchema, MacroDefinitionSchema, MacroRunStartSchema, MacroStateSchema, MacroSummaryArraySchema, MacroSummarySchema, MacroWaitResultSchema, NotebookSessionArraySchema, NotebookSessionSchema, parseSchema, ProjectDetailsSchema, ProjectGitActionResultSchema, ProjectGitDiffResultSchema, ProjectGitFutureResponseSchema, ProjectGitFutureStateSchema, ProjectGitLibrariesSchema, ProjectGitLibrarySchema, ProjectGitLogResultSchema, ProjectGitRemoteSchema, ProjectGitStatusSchema, ProjectGitTagSchema, ProjectGitTagsSchema, ProjectMetadataSchema, ProjectSummaryArraySchema, ProjectSummarySchema, ProjectTagsSchema, ProjectVariablesSchema, RecipeCreateOptionsSchema, RecipeCreateResultSchema, RecipeDetailsSchema, RecipeSummaryArraySchema, RecipeSummarySchema, safeParseSchema, ScenarioDetailsSchema, ScenarioStatusSchema, ScenarioStepRunSchema, ScenarioSummaryArraySchema, ScenarioSummarySchema, ScenarioWaitResultSchema, SqlNotebookCellSchema, SqlNotebookContentSchema, SqlNotebookHistorySchema, SqlNotebookSummaryArraySchema, SqlNotebookSummarySchema, SqlQueryResponseSchema, SqlQueryResultSchema, SqlQuerySchemaSchema, WikiArticleDataArraySchema, WikiArticleDataSchema, WikiArticleMetadataSchema, WikiSettingsSchema, WikiTaxonomyNodeSchema, } from "../packages/types/src/index.js";
-export type { BuildMode, CodeEnvActionResult, CodeEnvCreateOptions, CodeEnvDetails, CodeEnvGetLogOptions, CodeEnvLogResult, CodeEnvLogSummary, CodeEnvPackageList, CodeEnvSetPackagesOptions, CodeEnvSummary, CodeEnvUpdateImagesOptions, CodeEnvUpdatePackagesOptions, CodeEnvUsage, CodeEnvVersionForProject, CodeEnvWaitOptions, ConnectionSummary, DashboardDetails, DashboardSummary, DataQualityComputeResult, DataQualityProjectStatus, DataQualityRule, DataQualityRuleResult, DataQualityRules, DataQualityStatus, DataQualityStatusByPartition, DataQualityTimeline, DataQualityTimelineEntry, DatasetCreateOptions, DatasetDetails, DatasetSchema, DatasetSummary, FlowMapOptions, FlowZone, FlowZoneCreateOptions, FlowZoneItem, FlowZoneObjectType, FlowZonePosition, FlowZoneUpdateOptions, FolderCreateOptions, FolderDetails, FolderItem, FolderSummary, FutureState, FutureWaitResult, InsightDetails, InsightSummary, JobSummary, JobWaitResult, JupyterCell, JupyterNotebookContent, JupyterNotebookSummary, MacroDefinition, MacroRunStart, MacroState, MacroSummary, MacroSummaryArray, MacroWaitResult, NotebookSession, ProjectDetails, ProjectGitActionResult, ProjectGitDiffResult, ProjectGitFutureResponse, ProjectGitFutureState, ProjectGitLibraries, ProjectGitLibrary, ProjectGitLogResult, ProjectGitRemote, ProjectGitStatus, ProjectGitTag, ProjectGitTags, ProjectMetadata, ProjectSummary, ProjectTags, ProjectVariables, RecipeCreateOptions, RecipeCreateResult, RecipeDetails, RecipeSummary, SafeParseResult, ScenarioDetails, ScenarioStatus, ScenarioStepRun, ScenarioSummary, ScenarioWaitResult, SqlNotebookCell, SqlNotebookContent, SqlNotebookHistory, SqlNotebookSummary, SqlQueryResponse, SqlQueryResult, SqlQuerySchema, WikiArticleData, WikiArticleMetadata, WikiSettings, WikiTaxonomyNode, } from "../packages/types/src/index.js";
+export * from "../packages/types/src/index.js";

package/dist/src/schemas.js

@@ -3,4 +3,4 @@
  * The types package (packages/types/) owns the TypeBox schema definitions.
  * SDK consumers get everything through this re-export.
  */
-export { BuildModeSchema, CodeEnvActionResultSchema, CodeEnvCreateOptionsSchema, CodeEnvDetailsSchema, CodeEnvGetLogOptionsSchema, CodeEnvLogResultSchema, CodeEnvLogSummaryArraySchema, CodeEnvLogSummarySchema, CodeEnvPackageListSchema, CodeEnvSetPackagesOptionsSchema, CodeEnvSummaryArraySchema, CodeEnvSummarySchema, CodeEnvUpdateImagesOptionsSchema, CodeEnvUpdatePackagesOptionsSchema, CodeEnvUsageArraySchema, CodeEnvVersionForProjectSchema, CodeEnvWaitOptionsSchema, ConnectionSummarySchema, DashboardDetailsSchema, DashboardSummaryArraySchema, DashboardSummarySchema, DataQualityComputeResultSchema, DataQualityProjectStatusSchema, DataQualityRuleArraySchema, DataQualityRuleResultArraySchema, DataQualityRuleResultSchema, DataQualityRuleSchema, DataQualityRulesSchema, DataQualityStatusByPartitionSchema, DataQualityStatusSchema, DataQualityTimelineEntrySchema, DataQualityTimelineSchema, DatasetCreateOptionsSchema, DatasetDetailsSchema, DatasetSchemaSchema, DatasetSummaryArraySchema, DatasetSummarySchema, FlowMapOptionsSchema, FlowZoneArraySchema, FlowZoneCreateOptionsSchema, FlowZoneItemSchema, FlowZoneObjectTypeSchema, FlowZonePositionSchema, FlowZoneSchema, FlowZoneUpdateOptionsSchema, FolderCreateOptionsSchema, FolderDetailsSchema, FolderItemArraySchema, FolderItemSchema, FolderSummaryArraySchema, FolderSummarySchema, FutureStateSchema, FutureWaitResultSchema, InsightDetailsSchema, InsightSummaryArraySchema, InsightSummarySchema, JobSummaryArraySchema, JobSummarySchema, JobWaitResultSchema, JupyterCellSchema, JupyterNotebookContentSchema, JupyterNotebookSummaryArraySchema, JupyterNotebookSummarySchema, MacroDefinitionSchema, MacroRunStartSchema, MacroStateSchema, MacroSummaryArraySchema, MacroSummarySchema, MacroWaitResultSchema, NotebookSessionArraySchema, NotebookSessionSchema, parseSchema, ProjectDetailsSchema, ProjectGitActionResultSchema, ProjectGitDiffResultSchema, ProjectGitFutureResponseSchema, ProjectGitFutureStateSchema, ProjectGitLibrariesSchema, ProjectGitLibrarySchema, ProjectGitLogResultSchema, ProjectGitRemoteSchema, ProjectGitStatusSchema, ProjectGitTagSchema, ProjectGitTagsSchema, ProjectMetadataSchema, ProjectSummaryArraySchema, ProjectSummarySchema, ProjectTagsSchema, ProjectVariablesSchema, RecipeCreateOptionsSchema, RecipeCreateResultSchema, RecipeDetailsSchema, RecipeSummaryArraySchema, RecipeSummarySchema, safeParseSchema, ScenarioDetailsSchema, ScenarioStatusSchema, ScenarioStepRunSchema, ScenarioSummaryArraySchema, ScenarioSummarySchema, ScenarioWaitResultSchema, SqlNotebookCellSchema, SqlNotebookContentSchema, SqlNotebookHistorySchema, SqlNotebookSummaryArraySchema, SqlNotebookSummarySchema, SqlQueryResponseSchema, SqlQueryResultSchema, SqlQuerySchemaSchema, WikiArticleDataArraySchema, WikiArticleDataSchema, WikiArticleMetadataSchema, WikiSettingsSchema, WikiTaxonomyNodeSchema, } from "../packages/types/src/index.js";
+export * from "../packages/types/src/index.js";

package/dist/src/skill.js

@@ -1,8 +1,9 @@
-import { createHash, } from "node:crypto";
 import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
 import { fileURLToPath, } from "node:url";
+import { ClientValidationError, } from "./errors.js";
+import { sha256Hex, } from "./utils/stable-hash.js";
 const SKILL_URLS = [
     new URL("../skills/dataiku-dss/SKILL.md", import.meta.url),
     new URL("../../skills/dataiku-dss/SKILL.md", import.meta.url),
@@ -12,7 +13,7 @@ function skillDirectory() {
         if (fs.existsSync(skillUrl))
             return new URL("./", skillUrl);
     }
-    throw new Error(`Bundled Dataiku skill not found. Checked: ${SKILL_URLS.map((url) => url.pathname).join(", ")}`);
+    throw new ClientValidationError(`Bundled Dataiku skill not found. Checked: ${SKILL_URLS.map((url) => url.pathname).join(", ")}`, "internal_error");
 }
 function skillContent() {
     return fs.readFileSync(new URL("SKILL.md", skillDirectory()), "utf-8");
@@ -102,9 +103,6 @@ export function findWorkspaceRoot(startDir) {
     }
     return startDir;
 }
-function sha256Hex(value) {
-    return createHash("sha256").update(value).digest("hex");
-}
 function skillState(target, expectedSha256) {
     if (!fs.existsSync(target))
         return { status: "missing", };
@@ -127,8 +125,9 @@ function skillFiles() {
             else if (entry.isFile()) {
                 files.set(relativePath, fs.readFileSync(path.join(root, relativePath)));
             }
-            else
-                throw new Error(`Unsupported bundled skill entry: ${relativePath}`);
+            else {
+                throw new ClientValidationError(`Unsupported bundled skill entry: ${relativePath}`, "internal_error");
+            }
         }
     }
     visit("");

package/dist/src/utils/cleanup-ledger.js

@@ -1,5 +1,6 @@
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
+import { ClientValidationError, } from "../errors.js";
 import { canonicalDssUrl, } from "./dss-url.js";
 function isCleanupLedgerEntry(value) {
     if (!value || typeof value !== "object")
@@ -35,11 +36,11 @@ export async function preflightCleanupLedgerPath(filePath) {
     }
     catch (error) {
         if (error.code !== "ENOENT") {
-            throw new Error(`Could not preflight cleanup ledger ${resolved}: ${error instanceof Error ? error.message : String(error)}`, { cause: error, });
+            throw new ClientValidationError(`Could not preflight cleanup ledger ${resolved}: ${error instanceof Error ? error.message : String(error)}`, "validation_failed", undefined, undefined, { cause: error, });
         }
     }
     if (stats?.isDirectory()) {
-        throw new Error(`Cleanup ledger path is a directory, not a file: ${resolved}`);
+        throw new ClientValidationError(`Cleanup ledger path is a directory, not a file: ${resolved}`, "validation_failed");
     }
     if (stats !== undefined) {
         try {
@@ -48,9 +49,9 @@ export async function preflightCleanupLedgerPath(filePath) {
         }
         catch (error) {
             const code = error.code;
-            throw new Error(code === "EACCES" || code === "EPERM"
+            throw new ClientValidationError(code === "EACCES" || code === "EPERM"
                 ? `Cleanup ledger file is not writable: ${resolved}`
-                : `Could not preflight cleanup ledger ${resolved}: ${error instanceof Error ? error.message : String(error)}`, { cause: error, });
+                : `Could not preflight cleanup ledger ${resolved}: ${error instanceof Error ? error.message : String(error)}`, "validation_failed", undefined, undefined, { cause: error, });
         }
         return;
     }
@@ -60,7 +61,7 @@ export async function preflightCleanupLedgerPath(filePath) {
         await fs.rm(probe, { recursive: true, force: true, });
     }
     catch (error) {
-        throw new Error(`Cleanup ledger directory is not writable: ${parent}${error instanceof Error ? ` (${error.message})` : ""}`, { cause: error, });
+        throw new ClientValidationError(`Cleanup ledger directory is not writable: ${parent}${error instanceof Error ? ` (${error.message})` : ""}`, "validation_failed", undefined, undefined, { cause: error, });
     }
 }
 /**
@@ -94,10 +95,10 @@ export async function reserveCleanupLedgerDssUrl(filePath, dssUrl) {
         found = canonicalDssUrl(raw.trim());
     }
     catch (error) {
-        throw new Error("Cleanup ledger DSS binding is invalid.", { cause: error, });
+        throw new ClientValidationError("Cleanup ledger DSS binding is invalid.", "validation_failed", undefined, undefined, { cause: error, });
     }
     if (found !== expected) {
-        throw new Error("Cleanup ledger is reserved for a different DSS server.");
+        throw new ClientValidationError("Cleanup ledger is reserved for a different DSS server.", "validation_failed");
     }
 }
 /**
@@ -140,7 +141,7 @@ export async function readCleanupLedger(filePath) {
         .map((line, index) => {
         const parsed = JSON.parse(line);
         if (!isCleanupLedgerEntry(parsed)) {
-            throw new Error(`Invalid cleanup ledger entry at line ${index + 1}`);
+            throw new ClientValidationError(`Invalid cleanup ledger entry at line ${index + 1}`, "validation_failed");
         }
         return parsed;
     });

package/dist/src/utils/git-reference.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Validate and canonicalize a Git library reference path. This is the single
+ * validator used by both SDK dispatch and CLI mutation planning.
+ *
+ * Strip only the permitted outer '/' separators, then require nonempty
+ * ordinary segments: no empty segments and no '.' or '..' segments. A hostile
+ * path therefore cannot change which API resource a dispatcher's URL
+ * normalization would otherwise select.
+ */
+export declare function validateGitReferencePath(path: string): string;
+/** Validate a Git library reference path and URL-encode it per segment. */
+export declare function encodeGitReferencePath(path: string): string;

package/dist/src/utils/git-reference.js

@@ -0,0 +1,38 @@
+import { ClientValidationError, } from "../errors.js";
+function gitReferencePathError(path, message) {
+    return new ClientValidationError(message, "validation_failed", "Use a Git library reference path relative to the project library root: '/' -separated segment names, with no '.' or '..' segments.", { path, });
+}
+/**
+ * Validate and canonicalize a Git library reference path. This is the single
+ * validator used by both SDK dispatch and CLI mutation planning.
+ *
+ * Strip only the permitted outer '/' separators, then require nonempty
+ * ordinary segments: no empty segments and no '.' or '..' segments. A hostile
+ * path therefore cannot change which API resource a dispatcher's URL
+ * normalization would otherwise select.
+ */
+export function validateGitReferencePath(path) {
+    if (typeof path !== "string" || path.trim() === "") {
+        throw gitReferencePathError(path, "A Git library reference path is required.");
+    }
+    const normalized = path.replace(/^\/+/, "").replace(/\/+$/, "");
+    if (normalized === "") {
+        throw gitReferencePathError(path, "A Git library reference path is required.");
+    }
+    for (const segment of normalized.split("/")) {
+        if (segment === "") {
+            throw gitReferencePathError(path, "A Git library reference path must not contain empty segments (consecutive or repeated '/').");
+        }
+        if (segment === "." || segment === "..") {
+            throw gitReferencePathError(path, "A Git library reference path must not contain '.' or '..' segments.");
+        }
+    }
+    return normalized;
+}
+/** Validate a Git library reference path and URL-encode it per segment. */
+export function encodeGitReferencePath(path) {
+    return validateGitReferencePath(path)
+        .split("/")
+        .map((segment) => encodeURIComponent(segment))
+        .join("/");
+}

package/dist/src/utils/polling.d.ts

@@ -1,3 +1,6 @@
+/** Default fixed poll interval and overall wait budget for long-running DSS operations. */
+export declare const DEFAULT_POLL_INTERVAL_MS = 2000;
+export declare const DEFAULT_TIMEOUT_MS = 120000;
 /**
  * Shared polling helpers used by every long-running wait loop (jobs, futures,
  * scenarios, macros, Visual ML training, Project Git futures).

package/dist/src/utils/polling.js

@@ -1,3 +1,6 @@
+/** Default fixed poll interval and overall wait budget for long-running DSS operations. */
+export const DEFAULT_POLL_INTERVAL_MS = 2_000;
+export const DEFAULT_TIMEOUT_MS = 120_000;
 import { DataikuError, } from "../errors.js";
 /**
  * Shared polling helpers used by every long-running wait loop (jobs, futures,

package/dist/src/utils/project-archive.js

@@ -1,6 +1,6 @@
 import StreamZip from "node-stream-zip";
 import { stat, } from "node:fs/promises";
-import { ClientValidationError, } from "../errors.js";
+import { ClientValidationError, unexpectedResponseError, } from "../errors.js";
 const MANIFEST_MEMBER = "export-manifest.json";
 const DATASETS_ROOT = "project_config/datasets";
 const RECIPES_ROOT = "project_config/recipes";
@@ -144,7 +144,7 @@ function streamMember(zip, entry, accumulate, bufferMaxBytes, limits) {
             return reject(err);
         }
         if (!stm) {
-            return reject(new Error("archive produced no member stream"));
+            return reject(unexpectedResponseError("archive produced no member stream"));
         }
         const stream = stm;
         let bytes = 0;

package/dist/src/utils/stable-hash.d.ts

@@ -1,4 +1,6 @@
-export declare function sha256Hex(value: string): string;
+export declare function sha256Hex(value: string | Uint8Array): string;
+/** Lowercase or uppercase SHA-256 hex digest accepted by every `--expect-hash` guard. */
+export declare const SHA256_HEX_PATTERN: RegExp;
 /** Locale-independent UTF-16 code-unit order for deterministic machine output. */
 export declare function compareStrings(a: string, b: string): number;
 /**

package/dist/src/utils/stable-hash.js

@@ -1,6 +1,8 @@
 export function sha256Hex(value) {
     return new Bun.CryptoHasher("sha256").update(value).digest("hex");
 }
+/** Lowercase or uppercase SHA-256 hex digest accepted by every `--expect-hash` guard. */
+export const SHA256_HEX_PATTERN = /^[0-9a-fA-F]{64}$/;
 /** Locale-independent UTF-16 code-unit order for deterministic machine output. */
 export function compareStrings(a, b) {
     return a < b ? -1 : a > b ? 1 : 0;