@metabase/cli 0.5.0 → 0.5.2

package/dist/{cards-Bq73s48q.mjs → cards-DmzPtx81.mjs}

@@ -1,9 +1,9 @@
-import { at as listFlags, ct as profileFlag, nt as connectionFlags, o as renderList, st as outputFlags, ut as listEnvelopeSchema } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-C5Ha6Ou8.mjs";
-import { t as parseId } from "./parse-id-oCbmouCn.mjs";
-import { n as windowList } from "./window-BqMFpWMh.mjs";
-import { u as DashcardCompact } from "./dashboard-Phz3XpRM.mjs";
-import { r as dashcardView } from "./dashboard-XSTr9QCr.mjs";
+import { ct as outputFlags, lt as profileFlag, mt as listEnvelopeSchema, o as renderList, ot as listFlags, rt as connectionFlags } from "./cli.mjs";
+import { t as parseId } from "./parse-id-5BZGQ9Vd.mjs";
+import { t as defineMetabaseCommand } from "./runtime-Cmes70jO.mjs";
+import { n as windowList } from "./window-CfK_j6m1.mjs";
+import { d as DashcardCompact } from "./dashboard-Chjy5GKR.mjs";
+import { r as dashcardView } from "./dashboard-D5E3fMKh.mjs";
 //#region src/commands/dashboard/cards.ts
 const DashcardListEnvelope = listEnvelopeSchema(DashcardCompact);
 var cards_default = defineMetabaseCommand({

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { defineCommand, renderUsage, runMain } from "citty";
+import { defineCommand, parseArgs, renderUsage, runMain } from "citty";
 import { ZodError, core, z } from "zod";
 import tls from "node:tls";
 import { confirm, isCancel, password, select, text } from "@clack/prompts";
@@ -120,6 +120,15 @@ var InternalError = class extends MetabaseError {
 		this.name = "InternalError";
 	}
 };
+var FailedResultError = class extends MetabaseError {
+	category = "failed";
+	isRetryable = false;
+	developerDetail = null;
+	constructor(message) {
+		super(message);
+		this.name = "FailedResultError";
+	}
+};
 var AbortError = class extends MetabaseError {
 	category = "abort";
 	isRetryable = false;
@@ -442,6 +451,15 @@ function readValueFlag(item, spellings) {
 		value: readFlagValue(item, spellings)
 	};
 }
+function assertRequiredPositionals(rawArgs, argsDef) {
+	const given = [...readArgv(rawArgs, commandSpellings(argsDef))].filter((item) => item.kind === "positional").length;
+	const declared = Object.entries(argsDef).filter(([, def]) => def.type === "positional");
+	const missing = declared.slice(given).find(([, def]) => def.required === true);
+	if (missing === void 0) return;
+	assertArgv(rawArgs, argsDef);
+	const usage = declared.map(([name]) => `<${name}>`).join(" ");
+	throw new ConfigError(`missing argument: <${missing[0]}> (this command takes ${usage})`);
+}
 function assertPositionalCount(positionals, argsDef) {
 	const declared = Object.entries(argsDef).filter(([, def]) => def.type === "positional").map(([name]) => `<${name}>`);
 	const extra = positionals[declared.length];
@@ -481,6 +499,16 @@ function readsAsFlag(value, spellings) {
 	return value.startsWith("--no-") || parseFlagToken(value, spellings).flag !== null;
 }
 //#endregion
+//#region src/output/format.ts
+function resolveFormat({ json, format, isTty }) {
+	const explicit = format !== void 0 && format !== "auto" ? format : null;
+	if (explicit !== null && explicit !== "json" && explicit !== "text") throw new ConfigError(`invalid --format value: "${explicit}" (expected: auto, json, text)`);
+	if (json && explicit !== null && explicit !== "json") throw new ConfigError(`--json conflicts with --format ${explicit}`);
+	if (json) return "json";
+	if (explicit !== null) return explicit;
+	return isTty ? "text" : "json";
+}
+//#endregion
 //#region src/output/types.ts
 const DEFAULT_MAX_BYTES = 24576;
 function listEnvelopeSchema(item) {
@@ -508,6 +536,73 @@ function listEnvelopeShape(item) {
 	};
 }
 //#endregion
+//#region src/commands/parse-integer.ts
+const INTEGER_PATTERN = /^-?\d+$/;
+function parseInteger(value, options) {
+	const trimmed = value.trim();
+	if (!INTEGER_PATTERN.test(trimmed)) {
+		const expected = options.expected ?? "integer";
+		throw new ConfigError(`invalid ${options.name}: "${value}" (expected ${expected})`);
+	}
+	const parsed = Number.parseInt(trimmed, 10);
+	if (parsed < options.min) throw new ConfigError(`invalid ${options.name}: ${parsed} (must be ≥ ${options.min})`);
+	return parsed;
+}
+function parseOptionalInteger(value, options) {
+	if (value === void 0) return null;
+	return parseInteger(value, options);
+}
+//#endregion
+//#region src/commands/context.ts
+function resolveOutputFormat(args, options = {}) {
+	return resolveFormat({
+		json: args.json,
+		format: args.format,
+		isTty: options.isTty ?? Boolean(process.stdout.isTTY)
+	});
+}
+function resolveCommonFlags(args, options = {}) {
+	const fields = parseFields(args.fields);
+	const full = args.full === true;
+	if (full && fields !== void 0) throw new ConfigError("--full conflicts with --fields (use one or neither)");
+	return {
+		format: resolveOutputFormat(args, options),
+		full,
+		fields,
+		maxBytes: parseMaxBytes(args.maxBytes),
+		maxBytesGiven: args.maxBytes !== void 0,
+		range: parseRange(args.limit, args.offset),
+		url: args.url,
+		apiKey: args.apiKey,
+		profile: args.profile,
+		skipPreflight: args.skipPreflight
+	};
+}
+function parseFields(value) {
+	if (value === void 0 || value === "") return;
+	const parts = parseCsv(value);
+	return parts.length > 0 ? parts : void 0;
+}
+function parseMaxBytes(value) {
+	return parseInteger(value ?? String(24576), {
+		name: "--max-bytes",
+		min: 0
+	});
+}
+function parseRange(limit, offset) {
+	const parsedLimit = parseOptionalInteger(limit, {
+		name: "--limit",
+		min: 1
+	});
+	return {
+		offset: parseInteger(offset ?? "0", {
+			name: "--offset",
+			min: 0
+		}),
+		limit: parsedLimit === null ? void 0 : parsedLimit
+	};
+}
+//#endregion
 //#region src/commands/flags.ts
 function listFlag(def) {
 	return {
@@ -627,7 +722,7 @@ function trustSystemCa() {
 //#endregion
 //#region package.json
 var name = "@metabase/cli";
-var version = "0.5.0";
+var version = "0.5.2";
 var description = "Metabase CLI";
 //#endregion
 //#region src/runtime/command-augment.ts
@@ -647,38 +742,40 @@ const main = defineCommand({
 		description
 	},
 	subCommands: {
-		auth: () => import("./auth-DOz7KW5E.mjs").then((mod) => mod.default),
-		db: () => import("./db-C82M3Gpg.mjs").then((mod) => mod.default),
-		table: () => import("./table-qjgz2eek.mjs").then((mod) => mod.default),
-		field: () => import("./field-qF1KRJYB.mjs").then((mod) => mod.default),
-		upload: () => import("./upload-fcim1xtK.mjs").then((mod) => mod.default),
-		"content-translation": () => import("./content-translation-BlG41YrA.mjs").then((mod) => mod.default),
-		card: () => import("./card-Buc-X4Mh.mjs").then((mod) => mod.default),
-		dashboard: () => import("./dashboard-DH_soSQp.mjs").then((mod) => mod.default),
-		subscription: () => import("./subscription-CSR2t-xK.mjs").then((mod) => mod.default),
-		alert: () => import("./alert-DMlSjPEv.mjs").then((mod) => mod.default),
-		collection: () => import("./collection-D-sS0AFw.mjs").then((mod) => mod.default),
-		library: () => import("./library-D2ogEIfI.mjs").then((mod) => mod.default),
-		document: () => import("./document-WhSEyI-3.mjs").then((mod) => mod.default),
-		glossary: () => import("./glossary-BvVxqjxJ.mjs").then((mod) => mod.default),
-		transform: () => import("./transform-Y86R7_2F.mjs").then((mod) => mod.default),
-		"transform-job": () => import("./transform-job-Cg_1jzWI.mjs").then((mod) => mod.default),
-		"transform-tag": () => import("./transform-tag-DHg7j15d.mjs").then((mod) => mod.default),
-		setting: () => import("./setting-B-bxCkC0.mjs").then((mod) => mod.default),
-		search: () => import("./search-CB1A4HWx.mjs").then((mod) => mod.default),
-		"git-sync": () => import("./git-sync-BlgB_-8-.mjs").then((mod) => mod.default),
-		setup: () => import("./setup-Bvvqlz9d.mjs").then((mod) => mod.default),
-		snippet: () => import("./snippet-B7Kau5U8.mjs").then((mod) => mod.default),
-		segment: () => import("./segment-BEjaeLc5.mjs").then((mod) => mod.default),
-		measure: () => import("./measure-CUqJtDNm.mjs").then((mod) => mod.default),
-		dependency: () => import("./dependency-CLznxtLE.mjs").then((mod) => mod.default),
-		timeline: () => import("./timeline-CNkrY3e3.mjs").then((mod) => mod.default),
-		"timeline-event": () => import("./timeline-event-CSzx8EDP.mjs").then((mod) => mod.default),
-		eid: () => import("./eid-Ex4G-ZlN.mjs").then((mod) => mod.default),
-		query: () => import("./query-Ct697cY-.mjs").then((mod) => mod.default),
-		uuid: () => import("./uuid-DW30GY7B.mjs").then((mod) => mod.default),
-		upgrade: () => import("./upgrade-BBOEVIRa.mjs").then((mod) => mod.default),
-		skills: () => import("./skills-DxrO7HUz.mjs").then((mod) => mod.default)
+		auth: () => import("./auth-_cdypXeX.mjs").then((mod) => mod.default),
+		db: () => import("./db-BgKKN1-4.mjs").then((mod) => mod.default),
+		table: () => import("./table-Cb_Uvw8m.mjs").then((mod) => mod.default),
+		field: () => import("./field-BUkyWiWk.mjs").then((mod) => mod.default),
+		upload: () => import("./upload-Cqv-In6j.mjs").then((mod) => mod.default),
+		"content-translation": () => import("./content-translation-DxT1OMnP.mjs").then((mod) => mod.default),
+		card: () => import("./card-BnL92zoT.mjs").then((mod) => mod.default),
+		dashboard: () => import("./dashboard-Bq1pae4N.mjs").then((mod) => mod.default),
+		subscription: () => import("./subscription-CEFxmtGH.mjs").then((mod) => mod.default),
+		"data-action": () => import("./data-action-BZ2PvlaP.mjs").then((mod) => mod.default),
+		alert: () => import("./alert-mXHOt00T.mjs").then((mod) => mod.default),
+		collection: () => import("./collection-DRHGwFSL.mjs").then((mod) => mod.default),
+		library: () => import("./library-5I0TlXmf.mjs").then((mod) => mod.default),
+		document: () => import("./document-C0mZEg5w.mjs").then((mod) => mod.default),
+		glossary: () => import("./glossary-B9Eo4hXc.mjs").then((mod) => mod.default),
+		transform: () => import("./transform-kP11Mv9_.mjs").then((mod) => mod.default),
+		"transform-job": () => import("./transform-job-Dlx2c6II.mjs").then((mod) => mod.default),
+		"transform-tag": () => import("./transform-tag-dKCqQPTd.mjs").then((mod) => mod.default),
+		"transform-test": () => import("./transform-test-jFuzVhlT.mjs").then((mod) => mod.default),
+		setting: () => import("./setting-BBn9Lv9J.mjs").then((mod) => mod.default),
+		search: () => import("./search-OpYS2Ub4.mjs").then((mod) => mod.default),
+		"git-sync": () => import("./git-sync-CNTB5jvI.mjs").then((mod) => mod.default),
+		setup: () => import("./setup-8d7Uplhy.mjs").then((mod) => mod.default),
+		snippet: () => import("./snippet-CpZ5cJ_y.mjs").then((mod) => mod.default),
+		segment: () => import("./segment-D-SKpFzF.mjs").then((mod) => mod.default),
+		measure: () => import("./measure-Bz-bGn-Z.mjs").then((mod) => mod.default),
+		dependency: () => import("./dependency-6kfpR8Ga.mjs").then((mod) => mod.default),
+		timeline: () => import("./timeline-x0s_3sfc.mjs").then((mod) => mod.default),
+		"timeline-event": () => import("./timeline-event-B-nGnoVL.mjs").then((mod) => mod.default),
+		eid: () => import("./eid-Tp-ACZ4O.mjs").then((mod) => mod.default),
+		query: () => import("./query-0u1WR1bV.mjs").then((mod) => mod.default),
+		uuid: () => import("./uuid-D0sH5txV.mjs").then((mod) => mod.default),
+		upgrade: () => import("./upgrade-Cfouv1Ii.mjs").then((mod) => mod.default),
+		skills: () => import("./skills-BeIDC-_H.mjs").then((mod) => mod.default)
 	}
 });
 setMetabaseAugment(main, {
@@ -1068,6 +1165,8 @@ function defaultMessageForStatus(status) {
 //#endregion
 //#region ../client/src/version/features.ts
 const FEATURE_RULES = {
+	dataActionCollections: { since: 65 },
+	dataActionsWithoutModel: { since: 65 },
 	transforms: { since: 59 },
 	transformJobActivation: { since: 61 },
 	measures: { since: 59 },
@@ -1075,6 +1174,7 @@ const FEATURE_RULES = {
 		since: 59,
 		tokenFeature: "library"
 	},
+	libraryDashboards: { since: 65 },
 	remoteSync: {
 		since: 58,
 		tokenFeature: "remote_sync"
@@ -1522,18 +1622,23 @@ function writeText(text) {
 	process.stdout.write(text + "\n");
 }
 function renderItem(item, view, opts) {
-	const body = renderItemBody(item, view, applyProjection(item, view, opts.full, opts.fields), opts) + "\n";
-	assertItemWithinMaxBytes(body, opts);
-	process.stdout.write(body);
+	writeWithinMaxBytes(itemBody(item, view, opts), opts);
+}
+function itemBody(item, view, opts) {
+	return renderItemBody(item, view, applyProjection(item, view, opts.full, opts.fields), opts) + "\n";
 }
 function renderSummary(item, view, summaryText, opts) {
-	if (opts.format === "json" || opts.fields !== void 0 || opts.full) {
-		renderItem(item, view, opts);
-		return;
-	}
-	const body = (typeof summaryText === "function" ? summaryText() : summaryText) + "\n";
-	assertItemWithinMaxBytes(body, opts);
-	process.stdout.write(body);
+	writeWithinMaxBytes(summaryBody(item, view, summaryText, opts), opts);
+}
+function renderSummaryWithinMaxBytes(item, view, summaryText, opts) {
+	const body = summaryBody(item, view, summaryText, opts);
+	const oversize = oversizeMessage(body, opts);
+	if (oversize === null) process.stdout.write(body);
+	return oversize;
+}
+function summaryBody(item, view, summaryText, opts) {
+	if (opts.format === "json" || opts.fields !== void 0 || opts.full) return itemBody(item, view, opts);
+	return (typeof summaryText === "function" ? summaryText() : summaryText) + "\n";
 }
 function renderList(envelope, view, opts) {
 	renderListWithExtras(envelope, {}, view, opts);
@@ -1612,11 +1717,16 @@ function renderKeyValueLines(pairs) {
 	const padding = Math.max(...pairs.map(([label]) => label.length));
 	return pairs.map(([label, value]) => `${label.padEnd(padding)}  ${value}`).join("\n");
 }
-function assertItemWithinMaxBytes(body, opts) {
-	if (opts.maxBytes <= 0) return;
+function writeWithinMaxBytes(body, opts) {
+	const oversize = oversizeMessage(body, opts);
+	if (oversize !== null) throw new ConfigError(oversize);
+	process.stdout.write(body);
+}
+function oversizeMessage(body, opts) {
+	if (opts.maxBytes <= 0) return null;
 	const bytes = Buffer.byteLength(body, "utf8");
-	if (bytes <= opts.maxBytes) return;
-	throw new ConfigError(itemOversizeMessage(bytes, opts.maxBytes, opts.oversizeHint));
+	if (bytes <= opts.maxBytes) return null;
+	return itemOversizeMessage(bytes, opts.maxBytes, opts.oversizeHint);
 }
 //#endregion
 //#region src/output/error.ts
@@ -1638,6 +1748,7 @@ function exitCodeFor(category) {
 		case "partial-write":
 		case "timeout":
 		case "internal":
+		case "failed":
 		case "unknown": return FAILURE_EXIT_CODE;
 	}
 }
@@ -1719,8 +1830,16 @@ const METHOD_REQUIREMENTS = {
 	"dashboard.checkCardReferences": [],
 	"dashboard.parameterValues": [],
 	"dashboard.searchParameterValues": [],
+	"dataAction.list": [],
+	"dataAction.get": [],
+	"dataAction.create": ["dataActionsWithoutModel"],
+	"dataAction.update": [],
+	"dataAction.archive": [],
+	"dataAction.delete": [],
+	"dataAction.execute": [],
 	"database.list": [],
 	"database.get": [],
+	"database.update": [],
 	"database.schemas": [],
 	"database.schemaTables": [],
 	"database.syncSchema": [],
@@ -1764,6 +1883,7 @@ const METHOD_REQUIREMENTS = {
 	"gitSync.syncedCollections": ["remoteSync"],
 	"gitSync.remoteUrl": [],
 	"gitSync.branch": ["remoteSync"],
+	"gitSync.remote": ["remoteSync"],
 	"gitSync.trackedBranch": ["remoteSync"],
 	"gitSync.waitForTask": ["remoteSync"],
 	"glossary.list": [],
@@ -2251,6 +2371,7 @@ function installInterruptHandler(exit) {
 //#region src/cli.ts
 const HELP_FLAGS = /* @__PURE__ */ new Set(["--help", "-h"]);
 const JSON_HELP_FLAG = "--json";
+const OUTPUT_FORMAT_FLAGS = ["json", "format"];
 async function run() {
 	installInterruptHandler((code) => process.exit(code));
 	trustSystemCa();
@@ -2274,12 +2395,42 @@ async function run() {
 			reportError(new ConfigError(`unknown command: ${unknown}`));
 			return;
 		}
+		if (await refusedLeafArgv(rawArgs)) return;
 	}
 	await runMain(main, {
 		showUsage: showUsageWithBreadcrumb,
 		rawArgs
 	});
 }
+async function refusedLeafArgv(rawArgs) {
+	const leaf = await resolveLeafArgv(main, rawArgs);
+	if (leaf === null) return false;
+	const leafArgs = rawArgs.slice(leaf.argsStart);
+	try {
+		assertRequiredPositionals(leafArgs, leaf.argsDef);
+		return false;
+	} catch (error) {
+		reportError(error, reportFormat(leafArgs, leaf.argsDef));
+		return true;
+	}
+}
+function reportFormat(leafArgs, argsDef) {
+	const outputFlags = Object.fromEntries(OUTPUT_FORMAT_FLAGS.flatMap((key) => {
+		const def = argsDef[key];
+		return def === void 0 ? [] : [[key, def]];
+	}));
+	const parsed = parseArgs([...leafArgs], outputFlags);
+	const format = parsed["format"];
+	const json = parsed["json"] === true;
+	try {
+		return resolveOutputFormat(typeof format === "string" ? {
+			json,
+			format
+		} : { json });
+	} catch {
+		return;
+	}
+}
 async function normalizeArgv(argv) {
 	const hoisted = hoistGlobalFlags(argv);
 	const leaf = await resolveLeafArgv(main, hoisted);
@@ -2291,4 +2442,4 @@ run().catch((error) => {
 	reportError(error);
 });
 //#endregion
-export { setMetabaseAugment as $, consumeLegacyEnvWarnings as A, isNonInterruptFailure as At, evaluateFeatures as B, warn as C, ResponseShapeError as Ct, ENV_SKILLS_DIR as D, errorMessage as Dt, ENV_PROFILE as E, ValidationError as Et, missingTokenFeatureMessage as F, isRetryableStatus as G, ruleGap as H, versionTooOldMessage as I, isPlainObject as J, NOT_BLANK as K, FEATURE_NAMES as L, ProfileRefreshedError as M, escapeJsonPointerSegment as Mt, CapabilityError as N, ENV_SKIP_PREFLIGHT as O, formatZodIssue as Ot, RequirementFailure as P, parseJsonResult as Q, FEATURE_RULES as R, preflightUncheckedNotice as S, PartialWriteError as St, ENV_DISABLE_KEYRING as T, UnknownError as Tt, HttpError as U, isFeatureName as V, chainRequestFailure as W, parseJson as X, JSON_CONTENT_TYPE as Y, parseJsonOrPlain as Z, promptPassword as _, AbortError as _t, renderItem as a, listFlags as at, listTruncationNotice as b, MetabaseError as bt, renderSummary as c, profileFlag as ct, writeText as d, listEnvelopeSchemaWithExtras as dt, name as et, MALFORMED_CELL as f, assertArgv as ft, promptConfirm as g, parseEnumCsv as gt, projectForList as h, parseEnum as ht, reportError as i, listFlag as it, readEnv as j, KNOWN_RANGE as jt, ENV_URL as k, isFileNotFoundError as kt, serializeJson as l, DEFAULT_MAX_BYTES as lt, renderRows as m, parseCsv as mt, isMethodKey as n, connectionFlags as nt, renderList as o, listFlagsWithDefaultLimit as ot, formatScalar as p, givenFlagKeys as pt, isBlank as q, methodRequirements as r, formatFlags as rt, renderListWithExtras as s, outputFlags as st, interruptSignal as t, version as tt, writeJson as u, listEnvelopeSchema as ut, promptSelect as v, ConfigError as vt, ENV_API_KEY as w, TimeoutError as wt, preflightSkippedNotice as x, NetworkError as xt, promptText as y, InternalError as yt, Features as z };
+export { parseJsonResult as $, ENV_URL as A, UnknownError as At, Features as B, preflightUncheckedNotice as C, FailedResultError as Ct, ENV_PROFILE as D, PartialWriteError as Dt, ENV_DISABLE_KEYRING as E, NetworkError as Et, RequirementFailure as F, isNonInterruptFailure as Ft, chainRequestFailure as G, isFeatureName as H, missingTokenFeatureMessage as I, KNOWN_RANGE as It, isBlank as J, isRetryableStatus as K, versionTooOldMessage as L, escapeJsonPointerSegment as Lt, readEnv as M, errorMessage as Mt, ProfileRefreshedError as N, formatZodIssue as Nt, ENV_SKILLS_DIR as O, ResponseShapeError as Ot, CapabilityError as P, isFileNotFoundError as Pt, parseJsonOrPlain as Q, FEATURE_NAMES as R, preflightSkippedNotice as S, ConfigError as St, ENV_API_KEY as T, MetabaseError as Tt, ruleGap as U, evaluateFeatures as V, HttpError as W, JSON_CONTENT_TYPE as X, isPlainObject as Y, parseJson as Z, promptConfirm as _, givenFlagKeys as _t, renderItem as a, listFlag as at, promptText as b, parseEnumCsv as bt, renderSummary as c, outputFlags as ct, writeJson as d, resolveOutputFormat as dt, setMetabaseAugment as et, writeText as f, parseInteger as ft, projectForList as g, assertArgv as gt, renderRows as h, listEnvelopeSchemaWithExtras as ht, reportError as i, formatFlags as it, consumeLegacyEnvWarnings as j, ValidationError as jt, ENV_SKIP_PREFLIGHT as k, TimeoutError as kt, renderSummaryWithinMaxBytes as l, profileFlag as lt, formatScalar as m, listEnvelopeSchema as mt, isMethodKey as n, version as nt, renderList as o, listFlags as ot, MALFORMED_CELL as p, parseOptionalInteger as pt, NOT_BLANK as q, methodRequirements as r, connectionFlags as rt, renderListWithExtras as s, listFlagsWithDefaultLimit as st, interruptSignal as t, name as tt, serializeJson as u, resolveCommonFlags as ut, promptPassword as v, parseCsv as vt, warn as w, InternalError as wt, listTruncationNotice as x, AbortError as xt, promptSelect as y, parseEnum as yt, FEATURE_RULES as z };