@metabase/cli 0.3.2 → 0.4.0

package/dist/{list-vsXIMssK.mjs → list-CvZyTwmV.mjs}

@@ -1,8 +1,8 @@
-import { B as listFlags, G as listEnvelopeSchema, H as outputFlags, U as profileFlag, d as renderList, z as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-nCPku2nN.mjs";
-import { n as windowList } from "./window-DSb1tqSe.mjs";
-import { n as DocumentCompact } from "./document-BHpLJbKU.mjs";
-import { t as documentView } from "./document-CA0Q6lqu.mjs";
+import { G as listFlags, H as connectionFlags, J as profileFlag, X as listEnvelopeSchema, d as renderList, q as outputFlags } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-CZ5zh32z.mjs";
+import { n as windowList } from "./window-CI_QD04s.mjs";
+import { n as DocumentCompact } from "./document-DFCj1Az_.mjs";
+import { t as documentView } from "./document-C18b5rM6.mjs";
 //#region src/commands/document/list.ts
 const DocumentListEnvelope = listEnvelopeSchema(DocumentCompact);
 var list_default = defineMetabaseCommand({

package/dist/list-DcnNlYQA.mjs

@@ -0,0 +1,35 @@
+import { G as listFlags, H as connectionFlags, J as profileFlag, X as listEnvelopeSchema, d as renderList, q as outputFlags } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-CZ5zh32z.mjs";
+import { n as windowList } from "./window-CI_QD04s.mjs";
+import { n as GlossaryCompact } from "./glossary-BlNCrYbw.mjs";
+import { t as parseOptionalText } from "./parse-text-T0lTXzTZ.mjs";
+import { t as glossaryView } from "./glossary-LmZWwCNP.mjs";
+//#region src/commands/glossary/list.ts
+const GlossaryListEnvelope = listEnvelopeSchema(GlossaryCompact);
+var list_default = defineMetabaseCommand({
+	meta: {
+		name: "list",
+		description: "List glossary entries in term order"
+	},
+	details: "`--search` matches the term or the definition as a case-insensitive substring. Some servers read `%` and `_` in the text as SQL LIKE wildcards rather than literal characters.",
+	requires: ["glossary.list"],
+	args: {
+		...outputFlags,
+		...listFlags,
+		...profileFlag,
+		...connectionFlags,
+		search: {
+			type: "string",
+			description: "Keep entries whose term or definition contains this text (case-insensitive)"
+		}
+	},
+	outputSchema: GlossaryListEnvelope,
+	examples: ["mb glossary list", "mb glossary list --search churn --json"],
+	async run({ args, ctx, getClient }) {
+		const search = parseOptionalText(args.search, "--search");
+		const { data } = await (await getClient()).glossary.list({ search });
+		renderList(windowList(data, ctx.range), glossaryView, ctx);
+	}
+});
+//#endregion
+export { list_default as default };

package/dist/{list-DuJezLm_.mjs → list-DtgbtE3_.mjs}

@@ -1,6 +1,6 @@
-import { B as listFlags, G as listEnvelopeSchema, H as outputFlags, U as profileFlag, d as renderList, z as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-nCPku2nN.mjs";
-import { n as windowList } from "./window-DSb1tqSe.mjs";
+import { G as listFlags, H as connectionFlags, J as profileFlag, X as listEnvelopeSchema, d as renderList, q as outputFlags } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-CZ5zh32z.mjs";
+import { n as windowList } from "./window-CI_QD04s.mjs";
 import { n as SnippetCompact } from "./snippet-CyKAgIZl.mjs";
 import { t as snippetView } from "./snippet-oJLaYW9V.mjs";
 //#region src/commands/snippet/list.ts

package/dist/{login-Vw51Gts5.mjs → login-Bi_nGMJ9.mjs}

@@ -1,9 +1,9 @@
-import { C as promptSelect, E as warn, H as outputFlags, Q as ConfigError, S as promptPassword, U as profileFlag, ot as errorMessage, p as renderSummary, rt as TimeoutError, t as interruptSignal, tt as NetworkError, w as promptText, z as connectionFlags } from "./cli.mjs";
-import { A as OAUTH_SCOPE, C as ProbedUser, D as OAUTH_CLIENT_NAME, J as normalizeUrl, K as oauthCredentialFromTokens, M as exchangeCode, N as registerClient, O as USER_AGENT, P as tryDiscoverMetadata, S as writeProfile, X as summarizeServer, Y as ServerSummary, b as writeProbeFailure, c as readEnvCredentials, f as consumeKeychainResidualWarning, j as discoverLoginMetadata, k as revokeOAuthCredential, m as keyringFallbackWarning, p as consumeKeyringDowngradeWarning, s as explicitProfileName, t as defineMetabaseCommand, u as DEFAULT_PROFILE, x as writeProbeResult, y as writeOAuthProfile } from "./runtime-nCPku2nN.mjs";
-import { r as readInput } from "./input-DEvkIjGr.mjs";
-import { t as verifyAndProbe } from "./verify-DTOA_wVM.mjs";
-import { a as renderUserRole, i as renderUserName, n as renderSkew, o as renderVersionTag } from "./render-Gx1hR7IF.mjs";
-import { t as openBrowser } from "./process-CTrfxxaC.mjs";
+import { D as promptText, E as promptSelect, H as connectionFlags, J as profileFlag, T as promptPassword, at as ConfigError, ct as NetworkError, k as warn, p as renderSummary, pt as errorMessage, q as outputFlags, t as interruptSignal, ut as TimeoutError } from "./cli.mjs";
+import { A as registerClient, D as OAUTH_SCOPE, E as revokeOAuthCredential, G as normalizeUrl, K as ServerSummary, O as discoverLoginMetadata, T as USER_AGENT, U as oauthCredentialFromTokens, _ as writeProbeFailure, a as readEnvCredentials, b as ProbedUser, d as keyringFallbackWarning, g as writeOAuthProfile, i as explicitProfileName, j as tryDiscoverMetadata, k as exchangeCode, l as consumeKeychainResidualWarning, q as summarizeServer, s as DEFAULT_PROFILE, t as defineMetabaseCommand, u as consumeKeyringDowngradeWarning, v as writeProbeResult, w as OAUTH_CLIENT_NAME, y as writeProfile } from "./runtime-CZ5zh32z.mjs";
+import { i as readInput } from "./input-D8qW-KtR.mjs";
+import { t as verifyAndProbe } from "./verify-Mpb65a5v.mjs";
+import { a as renderUserRole, i as renderUserName, n as renderSkew, o as renderVersionTag } from "./render-BSfDD6ip.mjs";
+import { t as openBrowser } from "./process-D0HdqZ3r.mjs";
 import { z } from "zod";
 import { createServer } from "node:http";
 import { createHash, randomBytes } from "node:crypto";

package/dist/{logout-BDIqoVhv.mjs → logout-CiHQJWTu.mjs}

@@ -1,5 +1,5 @@
-import { E as warn, H as outputFlags, U as profileFlag, ot as errorMessage, p as renderSummary, x as promptConfirm } from "./cli.mjs";
-import { O as USER_AGENT, d as clearProfile, f as consumeKeychainResidualWarning, g as readProfileCredential, k as revokeOAuthCredential, l as resolveProfileName, t as defineMetabaseCommand } from "./runtime-nCPku2nN.mjs";
+import { J as profileFlag, k as warn, p as renderSummary, pt as errorMessage, q as outputFlags, w as promptConfirm } from "./cli.mjs";
+import { E as revokeOAuthCredential, T as USER_AGENT, c as clearProfile, l as consumeKeychainResidualWarning, o as resolveProfileName, p as readProfileCredential, t as defineMetabaseCommand } from "./runtime-CZ5zh32z.mjs";
 import { z } from "zod";
 //#region src/commands/auth/logout.ts
 const LogoutResult = z.object({

package/dist/{measure-LY9Tp9QZ.mjs → measure-D2qq5e8f.mjs}

@@ -1,4 +1,4 @@
-import { t as defineCommandGroup } from "./group-YQQ5GIcP.mjs";
+import { t as defineCommandGroup } from "./group-bpD_KcjA.mjs";
 //#region src/commands/measure/index.ts
 var measure_default = defineCommandGroup({
 	name: "measure",
@@ -11,11 +11,11 @@ var measure_default = defineCommandGroup({
 		purpose: "define reusable measures"
 	}],
 	subCommands: {
-		list: () => import("./list-yV6CyPzn.mjs").then((mod) => mod.default),
-		get: () => import("./get-CekXFP3x.mjs").then((mod) => mod.default),
-		create: () => import("./create-CnJKj9Nl.mjs").then((mod) => mod.default),
-		update: () => import("./update-CKDRuduL.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-1YVo-Wsu.mjs").then((mod) => mod.default)
+		list: () => import("./list-C-A-2HFq.mjs").then((mod) => mod.default),
+		get: () => import("./get-BSUsfysk.mjs").then((mod) => mod.default),
+		create: () => import("./create-B2tuInV9.mjs").then((mod) => mod.default),
+		update: () => import("./update-DAzRx0of.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-Ct1eyolN.mjs").then((mod) => mod.default)
 	}
 });
 //#endregion

package/dist/moderation-review-BdqEH6N1.mjs

@@ -0,0 +1,31 @@
+import { z } from "zod";
+//#region ../client/src/domain/moderation-review.ts
+const ModeratedItemType = z.enum(["card", "dashboard"]);
+const ModerationStatus = z.enum(["verified"]);
+const ModerationReview = z.object({
+	id: z.number().int(),
+	moderated_item_id: z.number().int(),
+	moderated_item_type: ModeratedItemType,
+	moderator_id: z.number().int(),
+	status: ModerationStatus.nullable(),
+	text: z.string().nullable(),
+	most_recent: z.boolean(),
+	created_at: z.string(),
+	updated_at: z.string()
+}).loose();
+const ModerationReviewCompact = ModerationReview.pick({
+	id: true,
+	moderated_item_id: true,
+	moderated_item_type: true,
+	status: true,
+	text: true,
+	most_recent: true
+}).strip();
+const ModerationReviewCreateInput = z.object({
+	moderated_item_id: z.number().int().positive(),
+	moderated_item_type: ModeratedItemType,
+	status: ModerationStatus.nullable().optional(),
+	text: z.string().nullable().optional()
+}).strict();
+//#endregion
+export { ModerationReviewCompact as n, ModerationReviewCreateInput as r, ModerationReview as t };

package/dist/{notification-DVrLkjFT.mjs → notification-DOYdl0ao.mjs}

@@ -1,4 +1,4 @@
-import { g as MALFORMED_CELL } from "./cli.mjs";
+import { _ as MALFORMED_CELL } from "./cli.mjs";
 import { i as NotificationCompact, o as NotificationHandler, r as NotificationCardPayload, s as NotificationSubscription } from "./notification-DaA4bBHW.mjs";
 import { z } from "zod";
 //#region src/output/views/notification.ts

package/dist/{parameter-values-DWjmO7Ai.mjs → parameter-values-CZow98nb.mjs}

@@ -1,6 +1,6 @@
-import { H as outputFlags, Q as ConfigError, U as profileFlag, p as renderSummary, z as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-nCPku2nN.mjs";
-import { t as parseId } from "./parse-id-whJX4DAb.mjs";
+import { H as connectionFlags, J as profileFlag, at as ConfigError, p as renderSummary, q as outputFlags } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-CZ5zh32z.mjs";
+import { t as parseId } from "./parse-id-BW09NysN.mjs";
 import { i as ParameterValuesCompact, r as ParameterValues } from "./parameter-Celg0wZa.mjs";
 //#region src/output/views/parameter.ts
 const parameterValuesView = {

package/dist/{parse-enum-Dc0dMZ3P.mjs → parse-enum-CLIXMsd8.mjs}

@@ -1,4 +1,4 @@
-import { Q as ConfigError } from "./cli.mjs";
+import { at as ConfigError } from "./cli.mjs";
 //#region src/commands/parse-enum.ts
 function parseEnumFlag(value, schema, name) {
 	const result = schema.safeParse(value);

package/dist/parse-id-BW09NysN.mjs

@@ -0,0 +1,13 @@
+import { tt as parseInteger } from "./runtime-CZ5zh32z.mjs";
+//#region src/commands/parse-id.ts
+function parseId(value, name = "id") {
+	return parseInteger(value, {
+		name,
+		min: 1
+	});
+}
+function parseIdCsv(raw, name) {
+	return raw.split(",").map((part) => parseId(part, name));
+}
+//#endregion
+export { parseIdCsv as n, parseId as t };

package/dist/{parse-ref-DTDld_LJ.mjs → parse-ref-Cw5fa4FI.mjs}

@@ -1,4 +1,4 @@
-import { Q as ConfigError } from "./cli.mjs";
+import { at as ConfigError } from "./cli.mjs";
 //#region src/commands/collection/parse-ref.ts
 const SPECIAL_TOKENS = /* @__PURE__ */ new Set(["root", "trash"]);
 const POSITIVE_INTEGER_PATTERN = /^[1-9]\d*$/;

package/dist/parse-text-T0lTXzTZ.mjs

@@ -0,0 +1,11 @@
+import { S as isBlank, at as ConfigError } from "./cli.mjs";
+//#region src/commands/parse-text.ts
+function parseText(value, name) {
+	if (isBlank(value)) throw new ConfigError(`invalid ${name}: must not be blank`);
+	return value;
+}
+function parseOptionalText(value, name) {
+	return value === void 0 ? void 0 : parseText(value, name);
+}
+//#endregion
+export { parseText as n, parseOptionalText as t };

package/dist/{path-BUUAGYO5.mjs → path-K6LPLYPb.mjs}

@@ -1,7 +1,7 @@
-import { B as listFlags, G as listEnvelopeSchema, H as outputFlags, d as renderList } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-nCPku2nN.mjs";
-import { n as windowList } from "./window-DSb1tqSe.mjs";
-import { i as loadVisibleSkills, n as findSkillByName, r as loadAllSkills } from "./skills-CqtNuSXM.mjs";
+import { G as listFlags, X as listEnvelopeSchema, d as renderList, q as outputFlags } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-CZ5zh32z.mjs";
+import { n as windowList } from "./window-CI_QD04s.mjs";
+import { i as loadVisibleSkills, n as findSkillByName, r as loadAllSkills } from "./skills-CJ9eXouJ.mjs";
 import { z } from "zod";
 //#region src/commands/skills/path.ts
 const SkillPath = z.object({

package/dist/{poll-CZeXepUQ.mjs → poll-Dz4tUm2f.mjs}

@@ -1,5 +1,5 @@
-import { rt as TimeoutError } from "./cli.mjs";
-import { n as throwIfAborted, t as combineAborts } from "./signal-k7cm5N6h.mjs";
+import { ut as TimeoutError } from "./cli.mjs";
+import { n as throwIfAborted, t as combineAborts } from "./signal-CxWeLszu.mjs";
 import { setTimeout } from "node:timers/promises";
 //#region ../client/src/poll.ts
 const DEFAULT_INTERVAL_MS = 2e3;

package/dist/{preflight-DcULqq8E.mjs → preflight-CX6cqB90.mjs}

@@ -1,6 +1,6 @@
-import { Q as ConfigError, et as MetabaseError, m as writeJson } from "./cli.mjs";
-import { R as chainRequestFailure } from "./runtime-nCPku2nN.mjs";
-import "./validate-xR_MHBNR.mjs";
+import { at as ConfigError, h as writeJson, st as MetabaseError } from "./cli.mjs";
+import { F as chainRequestFailure } from "./runtime-CZ5zh32z.mjs";
+import "./validate-D7e110oU.mjs";
 //#region src/commands/dashboard/preflight.ts
 async function preflightDashcardCardReferences(client, dashcards) {
 	const issues = await client.dashboard.checkCardReferences(dashcards);

package/dist/{process-CTrfxxaC.mjs → process-D0HdqZ3r.mjs}

@@ -1,4 +1,4 @@
-import { st as isFileNotFoundError } from "./cli.mjs";
+import { ht as isFileNotFoundError } from "./cli.mjs";
 import { spawn } from "node:child_process";
 //#region src/runtime/process.ts
 var ProcessNotFoundError = class extends Error {

package/dist/{publish-qVFmJQ1E.mjs → publish-COatW4Un.mjs}

@@ -1,7 +1,7 @@
-import { E as warn, H as outputFlags, U as profileFlag, ot as errorMessage, p as renderSummary, z as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-nCPku2nN.mjs";
-import { a as CollectionCompact, r as Collection } from "./collection-BxdPxD38.mjs";
-import { n as tableSelectorFlags, t as parseTableSelectors } from "./selectors-rEFuyXPZ.mjs";
+import { H as connectionFlags, J as profileFlag, k as warn, p as renderSummary, pt as errorMessage, q as outputFlags } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-CZ5zh32z.mjs";
+import { a as CollectionCompact, r as Collection } from "./collection-D3KXhvnc.mjs";
+import { i as tableSelectorFlags, n as parseTableSelectors } from "./table-selector-flags-1bYkAKld.mjs";
 import { z } from "zod";
 //#region src/commands/git-sync/sync-scope.ts
 function isOutsideSyncScope(collection) {

package/dist/{pulse-x0gFxWfG.mjs → pulse-D1uh8UIU.mjs}

@@ -1,4 +1,4 @@
-import { g as MALFORMED_CELL } from "./cli.mjs";
+import { _ as MALFORMED_CELL } from "./cli.mjs";
 import { n as PulseChannel, r as PulseCompact } from "./pulse-Dz0ocv0l.mjs";
 import { z } from "zod";
 //#region src/output/views/pulse.ts

package/dist/query-BJXTIDhy.mjs

@@ -0,0 +1,328 @@
+import { H as connectionFlags, J as profileFlag, _ as MALFORMED_CELL, at as ConfigError, h as writeJson, m as serializeJson, p as renderSummary, q as outputFlags, u as renderItem } from "./cli.mjs";
+import { F as chainRequestFailure, P as HttpError, R as parseJson, t as defineMetabaseCommand } from "./runtime-CZ5zh32z.mjs";
+import { t as readBody } from "./body-Dd-TwYYL.mjs";
+import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
+import { t as Field } from "./field-5nivEfd6.mjs";
+import { a as CardQueryResult, l as DatasetQuery, p as VisualizationSettings } from "./card-Bv4ZN0oV.mjs";
+import { p as TableQueryMetadata } from "./table-Ci6bhZkb.mjs";
+import { t as Database } from "./database-D-CRyRIv.mjs";
+import { t as Snippet } from "./snippet-CyKAgIZl.mjs";
+import { a as VirtualTable, i as QueryMetadataCompact, n as CompiledQueryCompact, r as QueryMetadata, t as CompiledQuery } from "./dataset-p5oNPQgL.mjs";
+import { t as cardQueryView } from "./card-DSrgU7lT.mjs";
+import { a as validateQuery, i as isMbql5Query, n as assertNotLegacyEnvelopeWrappingMbql5, r as getQuerySchemaBundle, t as ValidationOutcome } from "./validate-D7e110oU.mjs";
+import { o as skipValidateFlag } from "./validate-query-C7LuKiUT.mjs";
+import { i as formatQueryResult, n as exportFlags, r as readExportRequest, t as assertStreamedOutput } from "./export-flags-NiZ7C3Gm.mjs";
+import { t as pipeToStdout } from "./stream-McixcoUl.mjs";
+import { z } from "zod";
+//#region src/output/views/dataset.ts
+const DatabaseNames = z.array(Database.pick({ name: true }));
+const TableNames = z.array(z.union([TableQueryMetadata.pick({ display_name: true }), VirtualTable.pick({ display_name: true })]));
+const FieldNames = z.array(Field.pick({ display_name: true }));
+const SnippetNames = z.array(Snippet.pick({ name: true }));
+function joinLabels(schema, label) {
+	return (value) => {
+		const parsed = schema.safeParse(value);
+		return parsed.success ? parsed.data.map(label).join(", ") : MALFORMED_CELL;
+	};
+}
+const compiledQueryView = {
+	compactPick: CompiledQueryCompact,
+	tableColumns: [
+		{
+			key: "query",
+			label: "Query"
+		},
+		{
+			key: "params",
+			label: "Params"
+		},
+		{
+			key: "collection",
+			label: "Collection"
+		}
+	]
+};
+const queryMetadataView = {
+	compactPick: QueryMetadataCompact,
+	tableColumns: [
+		{
+			key: "databases",
+			label: "Databases",
+			format: joinLabels(DatabaseNames, (database) => database.name)
+		},
+		{
+			key: "tables",
+			label: "Tables",
+			format: joinLabels(TableNames, (table) => table.display_name)
+		},
+		{
+			key: "fields",
+			label: "Fields",
+			format: joinLabels(FieldNames, (field) => field.display_name)
+		},
+		{
+			key: "snippets",
+			label: "Snippets",
+			format: joinLabels(SnippetNames, (snippet) => snippet.name)
+		}
+	]
+};
+//#endregion
+//#region src/commands/query-mode.ts
+const queryModeFlags = {
+	"dry-run": {
+		type: "boolean",
+		description: "Check the body and compile it on the server to native SQL without running it; prints {ok, errors, sql}"
+	},
+	compile: {
+		type: "boolean",
+		description: "Print the native query the server compiles the body to, instead of running it"
+	},
+	metadata: {
+		type: "boolean",
+		description: "Print the databases, tables, fields and snippets the body references, instead of running it"
+	},
+	pretty: {
+		type: "boolean",
+		description: "With --compile: format the native query for reading, as the server does by default; --no-pretty compiles to one line"
+	},
+	...exportFlags,
+	"visualization-settings": {
+		type: "string",
+		description: "With --export-format: JSON object of visualization settings; column settings shape --format-rows, pivot_table.column_split the --pivot-results layout"
+	},
+	"print-schema": {
+		type: "boolean",
+		description: "Emit the bundled MBQL 5 query JSON Schema and exit; no body required"
+	}
+};
+const COLUMN_SPLIT_KEY = "pivot_table.column_split";
+const PIVOT_NEEDS_SPLIT = `--pivot-results requires --visualization-settings with ${COLUMN_SPLIT_KEY}`;
+function resolveQueryMode(args) {
+	const exportRequest = readExportRequest(args);
+	const visualizationSettings = readVisualizationSettings(args, exportRequest);
+	const selected = [];
+	if (args["print-schema"] === true) selected.push({
+		flag: "--print-schema",
+		mode: { kind: "print-schema" }
+	});
+	if (args["dry-run"] === true) selected.push({
+		flag: "--dry-run",
+		mode: { kind: "dry-run" }
+	});
+	if (args.compile === true) selected.push({
+		flag: "--compile",
+		mode: {
+			kind: "compile",
+			pretty: args.pretty
+		}
+	});
+	if (args.metadata === true) selected.push({
+		flag: "--metadata",
+		mode: { kind: "metadata" }
+	});
+	if (exportRequest !== null) {
+		const params = {
+			...exportRequest.params,
+			visualization_settings: visualizationSettings
+		};
+		selected.push({
+			flag: "--export-format",
+			mode: {
+				kind: "export",
+				format: exportRequest.format,
+				params
+			}
+		});
+	}
+	const [first, ...rest] = selected;
+	if (first === void 0) {
+		assertPrettyLeftAlone(args, { kind: "run" });
+		return { kind: "run" };
+	}
+	if (rest.length > 0) {
+		const others = rest.map((entry) => entry.flag).join(", ");
+		throw new ConfigError(`${first.flag} cannot be combined with ${others}`);
+	}
+	assertPrettyLeftAlone(args, first.mode);
+	return first.mode;
+}
+function assertPrettyLeftAlone(args, mode) {
+	if (args.pretty === void 0 || mode.kind === "compile") return;
+	throw new ConfigError(`${args.pretty ? "--pretty" : "--no-pretty"} requires --compile`);
+}
+function readVisualizationSettings(args, exportRequest) {
+	const raw = args["visualization-settings"];
+	const given = raw !== void 0 && raw !== "";
+	if (exportRequest === null) {
+		if (given) throw new ConfigError("--visualization-settings requires --export-format");
+		return;
+	}
+	if (!given) {
+		if (exportRequest.params.pivot_results) throw new ConfigError(PIVOT_NEEDS_SPLIT);
+		return;
+	}
+	const settings = parseJson(raw, VisualizationSettings, { source: "--visualization-settings" });
+	if (exportRequest.params.pivot_results && !hasColumnSplit(settings)) throw new ConfigError(PIVOT_NEEDS_SPLIT);
+	return settings;
+}
+function hasColumnSplit(settings) {
+	const split = settings[COLUMN_SPLIT_KEY];
+	return typeof split === "object" && split !== null;
+}
+//#endregion
+//#region src/commands/query.ts
+const QueryBody = z.unknown().describe("The query body: {\"lib/type\": \"mbql/query\", database, stages}; full schema: mb query --print-schema");
+const QueryDryRunOutcome = ValidationOutcome.extend({ sql: z.string().nullable().describe("The compiled native query; null when it did not compile") });
+const QueryOutput = z.union([
+	CardQueryResult,
+	QueryDryRunOutcome,
+	CompiledQuery,
+	QueryMetadata
+]);
+const COMPILE_REJECTION_STATUSES = /* @__PURE__ */ new Set([400, 500]);
+const FORBIDDEN_STATUS = 403;
+const WHOLE_QUERY_POINTER = "";
+const VALIDATION_HINT = " — fix them, or pass --skip-validate to send anyway";
+var query_default = defineMetabaseCommand({
+	meta: {
+		name: "query",
+		description: "Run, compile, or inspect an ad-hoc MBQL or native query"
+	},
+	details: "Reads a JSON query body from --body, --file, or stdin and runs it. MBQL 5 is Metabase's structured query format, shaped {\"lib/type\": \"mbql/query\", \"database\": <database id>, \"stages\": [{\"lib/type\": \"mbql.stage/mbql\", \"source-table\": <table id>, \"aggregation\": [[\"count\", {}]]}]} with ids from `mb database list` and `mb table list`; it is checked against a bundled JSON Schema before sending, and --print-schema prints that schema. --dry-run checks the body without running it: the local schema check, then the server compiles it to native SQL without touching the warehouse. It prints {ok, errors:[{path, message}], sql} and exits 0 when the query compiled, 2 when either check rejected it. Legacy MBQL 4 and legacy native bodies skip the local check. --compile prints the native query the server compiles the body to, --metadata the databases, tables, fields and snippets the body touches, and --export-format streams the rows as csv, json or xlsx; the three are mutually exclusive with each other, with --dry-run and with --print-schema. An export takes its column formatting and pivot layout from --visualization-settings, since an ad-hoc query has no card to read them from: --pivot-results needs their pivot_table.column_split.",
+	skills: [{
+		skill: "mbql",
+		purpose: "body shape, clause rules, and the dry-run loop"
+	}],
+	requires: [
+		"dataset.exportQuery",
+		"dataset.native",
+		"dataset.query",
+		"dataset.queryMetadata"
+	],
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		...bodyInputFlags,
+		...queryModeFlags,
+		...skipValidateFlag
+	},
+	inputSchema: QueryBody,
+	outputSchema: QueryOutput,
+	examples: [
+		"mb query --print-schema",
+		"cat q.json | mb query --dry-run",
+		"mb query --file q.json",
+		"mb query --file q.json --compile",
+		"mb query --file q.json --metadata --json",
+		"mb query --file q.json --export-format csv > rows.csv",
+		"mb query --file q.json --skip-validate"
+	],
+	async run({ args, ctx, getClient }) {
+		const mode = resolveQueryMode(args);
+		if (mode.kind === "print-schema") {
+			writeJson(getQuerySchemaBundle());
+			return;
+		}
+		const skip = args["skip-validate"] === true;
+		if (mode.kind === "dry-run" && skip) throw new ConfigError("--skip-validate cannot be combined with --dry-run");
+		if (mode.kind === "export") assertStreamedOutput(ctx);
+		const sources = {
+			flag: args.body,
+			file: args.file
+		};
+		if (mode.kind === "dry-run") {
+			const query = await readQuery(sources, {
+				skip: false,
+				dryRun: true
+			});
+			const outcome = await (await getClient()).dataset.native(query).then(compiledOutcome, rejectedOutcome);
+			writeJson(outcome);
+			if (!outcome.ok) throw new ConfigError(`server validation failed: ${outcome.errors.length} error(s)`);
+			return;
+		}
+		const datasetQuery = await readQuery(sources, {
+			skip,
+			dryRun: false
+		});
+		const client = await getClient();
+		if (mode.kind === "run") {
+			const queryResult = await client.dataset.query(datasetQuery);
+			renderSummary(queryResult, cardQueryView, () => formatQueryResult(queryResult), ctx);
+			return;
+		}
+		switch (mode.kind) {
+			case "compile": {
+				const compiled = await client.dataset.native(datasetQuery, { pretty: mode.pretty }).catch(refusedCompile);
+				renderSummary(compiled, compiledQueryView, () => formatCompiledQuery(compiled), ctx);
+				return;
+			}
+			case "metadata":
+				renderItem(await client.dataset.queryMetadata(datasetQuery), queryMetadataView, ctx);
+				return;
+			case "export":
+				await pipeToStdout(await client.dataset.exportQuery(mode.format, {
+					query: datasetQuery,
+					...mode.params
+				}));
+				return;
+		}
+	}
+});
+function notCompiled(local) {
+	return {
+		...local,
+		sql: null
+	};
+}
+function compiledOutcome(compiled) {
+	return {
+		ok: true,
+		errors: [],
+		sql: formatCompiledQuery(compiled)
+	};
+}
+function rejectedOutcome(error) {
+	if (!(error instanceof HttpError)) throw error;
+	if (error.status === FORBIDDEN_STATUS) throw compilePermissionFailure(error);
+	if (!COMPILE_REJECTION_STATUSES.has(error.status)) throw error;
+	return {
+		ok: false,
+		errors: [{
+			path: WHOLE_QUERY_POINTER,
+			message: error.message
+		}],
+		sql: null
+	};
+}
+function refusedCompile(error) {
+	if (error instanceof HttpError && error.status === FORBIDDEN_STATUS) throw compilePermissionFailure(error);
+	throw error;
+}
+function compilePermissionFailure(error) {
+	return chainRequestFailure(error, `the server refused to compile the query; compiling needs native query permission on its database and access to every table and card it reads: ${error.message}`);
+}
+async function readQuery(sources, options) {
+	const body = await readBody(sources, QueryBody);
+	preflightQuery(body, options);
+	return DatasetQuery.parse(body);
+}
+function preflightQuery(body, options) {
+	if (options.skip) return;
+	assertNotLegacyEnvelopeWrappingMbql5(body, {
+		contextLabel: "query",
+		bodyNoun: "the body"
+	});
+	if (!isMbql5Query(body)) return;
+	const outcome = validateQuery(body);
+	if (outcome.ok) return;
+	writeJson(options.dryRun ? notCompiled(outcome) : outcome);
+	const hint = options.dryRun ? "" : VALIDATION_HINT;
+	throw new ConfigError(`validation failed: ${outcome.errors.length} error(s)${hint}`);
+}
+function formatCompiledQuery(compiled) {
+	return typeof compiled.query === "string" ? compiled.query : serializeJson(compiled.query, false);
+}
+//#endregion
+export { query_default as default };