@metabase/cli 0.3.2 → 0.4.0

package/dist/{query-Cq1lmqL5.mjs → query-DmvkyDfo.mjs}

@@ -1,9 +1,9 @@
-import { H as outputFlags, Q as ConfigError, U as profileFlag, p as renderSummary, z as connectionFlags } from "./cli.mjs";
-import { V as parseJson, it as parseOptionalInteger, t as defineMetabaseCommand } from "./runtime-nCPku2nN.mjs";
-import { t as parseId } from "./parse-id-whJX4DAb.mjs";
-import { a as CardQueryResult, u as ExportFormat } from "./card-voh1k4hl.mjs";
-import { t as cardQueryView } from "./card-CEkp1mcI.mjs";
-import { t as formatQueryResult } from "./query-result-E4Q-Gra6.mjs";
+import { H as connectionFlags, J as profileFlag, p as renderSummary, q as outputFlags } from "./cli.mjs";
+import { R as parseJson, nt as parseOptionalInteger, t as defineMetabaseCommand } from "./runtime-CZ5zh32z.mjs";
+import { t as parseId } from "./parse-id-BW09NysN.mjs";
+import { a as CardQueryResult } from "./card-Bv4ZN0oV.mjs";
+import { t as cardQueryView } from "./card-DSrgU7lT.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/commands/card/query.ts
@@ -23,27 +23,14 @@ var query_default = defineMetabaseCommand({
 			description: "Card id",
 			required: true
 		},
-		"export-format": {
-			type: "string",
-			description: `Bypass JSON envelope and stream raw export: ${ExportFormat.options.join(" | ")}`
-		},
+		...exportFlags,
 		parameters: {
 			type: "string",
 			description: "JSON array of Metabase parameter objects to pass with the query"
 		},
 		limit: {
 			type: "string",
-			description: "Cap rows kept in the JSON envelope (no effect on streamed exports)"
-		},
-		"format-rows": {
-			type: "boolean",
-			description: "Streamed exports only: apply visualization-settings formatting to values (default false)",
-			default: false
-		},
-		"pivot-results": {
-			type: "boolean",
-			description: "Streamed exports only: emit the pivoted output for pivot questions (default false)",
-			default: false
+			description: "Cap rows kept in the JSON envelope; refused with --export-format"
 		}
 	},
 	outputSchema: CardQueryResult,
