@metabase/cli 0.3.2 → 0.4.0-alpha.release-65-integration-branch.31ca6bb

package/dist/export-CjqjDnaZ.mjs

@@ -0,0 +1,74 @@
+import { H as connectionFlags, J as profileFlag, at as ConfigError, k as warn, p as renderSummary, q as outputFlags } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-B8RtMb4B.mjs";
+import { o as SyncExportResult } from "./git-sync-COokpYgc.mjs";
+import { n as parseWaitFlags, t as gitSyncWaitFlags } from "./wait-flags-KX7NHdj4.mjs";
+import { a as syncExportView } from "./git-sync-DspFahwV.mjs";
+import { a as throwIfFailedTask, i as taskPollOptions, n as formatSyncTask } from "./sync-task-CXFoqlpF.mjs";
+import { t as branchFlag } from "./branch-flag-pFQPNYKr.mjs";
+//#region src/commands/git-sync/export.ts
+var export_default = defineMetabaseCommand({
+	meta: {
+		name: "export",
+		description: "Export Metabase changes back to the configured git remote"
+	},
+	details: "The export targets the branch git-sync tracks. On Metabase 63+ `--branch` defaults to it and must name it (the server answers 409 for any other branch); older servers export to the branch `--branch` names and switch git-sync to it, refusing with 400 when that branch's tip is not the last synced commit unless --force is given. To push to a new branch, use `git-sync stash` or `git-sync create-branch` first. When the remote has moved past the last sync, a plain export ends in a `conflict` task on 63+ and is refused with 400 on older servers. --merge (63+) folds the remote's changes in by a three-way merge (entities changed on both sides still end in `conflict`), --force overwrites them. `git-sync export-preflight` previews which applies. A task that ends in `conflict` makes the server count the remote commit it saw as synced, so a retry, --merge included, no longer sees the remote's changes: resolve a conflict with --force on the side to keep, or `git-sync create-branch` then export, never with a retry.",
+	requires: ["gitSync.export"],
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		branch: {
+			type: "string",
+			description: "Branch to export to (defaults to the remote-sync-branch setting; on 63+ it must be that branch)",
+			alias: "b"
+		},
+		message: {
+			type: "string",
+			description: "Commit message",
+			alias: "m"
+		},
+		force: {
+			type: "boolean",
+			description: "Force-push / overwrite remote",
+			default: false
+		},
+		merge: {
+			type: "boolean",
+			description: "When the remote moved on, fold its changes in by a three-way merge instead of ending in conflict",
+			default: false
+		},
+		...gitSyncWaitFlags
+	},
+	outputSchema: SyncExportResult,
+	examples: [
+		"mb git-sync export -m \"update dashboards\"",
+		"mb git-sync export --merge -m \"update dashboards\"",
+		"mb git-sync export --branch main --json",
+		"mb git-sync export --no-wait"
+	],
+	async run({ args, ctx, getClient }) {
+		const wait = parseWaitFlags(args);
+		if (args.merge && args.force) throw new ConfigError("--merge cannot be combined with --force");
+		const branch = branchFlag(args.branch);
+		const params = {};
+		if (branch !== null) params.branch = branch;
+		if (args.message !== void 0 && args.message !== "") params.message = args.message;
+		if (args.force) params.force = true;
+		if (args.merge) params.merge = true;
+		if (wait.enabled) params.wait = taskPollOptions(wait.schedule);
+		const result = await (await getClient()).gitSync.export(params);
+		if (!wait.enabled) renderSummary(result, syncExportView, `Started export task #${result.task_id}.`, ctx);
+		else {
+			const final = result.final ?? null;
+			renderSummary(result, syncExportView, final === null ? `Export task #${result.task_id} finished.` : formatSyncTask(final), ctx);
+			throwIfFailedTask(final, "export");
+		}
+		emitRealignHint(ctx);
+	}
+});
+function emitRealignHint(ctx) {
+	if (ctx.format !== "text") return;
+	warn("\nNote: if exporting to a host-bound repo, realign the host working tree with:\n  git -C <repo-path> restore --staged --worktree .");
+}
+//#endregion
+export { export_default as default };

