dataiku-sdk 3.1.0 → 3.3.0

package/dist/src/errors.d.ts

@@ -18,6 +18,8 @@ export interface DataikuRetryMetadata {
 export interface DataikuErrorTrustedMetadata {
     target?: string;
     elapsedMs?: number;
+    /** Set by the transport when the retained response body is only a bounded prefix. */
+    bodyTruncated?: boolean;
 }
 export declare function canonicalStatusText(status: number): string;
 export declare class ClientValidationError extends Error {
@@ -44,6 +46,7 @@ export declare class DataikuError extends Error {
     requestId?: string;
     readonly trustedTarget?: string;
     readonly trustedElapsedMs?: number;
+    readonly bodyTruncated?: boolean;
     constructor(status: number, statusText: string, body: string, retry?: DataikuRetryMetadata, requestId?: string, trustedMetadata?: DataikuErrorTrustedMetadata);
     get safeMessage(): string;
     private static extractSummary;

package/dist/src/errors.js

@@ -240,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 {
@@ -337,6 +339,7 @@ export class DataikuError extends Error {
     requestId;
     trustedTarget;
     trustedElapsedMs;
+    bodyTruncated;
     constructor(status, statusText, body, retry, requestId, trustedMetadata) {
         const details = DataikuError.buildDetails(status, body, retry);
         super(details.message);
@@ -351,6 +354,7 @@ export class DataikuError extends Error {
         this.requestId = requestId;
         this.trustedTarget = trustedMetadata?.target;
         this.trustedElapsedMs = trustedMetadata?.elapsedMs;
+        this.bodyTruncated = trustedMetadata?.bodyTruncated === true ? true : undefined;
     }
     get safeMessage() {
         const retrySummary = DataikuError.formatRetryMetadata(this.retry);

package/dist/src/index.d.ts

@@ -1,4 +1,4 @@
-export { DataikuClient, type DataikuClientConfig, type DataikuClientTraceEvent, } from "./client.js";
+export { DataikuClient, type DataikuClientConfig, type DataikuClientTraceEvent, type DataikuGetOptions, type UploadFormPart, } from "./client.js";
 export { type CredentialValidationOptions, type CredentialValidationResult, validateCredentials, } from "./auth.js";
 export { type DssCredentials, getConfigDir, getCredentialsPath, loadCredentials, saveCredentials, } from "./config.js";
 export { ClientValidationError, DataikuError, type DataikuErrorCategory, type DataikuErrorTaxonomy, type DataikuRetryMetadata, } from "./errors.js";
@@ -8,38 +8,47 @@ export { ApiServicesResource, } from "./resources/api-services.js";
 export { ApplicationsResource, } from "./resources/applications.js";
 export { BundlesResource, ProjectDeployerResource, } from "./resources/bundles.js";
 export { CodeEnvsResource, } from "./resources/code-envs.js";
-export { type ConnectionSchemaListOptions, ConnectionsResource, type ConnectionTableListOptions, } from "./resources/connections.js";
+export { type ConnectionAdminInput, type ConnectionSchemaListOptions, ConnectionsResource, type ConnectionTableListOptions, } from "./resources/connections.js";
 export { ContinuousActivitiesResource, } from "./resources/continuous-activities.js";
 export { DashboardsResource, } from "./resources/dashboards.js";
+export { type DataCollectionCreateRequest, type DataCollectionObject, type DataCollectionObjectReferenceType, type DataCollectionPermission, type DataCollectionSettings, DataCollectionsResource, type DataCollectionSummary, } from "./resources/data-collections.js";
 export { DataQualityResource, } from "./resources/data-quality.js";
-export { type DatasetBuildValidationResult, type DatasetCloneOptions, type DatasetCloneResult, type DatasetSchemaColumnInput, DatasetsResource, type UploadDatasetFileOptions, type UploadDatasetFileResult, type UploadedFileMetadata, } from "./resources/datasets.js";
+export { type DatasetBuildValidationResult, type DatasetCloneOptions, type DatasetCloneResult, type DatasetManagedCreateOptions, type DatasetManagedCreateResult, type DatasetSchemaColumnInput, DatasetsResource, type UploadDatasetFileOptions, type UploadDatasetFileResult, type UploadedFileMetadata, } from "./resources/datasets.js";
 export { DiscussionsResource, } from "./resources/discussions.js";
 export { type FlowZoneItemInput, FlowZonesResource, } from "./resources/flow-zones.js";
 export { FoldersResource, } from "./resources/folders.js";
 export { FuturesResource, } from "./resources/futures.js";
+export { type DssGroup, type GroupCreateRequest, GroupsResource, } from "./resources/groups.js";
 export { InsightsResource, } from "./resources/insights.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 { 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 * from "./resources/knowledge-banks.js";
+export * from "./resources/llms.js";
+export { type MacroResultOptions, type MacroRunFailure, type MacroRunHandle, type MacroRunOptions, type MacroRunWaitedResult, MacrosResource, type MacroWaitOptions, } from "./resources/macros.js";
 export { MeaningsResource, } from "./resources/meanings.js";
 export { MetricsResource, } from "./resources/metrics.js";
 export * from "./resources/ml-tasks.js";
 export * from "./resources/model-evaluation-stores.js";
 export { NotebooksResource, } from "./resources/notebooks.js";
+export { type PluginCodeEnvCreateOptions, type PluginContentItem, type PluginCreateDevOptions, type PluginFileDetails, type PluginGitInstallOptions, type PluginGitRemote, type PluginMissingType, type PluginProjectScopeOptions, type PluginSettings, PluginsResource, type PluginSummary, type PluginUsage, type PluginUsageReport, } from "./resources/plugins.js";
+export { type ProjectFolder, type ProjectFolderPermission, type ProjectFolderSettings, ProjectFoldersResource, } from "./resources/project-folders.js";
 export * from "./resources/project-git.js";
 export { ProjectLibraryResource, } from "./resources/project-library.js";
 export { type FlowMapResult, type ProjectImportProcessResult, type ProjectImportResult, type ProjectImportSettings, type ProjectImportUploadResult, ProjectsResource, } from "./resources/projects.js";
 export { type RecipeCloneOptions, type RecipeCloneResult, type RecipeGraphReference, type RecipeGraphValidationResult, type RecipeRunOptions, type RecipeRunOutput, type RecipeRunResult, RecipesResource, } from "./resources/recipes.js";
 export * from "./resources/saved-models.js";
-export { normalizeScenarioUpdateData, SCENARIO_CANONICAL_EDITABLE_FIELDS, type ScenarioFieldChange, type ScenarioFieldMismatch, type ScenarioScriptRunResult, ScenariosResource, type ScenarioUpdateNormalization, type ScenarioUpdatePreview, scenarioUpdatePreview, type ScenarioUpdateResult, } from "./resources/scenarios.js";
+export { normalizeScenarioUpdateData, SCENARIO_CANONICAL_EDITABLE_FIELDS, type ScenarioActiveUpdateResult, type ScenarioFieldChange, type ScenarioFieldMismatch, type ScenarioLightStatus, type ScenarioRunDetails, type ScenarioRunLog, type ScenarioRunStepReport, type ScenarioRunSummary, type ScenarioScriptRunResult, ScenariosResource, type ScenarioUpdateNormalization, type ScenarioUpdatePreview, scenarioUpdatePreview, type ScenarioUpdateResult, } from "./resources/scenarios.js";
 export { SqlResource, } from "./resources/sql.js";
 export { StatisticsResource, } from "./resources/statistics.js";
 export { StreamingEndpointsResource, } from "./resources/streaming-endpoints.js";
+export { type DssUser, type ExternalUserEntry, type ProvisionRequest, type UserActivity, type UserCreateRequest, UsersResource, } from "./resources/users.js";
 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, 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 { computeNextPollDelayMs, } from "./utils/polling.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, 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 "./schemas.js";
 export type { SafeParseResult, } 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 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, 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";

package/dist/src/index.js

@@ -15,19 +15,26 @@ export { CodeEnvsResource, } from "./resources/code-envs.js";
 export { ConnectionsResource, } from "./resources/connections.js";
 export { ContinuousActivitiesResource, } from "./resources/continuous-activities.js";
 export { DashboardsResource, } from "./resources/dashboards.js";
+export { DataCollectionsResource, } from "./resources/data-collections.js";
 export { DataQualityResource, } from "./resources/data-quality.js";
 export { DatasetsResource, } from "./resources/datasets.js";
 export { DiscussionsResource, } from "./resources/discussions.js";
 export { FlowZonesResource, } from "./resources/flow-zones.js";
 export { FoldersResource, } from "./resources/folders.js";
 export { FuturesResource, } from "./resources/futures.js";
+export { GroupsResource, } from "./resources/groups.js";
 export { InsightsResource, } from "./resources/insights.js";
-export { computeNextPollDelayMs, JobsResource, parseJobLogProgress, } from "./resources/jobs.js";
+export { JobsResource, parseJobLogProgress, } from "./resources/jobs.js";
+export * from "./resources/knowledge-banks.js";
+export * from "./resources/llms.js";
+export { MacrosResource, } from "./resources/macros.js";
 export { MeaningsResource, } from "./resources/meanings.js";
 export { MetricsResource, } from "./resources/metrics.js";
 export * from "./resources/ml-tasks.js";
 export * from "./resources/model-evaluation-stores.js";
 export { NotebooksResource, } from "./resources/notebooks.js";
+export { PluginsResource, } from "./resources/plugins.js";
+export { ProjectFoldersResource, } from "./resources/project-folders.js";
 export * from "./resources/project-git.js";
 export { ProjectLibraryResource, } from "./resources/project-library.js";
 export { ProjectsResource, } from "./resources/projects.js";
@@ -37,12 +44,14 @@ export { normalizeScenarioUpdateData, SCENARIO_CANONICAL_EDITABLE_FIELDS, Scenar
 export { SqlResource, } from "./resources/sql.js";
 export { StatisticsResource, } from "./resources/statistics.js";
 export { StreamingEndpointsResource, } from "./resources/streaming-endpoints.js";
+export { UsersResource, } from "./resources/users.js";
 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 { computeNextPollDelayMs, } from "./utils/polling.js";
 // Schemas (TypeBox schema objects for runtime validation)
-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 { 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 "./schemas.js";
 // Utilities
 export { deepMerge, } from "./utils/deep-merge.js";
 export { analyzeFlowMap, flowTopologyFingerprint, renderFlowMap, } from "./utils/flow-analysis.js";

package/dist/src/resources/analyses.js

@@ -1,11 +1,4 @@
-import { UsageError, } from "../cli/usage.js";
-import { BaseResource, } from "./base.js";
-function requireNonEmpty(value, name) {
-    if (typeof value !== "string" || value.trim().length === 0) {
-        throw new UsageError(`${name} must be a non-empty string.`, "validation_failed");
-    }
-    return value;
-}
+import { BaseResource, requireNonEmpty, } from "./base.js";
 export class AnalysesResource extends BaseResource {
     /** List visual analyses in a project. */
     async list(projectKey) {

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

@@ -28,7 +28,7 @@ export interface DeleteAppInstanceOptions {
 export type AppManifestReferenceKind = "scenario" | "folder" | "variable";
 /**
  * Source-verifiable app-manifest reference locations. Validation is scoped to
- * homepage tiles so identically named keys in arbitrary custom-form `config`
+ * homepage tiles so identically named keys in arbitrary custom tile `config`
  * objects are never treated as references.
  */
 export declare const APP_MANIFEST_REFERENCE_KEYS: Record<AppManifestReferenceKind, string[]>;
@@ -207,11 +207,13 @@ export declare class ApplicationsResource extends BaseResource {
     setManifestVersion(update: AppManifestVersionUpdate, projectKey?: string): Promise<AppManifestVersionWriteResult>;
     /**
      * Validate source-verifiable references in app homepage tiles:
-     * SCENARIO_RUN scenario IDs, DOWNLOAD_FILE managed-folder IDs, and runtime
-     * form parameter names (which DSS maps to project variables). Arbitrary
-     * custom-form `config` objects remain opaque. The manifest is never mutated.
-     * Missing/malformed references are returned deterministically; a reference
-     * kind with no applicable tiles does not trigger its project API.
+     * SCENARIO_RUN scenario IDs, DOWNLOAD_MANAGED_FOLDER_FILE managed-folder IDs,
+     * and PROJECT_VARIABLES_EDIT parameter names (which DSS maps to project
+     * variables). Tile types outside that set, including custom tiles and their
+     * `config` objects, remain opaque and are never parsed for references. The
+     * manifest is never mutated. Missing/malformed references are returned
+     * deterministically; a reference kind with no applicable tiles does not
+     * trigger its project API.
      */
     validateAppManifest(manifest: unknown, projectKey?: string): Promise<AppManifestValidationResult>;
     /**

package/dist/src/resources/applications.js

@@ -4,13 +4,13 @@ import { compareStrings, stableHash, stableJson, } from "../utils/stable-hash.js
 import { BaseResource, } from "./base.js";
 /**
  * Source-verifiable app-manifest reference locations. Validation is scoped to
- * homepage tiles so identically named keys in arbitrary custom-form `config`
+ * homepage tiles so identically named keys in arbitrary custom tile `config`
  * objects are never treated as references.
  */
 export const APP_MANIFEST_REFERENCE_KEYS = {
     scenario: ["SCENARIO_RUN.scenarioId",],
-    folder: ["DOWNLOAD_FILE.folderId", "DOWNLOAD_FILE.managedFolderId",],
-    variable: ["params[].name",],
+    folder: ["DOWNLOAD_MANAGED_FOLDER_FILE.folderId",],
+    variable: ["PROJECT_VARIABLES_EDIT.params[].name",],
 };
 /**
  * The only concurrency control the public app-manifest endpoint permits. DSS
@@ -382,11 +382,13 @@ export class ApplicationsResource extends BaseResource {
     }
     /**
      * Validate source-verifiable references in app homepage tiles:
-     * SCENARIO_RUN scenario IDs, DOWNLOAD_FILE managed-folder IDs, and runtime
-     * form parameter names (which DSS maps to project variables). Arbitrary
-     * custom-form `config` objects remain opaque. The manifest is never mutated.
-     * Missing/malformed references are returned deterministically; a reference
-     * kind with no applicable tiles does not trigger its project API.
+     * SCENARIO_RUN scenario IDs, DOWNLOAD_MANAGED_FOLDER_FILE managed-folder IDs,
+     * and PROJECT_VARIABLES_EDIT parameter names (which DSS maps to project
+     * variables). Tile types outside that set, including custom tiles and their
+     * `config` objects, remain opaque and are never parsed for references. The
+     * manifest is never mutated. Missing/malformed references are returned
+     * deterministically; a reference kind with no applicable tiles does not
+     * trigger its project API.
      */
     async validateAppManifest(manifest, projectKey) {
         const pk = this.resolveProjectKey(projectKey);
@@ -416,21 +418,19 @@ export class ApplicationsResource extends BaseResource {
                         if (tile["type"] === "SCENARIO_RUN") {
                             collectReferenceValue(tile["scenarioId"], propertyPath(tilePath, "scenarioId"), "scenarioId", "scenario", references, referenceIssues);
                         }
-                        if (tile["type"] === "DOWNLOAD_FILE") {
-                            for (const key of ["folderId", "managedFolderId",]) {
-                                if (!Object.prototype.hasOwnProperty.call(tile, key))
-                                    continue;
-                                collectReferenceValue(tile[key], propertyPath(tilePath, key), key, "folder", references, referenceIssues);
-                            }
+                        if (tile["type"] === "DOWNLOAD_MANAGED_FOLDER_FILE") {
+                            collectReferenceValue(tile["folderId"], propertyPath(tilePath, "folderId"), "folderId", "folder", references, referenceIssues);
                         }
-                        const params = tile["params"];
-                        if (!Array.isArray(params))
-                            continue;
-                        for (let paramIndex = 0; paramIndex < params.length; paramIndex += 1) {
-                            const param = params[paramIndex];
-                            if (!isPlainRecord(param))
+                        if (tile["type"] === "PROJECT_VARIABLES_EDIT") {
+                            const params = tile["params"];
+                            if (!Array.isArray(params))
                                 continue;
-                            collectReferenceValue(param["name"], `${propertyPath(tilePath, "params")}[${paramIndex}]["name"]`, "name", "variable", references, referenceIssues);
+                            for (let paramIndex = 0; paramIndex < params.length; paramIndex += 1) {
+                                const param = params[paramIndex];
+                                if (!isPlainRecord(param))
+                                    continue;
+                                collectReferenceValue(param["name"], `${propertyPath(tilePath, "params")}[${paramIndex}]["name"]`, "name", "variable", references, referenceIssues);
+                            }
                         }
                     }
                 }

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

@@ -1,4 +1,8 @@
 import type { DataikuClient } from "../client.js";
+/** Never disguise an unexpected successful HTTP payload as an empty listing. */
+export declare function requireArrayResponse<T>(value: unknown, operation: string): T[];
+/** Validate identifiers without changing significant whitespace or encoding. */
+export declare function requireNonEmpty(value: unknown, name: string): string;
 export declare abstract class BaseResource {
     protected readonly client: DataikuClient;
     constructor(client: DataikuClient);

package/dist/src/resources/base.js

@@ -1,3 +1,18 @@
+import { ClientValidationError, DataikuError, } from "../errors.js";
+/** Never disguise an unexpected successful HTTP payload as an empty listing. */
+export function requireArrayResponse(value, operation) {
+    if (!Array.isArray(value)) {
+        throw new DataikuError(200, "Unexpected Response", `${operation}: DSS did not return an array.`);
+    }
+    return value;
+}
+/** Validate identifiers without changing significant whitespace or encoding. */
+export function requireNonEmpty(value, name) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new ClientValidationError(`${name} must be a non-empty string.`, "validation_failed");
+    }
+    return value;
+}
 export class BaseResource {
     client;
     constructor(client) {

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

@@ -31,10 +31,15 @@ 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. 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).
+     * Create 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). The official
+     * client sends this PUT without a request body, and this resource
+     * mirrors that; DSS 15 additionally refuses re-exporting an existing
+     * bundle id ("Bundle <id> already exists"), so the documented
+     * "create or overwrite" claim does not hold — callers must delete the
+     * bundle first to replace it.
      */
     exportBundle(bundleId: string, projectKey?: string, options?: BundleExportOptions): Promise<void>;
     /** Delete an exported Design-node bundle. */

package/dist/src/resources/bundles.js

@@ -6,17 +6,22 @@ export class BundlesResource extends BaseResource {
         return res.bundles ?? [];
     }
     /**
-     * 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).
+     * Create 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). The official
+     * client sends this PUT without a request body, and this resource
+     * mirrors that; DSS 15 additionally refuses re-exporting an existing
+     * bundle id ("Bundle <id> already exists"), so the documented
+     * "create or overwrite" claim does not hold — callers must delete the
+     * bundle first to replace 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()}`, {});
+        await this.client.putVoidNoBody(`/public/api/projects/${this.enc(projectKey)}/bundles/exported/${encodeURIComponent(bundleId)}?${params.toString()}`);
     }
     /** Delete an exported Design-node bundle. */
     async deleteExported(bundleId, projectKey) {

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

@@ -1,6 +1,21 @@
 import type { DataikuClient } from "../client.js";
-import type { ConnectionSummary } from "../schemas.js";
+import { type ConnectionSummary, type FutureState } from "../schemas.js";
 import { BaseResource } from "./base.js";
+/**
+ * Connection definition for admin create/update. `name` and `type` are
+ * required on create; params are connection-type specific per the docs and may
+ * carry credentials (e.g. `params.password`), which this SDK forwards verbatim
+ * over TLS and never logs.
+ */
+export interface ConnectionAdminInput extends Record<string, unknown> {
+    name?: string;
+    type?: string;
+    params?: Record<string, unknown>;
+    allowWrite?: boolean;
+    allowManagedDatasets?: boolean;
+    usableBy?: string;
+    allowedGroups?: string[];
+}
 export declare function resolveAdminManagedStorageConnection(client: DataikuClient, capability: "allowManagedDatasets" | "allowManagedFolders", preferredName?: string): Promise<string | undefined>;
 export interface ConnectionSchemaListOptions {
     connection: string;
@@ -31,4 +46,66 @@ export declare class ConnectionsResource extends BaseResource {
     }): Promise<ConnectionSummary[]>;
     schemas(opts: ConnectionSchemaListOptions): Promise<string[]>;
     tables(opts: ConnectionTableListOptions): Promise<Record<string, unknown>>;
+    /**
+     * Lists all connections on the DSS instance (Admin required). Returns the
+     * documented dictionary of connection name to Connection object. Connection
+     * params may contain credentials (e.g. `params.password`); the SDK returns
+     * the server payload faithfully, and CLI output/plan layers redact them.
+     */
+    adminList(): Promise<Record<string, Record<string, unknown>>>;
+    /** Gets one connection by name (Admin required). */
+    adminGet(connectionName: string): Promise<Record<string, unknown>>;
+    /**
+     * Creates a connection (Admin required). Body is the Connection definition
+     * (`{name, type, params, ...}`); params are connection-type specific per
+     * the docs. DSS answers 200 with an empty body.
+     */
+    adminCreate(body: ConnectionAdminInput): Promise<Record<string, unknown>>;
+    /**
+     * Updates a connection (Admin required). Per the docs the body MUST have
+     * been obtained from a prior GET at the same URL; `type` and `name` may not
+     * be modified and undocumented attributes should pass through unchanged.
+     * DSS answers 204 with an empty body.
+     */
+    adminUpdate(connectionName: string, body: ConnectionAdminInput): Promise<Record<string, unknown>>;
+    /**
+     * Deletes a connection (Admin required). Per the docs DSS performs no check
+     * that the connection is not in use by a dataset, so this is destructive.
+     */
+    adminDelete(connectionName: string): Promise<{
+        deleted: string;
+    }>;
+    /**
+     * Tests whether a connection is available. Routed like the official
+     * dataikuapi Python client (`DSSConnection.test()`):
+     * `GET /connections/{connectionName}/test` — a pure availability test, not
+     * a settings read. Returns an error when testing is not supported for the
+     * connection type; the result carries `connectionOK` (true when available).
+     * The REST reference documents a same-URL "Test connection" variant of
+     * `GET /admin/connections/{name}`; this route is preferred because it
+     * cannot be confused with a settings retrieval.
+     */
+    adminTest(connectionName: string): Promise<Record<string, unknown>>;
+    /**
+     * Prepares the import of selected SQL or Hive tables (WRITE_CONF required).
+     * `keys` entries carry `{connectionName, name}` plus optional
+     * `catalog`/`schema`; Hive keys use the `@virtual(hive-jdbc):...`
+     * connection-name form documented by DSS. Returns a future reference; poll
+     * with `client.futures` when the result is not inline.
+     */
+    prepareTablesImport(opts: {
+        keys: Array<Record<string, unknown>>;
+        projectKey?: string;
+    }): Promise<FutureState>;
+    /**
+     * Performs an import from table candidates (WRITE_CONF required). At least
+     * one of `sqlImportCandidates` or `hiveImportCandidates` must be supplied;
+     * shapes follow the DSS SQL/Hive import candidate objects. Returns a future
+     * reference; poll with `client.futures`.
+     */
+    executeTablesImport(opts: {
+        sqlImportCandidates?: Array<Record<string, unknown>>;
+        hiveImportCandidates?: Array<Record<string, unknown>>;
+        projectKey?: string;
+    }): Promise<FutureState>;
 }

package/dist/src/resources/connections.js

@@ -1,4 +1,6 @@
-import { BaseResource, } from "./base.js";
+import { ClientValidationError, } from "../errors.js";
+import { FutureStateSchema, } from "../schemas.js";
+import { BaseResource, requireNonEmpty, } from "./base.js";
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -9,6 +11,12 @@ function normalizeConnectionNames(value) {
         .filter((v) => typeof v === "string" && v.length > 0)
         .sort();
 }
+function validateConnectionAdminInput(body, method) {
+    if (body === null || body === undefined || typeof body !== "object" || Array.isArray(body)) {
+        throw new ClientValidationError(`${method}: body must be a Connection object.`);
+    }
+    return body;
+}
 export async function resolveAdminManagedStorageConnection(client, capability, preferredName) {
     try {
         const raw = await client.get("/public/api/admin/connections/");
@@ -156,4 +164,127 @@ export class ConnectionsResource extends BaseResource {
             params.set("schemaName", opts.schema);
         return this.client.get(`/public/api/projects/${encodeURIComponent(pk)}/datasets/tables-import/actions/list-tables?${params.toString()}`);
     }
+    /* ----------------------------------------------------------------- */
+    /*  Admin connection management (GET/POST/PUT/DELETE /admin/connections) */
+    /* ----------------------------------------------------------------- */
+    /**
+     * Lists all connections on the DSS instance (Admin required). Returns the
+     * documented dictionary of connection name to Connection object. Connection
+     * params may contain credentials (e.g. `params.password`); the SDK returns
+     * the server payload faithfully, and CLI output/plan layers redact them.
+     */
+    async adminList() {
+        const raw = await this.client.get("/public/api/admin/connections");
+        if (raw === undefined || raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+            return {};
+        }
+        return raw;
+    }
+    /** Gets one connection by name (Admin required). */
+    async adminGet(connectionName) {
+        const enc = requireNonEmpty(connectionName, "connectionName").trim();
+        return this.client.get(`/public/api/admin/connections/${encodeURIComponent(enc)}`);
+    }
+    /**
+     * Creates a connection (Admin required). Body is the Connection definition
+     * (`{name, type, params, ...}`); params are connection-type specific per
+     * the docs. DSS answers 200 with an empty body.
+     */
+    async adminCreate(body) {
+        const validated = validateConnectionAdminInput(body, "connections.adminCreate");
+        const raw = await this.client.post("/public/api/admin/connections", validated);
+        return raw !== undefined && raw !== null && typeof raw === "object" && !Array.isArray(raw)
+            ? raw
+            : {};
+    }
+    /**
+     * Updates a connection (Admin required). Per the docs the body MUST have
+     * been obtained from a prior GET at the same URL; `type` and `name` may not
+     * be modified and undocumented attributes should pass through unchanged.
+     * DSS answers 204 with an empty body.
+     */
+    async adminUpdate(connectionName, body) {
+        const enc = requireNonEmpty(connectionName, "connectionName").trim();
+        const validated = validateConnectionAdminInput(body, "connections.adminUpdate");
+        const raw = await this.client.put(`/public/api/admin/connections/${encodeURIComponent(enc)}`, validated);
+        return raw !== undefined && raw !== null && typeof raw === "object" && !Array.isArray(raw)
+            ? raw
+            : {};
+    }
+    /**
+     * Deletes a connection (Admin required). Per the docs DSS performs no check
+     * that the connection is not in use by a dataset, so this is destructive.
+     */
+    async adminDelete(connectionName) {
+        const enc = requireNonEmpty(connectionName, "connectionName").trim();
+        await this.client.del(`/public/api/admin/connections/${encodeURIComponent(enc)}`);
+        return { deleted: enc, };
+    }
+    /**
+     * Tests whether a connection is available. Routed like the official
+     * dataikuapi Python client (`DSSConnection.test()`):
+     * `GET /connections/{connectionName}/test` — a pure availability test, not
+     * a settings read. Returns an error when testing is not supported for the
+     * connection type; the result carries `connectionOK` (true when available).
+     * The REST reference documents a same-URL "Test connection" variant of
+     * `GET /admin/connections/{name}`; this route is preferred because it
+     * cannot be confused with a settings retrieval.
+     */
+    async adminTest(connectionName) {
+        const enc = requireNonEmpty(connectionName, "connectionName").trim();
+        const raw = await this.client.get(`/public/api/connections/${encodeURIComponent(enc)}/test`);
+        return raw !== undefined && raw !== null && typeof raw === "object" && !Array.isArray(raw)
+            ? raw
+            : {};
+    }
+    /* ----------------------------------------------------------------- */
+    /*  Tables import (prepare-from-keys / execute-from-candidates)      */
+    /* ----------------------------------------------------------------- */
+    /**
+     * Prepares the import of selected SQL or Hive tables (WRITE_CONF required).
+     * `keys` entries carry `{connectionName, name}` plus optional
+     * `catalog`/`schema`; Hive keys use the `@virtual(hive-jdbc):...`
+     * connection-name form documented by DSS. Returns a future reference; poll
+     * with `client.futures` when the result is not inline.
+     */
+    async prepareTablesImport(opts) {
+        if (!Array.isArray(opts?.keys) || opts.keys.length === 0
+            || opts.keys.some((k) => k === null || typeof k !== "object" || Array.isArray(k))) {
+            throw new ClientValidationError("connections.prepareTablesImport: keys must be a non-empty array of key objects.");
+        }
+        for (const key of opts.keys) {
+            const connectionName = key["connectionName"];
+            const name = key["name"];
+            if (typeof connectionName !== "string" || connectionName.trim().length === 0
+                || typeof name !== "string" || name.trim().length === 0) {
+                throw new ClientValidationError("connections.prepareTablesImport: each key must carry non-empty string connectionName and name per the DSS tables-import contract.");
+            }
+        }
+        const pk = this.resolveProjectKey(opts.projectKey);
+        const raw = await this.client.post(`/public/api/projects/${encodeURIComponent(pk)}/datasets/tables-import/actions/prepare-from-keys`, { keys: opts.keys, });
+        return this.client.safeParse(FutureStateSchema, raw, "connections.prepareTablesImport");
+    }
+    /**
+     * Performs an import from table candidates (WRITE_CONF required). At least
+     * one of `sqlImportCandidates` or `hiveImportCandidates` must be supplied;
+     * shapes follow the DSS SQL/Hive import candidate objects. Returns a future
+     * reference; poll with `client.futures`.
+     */
+    async executeTablesImport(opts) {
+        const sql = opts?.sqlImportCandidates;
+        const hive = opts?.hiveImportCandidates;
+        if ((sql !== undefined && (!Array.isArray(sql) || sql.length === 0))
+            || (hive !== undefined && (!Array.isArray(hive) || hive.length === 0))
+            || (sql === undefined && hive === undefined)) {
+            throw new ClientValidationError("connections.executeTablesImport: sqlImportCandidates or hiveImportCandidates must be a non-empty array (at least one required).");
+        }
+        const pk = this.resolveProjectKey(opts.projectKey);
+        const body = {};
+        if (sql !== undefined)
+            body.sqlImportCandidates = sql;
+        if (hive !== undefined)
+            body.hiveImportCandidates = hive;
+        const raw = await this.client.post(`/public/api/projects/${encodeURIComponent(pk)}/datasets/tables-import/actions/execute-from-candidates`, body);
+        return this.client.safeParse(FutureStateSchema, raw, "connections.executeTablesImport");
+    }
 }