dataiku-sdk 0.7.0 → 0.8.0

package/dist/src/cli.js

@@ -1119,6 +1119,23 @@ function formatLineDiff(remoteName, localPath, remoteContent, localContent) {
     return lines.join("\n");
 }
 let outputFieldProjection;
+/**
+ * Non-fatal diagnostics queued during a command and flushed to stderr as one
+ * JSON envelope, so agents get a loud, machine-parseable signal (e.g. truncated
+ * exports) without polluting the stdout result contract.
+ */
+let pendingCliWarnings = [];
+function enqueueCliWarning(warning) {
+    pendingCliWarnings.push(warning);
+}
+/** Emit queued warnings as a single `{ warnings: [...] }` object on stderr. Idempotent. */
+function flushCliWarnings() {
+    if (pendingCliWarnings.length === 0)
+        return;
+    const warnings = pendingCliWarnings;
+    pendingCliWarnings = [];
+    process.stderr.write(`${JSON.stringify({ warnings, }, null, 2)}\n`);
+}
 function resolveFieldPath(source, field) {
     let current = source;
     for (const segment of field.split(".")) {
@@ -1148,6 +1165,7 @@ function projectResultFields(result, fields) {
     return pickResultFields(result, fields);
 }
 function writeCommandResult(result) {
+    flushCliWarnings();
     const projected = outputFieldProjection
         ? projectResultFields(result, outputFieldProjection)
         : result;
@@ -1495,6 +1513,7 @@ const FLAG_ALIASES = {
     "extra-ca-certs": "ca-cert",
     explain: "plan",
     "zone-name": "zone",
+    rows: "max-rows",
 };
 const VALUE_FLAGS = new Set([
     "fields",
@@ -2737,9 +2756,9 @@ const commands = {
                     timeoutMs: num(f["timeout"]),
                 });
             },
-            usage: "dss dataset preview <name> [--max-rows N] [--project-key KEY] [--timeout MS]",
-            description: "Preview dataset rows.",
-            examples: ["dss dataset preview orders", "dss dataset preview orders --max-rows 5",],
+            usage: "dss dataset preview <name> [--max-rows N|--rows N] [--project-key KEY] [--timeout MS]",
+            description: "Preview dataset rows (--rows is an alias for --max-rows).",
+            examples: ["dss dataset preview orders", "dss dataset preview orders --rows 5",],
         },
         metadata: {
             handler: (c, a, f) => {
@@ -2751,16 +2770,28 @@ const commands = {
             examples: ["dss dataset metadata orders",],
         },
         download: {
-            handler: (c, a, f) => {
+            handler: async (c, a, f) => {
                 requireArgs(a, 1, "dss dataset download <name>");
-                return c.datasets.download(a[0], {
+                const result = await c.datasets.download(a[0], {
                     outputPath: f["output"],
                     projectKey: f["project-key"],
                     limit: num(f["limit"]),
                 });
+                if (result.truncated) {
+                    enqueueCliWarning({
+                        code: "dataset_download_truncated",
+                        message: `Download of '${a[0]}' stopped at the ${result.limit}-row cap; the dataset has more rows. `
+                            + "Re-run with --limit N for more, or read inside a recipe (get_dataframe) for the full data.",
+                        dataset: a[0],
+                        rows: result.rows,
+                        limit: result.limit,
+                        path: result.path,
+                    });
+                }
+                return result;
             },
             usage: "dss dataset download <name> [--output PATH] [--limit N] [--project-key KEY]",
-            description: "Download up to --limit rows (default 100k) as CSV; returns { path, rows, truncated, limit } so truncation is visible.",
+            description: "Download up to --limit rows (default 100k) as CSV; returns { path, rows, truncated, limit }. When truncated, a dataset_download_truncated warning is also written to stderr so the cap is never silent.",
             examples: ["dss dataset download orders", "dss dataset download orders --output ./data/",],
         },
         create: {
@@ -4743,8 +4774,8 @@ function missingActionError(resource, validActions, usage) {
 function unknownResourceError(resource) {
     return new UsageError(`Unknown resource: ${resource}.`, "usage_error", COMMANDS_RUN_HINT, { resource, validResources: RESOURCE_NAMES, });
 }
-function unknownActionError(resource, action, validActions) {
-    return new UsageError(`Unknown action: ${resource} ${action ?? ""}`.trim(), "usage_error", COMMANDS_RUN_HINT, { resource, action, validActions, });
+function unknownActionError(resource, action, validActions, hint) {
+    return new UsageError(`Unknown action: ${resource} ${action ?? ""}`.trim(), "usage_error", hint ?? COMMANDS_RUN_HINT, { resource, action, validActions, });
 }
 function requireArgs(args, count, usage) {
     if (args.length < count) {
@@ -6774,8 +6805,9 @@ async function main() {
         }
         currentCommandContext.action = action;
         const authMeta = AUTH_ACTIONS[action];
-        if (!authMeta)
-            throw unknownActionError("auth", action, validActions);
+        if (!authMeta) {
+            throw unknownActionError("auth", action, validActions, "auth only supports 'login'. To check credentials/connectivity, run 'dss doctor'.");
+        }
         const result = await authMeta.handler(flags);
         writeCommandResult(result);
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "dataiku-sdk",
-	"version": "0.7.0",
+	"version": "0.8.0",
 	"description": "Dataiku DSS SDK and CLI for programmatic access to DSS REST APIs",
 	"type": "module",
 	"workspaces": [
@@ -35,10 +35,10 @@
 		"test:integration:rigorous:mutating": "RUN_DATAIKU_INTEGRATION=1 RUN_DATAIKU_INTEGRATION_MUTATING=1 bun test tests/integration-rigorous.test.ts"
 	},
 	"devDependencies": {
-		"@types/bun": "^1.3.13",
-		"dprint": "^0.53.2",
-		"oxlint": "^1.62.0",
-		"typescript": "^5.9.3"
+		"@types/bun": "^1.3.14",
+		"dprint": "^0.54.0",
+		"oxlint": "^1.68.0",
+		"typescript": "^6.0.3"
 	},
 	"dependencies": {
 		"@sinclair/typebox": "^0.34.49"