dataiku-sdk 3.0.0 → 3.2.0

package/dist/src/errors.js

@@ -8,6 +8,8 @@ export function dataikuErrorCode(category) {
             return "validation_failed";
         case "transient":
             return "transient";
+        case "unexpected_response":
+            return "unexpected_response";
         case "unknown":
             return "internal_error";
     }
@@ -17,11 +19,21 @@ const CANONICAL_STATUS_TEXT = {
     401: "Unauthorized",
     403: "Forbidden",
     404: "Not Found",
+    405: "Method Not Allowed",
+    406: "Not Acceptable",
     408: "Request Timeout",
     409: "Conflict",
+    410: "Gone",
+    412: "Precondition Failed",
+    413: "Payload Too Large",
+    415: "Unsupported Media Type",
+    416: "Range Not Satisfiable",
+    418: "I'm a Teapot",
     422: "Unprocessable Entity",
     425: "Too Early",
+    426: "Upgrade Required",
     429: "Too Many Requests",
+    451: "Unavailable For Legal Reasons",
     500: "Internal Server Error",
     501: "Not Implemented",
     502: "Bad Gateway",
@@ -43,6 +55,12 @@ export class ClientValidationError extends Error {
         this.details = details;
     }
 }
+/**
+ * Message prefix the client stamps on a 2xx body that is not JSON. The
+ * classifier recognizes exactly this prefix, so the parse-failure path and the
+ * taxonomy stay in sync as one contract.
+ */
+export const NON_JSON_RESPONSE_MARKER = "Expected JSON response body but got non-JSON content";
 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;
@@ -141,6 +159,18 @@ export function classifyDataikuError(status, body) {
             retryHint: "Network/transport failure. Retry with backoff and verify DSS URL reachability.",
         };
     }
+    // A 2xx response carrying a non-JSON body is a response-contract violation,
+    // not a transport fault: HTTP succeeded, but an intermediary (proxy, SSO or
+    // login page, HTML gateway) answered in place of the DSS API. Only the client's
+    // own parse-failure marker produces this prefix.
+    if (status >= 200 && status < 300
+        && lowerBody.startsWith(NON_JSON_RESPONSE_MARKER.toLowerCase())) {
+        return {
+            category: "unexpected_response",
+            retryable: false,
+            retryHint: "DSS returned a non-JSON response to a JSON API request (typically a proxy, gateway, or login page). Verify the DSS URL and that no intermediary serves HTML; do not retry unchanged.",
+        };
+    }
     const isSqlInputConnectionMismatch = (status === 400 || status >= 500)
         && lowerBody.includes("s3 dataset")
         && lowerBody.includes("athena connection");
