@metabase/cli 0.2.2 → 0.3.0

package/dist/{query-B9LlGOZI.mjs → query-BbqECzmF.mjs}

@@ -1,27 +1,19 @@
-import { ConfigError, connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-1HTHeDa4.mjs";
-import "./command-augment-D9pI9Vbh.mjs";
-import { defineMetabaseCommand, parseJson } from "./runtime-CPIHg_Zg.mjs";
-import { parseId } from "./parse-id-waEVK-uR.mjs";
-import "./embedding-B0x9CPkU.mjs";
-import "./field-RYBTW2KS.mjs";
-import "./parameter-hCQ80jnc.mjs";
-import { CardQueryResult, cardQueryView } from "./card-BFRRyTGs.mjs";
-import { formatQueryResult } from "./query-result-Bvh89K4f.mjs";
+import { i as ConfigError } from "./predicates-Bkm2IoeX.mjs";
+import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand, z as parseOptionalInteger } from "./runtime-DiKyBxOw.mjs";
+import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
+import { h as parseJson } from "./network-error-CEb9ymDW.mjs";
+import { i as CardExportFormat, o as CardQueryResult } from "./card-DZxRmver.mjs";
+import { t as cardQueryView } from "./card-zyUkr2nS.mjs";
+import { t as formatQueryResult } from "./query-result-DBDwk8TS.mjs";
 import { z } from "zod";
 import { Writable } from "node:stream";
-
 //#region src/output/stream.ts
 async function pipeToStdout(stream) {
 	await stream.pipeTo(Writable.toWeb(process.stdout));
 }
-
 //#endregion
 //#region src/commands/card/query.ts
