dataiku-sdk 0.10.1 → 0.11.0

package/dist/src/client.d.ts

@@ -138,7 +138,7 @@ export declare class DataikuClient {
     get workspaces(): WorkspacesResource;
     get metrics(): MetricsResource;
     get meanings(): MeaningsResource;
-    constructor(config: DataikuClientConfig);
+    constructor(config?: DataikuClientConfig);
     getRequestTimeoutMs(): number;
     resolveProjectKey(paramValue?: string): string;
     get<T = unknown>(path: string): Promise<T>;

package/dist/src/client.js

@@ -270,22 +270,23 @@ export class DataikuClient {
         return (this.meaningsResource ??= new MeaningsResource(this));
     }
     constructor(config) {
-        const url = config.url?.trim();
-        if (!url)
-            throw new Error("DataikuClientConfig.url is required and must not be empty");
-        const apiKey = config.apiKey?.trim();
-        if (!apiKey)
-            throw new Error("DataikuClientConfig.apiKey is required and must not be empty");
+        const envUrl = process.env["DATAIKU_URL"]?.trim();
+        const envApiKey = process.env["DATAIKU_API_KEY"]?.trim();
+        const url = config?.url?.trim() || envUrl;
+        const apiKey = config?.apiKey?.trim() || envApiKey;
+        if (!url || !apiKey) {
+            throw new Error("Dataiku URL and API key are required: pass {url, apiKey} or set DATAIKU_URL/DATAIKU_API_KEY");
+        }
         this.baseUrl = url.replace(/\/+$/, "");
         this.apiKey = apiKey;
-        this.defaultProjectKey = config.projectKey?.trim() || undefined;
-        this.requestTimeoutMs = config.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
-        const rawMax = config.retryMaxAttempts ?? DEFAULT_RETRY_MAX_ATTEMPTS;
+        this.defaultProjectKey = config?.projectKey?.trim() || undefined;
+        this.requestTimeoutMs = config?.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+        const rawMax = config?.retryMaxAttempts ?? DEFAULT_RETRY_MAX_ATTEMPTS;
         this.retryMaxAttempts = Math.min(Math.max(1, rawMax), MAX_RETRY_ATTEMPTS_CAP);
-        this.verbose = config.verbose === true;
-        this.tlsOptions = buildFetchTlsOptions(config);
-        this.onTrace = config.onTrace ?? defaultTrace;
-        this.onValidationWarning = config.onValidationWarning ?? defaultValidationWarning;
+        this.verbose = config?.verbose === true;
+        this.tlsOptions = config ? buildFetchTlsOptions(config) : undefined;
+        this.onTrace = config?.onTrace ?? defaultTrace;
+        this.onValidationWarning = config?.onValidationWarning ?? defaultValidationWarning;
     }
     getRequestTimeoutMs() {
         return this.requestTimeoutMs;

package/dist/src/errors.d.ts

@@ -15,6 +15,12 @@ export interface DataikuRetryMetadata {
     delaysMs: number[];
     timedOut: boolean;
 }
+export declare class ClientValidationError extends Error {
+    readonly code: StableErrorCode;
+    readonly hint?: string;
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, code?: StableErrorCode, hint?: string, details?: Record<string, unknown>);
+}
 export declare function classifyDataikuError(status: number, body: string): DataikuErrorTaxonomy;
 export declare class DataikuError extends Error {
     status: number;

package/dist/src/errors.js

@@ -12,8 +12,71 @@ export function dataikuErrorCode(category) {
             return "internal_error";
     }
 }
+export class ClientValidationError extends Error {
+    code;
+    hint;
+    details;
+    constructor(message, code = "validation_failed", hint, details) {
+        super(message);
+        this.name = "ClientValidationError";
+        this.code = code;
+        this.hint = hint;
+        this.details = details;
+    }
+}
 const TLS_CERTIFICATE_HINT = "TLS certificate verification failed. Trust the DSS/corporate CA with --ca-cert PATH or NODE_EXTRA_CA_CERTS; use --insecure only for temporary troubleshooting.";
 const BUSINESS_APPS_API_UNAVAILABLE_HINT = "Business Apps API is not available on this DSS instance. Use classic app commands or check DSS version/feature availability.";
+const MAX_ERROR_SUMMARY_LENGTH = 200;
+function isHtmlResponseBody(body) {
+    const lowerTrimmed = body.trimStart().slice(0, 500).toLowerCase();
+    return lowerTrimmed.startsWith("<")
+        || lowerTrimmed.includes("<!doctype html")
+        || lowerTrimmed.includes("<html")
+        || lowerTrimmed.includes("<body")
+        || lowerTrimmed.includes("<title");
+}
+function stripServerFilesystemPaths(text) {
+    return text
+        .replace(/\b[A-Za-z]:\\[^\s"'`<>),\]}]+/g, "[server path]")
+        .replace(/(^|[\s("'`[{])\/(?=[^\s"'`<>),\]}]*\/)(?!(?:public|dip|api|backend|auth|login|projects?|datasets?|recipes?|scenarios?|folders?)(?:\/|$))[^\s"'`<>),\]}]+/g, "$1[server path]");
+}
+function decodeHtmlEntities(text) {
+    return text
+        .replace(/&nbsp;/gi, " ")
+        .replace(/&amp;/gi, "&")
+        .replace(/&lt;/gi, "<")
+        .replace(/&gt;/gi, ">")
+        .replace(/&quot;/gi, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&apos;/gi, "'");
+}
+function firstHtmlTextLine(body) {
+    const text = decodeHtmlEntities(body
+        .replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, " ")
+        .replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, " ")
+        .replace(/<[^>]+>/g, "\n"));
+    return text
+        .split(/\r?\n/g)
+        .map((line) => line.trim())
+        .find((line) => line.length > 0);
+}
+function conciseErrorSummary(text) {
+    const sanitized = stripServerFilesystemPaths(text);
+    return sanitized.length > MAX_ERROR_SUMMARY_LENGTH
+        ? `${sanitized.slice(0, MAX_ERROR_SUMMARY_LENGTH)}…`
+        : sanitized;
+}
+function summarizeHtmlErrorBody(body) {
+    const textLine = firstHtmlTextLine(body);
+    if (!textLine)
+        return "HTML error page from DSS";
+    return `HTML error page from DSS: ${conciseErrorSummary(textLine)}`;
+}
+function summarizeErrorText(text) {
+    if (isHtmlResponseBody(text))
+        return summarizeHtmlErrorBody(text);
+    return conciseErrorSummary(text);
+}
 function isCertificateTrustFailure(lowerBody) {
     return lowerBody.includes("unable to verify the first certificate")
         || lowerBody.includes("unable to get local issuer certificate")
@@ -69,6 +132,15 @@ export function classifyDataikuError(status, body) {
             retryHint: "SQL recipes require SQL/Athena-backed input datasets. Use a SQL-compatible input, associate the S3 dataset with Athena, or create a Python recipe for file/S3 inputs.",
         };
     }
+    const isLicenseDenied = status >= 400
+        && lowerBody.includes("license does not allow");
+    if (isLicenseDenied) {
+        return {
+            category: "forbidden",
+            retryable: false,
+            retryHint: "DSS license or enabled features do not allow this operation. Contact a DSS administrator; do not retry unchanged.",
+        };
+    }
     const isMissingDatasetRootPath = status === 500
         && lowerBody.includes("root path of the dataset")
         && lowerBody.includes("does not exist");
@@ -79,10 +151,36 @@ export function classifyDataikuError(status, body) {
             retryHint: "Dataset files are missing on storage. Build/materialize the dataset or upstream recipes before preview/download.",
         };
     }
+    const isReadDirectoryAsFile = status >= 500
+        && lowerBody.includes("cannot read directory as file");
+    if (isReadDirectoryAsFile) {
+        return {
+            category: "validation",
+            retryable: false,
+            retryHint: "The path refers to a directory, not a file. List its contents instead of reading it as a file; do not retry unchanged.",
+        };
+    }
+    const apostropheNormalizedBody = lowerBody.replace(/\\u0027|\u2019/g, "'");
+    const isServerObjectMissingContraction = status >= 500
+        && apostropheNormalizedBody.includes("doesn't exist");
+    if (isServerObjectMissingContraction) {
+        return {
+            category: "not_found",
+            retryable: false,
+            retryHint: "Requested object was not found. Verify the identifier before retrying.",
+        };
+    }
+    const hasServerMissingObjectToken = lowerBody.includes("package")
+        || lowerBody.includes("directory");
+    const hasServerMissingObjectLanguage = lowerBody.includes("does not exist")
+        || lowerBody.includes("not found");
+    const isServerFilesystemNotFoundLike = status >= 500
+        && (lowerBody.includes("not a file")
+            || (hasServerMissingObjectToken && hasServerMissingObjectLanguage));
     const isServerNotFoundLike = status >= 500
         && (lowerBody.includes("not found") || lowerBody.includes("does not exist"))
         && ["dataset", "recipe", "scenario", "project", "folder",].some((token) => lowerBody.includes(token));
-    if (isServerNotFoundLike) {
+    if (isServerFilesystemNotFoundLike || isServerNotFoundLike) {
         return {
             category: "not_found",
             retryable: false,
@@ -133,7 +231,7 @@ export function classifyDataikuError(status, body) {
                 retryHint: BUSINESS_APPS_API_UNAVAILABLE_HINT,
             };
         }
-        const isHtmlGatewayResponse = lowerBody.includes("<!doctype html>");
+        const isHtmlGatewayResponse = isHtmlResponseBody(body);
         return {
             category: "not_found",
             retryable: false,
@@ -195,14 +293,14 @@ export class DataikuError extends Error {
         try {
             const parsed = JSON.parse(body);
             if (parsed.message)
-                return String(parsed.message);
+                return summarizeErrorText(String(parsed.message));
         }
         catch {
             // not JSON — use raw body
         }
         if (!body)
             return "(empty response body)";
-        return body.length > 200 ? `${body.slice(0, 200)}…` : body;
+        return summarizeErrorText(body);
     }
     static formatRetryMetadata(retry) {
         if (!retry)

package/dist/src/index.d.ts

@@ -1,7 +1,7 @@
 export { DataikuClient, type DataikuClientConfig, type DataikuClientTraceEvent, } from "./client.js";
 export { type CredentialValidationOptions, type CredentialValidationResult, validateCredentials, } from "./auth.js";
 export { type DssCredentials, getConfigDir, getCredentialsPath, loadCredentials, saveCredentials, } from "./config.js";
-export { DataikuError, type DataikuErrorCategory, type DataikuErrorTaxonomy, type DataikuRetryMetadata, } from "./errors.js";
+export { ClientValidationError, DataikuError, type DataikuErrorCategory, type DataikuErrorTaxonomy, type DataikuRetryMetadata, } from "./errors.js";
 export { ApiDeployerResource, } from "./resources/api-deployer.js";
 export { ApiServicesResource, } from "./resources/api-services.js";
 export { ApplicationsResource, } from "./resources/applications.js";
@@ -32,9 +32,9 @@ export { VariablesResource, } from "./resources/variables.js";
 export { WebappsResource, } from "./resources/webapps.js";
 export { WikiResource, } from "./resources/wiki.js";
 export { WorkspacesResource, } from "./resources/workspaces.js";
-export { BuildModeSchema, CodeEnvActionResultSchema, CodeEnvCreateOptionsSchema, CodeEnvDetailsSchema, CodeEnvPackageListSchema, CodeEnvSetPackagesOptionsSchema, CodeEnvSummaryArraySchema, CodeEnvSummarySchema, CodeEnvUpdatePackagesOptionsSchema, CodeEnvUsageArraySchema, 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, NotebookSessionArraySchema, NotebookSessionSchema, parseSchema, ProjectDetailsSchema, ProjectMetadataSchema, ProjectSummaryArraySchema, ProjectSummarySchema, ProjectVariablesSchema, RecipeCreateOptionsSchema, RecipeCreateResultSchema, RecipeDetailsSchema, RecipeSummaryArraySchema, RecipeSummarySchema, safeParseSchema, ScenarioDetailsSchema, ScenarioStatusSchema, ScenarioSummaryArraySchema, ScenarioSummarySchema, ScenarioWaitResultSchema, SqlNotebookCellSchema, SqlNotebookContentSchema, SqlNotebookSummaryArraySchema, SqlNotebookSummarySchema, SqlQueryResponseSchema, SqlQueryResultSchema, SqlQuerySchemaSchema, WikiArticleDataArraySchema, WikiArticleDataSchema, WikiArticleMetadataSchema, WikiSettingsSchema, WikiTaxonomyNodeSchema, } from "./schemas.js";
+export { BuildModeSchema, CodeEnvActionResultSchema, CodeEnvCreateOptionsSchema, CodeEnvDetailsSchema, CodeEnvPackageListSchema, CodeEnvSetPackagesOptionsSchema, CodeEnvSummaryArraySchema, CodeEnvSummarySchema, CodeEnvUpdatePackagesOptionsSchema, CodeEnvUsageArraySchema, 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, NotebookSessionArraySchema, NotebookSessionSchema, parseSchema, ProjectDetailsSchema, ProjectMetadataSchema, ProjectSummaryArraySchema, ProjectSummarySchema, ProjectVariablesSchema, RecipeCreateOptionsSchema, RecipeCreateResultSchema, RecipeDetailsSchema, RecipeSummaryArraySchema, RecipeSummarySchema, safeParseSchema, ScenarioDetailsSchema, ScenarioStatusSchema, ScenarioStepRunSchema, ScenarioSummaryArraySchema, ScenarioSummarySchema, ScenarioWaitResultSchema, SqlNotebookCellSchema, SqlNotebookContentSchema, SqlNotebookSummaryArraySchema, SqlNotebookSummarySchema, SqlQueryResponseSchema, SqlQueryResultSchema, SqlQuerySchemaSchema, WikiArticleDataArraySchema, WikiArticleDataSchema, WikiArticleMetadataSchema, WikiSettingsSchema, WikiTaxonomyNodeSchema, } from "./schemas.js";
 export type { SafeParseResult, } from "./schemas.js";
-export type { BuildMode, CodeEnvActionResult, CodeEnvCreateOptions, CodeEnvDetails, CodeEnvPackageList, CodeEnvSetPackagesOptions, CodeEnvSummary, CodeEnvUpdatePackagesOptions, CodeEnvUsage, 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, NotebookSession, ProjectDetails, ProjectMetadata, ProjectSummary, ProjectVariables, RecipeCreateOptions, RecipeCreateResult, RecipeDetails, RecipeSummary, ScenarioDetails, ScenarioStatus, ScenarioSummary, ScenarioWaitResult, SqlNotebookCell, SqlNotebookContent, SqlNotebookSummary, SqlQueryResponse, SqlQueryResult, SqlQuerySchema, WikiArticleData, WikiArticleMetadata, WikiSettings, WikiTaxonomyNode, } from "./schemas.js";
+export type { BuildMode, CodeEnvActionResult, CodeEnvCreateOptions, CodeEnvDetails, CodeEnvPackageList, CodeEnvSetPackagesOptions, CodeEnvSummary, CodeEnvUpdatePackagesOptions, CodeEnvUsage, 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, NotebookSession, ProjectDetails, ProjectMetadata, ProjectSummary, ProjectVariables, RecipeCreateOptions, RecipeCreateResult, RecipeDetails, RecipeSummary, ScenarioDetails, ScenarioStatus, ScenarioStepRun, ScenarioSummary, ScenarioWaitResult, SqlNotebookCell, SqlNotebookContent, SqlNotebookSummary, SqlQueryResponse, SqlQueryResult, SqlQuerySchema, WikiArticleData, WikiArticleMetadata, WikiSettings, WikiTaxonomyNode, } from "./schemas.js";
 export { deepMerge, } from "./utils/deep-merge.js";
 export { type NormalizedFlowEdge, type NormalizedFlowMap, type NormalizedFlowNode, normalizeFlowGraph, } from "./utils/flow-map.js";
 export { sanitizeFileName, } from "./utils/sanitize.js";

package/dist/src/index.js

@@ -4,7 +4,7 @@ export { DataikuClient, } from "./client.js";
 export { validateCredentials, } from "./auth.js";
 export { getConfigDir, getCredentialsPath, loadCredentials, saveCredentials, } from "./config.js";
 // Errors
-export { DataikuError, } from "./errors.js";
+export { ClientValidationError, DataikuError, } from "./errors.js";
 // Resources (for advanced use / extension)
 export { ApiDeployerResource, } from "./resources/api-deployer.js";
 export { ApiServicesResource, } from "./resources/api-services.js";
@@ -37,7 +37,7 @@ export { WebappsResource, } from "./resources/webapps.js";
 export { WikiResource, } from "./resources/wiki.js";
 export { WorkspacesResource, } from "./resources/workspaces.js";
 // Schemas (TypeBox schema objects for runtime validation)
-export { BuildModeSchema, CodeEnvActionResultSchema, CodeEnvCreateOptionsSchema, CodeEnvDetailsSchema, CodeEnvPackageListSchema, CodeEnvSetPackagesOptionsSchema, CodeEnvSummaryArraySchema, CodeEnvSummarySchema, CodeEnvUpdatePackagesOptionsSchema, CodeEnvUsageArraySchema, 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, NotebookSessionArraySchema, NotebookSessionSchema, parseSchema, ProjectDetailsSchema, ProjectMetadataSchema, ProjectSummaryArraySchema, ProjectSummarySchema, ProjectVariablesSchema, RecipeCreateOptionsSchema, RecipeCreateResultSchema, RecipeDetailsSchema, RecipeSummaryArraySchema, RecipeSummarySchema, safeParseSchema, ScenarioDetailsSchema, ScenarioStatusSchema, ScenarioSummaryArraySchema, ScenarioSummarySchema, ScenarioWaitResultSchema, SqlNotebookCellSchema, SqlNotebookContentSchema, SqlNotebookSummaryArraySchema, SqlNotebookSummarySchema, SqlQueryResponseSchema, SqlQueryResultSchema, SqlQuerySchemaSchema, WikiArticleDataArraySchema, WikiArticleDataSchema, WikiArticleMetadataSchema, WikiSettingsSchema, WikiTaxonomyNodeSchema, } from "./schemas.js";
+export { BuildModeSchema, CodeEnvActionResultSchema, CodeEnvCreateOptionsSchema, CodeEnvDetailsSchema, CodeEnvPackageListSchema, CodeEnvSetPackagesOptionsSchema, CodeEnvSummaryArraySchema, CodeEnvSummarySchema, CodeEnvUpdatePackagesOptionsSchema, CodeEnvUsageArraySchema, 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, NotebookSessionArraySchema, NotebookSessionSchema, parseSchema, ProjectDetailsSchema, ProjectMetadataSchema, ProjectSummaryArraySchema, ProjectSummarySchema, ProjectVariablesSchema, RecipeCreateOptionsSchema, RecipeCreateResultSchema, RecipeDetailsSchema, RecipeSummaryArraySchema, RecipeSummarySchema, safeParseSchema, ScenarioDetailsSchema, ScenarioStatusSchema, ScenarioStepRunSchema, ScenarioSummaryArraySchema, ScenarioSummarySchema, ScenarioWaitResultSchema, SqlNotebookCellSchema, SqlNotebookContentSchema, SqlNotebookSummaryArraySchema, SqlNotebookSummarySchema, SqlQueryResponseSchema, SqlQueryResultSchema, SqlQuerySchemaSchema, WikiArticleDataArraySchema, WikiArticleDataSchema, WikiArticleMetadataSchema, WikiSettingsSchema, WikiTaxonomyNodeSchema, } from "./schemas.js";
 // Utilities
 export { deepMerge, } from "./utils/deep-merge.js";
 export { normalizeFlowGraph, } from "./utils/flow-map.js";

package/dist/src/resources/applications.d.ts

@@ -31,7 +31,7 @@ export declare class ApplicationsResource extends BaseResource {
     createInstance(appId: string, body: Record<string, unknown>): Promise<AppInstanceRef>;
     /** Get the manifest for an app instance project. */
     getInstanceManifest(projectKey?: string): Promise<Record<string, unknown>>;
-    /** Save the manifest for an app instance project. */
+    /** Save the manifest for a Dataiku App template project (rejects classic app-instance projects). */
     saveInstanceManifest(manifest: Record<string, unknown>, projectKey?: string): Promise<void>;
     /** Delete an app instance project. */
     deleteInstance(projectKey?: string): Promise<void>;

package/dist/src/resources/applications.js

@@ -1,3 +1,4 @@
+import { ClientValidationError, DataikuError, } from "../errors.js";
 import { BaseResource, } from "./base.js";
 export class ApplicationsResource extends BaseResource {
     /** List all Dataiku Apps. */
@@ -20,12 +21,37 @@ export class ApplicationsResource extends BaseResource {
     async getInstanceManifest(projectKey) {
         return this.client.get(`/public/api/projects/${this.enc(projectKey)}/app-manifest`);
     }
-    /** Save the manifest for an app instance project. */
+    /** Save the manifest for a Dataiku App template project (rejects classic app-instance projects). */
     async saveInstanceManifest(manifest, projectKey) {
+        const currentManifest = await this.getInstanceManifest(projectKey);
+        if (currentManifest.projectAppType === "APP_INSTANCE") {
+            throw new ClientValidationError("Classic Dataiku App instance manifests cannot be saved through the app-manifest endpoint; only Dataiku App template project manifests can be updated.", "validation_failed", "Save against the Dataiku App template project instead; existing classic app-instance manifests are read-only through this endpoint.", { projectAppType: "APP_INSTANCE", projectKey: this.resolveProjectKey(projectKey), });
+        }
         await this.client.putVoid(`/public/api/projects/${this.enc(projectKey)}/app-manifest`, manifest);
     }
     /** Delete an app instance project. */
     async deleteInstance(projectKey) {
+        let manifest;
+        try {
+            manifest = await this.getInstanceManifest(projectKey);
+        }
+        catch (error) {
+            // DSS answers the app-manifest probe with 400 "neither an app template nor an app
+            // instance" for ordinary projects; treat only that as "not an app instance". Rethrow
+            // everything else (404 not-found, transient, permission) so real failures are not masked.
+            if (error instanceof DataikuError && error.status === 400) {
+                manifest = undefined;
+            }
+            else {
+                throw error;
+            }
+        }
+        if (manifest?.projectAppType !== "APP_INSTANCE") {
+            throw new ClientValidationError("Only classic Dataiku App instance projects can be deleted through app delete-instance.", "validation_failed", "Use `dss app delete-instance` only for projects whose app manifest has projectAppType=APP_INSTANCE; use `dss project delete` for ordinary projects.", {
+                projectAppType: manifest?.projectAppType ?? null,
+                projectKey: this.resolveProjectKey(projectKey),
+            });
+        }
         await this.client.del(`/public/api/projects/${this.enc(projectKey)}`);
     }
     /** List all Business Apps. */

package/dist/src/resources/continuous-activities.js

@@ -14,6 +14,7 @@ export class ContinuousActivitiesResource extends BaseResource {
     }
     /** Stop a continuous recipe activity. */
     async stop(recipeId, projectKey) {
+        await this.getStatus(recipeId, projectKey);
         await this.client.postText(`${this.activityPath(recipeId, projectKey)}/stop`);
     }
     activityPath(recipeId, projectKey) {

package/dist/src/resources/data-quality.js

@@ -1,3 +1,4 @@
+import { DataikuError, } from "../errors.js";
 import { DataQualityComputeResultSchema, DataQualityProjectStatusSchema, DataQualityRuleArraySchema, DataQualityRuleResultArraySchema, DataQualityRuleSchema, DataQualityRulesSchema, DataQualityStatusByPartitionSchema, DataQualityStatusSchema, DataQualityTimelineSchema, } from "../schemas.js";
 import { deepMerge, } from "../utils/deep-merge.js";
 import { BaseResource, } from "./base.js";
@@ -49,13 +50,14 @@ export class DataQualityResource extends BaseResource {
     async getRule(datasetName, ruleId, projectKey) {
         const rules = await this.listRules(datasetName, projectKey);
         const rule = rules.find((candidate) => candidate.id === ruleId);
-        if (!rule)
-            throw new Error(`Data quality rule not found: ${ruleId}`);
+        if (!rule) {
+            throw new DataikuError(404, "Not Found", JSON.stringify({ message: `Data quality rule not found: ${ruleId}`, }));
+        }
         return rule;
     }
     async status(datasetName, projectKey) {
         const pk = this.resolveProjectKey(projectKey);
-        const raw = await this.client.get(`${datasetPath(pk, datasetName)}/status`);
+        const raw = await this.client.get(`${datasetPath(pk, datasetName)}/status-by-partition`);
         return this.client.safeParse(DataQualityStatusSchema, raw, "dataQuality.status");
     }
     async statusByPartition(datasetName, opts = {}) {

package/dist/src/resources/datasets.d.ts

@@ -8,6 +8,9 @@ export interface DatasetBuildValidationResult {
     path: string | null;
     formatType: string | null;
     warnings: string[];
+    validationScope: "configuration";
+    materializationChecked: false;
+    note: string;
 }
 export interface DatasetSchemaColumnInput {
     name: string;

package/dist/src/resources/datasets.js

@@ -530,6 +530,9 @@ export class DatasetsResource extends BaseResource {
             path,
             formatType,
             warnings,
+            validationScope: "configuration",
+            materializationChecked: false,
+            note: "Validates build configuration only; it does not verify storage file existence or materialized data.",
         };
     }
     /** Clone dataset settings, preserving connection/storage, format, and schema fields. */

package/dist/src/resources/flow-zones.d.ts

@@ -20,6 +20,6 @@ export declare class FlowZonesResource extends BaseResource {
     moveItems(zoneId: string, items: FlowZoneItemInput[], projectKey?: string): Promise<FlowZone>;
     /** Move a single item into a flow zone. */
     moveItem(zoneId: string, item: FlowZoneItemInput, projectKey?: string): Promise<FlowZone>;
-    /** Get the graph for a single flow zone. */
-    graph(zoneId: string, projectKey?: string): Promise<unknown>;
+    /** Get the full flow graph, or the graph for a single non-default flow zone. */
+    graph(zoneId?: string, projectKey?: string): Promise<unknown>;
 }

package/dist/src/resources/flow-zones.js

@@ -54,8 +54,11 @@ export class FlowZonesResource extends BaseResource {
     async moveItem(zoneId, item, projectKey) {
         return this.moveItems(zoneId, [item,], projectKey);
     }
-    /** Get the graph for a single flow zone. */
+    /** Get the full flow graph, or the graph for a single non-default flow zone. */
     async graph(zoneId, projectKey) {
+        if (zoneId === undefined || zoneId === "default") {
+            return this.client.get(`/public/api/projects/${this.enc(projectKey)}/flow/graph/`);
+        }
         return this.client.get(`/public/api/projects/${this.enc(projectKey)}/flow/zones/${encodeURIComponent(zoneId)}/graph`);
     }
 }

package/dist/src/resources/meanings.d.ts

@@ -37,5 +37,7 @@ export declare class MeaningsResource extends BaseResource {
     create(id: string, label: string, type: MeaningType, body?: MeaningCreateBody): Promise<string>;
     /** Replace a user-defined meaning definition. */
     update(meaningId: string, body: MeaningDefinition): Promise<MeaningDefinition>;
+    /** Delete a user-defined meaning definition. */
+    delete(meaningId: string): Promise<void>;
     private meaningPath;
 }

package/dist/src/resources/meanings.js

@@ -27,6 +27,10 @@ export class MeaningsResource extends BaseResource {
     async update(meaningId, body) {
         return this.client.put(this.meaningPath(meaningId), body);
     }
+    /** Delete a user-defined meaning definition. */
+    async delete(meaningId) {
+        await this.client.del(this.meaningPath(meaningId));
+    }
     meaningPath(meaningId) {
         return `/public/api/meanings/${encodeURIComponent(meaningId)}`;
     }

package/dist/src/resources/notebooks.d.ts

@@ -5,15 +5,11 @@ export declare class NotebooksResource extends BaseResource {
     listJupyter(projectKey?: string): Promise<JupyterNotebookSummary[]>;
     /** Get the full content of a Jupyter notebook. */
     getJupyter(name: string, projectKey?: string): Promise<JupyterNotebookContent>;
+    /** Create a Jupyter notebook. */
+    createJupyter(name: string, content: JupyterNotebookContent, projectKey?: string): Promise<void>;
     /** Save (overwrite) a Jupyter notebook's content. */
     saveJupyter(name: string, content: JupyterNotebookContent, projectKey?: string): Promise<void>;
-    /**
-     * Delete a Jupyter notebook.
-     *
-     * The SDK intentionally does not expose notebook creation as a first-class
-     * resource method yet; integration tests create disposable notebooks through
-     * the documented project-level create endpoint.
-     */
+    /** Delete a Jupyter notebook. */
     deleteJupyter(name: string, projectKey?: string): Promise<void>;
     /**
      * Clear all cell outputs from a Jupyter notebook.
@@ -36,6 +32,8 @@ export declare class NotebooksResource extends BaseResource {
     listSql(projectKey?: string): Promise<SqlNotebookSummary[]>;
     /** Get the full content of a SQL notebook. */
     getSql(id: string, projectKey?: string): Promise<SqlNotebookContent>;
+    /** Create a SQL notebook. */
+    createSql(id: string, content: SqlNotebookContent, projectKey?: string): Promise<void>;
     /** Save (overwrite) a SQL notebook's content. */
     saveSql(id: string, content: SqlNotebookContent, projectKey?: string): Promise<void>;
     /** Delete a SQL notebook. */

package/dist/src/resources/notebooks.js

@@ -13,18 +13,17 @@ export class NotebooksResource extends BaseResource {
         const raw = await this.client.get(`/public/api/projects/${this.enc(projectKey)}/jupyter-notebooks/${nameEnc}`);
         return this.client.safeParse(JupyterNotebookContentSchema, raw, "notebooks.getJupyter");
     }
+    /** Create a Jupyter notebook. */
+    async createJupyter(name, content, projectKey) {
+        const nameEnc = encodeURIComponent(name);
+        await this.client.post(`/public/api/projects/${this.enc(projectKey)}/jupyter-notebooks/${nameEnc}`, content);
+    }
     /** Save (overwrite) a Jupyter notebook's content. */
     async saveJupyter(name, content, projectKey) {
         const nameEnc = encodeURIComponent(name);
         await this.client.putVoid(`/public/api/projects/${this.enc(projectKey)}/jupyter-notebooks/${nameEnc}`, content);
     }
-    /**
-     * Delete a Jupyter notebook.
-     *
-     * The SDK intentionally does not expose notebook creation as a first-class
-     * resource method yet; integration tests create disposable notebooks through
-     * the documented project-level create endpoint.
-     */
+    /** Delete a Jupyter notebook. */
     async deleteJupyter(name, projectKey) {
         const nameEnc = encodeURIComponent(name);
         await this.client.del(`/public/api/projects/${this.enc(projectKey)}/jupyter-notebooks/${nameEnc}`);
@@ -74,6 +73,10 @@ export class NotebooksResource extends BaseResource {
         const raw = await this.client.get(`/public/api/projects/${this.enc(projectKey)}/sql-notebooks/${idEnc}`);
         return this.client.safeParse(SqlNotebookContentSchema, raw, "notebooks.getSql");
     }
+    /** Create a SQL notebook. */
+    async createSql(id, content, projectKey) {
+        await this.client.post(`/public/api/projects/${this.enc(projectKey)}/sql-notebooks/`, { ...content, id, projectKey: this.resolveProjectKey(projectKey), });
+    }
     /** Save (overwrite) a SQL notebook's content. */
     async saveSql(id, content, projectKey) {
         const idEnc = encodeURIComponent(id);

package/dist/src/resources/projects.d.ts

@@ -69,7 +69,7 @@ export declare class ProjectsResource extends BaseResource {
     private postStream;
     private uploadJson;
     /** Create a new project. */
-    createProject(projectKey: string, name: string, ownerLogin?: string, settings?: ProjectLifecycleSettings | null): Promise<string>;
+    createProject(projectKey: string, name: string, ownerLogin: string, settings?: ProjectLifecycleSettings | null): Promise<Record<string, unknown>>;
     /** Delete a project using the lifecycle endpoint. */
     deleteProject(projectKey: string, dropData?: boolean): Promise<void>;
     /** Duplicate a project. */

package/dist/src/resources/projects.js

@@ -130,10 +130,10 @@ export class ProjectsResource extends BaseResource {
     }
     /** Create a new project. */
     async createProject(projectKey, name, ownerLogin, settings) {
-        return this.client.postText("/public/api/projects/", {
+        return this.client.post("/public/api/projects/", {
             projectKey,
             name,
-            owner: ownerLogin ?? null,
+            owner: ownerLogin,
             settings: settings ?? null,
             description: null,
             permissions: [],

package/dist/src/resources/recipes.d.ts

@@ -103,10 +103,10 @@ export declare class RecipesResource extends BaseResource {
     /** Clone recipe graph/settings and optionally clone a dataset output. */
     clone(sourceName: string, opts: RecipeCloneOptions): Promise<RecipeCloneResult>;
     /**
-    * Download a recipe code payload to a local file.
+        * Download a recipe code payload to a local file.
 
-    * Returns the path to the written file.
-    */
+        * Returns the path to the written file.
+        */
     downloadCode(recipeName: string, opts?: {
         outputPath?: string;
         projectKey?: string;

package/dist/src/resources/recipes.js

@@ -147,6 +147,20 @@ function rewriteSqlTableReferences(payload, rewrites) {
     }
     return next;
 }
+function rewritePayloadText(payload, rewrites) {
+    const entries = Object
+        .entries(rewrites)
+        .filter(([from,]) => from.length > 0)
+        .sort(([left,], [right,]) => right.length - left.length);
+    if (entries.length === 0)
+        return payload;
+    const replacements = new Map(entries);
+    const alternatives = entries
+        .map(([from,]) => escapedRegExp(from))
+        .join("|");
+    const pattern = new RegExp(String.raw `(?<![A-Za-z0-9_$])(${alternatives})(?![A-Za-z0-9_$])`, "g");
+    return payload.replace(pattern, (match) => replacements.get(match) ?? match);
+}
 function rewritePayload(payload, rewrites, payloadTextRewrites = {}, recipeType) {
     if (payload === undefined
         || (Object.keys(rewrites).length === 0 && Object.keys(payloadTextRewrites).length === 0)) {
@@ -162,10 +176,7 @@ function rewritePayload(payload, rewrites, payloadTextRewrites = {}, recipeType)
     if (isSqlRecipeType(recipeType)) {
         next = rewriteSqlTableReferences(next, rewrites);
     }
-    for (const [from, to,] of Object.entries(payloadTextRewrites)) {
-        if (from.length > 0)
-            next = next.split(from).join(to);
-    }
+    next = rewritePayloadText(next, payloadTextRewrites);
     return next;
 }
 function cloneRecipeDefinition(recipe, targetName, projectKey, rewrites) {
@@ -553,6 +564,37 @@ export class RecipesResource extends BaseResource {
             await provisionOutputDatasets();
             await createRecipe();
         }
+        // For sync recipes (a 1:1 copy) DSS does not propagate schema on build, so a
+        // schemaless dataset output silently builds to an empty dataset. Copy the
+        // single input's schema onto any schemaless dataset output so the build
+        // materializes rows (mirrors the DSS UI, which sets the sync output schema).
+        let syncOutputSchemaPropagated;
+        if (type.toLowerCase() === "sync" && !outputFolder) {
+            const inputRefs = recipeInputItems({ inputs, }).map((item) => item.ref);
+            const outputDatasetRefs = recipeOutputItems({ outputs, })
+                .filter((item) => item.type !== "MANAGED_FOLDER")
+                .map((item) => item.ref);
+            if (inputRefs.length === 1 && outputDatasetRefs.length > 0) {
+                const inputSchema = await this.client.datasets
+                    .schema(inputRefs[0], pk)
+                    .catch(() => undefined);
+                const inputColumns = inputSchema?.columns;
+                if (inputColumns && inputColumns.length > 0) {
+                    const propagated = [];
+                    for (const ref of outputDatasetRefs) {
+                        const current = await this.client.datasets
+                            .schema(ref, pk)
+                            .catch(() => undefined);
+                        if (current && current.columns.length === 0) {
+                            await this.client.datasets.updateSchema(ref, inputColumns, pk);
+                            propagated.push(ref);
+                        }
+                    }
+                    if (propagated.length > 0)
+                        syncOutputSchemaPropagated = propagated;
+                }
+            }
+        }
         // For join recipes: configure join conditions after creation
         let joinConfigured = false;
         const joinCols = typeof opts.joinOn === "string" ? [opts.joinOn,] : asStringArray(opts.joinOn);
@@ -627,6 +669,7 @@ export class RecipesResource extends BaseResource {
             createdDatasets,
             joinConfigured,
             outputProvisioningFallbackUsed: usedOutputProvisioningFallback,
+            ...(syncOutputSchemaPropagated ? { syncOutputSchemaPropagated, } : {}),
             ...(outputFolder ? { outputFolder, } : {}),
             ...(temporaryOutputDataset ? { temporaryOutputDataset, } : {}),
             ...(temporaryOutputDatasetDeleted !== undefined ? { temporaryOutputDatasetDeleted, } : {}),
@@ -719,10 +762,10 @@ export class RecipesResource extends BaseResource {
         };
     }
     /**
-    * Download a recipe code payload to a local file.
+        * Download a recipe code payload to a local file.
 
-    * Returns the path to the written file.
-    */
+        * Returns the path to the written file.
+        */
     async downloadCode(recipeName, opts) {
         const result = await this.get(recipeName, {
             includePayload: true,