@metabase/cli 0.3.2-alpha.fix-transform-test-ee-path.8ac2a7a → 0.4.0-alpha.release-65-integration-branch.31ca6bb

package/dist/{rescan-values-CNOiiWQ5.mjs → rescan-values-sJRwcHsk.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-Dtb93zKy.mjs";
-import { t as parseId } from "./parse-id-DtM6q9HU.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-B8RtMb4B.mjs";
+import { t as parseId } from "./parse-id-7ja3HUdB.mjs";
+import { a as DatabaseSyncResult } from "./database-BT7DVgSr.mjs";
+import { t as databaseSyncResultView } from "./database-Kq2AL5jH.mjs";
 //#region src/commands/db/rescan-values.ts
 var rescan_values_default = defineMetabaseCommand({
 	meta: {

package/dist/{run-DijA_BXt.mjs → run-COHDQ5J4.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-Dtb93zKy.mjs";
-import { t as parseId } from "./parse-id-DtM6q9HU.mjs";
+import { H as connectionFlags, J as profileFlag, p as renderSummary, q as outputFlags } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-B8RtMb4B.mjs";
+import { t as parseId } from "./parse-id-7ja3HUdB.mjs";
 import { a as TransformJobRunResult } from "./transform-job-CCguL6LP.mjs";
 //#region src/commands/transform-job/run.ts
 const transformJobRunResultView = {

package/dist/{run-QEUbWNm7.mjs → run-RXpFlDAB.mjs}

@@ -1,8 +1,8 @@
-import { $ as FailedResultError, H as outputFlags, U as profileFlag, p as renderSummary, z as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Dtb93zKy.mjs";
-import { t as parseId } from "./parse-id-DtM6q9HU.mjs";
+import { H as connectionFlags, J as profileFlag, p as renderSummary, q as outputFlags } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-B8RtMb4B.mjs";
+import { t as parseId } from "./parse-id-7ja3HUdB.mjs";
 import { c as TransformRunResult, p as isTransformRunFailed } from "./transform-DiW7bREn.mjs";
-import { i as waitFlags, n as parseWaitFlags } from "./wait-flags-CiJGrTCT.mjs";
+import { i as waitFlags, n as parseWaitFlags } from "./wait-flags-KX7NHdj4.mjs";
 //#region src/commands/transform/run.ts
 const transformRunResultView = {
 	compactPick: TransformRunResult,
@@ -26,7 +26,7 @@ var run_default = defineMetabaseCommand({
 		name: "run",
 		description: "Trigger a transform run by id"
 	},
-	details: "Starts a run and returns immediately. --wait polls the run to a terminal status. --sync additionally waits until the run's output table is registered and returns its `target_table_id`, so you can build MBQL cards against it — the run registers the table itself, so no separate `db sync-schema` is needed; --sync implies waiting for the run. While waiting, a run that does not succeed exits 1.",
+	details: "Starts a run and returns immediately. --wait polls the run to a terminal status. --sync additionally waits until the run's output table is registered and returns its `target_table_id`, so you can build MBQL cards against it — the run registers the table itself, so no separate `db sync-schema` is needed; --sync implies waiting for the run.",
 	requires: ["transform.run"],
 	args: {
 		...outputFlags,
@@ -66,11 +66,11 @@ var run_default = defineMetabaseCommand({
 		}
 		if (result.run_id === null || result.final === null) {
 			renderSummary(result, transformRunResultView, result.message, ctx);
-			throw new FailedResultError(`transform run did not start: ${result.message}`);
+			throw new Error(`transform run did not start: ${result.message}`);
 		}
 		const status = result.final.status;
 		renderSummary(result, transformRunResultView, summaryLine(id, result.run_id, status, syncTarget, result.target_table_id), ctx);
-		if (isTransformRunFailed(status)) throw new FailedResultError(`transform run ${result.run_id} ${status}`);
+		if (isTransformRunFailed(status)) throw new Error(`transform run ${result.run_id} ${status}`);
 	}
 });
 function summaryLine(transformId, runId, status, syncTarget, targetTableId) {

package/dist/{runs-BSlhVeDO.mjs → runs-CUYdCKiE.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-Dtb93zKy.mjs";
-import { t as parseId } from "./parse-id-DtM6q9HU.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-B8RtMb4B.mjs";
+import { t as parseId } from "./parse-id-7ja3HUdB.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-Dtb93zKy.mjs → runtime-B8RtMb4B.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, b as isPlainObject, c as ruleGap, ct as isFileNotFoundError, i as FEATURE_RULES, it as TimeoutError, j as ENV_SKIP_PREFLIGHT, l as reportError, lt as KNOWN_RANGE, n as methodRequirements, nt as NetworkError, o as evaluateFeatures, ot as ValidationError, q as flagConsumesValue, r as FEATURE_NAMES, rt as ResponseShapeError, st as errorMessage, t as interruptSignal, tt as MetabaseError } 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-ClL6gf7G.mjs").then((n) => n.t);
+						const { createClient } = await import("./client-BHIFvEg2.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-BE3rEb6I.mjs → schema-tables-CO5qyZBe.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-Dtb93zKy.mjs";
-import { t as parseId } from "./parse-id-DtM6q9HU.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-B8RtMb4B.mjs";
+import { t as parseId } from "./parse-id-7ja3HUdB.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-yDjBiwlH.mjs → schemas-CzHHgDdF.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-Dtb93zKy.mjs";
-import { t as parseId } from "./parse-id-DtM6q9HU.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-B8RtMb4B.mjs";
+import { t as parseId } from "./parse-id-7ja3HUdB.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-BWb052_b.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-B8RtMb4B.mjs";
+import { n as parseIdCsv, t as parseId } from "./parse-id-7ja3HUdB.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 };

package/dist/search-Cc9vHNae.mjs

@@ -0,0 +1,85 @@
+import { G as listFlags, H as connectionFlags, J as profileFlag, X as listEnvelopeSchema, at as ConfigError, d as renderList, q as outputFlags } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-B8RtMb4B.mjs";
+import { t as parseId } from "./parse-id-7ja3HUdB.mjs";
+import { t as collectForOutput } from "./window-CI_QD04s.mjs";
+import { n as parseText } from "./parse-text-T0lTXzTZ.mjs";
+import { n as FieldValueLabel, o as fieldValueLabelView, u as toValueLabel } from "./field-wmN6raOG.mjs";
+//#region src/commands/field/search.ts
+const FieldSearchListEnvelope = listEnvelopeSchema(FieldValueLabel);
+function fieldSearchValue(value, limit) {
+	if (value === void 0) {
+		if (limit === void 0) throw new ConfigError("--limit is required when --value is absent");
+		return;
+	}
+	return parseText(value, "--value");
+}
+const FIRST_SEARCH_SPAN = 1e3;
+const SEARCH_SPAN_GROWTH = 2;
+async function* searchPages(searchRows, request) {
+	const windowSpan = request.max ?? Number.POSITIVE_INFINITY;
+	let span = Math.min(windowSpan, FIRST_SEARCH_SPAN);
+	let seen = request.offset;
+	let filledBound = true;
+	while (filledBound) {
+		const bound = request.offset + span;
+		const rows = await searchRows(bound);
+		yield {
+			items: rows.slice(seen).map(toValueLabel),
+			total: null
+		};
+		filledBound = rows.length === bound && span < windowSpan;
+		seen = bound;
+		span = Math.min(span * SEARCH_SPAN_GROWTH, windowSpan);
+	}
+}
+var search_default = defineMetabaseCommand({
+	meta: {
+		name: "search",
+		description: "Search a field's values, answering them paired with the values of another field"
+	},
+	details: "Each row is a distinct pair of a value of `<id>` and the value of `<search-id>` on the same warehouse row, ordered by value. A FK on either side is followed to the key it points at, so searching an id column by a name column answers id/name pairs; after that both fields must be on one table, and a pair that is not answers no rows rather than an error, as does any failure of the warehouse query. `--value` keeps the rows whose `<search-id>` value contains it, case-insensitively; without it the first `--limit` rows are answered, so one of the two is required. `label` is null when `<id>` and `<search-id>` resolve to the same field once FKs are followed. A field with custom display values answers every mapped value instead, with its display value as `label`, matching `--value` against the display value and ignoring `<search-id>`. The endpoint takes no offset and reports no count, so `total` is null, every request asks for the rows from the first, at most 1000 at first and twice as many on each request after until the window is covered, and `has_more` is proven by one row fetched past it.",
+	requires: ["field.search"],
+	args: {
+		...outputFlags,
+		...listFlags,
+		limit: {
+			type: "string",
+			description: "Max items to return; required without --value (with it, default: as many as fit the output cap)"
+		},
+		...profileFlag,
+		...connectionFlags,
+		id: {
+			type: "positional",
+			description: "Field id whose values are answered",
+			required: true
+		},
+		"search-id": {
+			type: "positional",
+			description: "Field id whose values are searched",
+			required: true
+		},
+		value: {
+			type: "string",
+			description: "Text the searched values must contain (case-insensitive)"
+		}
+	},
+	outputSchema: FieldSearchListEnvelope,
+	examples: [
+		"mb field search 100 101 --value ada",
+		"mb field search 100 101 --value ada --limit 5 --json",
+		"mb field search 100 101 --limit 20 --json"
+	],
+	async run({ args, ctx, getClient }) {
+		const id = parseId(args.id);
+		const searchId = parseId(args["search-id"], "search-id");
+		const value = fieldSearchValue(args.value, ctx.range.limit);
+		const client = await getClient();
+		const searchRows = (limit) => client.field.search(id, searchId, value === void 0 ? { limit } : {
+			value,
+			limit
+		});
+		renderList(await collectForOutput((request) => searchPages(searchRows, request), fieldValueLabelView, ctx), fieldValueLabelView, ctx);
+	}
+});
+//#endregion
+export { search_default as default };

package/dist/{segment-Cm6zQjJW.mjs → segment-C_rsUkHK.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/segment/index.ts
 var segment_default = defineCommandGroup({
 	name: "segment",
@@ -11,11 +11,11 @@ var segment_default = defineCommandGroup({
 		purpose: "define reusable segments"
 	}],
 	subCommands: {
-		list: () => import("./list-Sd7jGZoX.mjs").then((mod) => mod.default),
-		get: () => import("./get-BcoJ9Aha.mjs").then((mod) => mod.default),
-		create: () => import("./create-Za1EskpV.mjs").then((mod) => mod.default),
-		update: () => import("./update-Bah7N8QX.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-DckxlWBt.mjs").then((mod) => mod.default)
+		list: () => import("./list-Dzzt6Yee.mjs").then((mod) => mod.default),
+		get: () => import("./get-BjqqFG2m.mjs").then((mod) => mod.default),
+		create: () => import("./create-R0Q-nRlq.mjs").then((mod) => mod.default),
+		update: () => import("./update-BnIEN390.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-BbNqts-V.mjs").then((mod) => mod.default)
 	}
 });
 //#endregion

package/dist/{send-kC8oerkT.mjs → send-C-3bkpni.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-Dtb93zKy.mjs";
-import { t as parseId } from "./parse-id-DtM6q9HU.mjs";
+import { H as connectionFlags, J as profileFlag, p as renderSummary, q as outputFlags } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-B8RtMb4B.mjs";
+import { t as parseId } from "./parse-id-7ja3HUdB.mjs";
 import { z } from "zod";
 //#region src/commands/alert/send.ts
 const AlertSendResult = z.object({

package/dist/{set-tFhPkxrL.mjs → set-BDkT37OT.mjs}

@@ -1,9 +1,9 @@
-import { H as outputFlags, U as profileFlag, _ as formatScalar, p as renderSummary, z as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Dtb93zKy.mjs";
-import { t as readBody } from "./body-CshgcV6U.mjs";
+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-B8RtMb4B.mjs";
+import { t as readBody } from "./body-CB2eDFFb.mjs";
 import { r as SettingValue } from "./setting-DTiLCW8g.mjs";
 import { t as settingValueView } from "./setting-CwRYgHYN.mjs";
-import { t as parseSettingKey } from "./key-PYetuQ13.mjs";
+import { t as parseSettingKey } from "./key-BynJSK9u.mjs";
 import { z } from "zod";
 //#region src/commands/setting/set.ts
 const SettingValueInput = z.unknown().describe("Any JSON value; the setting's own type constraints are enforced server-side");

package/dist/{set-active-lDKhAlij.mjs → set-active-CDJTfQEc.mjs}

@@ -1,7 +1,7 @@
-import { H as outputFlags, U as profileFlag, p as renderSummary, z as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Dtb93zKy.mjs";
+import { H as connectionFlags, J as profileFlag, p as renderSummary, q as outputFlags } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-B8RtMb4B.mjs";
 import { n as TransformJobActiveResult } from "./transform-job-CCguL6LP.mjs";
-import { t as parseEnumFlag } from "./parse-enum-Dc0dMZ3P.mjs";
+import { t as parseEnumFlag } from "./parse-enum-CLIXMsd8.mjs";
 import { z } from "zod";
 //#region src/commands/transform-job/set-active.ts
 const ActiveWord = z.enum(["true", "false"]);

package/dist/set-sensitivity-DVrINHde.mjs

@@ -0,0 +1,57 @@
+import { H as connectionFlags, J as profileFlag, p as renderSummary, q as outputFlags } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-B8RtMb4B.mjs";
+import { t as parseId } from "./parse-id-7ja3HUdB.mjs";
+import { f as FieldWithDataSensitivity, i as FieldDataSensitivity } from "./field-5nivEfd6.mjs";
+import { t as parseEnumFlag } from "./parse-enum-CLIXMsd8.mjs";
+import { l as fieldWithDataSensitivityView } from "./field-wmN6raOG.mjs";
+import { z } from "zod";
+//#region src/commands/field/set-sensitivity.ts
+const NONE = "none";
+const SensitivityArg = z.enum([...FieldDataSensitivity.options, NONE]);
+function parseSensitivity(value) {
+	const parsed = parseEnumFlag(value, SensitivityArg, "label");
+	return parsed === NONE ? null : parsed;
+}
+function summarize(field, sensitivity) {
+	if (sensitivity !== null) return `Labelled field ${field.id} "${field.display_name}" as ${sensitivity}.`;
+	const unset = `Field ${field.id} "${field.display_name}" carries no hand-set label`;
+	if (field.data_sensitivity === null) return `${unset} and is unlabelled.`;
+	return `${unset} and shows the classifier's ${field.data_sensitivity}.`;
+}
+var set_sensitivity_default = defineMetabaseCommand({
+	meta: {
+		name: "set-sensitivity",
+		description: "Label a field's data sensitivity by hand, or withdraw the label with `none`"
+	},
+	details: "A label set here is a person's call that the server's classifier never overwrites; `none` withdraws it, and the field then shows the label the classifier wrote, if it wrote one, else none. Answers the field with its `data_sensitivity`.",
+	requires: ["field.setDataSensitivity"],
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		id: {
+			type: "positional",
+			description: "Field id",
+			required: true
+		},
+		label: {
+			type: "positional",
+			description: `Sensitivity label (${SensitivityArg.options.join(" | ")})`,
+			required: true
+		}
+	},
+	outputSchema: FieldWithDataSensitivity,
+	examples: [
+		"mb field set-sensitivity 100 PII",
+		"mb field set-sensitivity 100 none",
+		"mb field set-sensitivity 100 PHI --json"
+	],
+	async run({ args, ctx, getClient }) {
+		const id = parseId(args.id);
+		const sensitivity = parseSensitivity(args.label);
+		const field = await (await getClient()).field.setDataSensitivity(id, { data_sensitivity: sensitivity });
+		renderSummary(field, fieldWithDataSensitivityView, summarize(field, sensitivity), ctx);
+	}
+});
+//#endregion
+export { set_sensitivity_default as default };

package/dist/{setting-DrJXCaFE.mjs → setting-CoLzd08x.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/setting/index.ts
 var setting_default = defineCommandGroup({
 	name: "setting",
@@ -8,9 +8,9 @@ var setting_default = defineCommandGroup({
 		purpose: "setting get/set JSON value quoting"
 	}],
 	subCommands: {
-		list: () => import("./list-CBLxhaNZ.mjs").then((m) => m.default),
-		get: () => import("./get-CE9_4Q7E.mjs").then((m) => m.default),
-		set: () => import("./set-tFhPkxrL.mjs").then((m) => m.default)
+		list: () => import("./list-DUcnAb1h.mjs").then((m) => m.default),
+		get: () => import("./get-D_v1IAL1.mjs").then((m) => m.default),
+		set: () => import("./set-BDkT37OT.mjs").then((m) => m.default)
 	}
 });
 //#endregion