package/dist/export-flags-BETJHNcw.mjs

@@ -0,0 +1,81 @@
+import { at as ConfigError, v as formatScalar, y as renderRows } from "./cli.mjs";
+import { n as ExportFormat, r as PivotExportFormat } from "./query-BKtMP5eH.mjs";
+import { t as parseEnumFlag } from "./parse-enum-CLIXMsd8.mjs";
+//#region src/output/query-result.ts
+function formatQueryResult(result) {
+	if (result.status !== "completed" || result.data === void 0) {
+		const detail = typeof result.error === "string" && result.error !== "" ? `: ${result.error}` : "";
+		return `Query ${result.status}${detail}`;
+	}
+	const head = result.data.cols.map((col) => col.display_name ?? col.name);
+	const rowCount = result.row_count ?? result.data.rows.length;
+	const summary = `${rowCount} row${rowCount === 1 ? "" : "s"}.`;
+	if (result.data.rows.length === 0) return summary;
+	return `${renderRows(head, result.data.rows.map((row) => Array.isArray(row) ? row.map((cell) => formatScalar(cell)) : [formatScalar(row)]))}\n${summary}`;
+}
+//#endregion
+//#region src/commands/export-flags.ts
+const PIVOT_FORMATS = PivotExportFormat.options.join(" or ");
+const exportOnlyFlags = {
+	"format-rows": {
+		type: "boolean",
+		description: "Streamed exports only: format values as Metabase displays them, column settings included",
+		default: false
+	},
+	"pivot-results": {
+		type: "boolean",
+		description: `With --export-format ${PIVOT_FORMATS}: lay a pivot table's rows out as the pivot, with its subtotals; refused when the server has pivoted exports turned off`,
+		default: false
+	},
+	"csv-include-bom": {
+		type: "boolean",
+		description: "With --export-format csv: open the file with a UTF-8 byte order mark, so Excel reads it as UTF-8",
+		default: false
+	}
+};
+const exportFlags = {
+	"export-format": {
+		type: "string",
+		description: `Bypass the JSON envelope and stream the raw export: ${ExportFormat.options.join(" | ")}`
+	},
+	...exportOnlyFlags
+};
+function isExportOnlyFlag(flag) {
+	return flag in exportOnlyFlags;
+}
+const EXPORT_ONLY_FLAGS = Object.keys(exportOnlyFlags).filter(isExportOnlyFlag);
+/**
+* The export the flags ask for, or `null` when `--export-format` is absent. An export-only flag
+* given without a format would be ignored silently, so it is refused.
+*/
+function readExportRequest(args) {
+	const raw = args["export-format"];
+	if (raw === void 0 || raw === "") {
+		const stray = EXPORT_ONLY_FLAGS.find((flag) => args[flag]);
+		if (stray !== void 0) throw new ConfigError(`--${stray} requires --export-format`);
+		return null;
+	}
+	const format = parseEnumFlag(raw, ExportFormat, "--export-format");
+	if (args["csv-include-bom"] && format !== "csv") throw new ConfigError("--csv-include-bom requires --export-format csv");
+	if (args["pivot-results"] && !PivotExportFormat.safeParse(format).success) throw new ConfigError(`--pivot-results requires --export-format ${PIVOT_FORMATS}`);
+	return {
+		format,
+		params: {
+			format_rows: args["format-rows"],
+			pivot_results: args["pivot-results"],
+			csv_include_bom: args["csv-include-bom"]
+		}
+	};
+}
+/**
+* A streamed export is the server's bytes, so a flag that shapes the JSON output would be ignored
+* silently and is refused. `--json` and `--format` still pick the shape of an error report.
+*/
+function assertStreamedOutput(ctx) {
+	if (ctx.full) throw new ConfigError("--full cannot be combined with --export-format");
+	if (ctx.fields !== void 0) throw new ConfigError("--fields cannot be combined with --export-format");
+	if (ctx.maxBytesGiven) throw new ConfigError("--max-bytes cannot be combined with --export-format");
+	if (ctx.range.limit !== void 0) throw new ConfigError("--limit cannot be combined with --export-format");
+}
+//#endregion
+export { formatQueryResult as i, exportFlags as n, readExportRequest as r, assertStreamedOutput as t };