@@ -56,17 +43,16 @@ var query_default = defineMetabaseCommand({
 	async run({ args, ctx, getClient }) {
 		const id = parseId(args.id);
 		const parameters = parseParameters(args.parameters);
-		const client = await getClient();
-		const exportFormatRaw = args["export-format"];
-		if (exportFormatRaw !== void 0 && exportFormatRaw !== "") {
-			await pipeToStdout(await client.card.exportQuery(id, parseExportFormat(exportFormatRaw), {
+		const exportRequest = readExportRequest(args);
+		if (exportRequest !== null) {
+			assertStreamedOutput(ctx);
+			await pipeToStdout(await (await getClient()).card.exportQuery(id, exportRequest.format, {
 				parameters,
-				format_rows: args["format-rows"],
-				pivot_results: args["pivot-results"]
+				...exportRequest.params
 			}));
 			return;
 		}
-		const limited = applyLimit(await client.card.query(id, { parameters }), parseOptionalInteger(args.limit, {
+		const limited = applyLimit(await (await getClient()).card.query(id, { parameters }), parseOptionalInteger(args.limit, {
 			name: "--limit",
 			min: 1
 		}));
@@ -77,11 +63,6 @@ function parseParameters(raw) {
 	if (raw === void 0 || raw === "") return [];
 	return parseJson(raw, QueryParameters, { source: "--parameters" });
 }
-function parseExportFormat(raw) {
-	const result = ExportFormat.safeParse(raw);
-	if (!result.success) throw new ConfigError(`invalid --export-format: "${raw}" (expected: ${ExportFormat.options.join(", ")})`);
-	return result.data;
-}
 function applyLimit(result, limit) {
 	if (limit === null || result.data === void 0 || result.data.rows.length <= limit) return result;
 	return {

package/dist/remapping-CPAvDKHV.mjs

@@ -0,0 +1,53 @@
+import { H as connectionFlags, J as profileFlag, p as renderSummary, q as outputFlags, v as formatScalar } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-CZ5zh32z.mjs";
+import { t as parseId } from "./parse-id-BW09NysN.mjs";
+import { n as parseText } from "./parse-text-T0lTXzTZ.mjs";
+import { i as fieldRemappingMissView, r as fieldRemappingMatchView, t as FieldRemappingResult, u as toValueLabel } from "./field-wmN6raOG.mjs";
+//#region src/commands/field/remapping.ts
+var remapping_default = defineMetabaseCommand({
+	meta: {
+		name: "remapping",
+		description: "Look up another field's value on the row where a field equals a value"
+	},
+	details: "Answers `{ found: true, value, label }` with `label` the value of `<remapped-id>` on the one row where `<id>` equals `<value>`, or `{ found: false }` when no row does. A FK `<id>` is followed to the key it points at, and `<remapped-id>` must be on that key's table: the server answers a pair that is not, and any failure of the warehouse query, as `{ found: false }` rather than an error. When `<id>` is numeric the server reads the leading number of `<value>` and ignores any text after it (`20abc` looks up 20), failing only a value with no leading number; a value starting with `-` goes after `--` (`mb field remapping 100 101 -- -5`). In text mode the label prints bare so the result composes in a shell; an empty line means either no row matched or the matched label is empty, which `--json` tells apart.",
+	requires: ["field.remapping"],
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		id: {
+			type: "positional",
+			description: "Field id the value belongs to",
+			required: true
+		},
+		"remapped-id": {
+			type: "positional",
+			description: "Field id whose value on that row is answered",
+			required: true
+		},
+		value: {
+			type: "positional",
+			description: "Value of <id> to look up",
+			required: true
+		}
+	},
+	outputSchema: FieldRemappingResult,
+	examples: ["mb field remapping 100 101 20", "mb field remapping 100 101 20 --json"],
+	async run({ args, ctx, getClient }) {
+		const id = parseId(args.id);
+		const remappedId = parseId(args["remapped-id"], "remapped-id");
+		const value = parseText(args.value, "value");
+		const pair = await (await getClient()).field.remapping(id, remappedId, { value });
+		if (pair === null) {
+			renderSummary({ found: false }, fieldRemappingMissView, "", ctx);
+			return;
+		}
+		const match = {
+			found: true,
+			...toValueLabel(pair)
+		};
+		renderSummary(match, fieldRemappingMatchView, formatScalar(match.label), ctx);
+	}
+});
+//#endregion
+export { remapping_default as default };

package/dist/{remove-collection-DBqh2Lqm.mjs → remove-collection-Bg-sNX3U.mjs}

@@ -1,8 +1,8 @@
-import { H as outputFlags, 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 { c as SyncSettingsUpdateResult } from "./git-sync-BwBRmEhE.mjs";
-import { o as syncSettingsUpdateView } from "./git-sync-TjX1r_wF.mjs";
+import { H as connectionFlags, J as profileFlag, 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 { l as SyncSettingsUpdateResult } from "./git-sync-COokpYgc.mjs";
+import { c as syncSettingsUpdateView } from "./git-sync-DspFahwV.mjs";
 //#region src/commands/git-sync/remove-collection.ts
 var remove_collection_default = defineMetabaseCommand({
 	meta: {

package/dist/{render-Gx1hR7IF.mjs → render-BSfDD6ip.mjs}

@@ -1,5 +1,5 @@
-import { ct as KNOWN_RANGE } from "./cli.mjs";
-import { Q as Skew } from "./runtime-nCPku2nN.mjs";
+import { gt as KNOWN_RANGE } from "./cli.mjs";
+import { Y as Skew } from "./runtime-CZ5zh32z.mjs";
 //#region src/commands/auth/render.ts
 const SKEW_LABEL = Object.freeze({
 	supported: "supported",

package/dist/{replace-CujInVY9.mjs → replace-RCHeZLUT.mjs}

@@ -1,8 +1,8 @@
-import { H as outputFlags, 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, 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 { n as UploadUpdateResult } from "./upload-DAtxBBms.mjs";
-import { n as requireUploadFilePath, t as readCsvFile } from "./upload-Do2PBSeH.mjs";
+import { n as requireUploadFilePath, t as readCsvFile } from "./upload-C2fhpKkP.mjs";
 import { n as uploadUpdateResultView } from "./upload-C3z5ZaXA.mjs";
 //#region src/commands/upload/replace.ts
 var replace_default = defineMetabaseCommand({

package/dist/{rescan-values-HypqBCSK.mjs → rescan-values-CpDGYZvf.mjs}

@@ -1,8 +1,8 @@
-import { H as outputFlags, 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 { a as DatabaseSyncResult } from "./database-JtHTqSpq.mjs";
-import { t as databaseSyncResultView } from "./database-C3E9PZSx.mjs";
+import { H as connectionFlags, J as profileFlag, 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 { a as DatabaseSyncResult } from "./database-D-CRyRIv.mjs";
+import { t as databaseSyncResultView } from "./database-MlUPpitM.mjs";
 //#region src/commands/db/rescan-values.ts
 var rescan_values_default = defineMetabaseCommand({
 	meta: {

package/dist/rescan-values-PeMnpaFY.mjs

@@ -0,0 +1,32 @@
+import { H as connectionFlags, J as profileFlag, 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 { l as TableFieldValuesResult } from "./table-Ci6bhZkb.mjs";
+import { i as tableFieldValuesResultView } from "./table-CxvaDiIZ.mjs";
+//#region src/commands/table/rescan-values.ts
+var rescan_values_default = defineMetabaseCommand({
+	meta: {
+		name: "rescan-values",
+		description: "Trigger a rescan of cached field values for one table"
+	},
+	details: "Queues an async rescan of the distinct values behind this table's filter dropdowns and returns immediately with the server's `success` acknowledgement. Only the sets already cached and read in the last 14 days are refreshed; a set never read, discarded, or unread for longer is skipped until a read rebuilds or revives it. To rescan a set of tables use `mb table bulk-rescan-values`.",
+	requires: ["table.rescanValues"],
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		id: {
+			type: "positional",
+			description: "Table id",
+			required: true
+		}
+	},
+	outputSchema: TableFieldValuesResult,
+	examples: ["mb table rescan-values 42", "mb table rescan-values 42 --json"],
+	async run({ args, ctx, getClient }) {
+		const id = parseId(args.id);
+		renderSummary(await (await getClient()).table.rescanValues(id), tableFieldValuesResultView, `Field-values rescan queued for table ${id}.`, ctx);
+	}
+});
+//#endregion
+export { rescan_values_default as default };

package/dist/{run-DEkQSOQa.mjs → run-CaQ7kubO.mjs}

@@ -1,6 +1,6 @@
-import { H as outputFlags, 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, 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 { a as TransformJobRunResult } from "./transform-job-CCguL6LP.mjs";
 //#region src/commands/transform-job/run.ts
 const transformJobRunResultView = {

package/dist/{run-b3jyF29q.mjs → run-DkRkZRgf.mjs}

@@ -1,8 +1,8 @@
-import { H as outputFlags, 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, 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 { c as TransformRunResult, p as isTransformRunFailed } from "./transform-DiW7bREn.mjs";
-import { i as waitFlags, n as parseWaitFlags } from "./wait-flags-BCeCnaz3.mjs";
+import { i as waitFlags, n as parseWaitFlags } from "./wait-flags-rUU4NUrv.mjs";
 //#region src/commands/transform/run.ts
 const transformRunResultView = {
 	compactPick: TransformRunResult,

package/dist/{runs-GHqHLGy4.mjs → runs-BDjoVJ0P.mjs}

@@ -1,9 +1,9 @@
-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 { t as parseId } from "./parse-id-whJX4DAb.mjs";
-import { t as collectForOutput } 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 { t as parseId } from "./parse-id-BW09NysN.mjs";
+import { t as collectForOutput } from "./window-CI_QD04s.mjs";
 import { s as TransformRunCompact } from "./transform-DiW7bREn.mjs";
-import { t as transformRunView } from "./transform-CtqB1WYo.mjs";
+import { t as transformRunView } from "./transform-CNBIV7No.mjs";
 //#region src/commands/transform/runs.ts
 const TransformRunListEnvelope = listEnvelopeSchema(TransformRunCompact);
 var runs_default = defineMetabaseCommand({

package/dist/{runtime-nCPku2nN.mjs → runtime-CZ5zh32z.mjs}

@@ -1,4 +1,4 @@
-import { D as ENV_API_KEY, E as warn, F as ProfileRefreshedError, I as setMetabaseAugment, J as normalizeFlag, M as ENV_URL, N as consumeLegacyEnvWarnings, O as ENV_DISABLE_KEYRING, P as readEnv, Q as ConfigError, R as version, Y as toAliasArray, Z as ChainedRequestError, a as Features, at as ValidationError, b as isPlainObject, c as ruleGap, ct as KNOWN_RANGE, et as MetabaseError, i as FEATURE_RULES, j as ENV_SKIP_PREFLIGHT, l as reportError, n as methodRequirements, nt as ResponseShapeError, o as evaluateFeatures, ot as errorMessage, q as flagConsumesValue, r as FEATURE_NAMES, rt as TimeoutError, st as isFileNotFoundError, t as interruptSignal, tt as NetworkError } from "./cli.mjs";
+import { $ as givenFlagKeys, A as ENV_API_KEY, C as isPlainObject, F as ENV_URL, I as consumeLegacyEnvWarnings, L as readEnv, P as ENV_SKIP_PREFLIGHT, Q as assertArgv, R as ProfileRefreshedError, V as version, a as Features, at as ConfigError, c as ruleGap, ct as NetworkError, et as parseCsv, ft as ValidationError, gt as KNOWN_RANGE, ht as isFileNotFoundError, i as FEATURE_RULES, it as ChainedRequestError, j as ENV_DISABLE_KEYRING, k as warn, l as reportError, lt as ResponseShapeError, n as methodRequirements, o as evaluateFeatures, pt as errorMessage, r as FEATURE_NAMES, st as MetabaseError, t as interruptSignal, ut as TimeoutError, z as setMetabaseAugment } from "./cli.mjs";
 import { defineCommand } from "citty";
 import { z } from "zod";
 import { Entry } from "@napi-rs/keyring";
@@ -9,7 +9,10 @@ import { homedir } from "node:os";
 const INTEGER_PATTERN = /^-?\d+$/;
 function parseInteger(value, options) {
 	const trimmed = value.trim();
-	if (!INTEGER_PATTERN.test(trimmed)) throw new ConfigError(`invalid ${options.name}: "${value}" (expected integer)`);
+	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;
@@ -1462,34 +1465,6 @@ function resolveFormat({ json, format, isTty }) {
 	return isTty ? "text" : "json";
 }
 //#endregion
-//#region src/runtime/csv.ts
-function parseCsv(raw) {
-	return raw.split(",").map((part) => part.trim()).filter((part) => part.length > 0);
-}
-function parseEnumCsv(raw, schema, flagName) {
-	if (raw === void 0 || raw === "") return;
-	const parts = parseCsv(raw);
-	if (parts.length === 0) return;
-	const accepted = [];
-	const rejected = [];
-	for (const part of parts) {
-		const result = schema.safeParse(part);
-		if (result.success) accepted.push(result.data);
-		else rejected.push(part);
-	}
-	if (rejected.length > 0) {
-		const allowed = Object.values(schema.enum).join(", ");
-		throw new ConfigError(`invalid ${flagName} value: ${rejected.join(", ")} (expected one of: ${allowed})`);
-	}
-	return accepted;
-}
-function parseEnum(raw, schema, flagName) {
-	if (raw === void 0 || raw === "") return;
-	const result = schema.safeParse(raw);
-	if (!result.success) throw new ConfigError(`invalid ${flagName} value: "${raw}" (expected one of: ${Object.values(schema.enum).join(", ")})`);
-	return result.data;
-}
-//#endregion
 //#region src/commands/context.ts
 function resolveOutputFormat(args, options = {}) {
 	return resolveFormat({
@@ -1507,6 +1482,7 @@ function resolveCommonFlags(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,
@@ -1539,51 +1515,6 @@ function parseRange(limit, offset) {
 	};
 }
 //#endregion
-//#region src/commands/known-flags.ts
-const ARGUMENT_SEPARATOR = "--";
-const NEGATION_PREFIX = "no-";
-const BUILTIN_FLAGS = [
-	"help",
-	"h",
-	"version",
-	"v"
-];
-function assertKnownFlags(rawArgs, argsDef) {
-	const allowed = allowedFlagKeys(argsDef);
-	let index = 0;
-	while (index < rawArgs.length) {
-		const token = rawArgs[index];
-		if (token === void 0 || token === ARGUMENT_SEPARATOR) return;
-		if (!isFlagToken(token)) {
-			index += 1;
-			continue;
-		}
-		if (!flagCandidates(token).some((candidate) => allowed.has(candidate))) throw new ConfigError(`unknown flag: ${displayFlag(token)}`);
-		index += flagConsumesValue(token, argsDef) ? 2 : 1;
-	}
-}
-function allowedFlagKeys(argsDef) {
-	const keys = new Set(BUILTIN_FLAGS.map(normalizeFlag));
-	for (const [name, def] of Object.entries(argsDef)) {
-		keys.add(normalizeFlag(name));
-		if ("alias" in def) for (const alias of toAliasArray(def.alias)) keys.add(normalizeFlag(alias));
-	}
-	return keys;
-}
-function isFlagToken(token) {
-	return token.startsWith("-") && token !== "-";
-}
-function displayFlag(token) {
-	const equals = token.indexOf("=");
-	return equals === -1 ? token : token.slice(0, equals);
-}
-function flagCandidates(token) {
-	const name = displayFlag(token).replace(/^-+/, "");
-	const candidates = [normalizeFlag(name)];
-	if (name.startsWith(NEGATION_PREFIX)) candidates.push(normalizeFlag(name.slice(3)));
-	return candidates;
-}
-//#endregion
 //#region src/commands/runtime.ts
 function defineMetabaseCommand(def) {
 	const requirements = def.requires === null ? null : deriveRequirements(def.requires);
@@ -1591,12 +1522,12 @@ function defineMetabaseCommand(def) {
 		meta: def.meta,
 		args: def.args,
 		async run({ args, rawArgs }) {
-			const commonArgs = pickCommonArgs(args);
+			const commonArgs = pickCommonArgs(args, givenFlagKeys(rawArgs, def.args));
 			let reportFormat;
 			try {
-				reportFormat = resolveOutputFormat(commonArgs);
+				reportFormat = resolveReportFormat(commonArgs, rawArgs, def.args);
+				assertArgv(rawArgs, def.args);
 				const ctx = resolveCommonFlags(commonArgs);
-				assertKnownFlags(rawArgs, def.args);
 				let cachedConfig = null;
 				let cachedClient = null;
 				const getResolvedConfig = async () => {
@@ -1611,7 +1542,7 @@ function defineMetabaseCommand(def) {
 						const resolved = await getResolvedConfig();
 						const probe = await readCachedProbe(resolved.profile, resolved.url);
 						const server = probe === null ? null : createServerProfile(probe);
-						const { createClient } = await import("./client-BnK0evYf.mjs").then((n) => n.t);
+						const { createClient } = await import("./client-ToLiPu9q.mjs").then((n) => n.t);
 						cachedClient = createClient({
 							url: resolved.url,
 							credential: resolved.credential
@@ -1723,13 +1654,21 @@ async function refreshChangedProbe(cached) {
 	});
 	return note;
 }
-function pickCommonArgs(args) {
+function resolveReportFormat(commonArgs, rawArgs, argsDef) {
+	try {
+		return resolveOutputFormat(commonArgs);
+	} catch (error) {
+		assertArgv(rawArgs, argsDef);
+		throw error;
+	}
+}
+function pickCommonArgs(args, given) {
 	const out = {};
 	if (typeof args["format"] === "string") out.format = args["format"];
 	if (typeof args["json"] === "boolean") out.json = args["json"];
 	if (typeof args["full"] === "boolean") out.full = args["full"];
 	if (typeof args["fields"] === "string") out.fields = args["fields"];
-	if (typeof args["maxBytes"] === "string") out.maxBytes = args["maxBytes"];
+	if (typeof args["maxBytes"] === "string" && given.has("maxBytes")) out.maxBytes = args["maxBytes"];
 	if (typeof args["limit"] === "string") out.limit = args["limit"];
 	if (typeof args["offset"] === "string") out.offset = args["offset"];
 	if (typeof args["profile"] === "string") out.profile = args["profile"];
@@ -1746,4 +1685,4 @@ function buildConfigFlags(ctx) {
 	return flags;
 }
 //#endregion
-export { createServerProfile as $, OAUTH_SCOPE as A, JSON_CONTENT_TYPE as B, ProbedUser as C, OAUTH_CLIENT_NAME as D, profileAuthMethod as E, buildNetworkError as F, credentialSecrets as G, parseJsonOrPlain as H, isConnectionClosed as I, normalizeUrl as J, oauthCredentialFromTokens as K, HttpError as L, exchangeCode as M, registerClient as N, USER_AGENT as O, tryDiscoverMetadata as P, Skew as Q, chainRequestFailure as R, writeProfile as S, ProfileLastFailure as T, assertCredentialHeaderSafe as U, parseJson as V, credentialAuthHeader as W, summarizeServer as X, ServerSummary as Y, checkFeatures as Z, readProfileRecord as _, readCachedServerProfile as a, writeProbeFailure as b, readEnvCredentials as c, clearProfile as d, probeServer as et, consumeKeychainResidualWarning as f, readProfileCredential as g, listProfileRecords as h, parseEnumCsv as i, parseOptionalInteger as it, discoverLoginMetadata as j, revokeOAuthCredential as k, resolveProfileName as l, keyringFallbackWarning as m, parseCsv as n, RequirementFailure as nt, createCredentialRefresher as o, consumeKeyringDowngradeWarning as p, displayUrl as q, parseEnum as r, parseInteger as rt, explicitProfileName as s, defineMetabaseCommand as t, CapabilityError as tt, DEFAULT_PROFILE as u, resolveRecordCredential as v, ProfileAuthMethod as w, writeProbeResult as x, writeOAuthProfile as y, isRetryableStatus as z };
+export { CapabilityError as $, registerClient as A, assertCredentialHeaderSafe as B, profileAuthMethod as C, OAUTH_SCOPE as D, revokeOAuthCredential as E, chainRequestFailure as F, normalizeUrl as G, credentialSecrets as H, isRetryableStatus as I, checkFeatures as J, ServerSummary as K, JSON_CONTENT_TYPE as L, buildNetworkError as M, isConnectionClosed as N, discoverLoginMetadata as O, HttpError as P, probeServer as Q, parseJson as R, ProfileLastFailure as S, USER_AGENT as T, oauthCredentialFromTokens as U, credentialAuthHeader as V, displayUrl as W, createServerProfile as X, Skew as Y, PROBE_PATH as Z, writeProbeFailure as _, readEnvCredentials as a, ProbedUser as b, clearProfile as c, keyringFallbackWarning as d, RequirementFailure as et, listProfileRecords as f, writeOAuthProfile as g, resolveRecordCredential as h, explicitProfileName as i, tryDiscoverMetadata as j, exchangeCode as k, consumeKeychainResidualWarning as l, readProfileRecord as m, readCachedServerProfile as n, parseOptionalInteger as nt, resolveProfileName as o, readProfileCredential as p, summarizeServer as q, createCredentialRefresher as r, DEFAULT_PROFILE as s, defineMetabaseCommand as t, parseInteger as tt, consumeKeyringDowngradeWarning as u, writeProbeResult as v, OAUTH_CLIENT_NAME as w, ProfileAuthMethod as x, writeProfile as y, parseJsonOrPlain as z };

package/dist/{schema-tables-B5L05Y1L.mjs → schema-tables-C2qjLcPq.mjs}

@@ -1,9 +1,9 @@
-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 { t as parseId } from "./parse-id-whJX4DAb.mjs";
-import { n as windowList } from "./window-DSb1tqSe.mjs";
-import { n as TableCompact } from "./table-DfuY0N8e.mjs";
-import { t as tableView } from "./table-C6h4tIRw.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 { t as parseId } from "./parse-id-BW09NysN.mjs";
+import { n as windowList } from "./window-CI_QD04s.mjs";
+import { a as TableCompact } from "./table-Ci6bhZkb.mjs";
+import { u as tableView } from "./table-CxvaDiIZ.mjs";
 //#region src/commands/db/schema-tables.ts
 const DatabaseSchemaTablesEnvelope = listEnvelopeSchema(TableCompact);
 var schema_tables_default = defineMetabaseCommand({

package/dist/{schemas-Clx26p_4.mjs → schemas-D8hfNduk.mjs}

@@ -1,7 +1,7 @@
-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 { t as parseId } from "./parse-id-whJX4DAb.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 { t as parseId } from "./parse-id-BW09NysN.mjs";
+import { n as windowList } from "./window-CI_QD04s.mjs";
 import { z } from "zod";
 //#region src/commands/db/schemas.ts
 const SchemaName = z.object({ name: z.string() });

package/dist/search-BrQQuNmh.mjs

@@ -0,0 +1,131 @@
+import { H as connectionFlags, J as profileFlag, K as listFlagsWithDefaultLimit, W as listFlag, X as listEnvelopeSchema, at as ConfigError, d as renderList, nt as parseEnumCsv, q as outputFlags } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-CZ5zh32z.mjs";
+import { n as parseIdCsv, t as parseId } from "./parse-id-BW09NysN.mjs";
+import { r as windowServerPage } from "./window-CI_QD04s.mjs";
+import { i as SearchResultCompact, n as SearchModel, t as SEARCH_MODELS } from "./search-BAXg-EJw.mjs";
+import { t as parseOptionalText } from "./parse-text-T0lTXzTZ.mjs";
+//#region src/output/views/search.ts
+const searchResultView = {
+	compactPick: SearchResultCompact,
+	tableColumns: [
+		{
+			key: "id",
+			label: "ID"
+		},
+		{
+			key: "model",
+			label: "Model"
+		},
+		{
+			key: "name",
+			label: "Name"
+		}
+	]
+};
+//#endregion
+//#region src/commands/search.ts
+const DEFAULT_LIMIT = 20;
+const SEARCH_MODELS_DESCRIPTION = `Comma-separated model filter: ${SEARCH_MODELS.join(",")}`;
+const RESULT_METADATA = "result_metadata";
+const SearchListEnvelope = listEnvelopeSchema(SearchResultCompact);
+var search_default = defineMetabaseCommand({
+	meta: {
+		name: "search",
+		description: "Search Metabase content (cards, dashboards, collections, …)"
+	},
+	details: "Ranks content against a query string. To simply enumerate a resource, prefer its `… list` verb.",
+	skills: [{
+		skill: "core",
+		purpose: "search vs. list"
+	}],
+	requires: ["search.query"],
+	args: {
+		...outputFlags,
+		...listFlagsWithDefaultLimit(DEFAULT_LIMIT),
+		...profileFlag,
+		...connectionFlags,
+		query: {
+			type: "positional",
+			description: "Search query string",
+			required: false
+		},
+		models: listFlag({
+			type: "string",
+			description: SEARCH_MODELS_DESCRIPTION,
+			alias: "m"
+		}),
+		archived: {
+			type: "boolean",
+			description: "Search only archived items (instead of only active ones)",
+			default: false
+		},
+		"db-id": {
+			type: "string",
+			description: "Restrict to items on a given database id"
+		},
+		verified: {
+			type: "boolean",
+			description: "Only verified content"
+		},
+		collection: {
+			type: "string",
+			description: "Restrict to one collection by id: its own row, subcollections and the content filed under them, never segments, measures or transforms (dashboard questions need --include-dashboard-questions)"
+		},
+		"created-by": listFlag({
+			type: "string",
+			description: "Comma-separated user ids; matches items created by any of them (drops models with no creator)"
+		}),
+		"search-native-query": {
+			type: "boolean",
+			description: "Also match native query text; narrows to cards, models, metrics, actions and transforms"
+		},
+		"include-metadata": {
+			type: "boolean",
+			description: "Attach result_metadata to card, model and metric rows (needs --json --full, or --fields naming result_metadata)"
+		},
+		"include-dashboard-questions": {
+			type: "boolean",
+			description: "Also match questions saved into a dashboard (excluded by default)"
+		}
+	},
+	outputSchema: SearchListEnvelope,
+	examples: [
+		"mb search orders",
+		"mb search --models card,dashboard --limit 10 --json",
+		"mb search products --archived",
+		"mb search --collection 12 --created-by 3,7 --include-dashboard-questions --json",
+		"mb search revenue --search-native-query --include-metadata --full --json"
+	],
+	async run({ args, ctx, getClient }) {
+		const tableDbIdRaw = args["db-id"];
+		const tableDbId = tableDbIdRaw === void 0 ? void 0 : parseId(tableDbIdRaw, "--db-id");
+		const models = parseEnumCsv(args.models, SearchModel, "--models");
+		const collection = args.collection === void 0 ? void 0 : parseId(args.collection, "--collection");
+		const createdByRaw = args["created-by"];
+		const createdBy = createdByRaw === void 0 ? void 0 : parseIdCsv(createdByRaw, "--created-by");
+		const includeMetadata = args["include-metadata"] === true;
+		if (includeMetadata && !printsResultMetadata(ctx)) throw new ConfigError("--include-metadata needs --json --full, or --fields naming result_metadata: every other output drops it");
+		const q = parseOptionalText(args.query, "query");
+		const { data, total } = await (await getClient()).search.query({
+			q,
+			models,
+			archived: args.archived ? true : void 0,
+			limit: ctx.range.limit,
+			offset: ctx.range.offset,
+			table_db_id: tableDbId,
+			verified: args.verified ? true : void 0,
+			collection,
+			created_by: createdBy,
+			search_native_query: args["search-native-query"] ? true : void 0,
+			include_metadata: includeMetadata ? true : void 0,
+			include_dashboard_questions: args["include-dashboard-questions"] ? true : void 0
+		});
+		renderList(windowServerPage(data, total, ctx.range), searchResultView, ctx);
+	}
+});
+function printsResultMetadata(ctx) {
+	if (ctx.fields !== void 0) return ctx.fields.some((path) => path === RESULT_METADATA || path.startsWith(`${RESULT_METADATA}.`));
+	return ctx.full && ctx.format === "json";
+}
+//#endregion
+export { search_default as default };