-const ExportFormat = z.enum([
-	"csv",
-	"json",
-	"xlsx"
-]);
 const QueryParameters = z.array(z.unknown());
 var query_default = defineMetabaseCommand({
 	meta: {
@@ -40,7 +32,7 @@ var query_default = defineMetabaseCommand({
 		},
 		"export-format": {
 			type: "string",
-			description: `Bypass JSON envelope and stream raw export: ${ExportFormat.options.join(" | ")}`
+			description: `Bypass JSON envelope and stream raw export: ${CardExportFormat.options.join(" | ")}`
 		},
 		parameters: {
 			type: "string",
@@ -74,20 +66,17 @@ var query_default = defineMetabaseCommand({
 		const client = await getClient();
 		const exportFormatRaw = args["export-format"];
 		if (exportFormatRaw !== void 0 && exportFormatRaw !== "") {
-			await streamExport(client, id, {
-				format: parseExportFormat(exportFormatRaw),
+			await pipeToStdout(await client.card.exportQuery(id, parseExportFormat(exportFormatRaw), {
 				parameters,
-				formatRows: args["format-rows"],
-				pivotResults: args["pivot-results"]
-			});
+				format_rows: args["format-rows"],
+				pivot_results: args["pivot-results"]
+			}));
 			return;
 		}
-		const result = await client.requestParsed(CardQueryResult, `/api/card/${id}/query`, {
-			method: "POST",
-			body: { parameters }
-		});
-		const limit = args.limit === void 0 || args.limit === "" ? null : parseId(args.limit, "limit");
-		const limited = applyLimit(result, limit);
+		const limited = applyLimit(await client.card.query(id, { parameters }), parseOptionalInteger(args.limit, {
+			name: "--limit",
+			min: 1
+		}));
 		renderSummary(limited, cardQueryView, () => formatQueryResult(limited), ctx);
 	}
 });
@@ -96,8 +85,8 @@ function parseParameters(raw) {
 	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(", ")})`);
+	const result = CardExportFormat.safeParse(raw);
+	if (!result.success) throw new ConfigError(`invalid --export-format: "${raw}" (expected: ${CardExportFormat.options.join(", ")})`);
 	return result.data;
 }
 function applyLimit(result, limit) {
@@ -110,18 +99,5 @@ function applyLimit(result, limit) {
 		}
 	};
 }
-async function streamExport(client, id, options) {
-	const body = new URLSearchParams({
-		parameters: JSON.stringify(options.parameters),
-		format_rows: String(options.formatRows),
-		pivot_results: String(options.pivotResults)
-	});
-	const stream = await client.requestStream(`/api/card/${id}/query/${options.format}`, {
-		method: "POST",
-		body
-	});
-	await pipeToStdout(stream);
-}
-
 //#endregion
-export { query_default as default };
+export { query_default as default };

package/dist/{query-DpVWKW-y.mjs → query-Dc__-KJH.mjs}

@@ -1,21 +1,16 @@
-import { ConfigError, connectionFlags, outputFlags, profileFlag, renderSummary, writeJson } from "./capabilities-1HTHeDa4.mjs";
-import "./command-augment-D9pI9Vbh.mjs";
-import { defineMetabaseCommand } from "./runtime-CPIHg_Zg.mjs";
-import "./input-BpXlmJ5J.mjs";
-import { readBody } from "./body-DXJ2v3GY.mjs";
-import { bodyInputFlags } from "./body-flags-Cbv-Ba6W.mjs";
-import "./embedding-B0x9CPkU.mjs";
-import "./field-RYBTW2KS.mjs";
-import "./parameter-hCQ80jnc.mjs";
-import { CardQueryResult, cardQueryView } from "./card-BFRRyTGs.mjs";
-import { assertNotLegacyEnvelopeWrappingMbql5, getQuerySchemaBundle, isMbql5Query, validateQuery } from "./validate-BoY75_M3.mjs";
-import { skipValidateFlag } from "./validate-query-Di0VKMF-.mjs";
-import { formatQueryResult } from "./query-result-Bvh89K4f.mjs";
+import { i as ConfigError } from "./predicates-Bkm2IoeX.mjs";
+import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary, l as writeJson } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
+import { t as readBody } from "./body-Cur4NJt9.mjs";
+import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
+import { o as CardQueryResult } from "./card-DZxRmver.mjs";
+import { t as cardQueryView } from "./card-zyUkr2nS.mjs";
+import { i as validateQuery, n as getQuerySchemaBundle, r as isMbql5Query, t as assertNotLegacyEnvelopeWrappingMbql5 } from "./validate-BWchyW0V.mjs";
+import { o as skipValidateFlag } from "./validate-query-DaGYSmpQ.mjs";
+import { t as formatQueryResult } from "./query-result-DBDwk8TS.mjs";
 import { z } from "zod";
-
 //#region src/commands/query.ts
 const QueryBody = z.unknown().describe("MBQL 5, legacy MBQL, or native query body — full MBQL 5 schema: mb query --print-schema");
-const QUERY_ENDPOINT = "/api/dataset";
 var query_default = defineMetabaseCommand({
 	meta: {
 		name: "query",
@@ -66,8 +61,7 @@ var query_default = defineMetabaseCommand({
 			contextLabel: "query",
 			bodyNoun: "the body"
 		});
-		const skipValidation = explicitSkip || !isMbql5Query(body);
-		if (!skipValidation) {
+		if (!(explicitSkip || !isMbql5Query(body))) {
 			const outcome = validateQuery(body);
 			if (!outcome.ok) {
 				writeJson(outcome);
@@ -85,14 +79,9 @@ var query_default = defineMetabaseCommand({
 			});
 			return;
 		}
-		const client = await getClient();
-		const queryResult = await client.requestParsed(CardQueryResult, QUERY_ENDPOINT, {
-			method: "POST",
-			body
-		});
+		const queryResult = await (await getClient()).dataset.query(body);
 		renderSummary(queryResult, cardQueryView, () => formatQueryResult(queryResult), ctx);
 	}
 });
-
 //#endregion
-export { query_default as default };
+export { query_default as default };

package/dist/{query-result-Bvh89K4f.mjs → query-result-DBDwk8TS.mjs}

@@ -1,19 +1,15 @@
-import { formatScalar, renderRows } from "./capabilities-1HTHeDa4.mjs";
-
+import { f as formatScalar, p as renderRows } from "./cli.mjs";
 //#region src/output/query-result.ts
 function formatQueryResult(result) {
 	if (result.status !== "completed" || result.data === void 0) {
-		const hasError = typeof result.error === "string" && result.error !== "";
-		const detail = hasError ? `: ${result.error}` : "";
+		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;
-	const rows = result.data.rows.map((row) => Array.isArray(row) ? row.map((cell) => formatScalar(cell)) : [formatScalar(row)]);
-	return `${renderRows(head, rows)}\n${summary}`;
+	return `${renderRows(head, result.data.rows.map((row) => Array.isArray(row) ? row.map((cell) => formatScalar(cell)) : [formatScalar(row)]))}\n${summary}`;
 }
-
 //#endregion
-export { formatQueryResult };
+export { formatQueryResult as t };

package/dist/remove-collection-BOnxYvhj.mjs

@@ -0,0 +1,36 @@
+import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
+import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
+import { s as SyncSettingsUpdateResult } from "./git-sync-BDnxPrqU.mjs";
+import { o as syncSettingsUpdateView } from "./git-sync-DxD_ng48.mjs";
+//#region src/commands/git-sync/remove-collection.ts
+var remove_collection_default = defineMetabaseCommand({
+	meta: {
+		name: "remove-collection",
+		description: "Unmark a collection as git-synced; cascades to descendants by location prefix"
+	},
+	capabilities: {
+		minVersion: 60,
+		tokenFeature: "remote_sync"
+	},
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		id: {
+			type: "positional",
+			description: "Collection id (positive integer)",
+			required: true
+		}
+	},
+	outputSchema: SyncSettingsUpdateResult,
+	examples: ["mb git-sync remove-collection 12", "mb git-sync remove-collection 12 --json --profile prod"],
+	async run({ args, ctx, getClient }) {
+		const collectionId = parseId(args.id, "id");
+		const result = await (await getClient()).gitSync.setCollectionSynced(collectionId, false);
+		const taskPart = result.task_id !== void 0 ? ` (task #${result.task_id})` : "";
+		renderSummary(result, syncSettingsUpdateView, result.success ? `Collection ${collectionId} is no longer git-synced${taskPart}.` : `Could not update git-sync setting for collection ${collectionId}.`, ctx);
+	}
+});
+//#endregion
+export { remove_collection_default as default };

package/dist/{render-rgZBe3rO.mjs → render-CI93iP0I.mjs}

@@ -1,9 +1,8 @@
+import "./cli.mjs";
 //#region src/commands/auth/render.ts
-const EMPTY_CELL = "—";
 function pickProperty(value, key) {
-	if (typeof value !== "object" || value === null || !(key in value)) return void 0;
-	const inner = Reflect.get(value, key);
-	return inner;
+	if (typeof value !== "object" || value === null || !(key in value)) return;
+	return Reflect.get(value, key);
 }
 function pickString(value, key) {
 	const inner = pickProperty(value, key);
@@ -14,24 +13,23 @@ function pickBoolean(value, key) {
 	return typeof inner === "boolean" ? inner : null;
 }
 function renderUserName(value) {
-	return pickString(value, "name") ?? EMPTY_CELL;
+	return pickString(value, "name") ?? "—";
 }
 function renderUserRole(value) {
 	const isAdmin = pickBoolean(value, "isAdmin");
-	if (isAdmin === null) return EMPTY_CELL;
+	if (isAdmin === null) return "—";
 	return isAdmin ? "Admin" : "User";
 }
 function renderAuthMethod(value) {
 	if (value === "oauth") return "OAuth";
 	if (value === "apiKey") return "API key";
-	return EMPTY_CELL;
+	return "—";
 }
 function renderVersionTag(value) {
-	return pickString(value, "tag") ?? EMPTY_CELL;
+	return pickString(value, "tag") ?? "—";
 }
 function renderTimestamp(value) {
-	return typeof value === "string" ? value : EMPTY_CELL;
+	return typeof value === "string" ? value : "—";
 }
-
 //#endregion
-export { EMPTY_CELL, renderAuthMethod, renderTimestamp, renderUserName, renderUserRole, renderVersionTag };
+export { renderVersionTag as a, renderUserRole as i, renderTimestamp as n, renderUserName as r, renderAuthMethod as t };

package/dist/{replace-sHtPBNnA.mjs → replace-Cq4CxVa-.mjs}

@@ -1,10 +1,8 @@
-import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-1HTHeDa4.mjs";
-import "./command-augment-D9pI9Vbh.mjs";
-import { defineMetabaseCommand } from "./runtime-CPIHg_Zg.mjs";
-import { parseId } from "./parse-id-waEVK-uR.mjs";
-import "./input-BpXlmJ5J.mjs";
-import { UploadUpdateResult, readCsvFile, requireUploadFilePath, updateTableFromCsv, uploadUpdateResultView } from "./requests-Pc0u7PQS.mjs";
-
+import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
+import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
+import { n as UploadUpdateResult } from "./upload-DAtxBBms.mjs";
+import { i as uploadUpdateResultView, n as requireUploadFilePath, t as readCsvFile } from "./upload-CH632qW6.mjs";
 //#region src/commands/upload/replace.ts
 var replace_default = defineMetabaseCommand({
 	meta: {
@@ -32,11 +30,8 @@ var replace_default = defineMetabaseCommand({
 	async run({ args, ctx, getClient }) {
 		const id = parseId(args.id);
 		const file = await readCsvFile(requireUploadFilePath(args.file));
-		const client = await getClient();
-		const result = await updateTableFromCsv(client, id, "replace", file);
-		renderSummary(result, uploadUpdateResultView, `Replaced table ${id} with "${file.filename}".`, ctx);
+		renderSummary(await (await getClient()).table.replaceCsv(id, file), uploadUpdateResultView, `Replaced table ${id} with "${file.filename}".`, ctx);
 	}
 });
-
 //#endregion
-export { replace_default as default };
+export { replace_default as default };

package/dist/rescan-values-Dr_j416g.mjs

@@ -0,0 +1,31 @@
+import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
+import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
+import { a as DatabaseSyncResult } from "./database-C8G6ZKG0.mjs";
+import { t as databaseSyncResultView } from "./database-B19qlLKZ.mjs";
+//#region src/commands/db/rescan-values.ts
+var rescan_values_default = defineMetabaseCommand({
+	meta: {
+		name: "rescan-values",
+		description: "Trigger a rescan of cached field values for a database"
+	},
+	capabilities: { minVersion: 58 },
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		id: {
+			type: "positional",
+			description: "Database id",
+			required: true
+		}
+	},
+	outputSchema: DatabaseSyncResult,
+	examples: ["mb db rescan-values 1", "mb db rescan-values 1 --json"],
+	async run({ args, ctx, getClient }) {
+		const id = parseId(args.id);
+		renderSummary(await (await getClient()).database.rescanValues(id), databaseSyncResultView, `Field-values rescan queued for database ${id}.`, ctx);
+	}
+});
+//#endregion
+export { rescan_values_default as default };

package/dist/revision-message-flag-8TCHYJV6.mjs

@@ -0,0 +1,8 @@
+const revisionMessageFlag = { revisionMessage: {
+	type: "string",
+	description: "Audit-log message recorded with the change",
+	alias: "revision-message",
+	default: "Archived via mb CLI"
+} };
+//#endregion
+export { revisionMessageFlag as t };

package/dist/run-C3DkS6NP.mjs

@@ -0,0 +1,82 @@
+import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
+import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
+import { l as isTransformRunFailed, o as TransformRunResult } from "./transform-D3QX0jxA.mjs";
+import { i as waitFlags, n as parseWaitFlags } from "./wait-flags-DWEF9tX4.mjs";
+//#region src/commands/transform/run.ts
+const transformRunResultView = {
+	compactPick: TransformRunResult,
+	tableColumns: [
+		{
+			key: "run_id",
+			label: "Run ID"
+		},
+		{
+			key: "message",
+			label: "Message"
+		},
+		{
+			key: "target_table_id",
+			label: "Target table"
+		}
+	]
+};
+var run_default = defineMetabaseCommand({
+	meta: {
+		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.",
+	capabilities: { minVersion: 59 },
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		...waitFlags,
+		sync: {
+			type: "boolean",
+			description: "After a successful run, wait until the output table is registered and return its id (implies --wait)",
+			default: false
+		},
+		id: {
+			type: "positional",
+			description: "Transform id",
+			required: true
+		}
+	},
+	outputSchema: TransformRunResult,
+	examples: [
+		"mb transform run 1",
+		"mb transform run 1 --wait --json",
+		"mb transform run 1 --sync --json"
+	],
+	async run({ args, ctx, getClient }) {
+		const id = parseId(args.id);
+		const syncTarget = args.sync === true;
+		const wait = parseWaitFlags(args);
+		const waitForRun = wait.enabled || syncTarget;
+		const result = await (await getClient()).transform.run(id, {
+			...waitForRun && { wait: wait.schedule },
+			syncTarget
+		});
+		if (!waitForRun) {
+			const started = result.run_id === null ? result.message : `Started run ${result.run_id} for transform ${id}.`;
+			renderSummary(result, transformRunResultView, started, ctx);
+			return;
+		}
+		if (result.run_id === null || result.final === null) {
+			renderSummary(result, transformRunResultView, result.message, ctx);
+			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 Error(`transform run ${result.run_id} ${status}`);
+	}
+});
+function summaryLine(transformId, runId, status, syncTarget, targetTableId) {
+	const base = `Run ${runId} of transform ${transformId} ${status}.`;
+	if (!syncTarget) return base;
+	return targetTableId === null || targetTableId === void 0 ? `${base} Output table not registered before the wait timeout (it may still be syncing).` : `${base} Output table ${targetTableId} registered.`;
+}
+//#endregion
+export { run_default as default };

package/dist/{run-Ce_gPVcg.mjs → run-DdGJ544X.mjs}

@@ -1,14 +1,8 @@
-import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-1HTHeDa4.mjs";
-import "./command-augment-D9pI9Vbh.mjs";
-import { defineMetabaseCommand } from "./runtime-CPIHg_Zg.mjs";
-import { parseId } from "./parse-id-waEVK-uR.mjs";
-import { z } from "zod";
-
+import { F as outputFlags, I as profileFlag, M as connectionFlags, c as renderSummary } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
+import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
+import { a as TransformJobRunResult } from "./transform-job-DRrK28IH.mjs";
 //#region src/commands/transform-job/run.ts
-const TransformJobRunResult = z.object({
-	message: z.string(),
-	job_run_id: z.string()
-});
 const transformJobRunResultView = {
 	compactPick: TransformJobRunResult,
 	tableColumns: [{
@@ -45,14 +39,10 @@ var run_default = defineMetabaseCommand({
 	examples: ["mb transform-job run 1", "mb transform-job run 1 --force-refresh --json"],
 	async run({ args, ctx, getClient }) {
 		const id = parseId(args.id);
-		const client = await getClient();
-		const result = await client.requestParsed(TransformJobRunResult, `/api/transform-job/${id}/run`, {
-			method: "POST",
-			body: { run_all: args["force-refresh"] === true }
-		});
-		renderSummary(result, transformJobRunResultView, `Started transform job ${id}.`, ctx);
+		const result = await (await getClient()).transformJob.run(id, { run_all: args["force-refresh"] === true });
+		const summary = result.job_run_id === null ? `Transform job ${id} was not started (already running, or it resolves to no transforms).` : `Started transform job ${id}.`;
+		renderSummary(result, transformJobRunResultView, summary, ctx);
 	}
 });
-
 //#endregion
-export { run_default as default };
+export { run_default as default };

package/dist/runs-CUNWiidL.mjs

@@ -0,0 +1,38 @@
+import { F as outputFlags, I as profileFlag, M as connectionFlags, N as listFlags, R as listEnvelopeSchema, s as renderList } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-DiKyBxOw.mjs";
+import { t as parseId } from "./parse-id-C_jmKFaa.mjs";
+import { t as collectForOutput } from "./window-BkvrP0gB.mjs";
+import { a as TransformRunCompact } from "./transform-D3QX0jxA.mjs";
+import { t as transformRunView } from "./transform-DoTyyXAu.mjs";
+//#region src/commands/transform/runs.ts
+const TransformRunListEnvelope = listEnvelopeSchema(TransformRunCompact);
+var runs_default = defineMetabaseCommand({
+	meta: {
+		name: "runs",
+		description: "List recent transform runs"
+	},
+	capabilities: { minVersion: 59 },
+	args: {
+		...outputFlags,
+		...listFlags,
+		...profileFlag,
+		...connectionFlags,
+		"transform-id": {
+			type: "string",
+			description: "Filter to runs of a single transform id"
+		}
+	},
+	outputSchema: TransformRunListEnvelope,
+	examples: [
+		"mb transform runs",
+		"mb transform runs --transform-id 1 --json",
+		"mb transform runs --limit 10 --json"
+	],
+	async run({ args, ctx, getClient }) {
+		const transformId = args["transform-id"] === void 0 ? void 0 : parseId(args["transform-id"], "--transform-id");
+		const client = await getClient();
+		renderList(await collectForOutput((request) => client.transform.runPages({ "transform-ids": transformId }, request), transformRunView, ctx), transformRunView, ctx);
+	}
+});
+//#endregion
+export { runs_default as default };