package/dist/export-preflight-DzvIP6TB.mjs

@@ -0,0 +1,35 @@
+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 { i as SyncExportPreflight } from "./git-sync-COokpYgc.mjs";
+import { i as syncExportPreflightView, t as formatExportPreflight } from "./git-sync-DspFahwV.mjs";
+import { t as branchFlag } from "./branch-flag-pFQPNYKr.mjs";
+//#region src/commands/git-sync/export-preflight.ts
+var export_preflight_default = defineMetabaseCommand({
+	meta: {
+		name: "export-preflight",
+		description: "Preview what an export would do against the live remote branch, without writing"
+	},
+	details: "Compares the current Metabase content with the remote branch. `has_changes` says whether the remote has advanced past the last synced version (false when nothing has been synced yet, and after a task that ended in `conflict`, which the server counts as synced), `clean` whether a three-way merge would apply without conflicts, `conflicts` names the entities that would conflict, `summary` counts the remote changes a merge would fold in, `force_push_casualties` names the remote content a force push would discard (empty when nothing has been synced yet, although a forced export then replaces the remote's managed directories wholesale), and `reason` is `history-rewritten` when the remote was force-pushed or rebased so no merge base exists. The branch must be the one git-sync tracks; the server answers 409 otherwise.",
+	requires: ["gitSync.exportPreflight", "gitSync.trackedBranch"],
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		branch: {
+			type: "string",
+			description: "Branch to preview against (defaults to the remote-sync-branch setting; must be that branch)",
+			alias: "b"
+		}
+	},
+	outputSchema: SyncExportPreflight,
+	examples: ["mb git-sync export-preflight", "mb git-sync export-preflight --branch main --json"],
+	async run({ args, ctx, getClient }) {
+		const given = branchFlag(args.branch);
+		const mb = await getClient();
+		const branch = given ?? await mb.gitSync.trackedBranch();
+		const result = await mb.gitSync.exportPreflight({ branch });
+		renderSummary(result, syncExportPreflightView, () => formatExportPreflight(branch, result), ctx);
+	}
+});
+//#endregion
+export { export_preflight_default as default };

package/dist/{field-CcN4oZy6.mjs → field-5nivEfd6.mjs}

@@ -187,6 +187,17 @@ const FieldCompact = Field.pick({
 	semantic_type: true,
 	fk_target_field_id: true
 }).strip();