@@ -210,6 +240,8 @@ export function classifyDataikuError(status, body) {
         && (lowerBody.includes("column_not_found")
             || lowerBody.includes("table_not_found")
             || lowerBody.includes("no_such_table")
+            || lowerBody.includes("no such column")
+            || lowerBody.includes("no such table")
             || lowerBody.includes("column does not exist"));
     if (isSqlEngineValidation) {
         return {
@@ -280,6 +312,16 @@ export function classifyDataikuError(status, body) {
             retryHint: "Retry with exponential backoff. If it persists, check DSS availability and upstream proxies.",
         };
     }
+    // Any remaining HTTP error status is an API-contract mismatch: the endpoint,
+    // resource, or DSS feature/version does not support this request. It is
+    // non-retryable — retrying unchanged cannot succeed.
+    if (status >= 400) {
+        return {
+            category: "unexpected_response",
+            retryable: false,
+            retryHint: "The DSS API rejected the request with an unrecognized HTTP status. Verify the endpoint, resource, and DSS feature/version availability; do not retry unchanged.",
+        };
+    }
     return {
         category: "unknown",
         retryable: false,

package/dist/src/index.d.ts

@@ -18,7 +18,7 @@ export { type FlowZoneItemInput, FlowZonesResource, } from "./resources/flow-zon
 export { FoldersResource, } from "./resources/folders.js";
 export { FuturesResource, } from "./resources/futures.js";
 export { InsightsResource, } from "./resources/insights.js";
-export { computeNextPollDelayMs, type JobBuildAndWaitOptions, type JobBuildOptions, type JobBuildTarget, type JobBuildTargetType, type JobLogFilter, type JobLogProgress, type JobLogSummary, JobsResource, parseJobLogProgress, } from "./resources/jobs.js";
+export { computeNextPollDelayMs, type JobBuildAndWaitOptions, type JobBuildOptions, type JobBuildTarget, type JobBuildTargetType, type JobLogFilter, type JobLogProgress, type JobLogSummary, type JobLogUnavailableReason, JobsResource, type JobWaitOutcome, parseJobLogProgress, } from "./resources/jobs.js";
 export { MeaningsResource, } from "./resources/meanings.js";
 export { MetricsResource, } from "./resources/metrics.js";
 export * from "./resources/ml-tasks.js";
@@ -37,10 +37,11 @@ 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, ProjectGitActionResultSchema, ProjectGitDiffResultSchema, ProjectGitFutureResponseSchema, ProjectGitFutureStateSchema, ProjectGitLibrariesSchema, ProjectGitLibrarySchema, ProjectGitLogResultSchema, ProjectGitRemoteSchema, ProjectGitStatusSchema, ProjectGitTagSchema, ProjectGitTagsSchema, 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 { 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, NotebookSessionArraySchema, NotebookSessionSchema, parseSchema, ProjectDetailsSchema, ProjectGitActionResultSchema, ProjectGitDiffResultSchema, ProjectGitFutureResponseSchema, ProjectGitFutureStateSchema, ProjectGitLibrariesSchema, ProjectGitLibrarySchema, ProjectGitLogResultSchema, ProjectGitRemoteSchema, ProjectGitStatusSchema, ProjectGitTagSchema, ProjectGitTagsSchema, ProjectMetadataSchema, ProjectSummaryArraySchema, ProjectSummarySchema, 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 "./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, ProjectGitActionResult, ProjectGitDiffResult, ProjectGitFutureResponse, ProjectGitFutureState, ProjectGitLibraries, ProjectGitLibrary, ProjectGitLogResult, ProjectGitRemote, ProjectGitStatus, ProjectGitTag, ProjectGitTags, 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 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, NotebookSession, ProjectDetails, ProjectGitActionResult, ProjectGitDiffResult, ProjectGitFutureResponse, ProjectGitFutureState, ProjectGitLibraries, ProjectGitLibrary, ProjectGitLogResult, ProjectGitRemote, ProjectGitStatus, ProjectGitTag, ProjectGitTags, 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 AnalyzedFlowMap, type AnalyzedFlowNode, analyzeFlowMap, type FlowMapComponent, type FlowMapDiagnostic, type FlowMapRendering, type FlowMapZone, type FlowRenderFormat, flowTopologyFingerprint, renderFlowMap, } from "./utils/flow-analysis.js";
 export { type NormalizedFlowEdge, type NormalizedFlowMap, type NormalizedFlowNode, normalizeFlowGraph, } from "./utils/flow-map.js";
 export * from "./utils/project-archive.js";
 export { sanitizeFileName, } from "./utils/sanitize.js";

package/dist/src/index.js

@@ -42,9 +42,10 @@ 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, ProjectGitActionResultSchema, ProjectGitDiffResultSchema, ProjectGitFutureResponseSchema, ProjectGitFutureStateSchema, ProjectGitLibrariesSchema, ProjectGitLibrarySchema, ProjectGitLogResultSchema, ProjectGitRemoteSchema, ProjectGitStatusSchema, ProjectGitTagSchema, ProjectGitTagsSchema, 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 { 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, NotebookSessionArraySchema, NotebookSessionSchema, parseSchema, ProjectDetailsSchema, ProjectGitActionResultSchema, ProjectGitDiffResultSchema, ProjectGitFutureResponseSchema, ProjectGitFutureStateSchema, ProjectGitLibrariesSchema, ProjectGitLibrarySchema, ProjectGitLogResultSchema, ProjectGitRemoteSchema, ProjectGitStatusSchema, ProjectGitTagSchema, ProjectGitTagsSchema, ProjectMetadataSchema, ProjectSummaryArraySchema, ProjectSummarySchema, 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 "./schemas.js";
 // Utilities
 export { deepMerge, } from "./utils/deep-merge.js";
+export { analyzeFlowMap, flowTopologyFingerprint, renderFlowMap, } from "./utils/flow-analysis.js";
 export { normalizeFlowGraph, } from "./utils/flow-map.js";
 export * from "./utils/project-archive.js";
 export { sanitizeFileName, } from "./utils/sanitize.js";

package/dist/src/resources/api-services.d.ts

@@ -9,6 +9,32 @@ export interface ApiServicePackageListItem extends Record<string, unknown> {
     packageId?: string;
     serviceId?: string;
 }
+/**
+ * 64-hex SHA-256 hash of the service settings as last fetched, used as a
+ * non-atomic stale-read guard: the write is refused when the settings already
+ * differ at the verification read. DSS exposes no conditional write, so a
+ * writer committing between that read and the PUT is still not detected.
+ */
+export interface ApiServiceSaveOptions {
+    expectHash?: string;
+}
+/** Optional, documented parameters of the package-generation endpoint. */
+export interface ApiServiceCreatePackageOptions {
+    releaseNotes?: string;
+}
+/**
+ * Optional, documented parameter of the package-publish endpoint: the id of
+ * the published service on the API Deployer where the package is deployed
+ * (defaults to the service's own id server-side).
+ */
+export interface ApiServicePublishOptions {
+    publishedServiceId?: string;
+}
+export interface ApiServicePackageListItem extends Record<string, unknown> {
+    id?: string;
+    packageId?: string;
+    serviceId?: string;
+}
 export type ApiServiceActionResult = Record<string, unknown> | undefined;
 export declare class ApiServicesResource extends BaseResource {
     /** List API services in a project. */
@@ -17,24 +43,40 @@ export declare class ApiServicesResource extends BaseResource {
     create(serviceId: string, projectKey?: string): Promise<ApiServiceActionResult>;
     /** Get API service settings, including endpoint definitions. */
     getSettings(serviceId: string, projectKey?: string): Promise<Record<string, unknown>>;
-    /** Save API service settings. */
-    saveSettings(serviceId: string, body: Record<string, unknown>, projectKey?: string): Promise<ApiServiceActionResult>;
+    /**
+     * Save API service settings with explicit replacement semantics: the body
+     * is the complete settings object (fetched via get-settings) and is PUT
+     * as-is. With `expectHash` armed, the settings are read first and their
+     * stable hash must match, or the write is refused before any PUT.
+     */
+    saveSettings(serviceId: string, body: Record<string, unknown>, projectKey?: string, options?: ApiServiceSaveOptions): Promise<ApiServiceActionResult>;
     /** Add a standard prediction endpoint backed by a saved model. */
     addPredictionEndpoint(serviceId: string, endpointId: string, savedModelId: string, projectKey?: string): Promise<ApiServiceActionResult>;
     /** List deployable packages for an API service. */
     listPackages(serviceId: string, projectKey?: string): Promise<ApiServicePackageListItem[]>;
     /** Get an API service package summary. */
     getPackageSummary(serviceId: string, packageId: string, projectKey?: string): Promise<Record<string, unknown>>;
-    /** Create a deployable package from the current service state. */
-    createPackage(serviceId: string, packageId: string, projectKey?: string): Promise<{
+    /**
+     * Create a deployable package from the current service state. The
+     * documented optional `releaseNotes` parameter is forwarded as the
+     * `releaseNotes` query parameter when provided.
+     */
+    createPackage(serviceId: string, packageId: string, projectKey?: string, options?: ApiServiceCreatePackageOptions): Promise<{
         message: string;
     }>;
     /** Delete an API service package. */
     deletePackage(serviceId: string, packageId: string, projectKey?: string): Promise<void>;
     /** Download an API service package archive. */
     downloadPackageArchive(serviceId: string, packageId: string, projectKey?: string): Promise<Response>;
-    /** Publish an API service package to the API Deployer. */
-    publishPackage(serviceId: string, packageId: string, projectKey?: string): Promise<ApiServiceActionResult>;
+    /**
+     * Publish an API service package to the API Deployer. The documented
+     * optional `publishedServiceId` parameter selects the published service
+     * the package is deployed to (a new published service is created when no
+     * match exists; when omitted, the server falls back to the service's own
+     * id). It is forwarded as the `publishedServiceId` query parameter when
+     * provided.
+     */
+    publishPackage(serviceId: string, packageId: string, projectKey?: string, options?: ApiServicePublishOptions): Promise<ApiServiceActionResult>;
     private servicePath;
     private packagePath;
 }

package/dist/src/resources/api-services.js

@@ -1,4 +1,21 @@
+import { ClientValidationError, } from "../errors.js";
+import { stableHash, } from "../utils/stable-hash.js";
 import { BaseResource, } from "./base.js";
+const EXPECT_HASH_PATTERN = /^[0-9a-fA-F]{64}$/;
+function assertExpectedSettingsHash(serviceId, expectHash, current, projectKey) {
+    if (!EXPECT_HASH_PATTERN.test(expectHash)) {
+        throw new ClientValidationError("Expected API service settings hash must be a 64-character SHA-256 hex digest.", "validation_failed", "Use the hash value returned by a previous read.", { projectKey, serviceId, });
+    }
+    const actual = stableHash(current);
+    if (actual !== expectHash.toLowerCase()) {
+        throw new ClientValidationError(`The API service ${JSON.stringify(serviceId)} changed since it was read.`, "validation_failed", "Re-read the service settings and retry with the current hash value.", {
+            projectKey,
+            serviceId,
+            expectedHash: expectHash.toLowerCase(),
+            actualHash: actual,
+        });
+    }
+}
 export class ApiServicesResource extends BaseResource {
     /** List API services in a project. */
     async list(projectKey) {
@@ -12,8 +29,17 @@ export class ApiServicesResource extends BaseResource {
     async getSettings(serviceId, projectKey) {
         return this.client.get(`${this.servicePath(serviceId, projectKey)}/settings`);
     }
-    /** Save API service settings. */
-    async saveSettings(serviceId, body, projectKey) {
+    /**
+     * Save API service settings with explicit replacement semantics: the body
+     * is the complete settings object (fetched via get-settings) and is PUT
+     * as-is. With `expectHash` armed, the settings are read first and their
+     * stable hash must match, or the write is refused before any PUT.
+     */
+    async saveSettings(serviceId, body, projectKey, options = {}) {
+        if (options.expectHash !== undefined) {
+            const current = await this.getSettings(serviceId, projectKey);
+            assertExpectedSettingsHash(serviceId, options.expectHash, current, projectKey);
+        }
         return this.client.put(`${this.servicePath(serviceId, projectKey)}/settings`, body);
     }
     /** Add a standard prediction endpoint backed by a saved model. */
@@ -35,9 +61,17 @@ export class ApiServicesResource extends BaseResource {
     async getPackageSummary(serviceId, packageId, projectKey) {
         return this.client.get(`${this.packagePath(serviceId, packageId, projectKey)}/summary`);
     }
-    /** Create a deployable package from the current service state. */
-    async createPackage(serviceId, packageId, projectKey) {
-        const message = await this.client.postText(this.packagePath(serviceId, packageId, projectKey), {});
+    /**
+     * Create a deployable package from the current service state. The
+     * documented optional `releaseNotes` parameter is forwarded as the
+     * `releaseNotes` query parameter when provided.
+     */
+    async createPackage(serviceId, packageId, projectKey, options = {}) {
+        const params = new URLSearchParams();
+        if (options.releaseNotes !== undefined)
+            params.set("releaseNotes", options.releaseNotes);
+        const query = params.size > 0 ? `?${params.toString()}` : "";
+        const message = await this.client.postText(`${this.packagePath(serviceId, packageId, projectKey)}${query}`, {});
         return { message, };
     }
     /** Delete an API service package. */
@@ -48,9 +82,21 @@ export class ApiServicesResource extends BaseResource {
     async downloadPackageArchive(serviceId, packageId, projectKey) {
         return this.client.stream(`${this.packagePath(serviceId, packageId, projectKey)}/archive`);
     }
-    /** Publish an API service package to the API Deployer. */
-    async publishPackage(serviceId, packageId, projectKey) {
-        return this.client.post(`${this.packagePath(serviceId, packageId, projectKey)}/publish`, {});
+    /**
+     * Publish an API service package to the API Deployer. The documented
+     * optional `publishedServiceId` parameter selects the published service
+     * the package is deployed to (a new published service is created when no
+     * match exists; when omitted, the server falls back to the service's own
+     * id). It is forwarded as the `publishedServiceId` query parameter when
+     * provided.
+     */
+    async publishPackage(serviceId, packageId, projectKey, options = {}) {
+        const params = new URLSearchParams();
+        if (options.publishedServiceId !== undefined) {
+            params.set("publishedServiceId", options.publishedServiceId);
+        }
+        const query = params.size > 0 ? `?${params.toString()}` : "";
+        return this.client.post(`${this.packagePath(serviceId, packageId, projectKey)}/publish${query}`, {});
     }
     servicePath(serviceId, projectKey) {
         return `/public/api/projects/${this.enc(projectKey)}/apiservices/${encodeURIComponent(serviceId)}`;

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

@@ -1,23 +1,68 @@
 import { BaseResource } from "./base.js";
+/**
+ * Optional, documented parameters of the bundle-export endpoint:
+ * - `releaseNotes`: important changes introduced in the bundle;
+ * - `evaluateProjectStandardsChecks`: whether the Project Standards Checks
+ *   applying to the project should run (defaults to true server-side, and the
+ *   official client always sends it).
+ */
+export interface BundleExportOptions {
+    releaseNotes?: string;
+    evaluateProjectStandardsChecks?: boolean;
+}
+/**
+ * Optional, documented parameter of the bundle-publish endpoint: the key of
+ * the published project on the Project Deployer where the bundle is deployed
+ * (a new published project is created when no match exists; when omitted, the
+ * server falls back to the source project's key).
+ */
+export interface BundlePublishOptions {
+    publishedProjectKey?: string;
+}
+/**
+ * Optional, documented parameter of the bundle-activation endpoint: scenario
+ * IDs mapped to whether each scenario should be enabled or disabled upon
+ * activation.
+ */
+export interface BundleActivateOptions {
+    scenariosToEnable?: Record<string, boolean>;
+}
 export declare class BundlesResource extends BaseResource {
     /** List bundles exported from a project on the Design node. */
     listExported(projectKey?: string): Promise<Record<string, unknown>[]>;
-    /** Create or overwrite an exported Design-node bundle. */
-    exportBundle(bundleId: string, projectKey?: string): Promise<void>;
+    /**
+     * Create or overwrite an exported Design-node bundle. The documented
+     * optional parameters are forwarded as query parameters:
+     * `releaseNotes` when provided, and `evaluateProjectStandardsChecks`
+     * (defaults to true, matching the official client which always sends it).
+     */
+    exportBundle(bundleId: string, projectKey?: string, options?: BundleExportOptions): Promise<void>;
     /** Delete an exported Design-node bundle. */
     deleteExported(bundleId: string, projectKey?: string): Promise<void>;
     /** Download an exported Design-node bundle archive. */
     downloadExportedArchive(bundleId: string, projectKey?: string): Promise<Response>;
-    /** Publish a Design-node bundle to the Project Deployer. */
-    publish(bundleId: string, projectKey?: string): Promise<Record<string, unknown>>;
+    /**
+     * Publish a Design-node bundle to the Project Deployer. The documented
+     * optional `publishedProjectKey` parameter selects the published project
+     * the bundle is deployed to (a new published project is created when no
+     * match exists; when omitted, the server falls back to the source
+     * project's key). It is forwarded as the `publishedProjectKey` query
+     * parameter when provided.
+     */
+    publish(bundleId: string, projectKey?: string, options?: BundlePublishOptions): Promise<Record<string, unknown>>;
     /** List bundles imported into a project on the Automation node. */
     listImported(projectKey?: string): Promise<Record<string, unknown>[]>;
     /** Import a server-side bundle archive into an Automation-node project. */
     importFromArchive(archivePath: string, projectKey?: string): Promise<Record<string, unknown>>;
     /** Import a local bundle archive stream into an Automation-node project. */
     importFromStream(filePath: string, projectKey?: string): Promise<void>;
-    /** Activate an imported Automation-node bundle. */
-    activate(bundleId: string, projectKey?: string): Promise<Record<string, unknown>>;
+    /**
+     * Activate an imported Automation-node bundle. The documented optional
+     * `scenariosToEnable` dict (scenario ID → enabled/disabled upon
+     * activation) is forwarded as the `scenariosActiveOnActivation` request
+     * body when provided.
+     */
+    activate(bundleId: string, projectKey?: string, options?: BundleActivateOptions): Promise<Record<string, unknown>>;
     /** Preload an imported Automation-node bundle. */
     preload(bundleId: string, projectKey?: string): Promise<Record<string, unknown>>;
     /** Delete an imported Automation-node bundle. */

package/dist/src/resources/bundles.js

@@ -5,9 +5,18 @@ export class BundlesResource extends BaseResource {
         const res = await this.client.get(`/public/api/projects/${this.enc(projectKey)}/bundles/exported`);
         return res.bundles ?? [];
     }
-    /** Create or overwrite an exported Design-node bundle. */
-    async exportBundle(bundleId, projectKey) {
-        await this.client.putVoid(`/public/api/projects/${this.enc(projectKey)}/bundles/exported/${encodeURIComponent(bundleId)}`, {});
+    /**
+     * Create or overwrite an exported Design-node bundle. The documented
+     * optional parameters are forwarded as query parameters:
+     * `releaseNotes` when provided, and `evaluateProjectStandardsChecks`
+     * (defaults to true, matching the official client which always sends it).
+     */
+    async exportBundle(bundleId, projectKey, options = {}) {
+        const params = new URLSearchParams();
+        if (options.releaseNotes !== undefined)
+            params.set("releaseNotes", options.releaseNotes);
+        params.set("evaluateProjectStandardsChecks", String(options.evaluateProjectStandardsChecks ?? true));
+        await this.client.putVoid(`/public/api/projects/${this.enc(projectKey)}/bundles/exported/${encodeURIComponent(bundleId)}?${params.toString()}`, {});
     }
     /** Delete an exported Design-node bundle. */
     async deleteExported(bundleId, projectKey) {
@@ -17,9 +26,21 @@ export class BundlesResource extends BaseResource {
     async downloadExportedArchive(bundleId, projectKey) {
         return this.client.stream(`/public/api/projects/${this.enc(projectKey)}/bundles/exported/${encodeURIComponent(bundleId)}/archive`);
     }
-    /** Publish a Design-node bundle to the Project Deployer. */
-    async publish(bundleId, projectKey) {
-        return this.client.post(`/public/api/projects/${this.enc(projectKey)}/bundles/${encodeURIComponent(bundleId)}/publish`, {});
+    /**
+     * Publish a Design-node bundle to the Project Deployer. The documented
+     * optional `publishedProjectKey` parameter selects the published project
+     * the bundle is deployed to (a new published project is created when no
+     * match exists; when omitted, the server falls back to the source
+     * project's key). It is forwarded as the `publishedProjectKey` query
+     * parameter when provided.
+     */
+    async publish(bundleId, projectKey, options = {}) {
+        const params = new URLSearchParams();
+        if (options.publishedProjectKey !== undefined) {
+            params.set("publishedProjectKey", options.publishedProjectKey);
+        }
+        const query = params.size > 0 ? `?${params.toString()}` : "";
+        return this.client.post(`/public/api/projects/${this.enc(projectKey)}/bundles/${encodeURIComponent(bundleId)}/publish${query}`, {});
     }
     /** List bundles imported into a project on the Automation node. */
     async listImported(projectKey) {
@@ -34,9 +55,18 @@ export class BundlesResource extends BaseResource {
     async importFromStream(filePath, projectKey) {
         await this.client.upload(`/public/api/projects/${this.enc(projectKey)}/bundles/imported/actions/importFromStream`, filePath);
     }
-    /** Activate an imported Automation-node bundle. */
-    async activate(bundleId, projectKey) {
-        return this.client.post(`/public/api/projects/${this.enc(projectKey)}/bundles/imported/${encodeURIComponent(bundleId)}/actions/activate`, {});
+    /**
+     * Activate an imported Automation-node bundle. The documented optional
+     * `scenariosToEnable` dict (scenario ID → enabled/disabled upon
+     * activation) is forwarded as the `scenariosActiveOnActivation` request
+     * body when provided.
+     */
+    async activate(bundleId, projectKey, options = {}) {
+        const body = options.scenariosToEnable !== undefined
+            && Object.keys(options.scenariosToEnable).length > 0
+            ? { scenariosActiveOnActivation: options.scenariosToEnable, }
+            : {};
+        return this.client.post(`/public/api/projects/${this.enc(projectKey)}/bundles/imported/${encodeURIComponent(bundleId)}/actions/activate`, body);
     }
     /** Preload an imported Automation-node bundle. */
     async preload(bundleId, projectKey) {

package/dist/src/resources/code-envs.d.ts

@@ -1,4 +1,4 @@
-import type { CodeEnvActionResult, CodeEnvCreateOptions, CodeEnvDetails, CodeEnvPackageList, CodeEnvSetPackagesOptions, CodeEnvSummary, CodeEnvUpdatePackagesOptions, CodeEnvWaitOptions } from "../schemas.js";
+import type { CodeEnvActionResult, CodeEnvCreateOptions, CodeEnvDetails, CodeEnvGetLogOptions, CodeEnvLogResult, CodeEnvLogSummary, CodeEnvPackageList, CodeEnvSetPackagesOptions, CodeEnvSummary, CodeEnvUpdateImagesOptions, CodeEnvUpdatePackagesOptions, CodeEnvVersionForProject, CodeEnvWaitOptions } from "../schemas.js";
 import { BaseResource } from "./base.js";
 export declare class CodeEnvsResource extends BaseResource {
     list(opts?: {
@@ -6,9 +6,31 @@ export declare class CodeEnvsResource extends BaseResource {
     }): Promise<CodeEnvSummary[]>;
     get(envLang: string, envName: string): Promise<CodeEnvDetails>;
     getDefinition(envLang: string, envName: string): Promise<Record<string, unknown>>;
+    /** List the build log files DSS keeps for this code environment. */
+    listLogs(envLang: string, envName: string): Promise<CodeEnvLogSummary[]>;
+    /**
+     * Fetch one code-env build log, bounded by default: at most
+     * `maxBytes` bytes (default 10 MiB, 0 disables the cap) and the last
+     * `maxLines` lines (default 500, 0 disables the tail). Returns what was
+     * kept plus the truncation flags so callers can warn instead of
+     * silently losing output.
+     */
+    getLog(envLang: string, envName: string, logName: string, opts?: CodeEnvGetLogOptions): Promise<CodeEnvLogResult>;
+    /**
+     * Rebuild the Docker image(s) of the code environment to match its
+     * settings. `wait: false` returns the raw DSS future payload.
+     */
+    updateImages(envLang: string, envName: string, opts?: CodeEnvUpdateImagesOptions): Promise<CodeEnvActionResult>;
+    /**
+     * Resolve the code-env version a project uses (versioned environments on
+     * automation nodes); empty `version` for unversioned environments.
+     */
+    getVersionForProject(envLang: string, envName: string, projectKey: string): Promise<CodeEnvVersionForProject>;
     create(opts: CodeEnvCreateOptions): Promise<CodeEnvActionResult>;
-    setDefinition(envLang: string, envName: string, definition: Record<string, unknown>): Promise<CodeEnvActionResult>;
-    setPackages(envLang: string, envName: string, packages: CodeEnvPackageList, opts?: Pick<CodeEnvSetPackagesOptions, "installCorePackages">): Promise<CodeEnvActionResult>;
+    setDefinition(envLang: string, envName: string, definition: Record<string, unknown>, opts?: {
+        expectHash?: string;
+    }): Promise<CodeEnvActionResult>;
+    setPackages(envLang: string, envName: string, packages: CodeEnvPackageList, opts?: Pick<CodeEnvSetPackagesOptions, "installCorePackages" | "expectHash">): Promise<CodeEnvActionResult>;
     updatePackages(envLang: string, envName: string, opts?: CodeEnvUpdatePackagesOptions): Promise<CodeEnvActionResult>;
     setJupyterSupport(envLang: string, envName: string, active: boolean, opts?: CodeEnvWaitOptions): Promise<CodeEnvActionResult>;
     delete(envLang: string, envName: string, opts?: CodeEnvWaitOptions): Promise<CodeEnvActionResult>;