+const FieldWithDataSensitivity = Field.extend({ data_sensitivity: FieldDataSensitivity.nullable() });
+const FieldDetail = z.union([FieldWithDataSensitivity, Field]);
+/** The shape `GET` and `PUT /api/field/{id}` answer on a server with `features`. */
+function fieldDetailSchema(features) {
+	return features.fieldDataSensitivity ? FieldWithDataSensitivity : Field;
+}
+/** Whether `field` came from a server that labels data sensitivity. */
+function hasDataSensitivity(field) {
+	return "data_sensitivity" in field && FieldWithDataSensitivity.shape.data_sensitivity.safeParse(field.data_sensitivity).success;
+}
+const FieldWithDataSensitivityCompact = FieldCompact.extend({ data_sensitivity: FieldDataSensitivity.nullable() }).strip();
 const NonBlankNullable = z.string().min(1).nullable();
 const FieldUpdateInput = z.object({
 	display_name: NonBlankNullable.optional(),
@@ -214,12 +225,31 @@ const FieldValuesCompact = FieldValues.pick({
 	field_id: true,
 	has_more_values: true
 }).strip();
-const FieldSearchMatches = z.array(z.array(z.unknown()));
-const FieldRemappedValue = z.tuple([z.unknown(), z.unknown()]);
+const FieldSearchMatches = z.array(z.union([z.tuple([z.unknown()]), z.tuple([z.unknown(), z.unknown()])]));
+const FieldRemappedPair = z.tuple([z.unknown(), z.unknown()]);
+const FieldRemappedSingle = z.tuple([z.unknown()]).transform(([value]) => [value, value]);
+const FieldRemappedValue = z.union([FieldRemappedPair, FieldRemappedSingle]);
+const FieldRemappedRowWireV59 = z.array(z.unknown()).min(1);
+function firstTwoCells(row) {
+	const [value, second] = row;
+	return row.length === 1 ? [value, value] : [value, second];
+}
+function valueTwice(row) {
+	const [value] = row;
+	return [value, value];
+}
+/**
+* The row `GET /api/field/{id}/remapping/{remapped-id}` answers on a server with `features`, read as
+* `FieldRemappedValue`. `sameField` says the two ids name one field.
+*/
+function fieldRemappedValueSchema(features, sameField) {
+	if (!features.fieldRemappingAppendsDisplayColumns) return FieldRemappedValue;
+	return FieldRemappedRowWireV59.transform(sameField ? valueTwice : firstTwoCells);
+}
 const FieldSummary = z.object({
 	field_id: z.number().int(),
 	count: z.number().int(),
 	distincts: z.number().int()
 });
 //#endregion
-export { FieldSearchMatches as a, FieldUpdateInput as c, FieldRemappedValue as i, FieldValues as l, FieldBaseType as n, FieldSemanticType as o, FieldCompact as r, FieldSummary as s, Field as t, FieldValuesCompact as u };
+export { FieldDetail as a, FieldSummary as c, FieldValuesCompact as d, FieldWithDataSensitivity as f, hasDataSensitivity as g, fieldRemappedValueSchema as h, FieldDataSensitivity as i, FieldUpdateInput as l, fieldDetailSchema as m, FieldBaseType as n, FieldSearchMatches as o, FieldWithDataSensitivityCompact as p, FieldCompact as r, FieldSemanticType as s, Field as t, FieldValues as u };

package/dist/field-fBpiGiqr.mjs

@@ -0,0 +1,21 @@
+import { t as defineCommandGroup } from "./group-bpD_KcjA.mjs";
+//#region src/commands/field/index.ts
+var field_default = defineCommandGroup({
+	name: "field",
+	description: "Manage Metabase fields",
+	skills: [{
+		skill: "metadata",
+		purpose: "semantic types, FK targets, visibility, dropdown behavior"
+	}],
+	subCommands: {
+		get: () => import("./get-NOMvMvYJ.mjs").then((m) => m.default),
+		values: () => import("./values-CXN4xTTh.mjs").then((m) => m.default),
+		summary: () => import("./summary-DvIf2EiO.mjs").then((m) => m.default),
+		update: () => import("./update-CHkVN69L.mjs").then((m) => m.default),
+		search: () => import("./search-Cc9vHNae.mjs").then((m) => m.default),
+		remapping: () => import("./remapping-CgA6UJGU.mjs").then((m) => m.default),
+		"set-sensitivity": () => import("./set-sensitivity-DVrINHde.mjs").then((m) => m.default)
+	}
+});
+//#endregion
+export { field_default as default };

package/dist/field-wmN6raOG.mjs

@@ -0,0 +1,128 @@
+import { c as FieldSummary, d as FieldValuesCompact, p as FieldWithDataSensitivityCompact, r as FieldCompact } from "./field-5nivEfd6.mjs";
+import { z } from "zod";
+//#region src/output/views/field.ts
+function formatTypeTag(value) {
+	return typeof value === "string" ? value.replace(/^type\//, "") : "";
+}
+function formatFkTarget(value) {
+	return typeof value === "number" ? `field ${value}` : "";
+}
+const FIELD_COLUMNS = [
+	{
+		key: "id",
+		label: "ID"
+	},
+	{
+		key: "name",
+		label: "Name"
+	},
+	{
+		key: "display_name",
+		label: "Display Name"
+	},
+	{
+		key: "base_type",
+		label: "Base Type",
+		format: formatTypeTag
+	},
+	{
+		key: "semantic_type",
+		label: "Semantic Type",
+		format: formatTypeTag
+	},
+	{
+		key: "fk_target_field_id",
+		label: "FK Target",
+		format: formatFkTarget
+	},
+	{
+		key: "description",
+		label: "Description"
+	}
+];
+const fieldView = {
+	compactPick: FieldCompact,
+	tableColumns: FIELD_COLUMNS
+};
+const fieldWithDataSensitivityView = {
+	compactPick: FieldWithDataSensitivityCompact,
+	tableColumns: [...FIELD_COLUMNS, {
+		key: "data_sensitivity",
+		label: "Sensitivity"
+	}]
+};
+const FieldValueLabel = z.object({
+	value: z.unknown(),
+	label: z.unknown()
+});
+function toValueLabel(row) {
+	const [value, label = null] = row;
+	return {
+		value,
+		label
+	};
+}
+const VALUE_LABEL_COLUMNS = [{
+	key: "value",
+	label: "Value"
+}, {
+	key: "label",
+	label: "Label"
+}];
+const fieldValueLabelView = {
+	compactPick: FieldValueLabel,
+	tableColumns: VALUE_LABEL_COLUMNS
+};
+const FieldRemappingMatch = z.object({
+	found: z.literal(true),
+	...FieldValueLabel.shape
+});
+const FieldRemappingMiss = z.object({ found: z.literal(false) });
+const FieldRemappingResult = z.discriminatedUnion("found", [FieldRemappingMatch, FieldRemappingMiss]);
+const fieldRemappingMatchView = {
+	compactPick: FieldRemappingMatch,
+	tableColumns: VALUE_LABEL_COLUMNS
+};
+const fieldRemappingMissView = {
+	compactPick: FieldRemappingMiss,
+	tableColumns: [{
+		key: "found",
+		label: "Found"
+	}]
+};
+const fieldValuesView = {
+	compactPick: FieldValuesCompact,
+	tableColumns: [
+		{
+			key: "field_id",
+			label: "Field"
+		},
+		{
+			key: "has_more_values",
+			label: "Has More"
+		},
+		{
+			key: "values",
+			label: "Values"
+		}
+	]
+};
+const fieldSummaryView = {
+	compactPick: FieldSummary,
+	tableColumns: [
+		{
+			key: "field_id",
+			label: "Field"
+		},
+		{
+			key: "count",
+			label: "Count"
+		},
+		{
+			key: "distincts",
+			label: "Distinct"
+		}
+	]
+};
+//#endregion
+export { fieldSummaryView as a, fieldView as c, fieldRemappingMissView as i, fieldWithDataSensitivityView as l, FieldValueLabel as n, fieldValueLabelView as o, fieldRemappingMatchView as r, fieldValuesView as s, FieldRemappingResult as t, toValueLabel as u };

package/dist/{fields-zQ6O_W_H.mjs → fields-C-au1eLO.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 { r as FieldCompact } from "./field-CcN4oZy6.mjs";
-import { r as fieldView } from "./field-fDtIrY6D.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 { r as FieldCompact } from "./field-5nivEfd6.mjs";
+import { c as fieldView } from "./field-wmN6raOG.mjs";
 //#region src/commands/table/fields.ts
 const FieldListEnvelope = listEnvelopeSchema(FieldCompact);
 var fields_default = defineMetabaseCommand({

package/dist/filter-flags-BIFcA2TT.mjs

@@ -0,0 +1,72 @@
+import { W as listFlag, nt as parseEnumCsv, tt as parseEnum } from "./cli.mjs";
+import { i as SortDirection } from "./query-BKtMP5eH.mjs";
+import { s as CardType } from "./card-P5mBknsl.mjs";
+import { f as DependencyType, l as DependencyItemsSortColumn, p as DependentsSortColumn } from "./dependency-DzLH3J8P.mjs";
+import { t as parseOptionalText } from "./parse-text-T0lTXzTZ.mjs";
+//#region src/commands/dependency/filter-flags.ts
+const sharedFilterFlags = {
+	"include-personal-collections": {
+		type: "boolean",
+		description: "Also list content in personal collections"
+	},
+	"sort-direction": {
+		type: "string",
+		description: `Sort direction: ${SortDirection.options.join("|")} (default: asc)`
+	}
+};
+const dependentFilterFlags = {
+	"dependent-types": listFlag({
+		type: "string",
+		description: `Comma-separated entity kinds to keep: ${DependencyType.options.join(",")}`
+	}),
+	"dependent-card-types": listFlag({
+		type: "string",
+		description: `Comma-separated card kinds to keep (narrows card dependents only): ${CardType.options.join(",")}`
+	}),
+	"sort-column": {
+		type: "string",
+		description: `Sort by: ${DependentsSortColumn.options.join("|")} (default: name)`
+	},
+	...sharedFilterFlags
+};
+function readDependentFilters(args) {
+	return {
+		"dependent-types": parseEnumCsv(args["dependent-types"], DependencyType, "--dependent-types"),
+		"dependent-card-types": parseEnumCsv(args["dependent-card-types"], CardType, "--dependent-card-types"),
+		"include-personal-collections": args["include-personal-collections"] ? true : void 0,
+		"sort-column": parseEnum(args["sort-column"], DependentsSortColumn, "--sort-column"),
+		"sort-direction": parseEnum(args["sort-direction"], SortDirection, "--sort-direction")
+	};
+}
+const queryFlag = { query: {
+	type: "string",
+	description: "Keep entities whose name or location contains this text (case-insensitive)"
+} };
+const itemFilterFlags = {
+	types: listFlag({
+		type: "string",
+		description: `Comma-separated entity kinds to list: ${DependencyType.options.join(",")}`
+	}),
+	"card-types": listFlag({
+		type: "string",
+		description: `Comma-separated card kinds to list (narrows cards only): ${CardType.options.join(",")}`
+	}),
+	...queryFlag,
+	"sort-column": {
+		type: "string",
+		description: `Sort by: ${DependencyItemsSortColumn.options.join("|")} (default: name)`
+	},
+	...sharedFilterFlags
+};
+function readItemFilters(args) {
+	return {
+		types: parseEnumCsv(args.types, DependencyType, "--types"),
+		"card-types": parseEnumCsv(args["card-types"], CardType, "--card-types"),
+		query: parseOptionalText(args.query, "--query"),
+		"include-personal-collections": args["include-personal-collections"] ? true : void 0,
+		"sort-column": parseEnum(args["sort-column"], DependencyItemsSortColumn, "--sort-column"),
+		"sort-direction": parseEnum(args["sort-direction"], SortDirection, "--sort-direction")
+	};
+}
+//#endregion
+export { readItemFilters as a, readDependentFilters as i, itemFilterFlags as n, queryFlag as r, dependentFilterFlags as t };

package/dist/fks-83QIm8xb.mjs

@@ -0,0 +1,36 @@
+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 { d as TableForeignKeyCompact } from "./table-Ci6bhZkb.mjs";
+import { a as tableForeignKeyView } from "./table-CxvaDiIZ.mjs";
+//#region src/commands/table/fks.ts
+const TableForeignKeyListEnvelope = listEnvelopeSchema(TableForeignKeyCompact);
+var fks_default = defineMetabaseCommand({
+	meta: {
+		name: "fks",
+		description: "List the foreign keys pointing at a table"
+	},
+	details: "Lists every active field whose `fk_target_field_id` is an active, unretired field of this table, the table's own self-references included. The server leaves out origin fields in inactive tables and in tables the caller cannot read, so a non-admin sees only the foreign keys from tables it can read. The text table names the origin as `<schema>.<table>.<field>`, or `<table>.<field>` on a database without schemas.",
+	requires: ["table.fks"],
+	args: {
+		...outputFlags,
+		...listFlags,
+		...profileFlag,
+		...connectionFlags,
+		id: {
+			type: "positional",
+			description: "Table id",
+			required: true
+		}
+	},
+	outputSchema: TableForeignKeyListEnvelope,
+	examples: ["mb table fks 42", "mb table fks 42 --json"],
+	async run({ args, ctx, getClient }) {
+		const id = parseId(args.id);
+		const { data } = await (await getClient()).table.fks(id);
+		renderList(windowList(data, ctx.range), tableForeignKeyView, ctx);
+	}
+});
+//#endregion
+export { fks_default as default };

package/dist/{get-93wuhTn2.mjs → get-BMHbEGbr.mjs}

@@ -1,7 +1,7 @@
-import { H as outputFlags, U as profileFlag, u as renderItem, z as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-nCPku2nN.mjs";
-import { t as Library } from "./library-BPIzb3K_.mjs";
-import { t as libraryView } from "./library-PGCfm0UA.mjs";
+import { H as connectionFlags, J as profileFlag, q as outputFlags, u as renderItem } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-B8RtMb4B.mjs";
+import { t as Library } from "./library-Ck0EK5bi.mjs";
+import { t as libraryView } from "./library-BOv5SY24.mjs";
 //#region src/commands/library/get.ts
 var get_default = defineMetabaseCommand({
 	meta: {

package/dist/{get-DXwlZjw0.mjs → get-BTCOzSkl.mjs}

@@ -1,6 +1,6 @@
-import { H as outputFlags, U as profileFlag, u as renderItem, 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, q as outputFlags, u as renderItem } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-B8RtMb4B.mjs";
+import { t as parseId } from "./parse-id-7ja3HUdB.mjs";
 import { t as Snippet } from "./snippet-CyKAgIZl.mjs";
 import { t as snippetView } from "./snippet-oJLaYW9V.mjs";
 //#region src/commands/snippet/get.ts

package/dist/{get-CekXFP3x.mjs → get-BawLhSwW.mjs}

@@ -1,6 +1,6 @@
-import { H as outputFlags, U as profileFlag, u as renderItem, 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, q as outputFlags, u as renderItem } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-B8RtMb4B.mjs";
+import { t as parseId } from "./parse-id-7ja3HUdB.mjs";
 import { t as Measure } from "./measure-CtfjqJFP.mjs";
 import { t as measureView } from "./measure-4P0bOlZ3.mjs";
 //#region src/commands/measure/get.ts

package/dist/{get-BLjcCXp8.mjs → get-BjqqFG2m.mjs}

@@ -1,6 +1,6 @@
-import { H as outputFlags, U as profileFlag, u as renderItem, 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, q as outputFlags, u as renderItem } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-B8RtMb4B.mjs";
+import { t as parseId } from "./parse-id-7ja3HUdB.mjs";
 import { t as Segment } from "./segment-OsrbUDzw.mjs";
 import { t as segmentView } from "./segment-C_gl5ag6.mjs";
 //#region src/commands/segment/get.ts

package/dist/{get-is8x5f2n.mjs → get-C-R_Fdsi.mjs}

@@ -1,6 +1,6 @@
-import { H as outputFlags, U as profileFlag, u as renderItem, 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, q as outputFlags, u as renderItem } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-B8RtMb4B.mjs";
+import { t as parseId } from "./parse-id-7ja3HUdB.mjs";
 import { t as Timeline } from "./timeline-CCSU2qOS.mjs";
 import { n as timelineView } from "./timeline-uDCmwGFT.mjs";
 //#region src/commands/timeline/get.ts

package/dist/{get-DC_huYD8.mjs → get-C73V2KsB.mjs}

@@ -1,8 +1,8 @@
-import { B as listFlags, E as warn, H as outputFlags, K as listEnvelopeSchemaWithExtras, Q as ConfigError, U as profileFlag, f as renderListWithExtras, h as writeText } from "./cli.mjs";
-import { a as readCachedServerProfile, l as resolveProfileName, n as parseCsv, t as defineMetabaseCommand } from "./runtime-nCPku2nN.mjs";
-import { n as windowList } from "./window-DSb1tqSe.mjs";
-import { a as readSkillContent, i as loadVisibleSkills, o as selectForProfile, r as loadAllSkills, s as selectSkillsByNames, t as SkillContent } from "./skills-CqtNuSXM.mjs";
-import { i as unfilteredFlag, r as skillFilterNotices, t as UnavailableSkills } from "./skill-list-DAvGGHzS.mjs";
+import { G as listFlags, J as profileFlag, Z as listEnvelopeSchemaWithExtras, at as ConfigError, et as parseCsv, f as renderListWithExtras, g as writeText, k as warn, q as outputFlags } from "./cli.mjs";
+import { n as readCachedServerProfile, o as resolveProfileName, t as defineMetabaseCommand } from "./runtime-B8RtMb4B.mjs";
+import { n as windowList } from "./window-CI_QD04s.mjs";
+import { a as readSkillContent, i as loadVisibleSkills, o as selectForProfile, r as loadAllSkills, s as selectSkillsByNames, t as SkillContent } from "./skills-4qDjKRSk.mjs";
+import { i as unfilteredFlag, r as skillFilterNotices, t as UnavailableSkills } from "./skill-list-BgihWuPf.mjs";
 //#region src/commands/skills/get.ts
 const SkillGetEnvelope = listEnvelopeSchemaWithExtras(SkillContent, { unavailable: UnavailableSkills });
 const SKILL_OVERSIZE_HINT = "a skill body is indivisible — pass --max-bytes 0 to print it whole, or `mb skills path <name>` to read it from disk";

package/dist/{get-CG6G-mzV.mjs → get-C9sq2boy.mjs}

@@ -1,8 +1,8 @@
-import { H as outputFlags, U as profileFlag, u as renderItem, 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 DashboardDetail } from "./dashboard-D0hwTC-f.mjs";
-import { t as dashboardView } from "./dashboard-DgK81azj.mjs";
+import { H as connectionFlags, J as profileFlag, q as outputFlags, u as renderItem } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-B8RtMb4B.mjs";
+import { t as parseId } from "./parse-id-7ja3HUdB.mjs";
+import { o as DashboardDetail } from "./dashboard-Phz3XpRM.mjs";
+import { n as dashboardView } from "./dashboard-XSTr9QCr.mjs";
 //#region src/commands/dashboard/get.ts
 var get_default = defineMetabaseCommand({
 	meta: {

package/dist/{get-Cf6a4fFN.mjs → get-Cggv6yLC.mjs}

@@ -1,8 +1,8 @@
-import { H as outputFlags, U as profileFlag, u as renderItem, z as connectionFlags } from "./cli.mjs";
+import { H as connectionFlags, J as profileFlag, q as outputFlags, u as renderItem } from "./cli.mjs";
 import { n as Notification } from "./notification-DaA4bBHW.mjs";
-import { t as notificationView } from "./notification-DVrLkjFT.mjs";
-import { t as defineMetabaseCommand } from "./runtime-nCPku2nN.mjs";
-import { t as parseId } from "./parse-id-whJX4DAb.mjs";
+import { t as notificationView } from "./notification-DOYdl0ao.mjs";
+import { t as defineMetabaseCommand } from "./runtime-B8RtMb4B.mjs";
+import { t as parseId } from "./parse-id-7ja3HUdB.mjs";
 //#region src/commands/alert/get.ts
 var get_default = defineMetabaseCommand({
 	meta: {

package/dist/{get-xPv7e5Ez.mjs → get-CkXc0Xld.mjs}

@@ -1,8 +1,8 @@
-import { H as outputFlags, U as profileFlag, u as renderItem, 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 Card } from "./card-voh1k4hl.mjs";
-import { n as cardView } from "./card-CEkp1mcI.mjs";
+import { H as connectionFlags, J as profileFlag, q as outputFlags, u as renderItem } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-B8RtMb4B.mjs";
+import { t as parseId } from "./parse-id-7ja3HUdB.mjs";
+import { t as Card } from "./card-P5mBknsl.mjs";
+import { n as cardView } from "./card-CQNUT9pm.mjs";
 //#region src/commands/card/get.ts
 var get_default = defineMetabaseCommand({
 	meta: {