@metabase/cli 0.4.1-alpha.release-65-integration-branch.5cbe297 → 0.5.1

package/dist/cli.mjs

@@ -138,6 +138,9 @@ var AbortError = class extends MetabaseError {
 		this.name = "AbortError";
 	}
 };
+function isNonInterruptFailure(error) {
+	return error instanceof MetabaseError && !(error instanceof AbortError);
+}
 var ChainedRequestError = class extends MetabaseError {
 	cause;
 	constructor(message, cause) {
@@ -165,6 +168,16 @@ var UnknownError = class extends MetabaseError {
 		this.developerDetail = input;
 	}
 };
+var PartialWriteError = class extends MetabaseError {
+	category = "partial-write";
+	isRetryable = false;
+	developerDetail;
+	constructor(message, developerDetail) {
+		super(message);
+		this.name = "PartialWriteError";
+		this.developerDetail = developerDetail;
+	}
+};
 function toMetabaseError(error) {
 	if (error instanceof MetabaseError) return error;
 	if (error instanceof ZodError) return new ConfigError(error.issues.map(formatZodIssue).join("; "));
@@ -577,7 +590,7 @@ const connectionFlags = {
 	},
 	skipPreflight: {
 		type: "boolean",
-		description: "Skip the server version capability check for this command",
+		description: "Skip the client's version and license checks made before a request, and let the server answer",
 		alias: "skip-preflight"
 	}
 };
@@ -623,7 +636,7 @@ function trustSystemCa() {
 //#endregion
 //#region package.json
 var name = "@metabase/cli";
-var version = "0.4.1-alpha.release-65-integration-branch.5cbe297";
+var version = "0.5.1";
 var description = "Metabase CLI";
 //#endregion
 //#region src/runtime/command-augment.ts
@@ -643,40 +656,40 @@ const main = defineCommand({
 		description
 	},
 	subCommands: {
-		auth: () => import("./auth-Ca84a5fv.mjs").then((mod) => mod.default),
-		db: () => import("./db-_H9HAS6H.mjs").then((mod) => mod.default),
-		table: () => import("./table-C--k-JXA.mjs").then((mod) => mod.default),
-		field: () => import("./field-C9AcBe8x.mjs").then((mod) => mod.default),
-		upload: () => import("./upload-T5wS1XtL.mjs").then((mod) => mod.default),
-		"content-translation": () => import("./content-translation-XnHISl5-.mjs").then((mod) => mod.default),
-		card: () => import("./card-P2-4BkXV.mjs").then((mod) => mod.default),
-		dashboard: () => import("./dashboard-C-YJxDam.mjs").then((mod) => mod.default),
-		subscription: () => import("./subscription-DPAGevGU.mjs").then((mod) => mod.default),
-		"data-action": () => import("./data-action-DER3EMD7.mjs").then((mod) => mod.default),
-		alert: () => import("./alert-DnTCjYIu.mjs").then((mod) => mod.default),
-		collection: () => import("./collection-BI8Fy9vS.mjs").then((mod) => mod.default),
-		library: () => import("./library-Cdj_uj1H.mjs").then((mod) => mod.default),
-		document: () => import("./document-CGvUmD9i.mjs").then((mod) => mod.default),
-		glossary: () => import("./glossary-C6EnoEXg.mjs").then((mod) => mod.default),
-		transform: () => import("./transform-BZaNFGeK.mjs").then((mod) => mod.default),
-		"transform-job": () => import("./transform-job-QMI2qWin.mjs").then((mod) => mod.default),
-		"transform-tag": () => import("./transform-tag-CzjLKILh.mjs").then((mod) => mod.default),
-		"transform-test": () => import("./transform-test-B9le1jKH.mjs").then((mod) => mod.default),
-		setting: () => import("./setting-CUxdweNJ.mjs").then((mod) => mod.default),
-		search: () => import("./search-Dl7xzF6Q.mjs").then((mod) => mod.default),
-		"git-sync": () => import("./git-sync-D4R0cHvk.mjs").then((mod) => mod.default),
-		setup: () => import("./setup-4uySIB-t.mjs").then((mod) => mod.default),
-		snippet: () => import("./snippet-C3gamfFK.mjs").then((mod) => mod.default),
-		segment: () => import("./segment-Bx28f38v.mjs").then((mod) => mod.default),
-		measure: () => import("./measure-DhX_mmZK.mjs").then((mod) => mod.default),
-		dependency: () => import("./dependency-v9fHJ-N-.mjs").then((mod) => mod.default),
-		timeline: () => import("./timeline-ClMmTycg.mjs").then((mod) => mod.default),
-		"timeline-event": () => import("./timeline-event-BY2Hj72e.mjs").then((mod) => mod.default),
-		eid: () => import("./eid-DsGNJ16z.mjs").then((mod) => mod.default),
-		query: () => import("./query-DvlGWjgG.mjs").then((mod) => mod.default),
-		uuid: () => import("./uuid-3qmLYgrG.mjs").then((mod) => mod.default),
-		upgrade: () => import("./upgrade-BRJH93W0.mjs").then((mod) => mod.default),
-		skills: () => import("./skills-86j411Qz.mjs").then((mod) => mod.default)
+		auth: () => import("./auth-BPbsm8yV.mjs").then((mod) => mod.default),
+		db: () => import("./db-m5bQcXdn.mjs").then((mod) => mod.default),
+		table: () => import("./table-P9ovwcaB.mjs").then((mod) => mod.default),
+		field: () => import("./field-DktidTPB.mjs").then((mod) => mod.default),
+		upload: () => import("./upload-Dvjfz16M.mjs").then((mod) => mod.default),
+		"content-translation": () => import("./content-translation-DoGTQnvH.mjs").then((mod) => mod.default),
+		card: () => import("./card-BTBDBsu-.mjs").then((mod) => mod.default),
+		dashboard: () => import("./dashboard-BP0p62fp.mjs").then((mod) => mod.default),
+		subscription: () => import("./subscription-Dh--agqE.mjs").then((mod) => mod.default),
+		"data-action": () => import("./data-action-Cr17CfgE.mjs").then((mod) => mod.default),
+		alert: () => import("./alert-DQkF8jYR.mjs").then((mod) => mod.default),
+		collection: () => import("./collection-B19phRNU.mjs").then((mod) => mod.default),
+		library: () => import("./library-DzejNMqX.mjs").then((mod) => mod.default),
+		document: () => import("./document-BaRQ5fBd.mjs").then((mod) => mod.default),
+		glossary: () => import("./glossary-BSgRQ2HO.mjs").then((mod) => mod.default),
+		transform: () => import("./transform-10YE8j5K.mjs").then((mod) => mod.default),
+		"transform-job": () => import("./transform-job-D97AutnF.mjs").then((mod) => mod.default),
+		"transform-tag": () => import("./transform-tag-BXusFzMX.mjs").then((mod) => mod.default),
+		"transform-test": () => import("./transform-test-UsH1udc4.mjs").then((mod) => mod.default),
+		setting: () => import("./setting-CDRusiqP.mjs").then((mod) => mod.default),
+		search: () => import("./search-DyC54bGf.mjs").then((mod) => mod.default),
+		"git-sync": () => import("./git-sync-BwkWeJAz.mjs").then((mod) => mod.default),
+		setup: () => import("./setup-BZaJVww3.mjs").then((mod) => mod.default),
+		snippet: () => import("./snippet-Ce0o33Rj.mjs").then((mod) => mod.default),
+		segment: () => import("./segment-DeT_Yic6.mjs").then((mod) => mod.default),
+		measure: () => import("./measure-CbMgNhlG.mjs").then((mod) => mod.default),
+		dependency: () => import("./dependency-BlTYysYG.mjs").then((mod) => mod.default),
+		timeline: () => import("./timeline-DLaBypse.mjs").then((mod) => mod.default),
+		"timeline-event": () => import("./timeline-event-xAAR6b-v.mjs").then((mod) => mod.default),
+		eid: () => import("./eid-CaumGUFD.mjs").then((mod) => mod.default),
+		query: () => import("./query-CN3BW5WB.mjs").then((mod) => mod.default),
+		uuid: () => import("./uuid-B8ynbkqG.mjs").then((mod) => mod.default),
+		upgrade: () => import("./upgrade-B6V_1cUh.mjs").then((mod) => mod.default),
+		skills: () => import("./skills-9ihLaSmM.mjs").then((mod) => mod.default)
 	}
 });
 setMetabaseAugment(main, {
@@ -694,6 +707,554 @@ setMetabaseAugment(main, {
 	requires: null
 });
 //#endregion
+//#region ../client/src/json.ts
+const JSON_CONTENT_TYPE = "application/json";
+function parseJson(input, schema, opts = {}) {
+	const result = parseJsonResult(input, schema, opts);
+	if (!result.ok) throw result.error;
+	return result.value;
+}
+function parseJsonResult(input, schema, opts = {}) {
+	const sourcePrefix = opts.source === void 0 ? "" : `${opts.source}: `;
+	let raw;
+	try {
+		raw = JSON.parse(input);
+	} catch (error) {
+		return {
+			ok: false,
+			error: new ConfigError(`${sourcePrefix}invalid JSON: ${errorMessage(error)}`)
+		};
+	}
+	const parsed = schema.safeParse(raw);
+	if (!parsed.success) return {
+		ok: false,
+		error: new ValidationError(`${sourcePrefix}value did not match expected schema`, {
+			source: opts.source ?? "<input>",
+			zodIssues: parsed.error.issues
+		})
+	};
+	return {
+		ok: true,
+		value: parsed.data
+	};
+}
+function parseJsonOrPlain(text, contentType, schema, opts = {}) {
+	if (!isJsonContentType(contentType)) return parseJson(JSON.stringify(text), schema, opts);
+	const attempt = parseJsonResult(text, schema, opts);
+	if (attempt.ok) return attempt.value;
+	if (attempt.error instanceof ValidationError) throw attempt.error;
+	return parseJson(JSON.stringify(text), schema, opts);
+}
+function isJsonContentType(contentType) {
+	return contentType !== null && contentType.includes("application/json");
+}
+//#endregion
+//#region ../client/src/predicates.ts
+function isPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+const JAVA_WHITESPACE = "	\n\v\f\r            \u2028\u2029 　";
+const UNICODE_ESCAPE_DIGITS = 4;
+function unicodeEscape(char) {
+	return `\\u${char.charCodeAt(0).toString(16).padStart(UNICODE_ESCAPE_DIGITS, "0")}`;
+}
+const JAVA_WHITESPACE_ESCAPED = [...JAVA_WHITESPACE].map(unicodeEscape).join("");
+/** Matches a string Metabase reads as not blank: one holding a character that is not Java whitespace. */
+const NOT_BLANK = new RegExp(`[^${JAVA_WHITESPACE_ESCAPED}]`);
+/** Whether Metabase reads `value` as blank: empty, or Java whitespace only. */
+function isBlank(value) {
+	return !NOT_BLANK.test(value);
+}
+//#endregion
+//#region ../client/src/http/sanitize.ts
+const SECRET_HEADER_NAMES = /* @__PURE__ */ new Set([
+	"authorization",
+	"x-api-key",
+	"x-metabase-session",
+	"cookie",
+	"set-cookie",
+	"proxy-authorization"
+]);
+const REDACTED = "[REDACTED]";
+function redactHeaders(headers) {
+	const result = {};
+	const entries = headers instanceof Headers ? headers.entries() : Object.entries(headers);
+	for (const [key, value] of entries) result[key] = SECRET_HEADER_NAMES.has(key.toLowerCase()) ? REDACTED : value;
+	return result;
+}
+function redactBody(body, ctx) {
+	let result = body;
+	for (const secret of ctx.knownSecrets) {
+		if (secret.length === 0) continue;
+		result = result.replaceAll(secret, REDACTED);
+	}
+	return result;
+}
+const SERVER_ERROR_STATUSES_START = 500;
+const SERVER_ERROR_STATUSES_END = 600;
+const TEXT_CONTENT_TYPE = "text/plain";
+const ROUTE_MISSING_LITERAL = "API endpoint does not exist.";
+const RESOURCE_MISSING_LITERAL = "Not found.";
+const STATUS_CLASSIFICATIONS = {
+	401: { retryable: false },
+	403: {
+		retryable: false,
+		message: "The request was refused (403): the signed-in user is not allowed to do this."
+	},
+	404: { retryable: false },
+	409: {
+		retryable: false,
+		message: "The request was refused (409): it conflicts with what already exists."
+	},
+	408: {
+		retryable: true,
+		message: "Metabase timed out responding."
+	},
+	425: { retryable: true },
+	429: {
+		retryable: true,
+		message: "Metabase rate-limited the request."
+	},
+	500: { retryable: true },
+	502: { retryable: true },
+	503: { retryable: true },
+	504: {
+		retryable: true,
+		message: "Metabase timed out responding."
+	}
+};
+const ErrorEnvelope = z.object({
+	message: z.string().optional(),
+	error: z.string().optional(),
+	"error-message": z.string().optional(),
+	via: z.array(z.object({ message: z.string().optional() }).loose()).optional(),
+	"specific-errors": z.unknown().optional(),
+	errors: z.unknown().optional(),
+	"error-code": z.string().optional(),
+	"non-remote-synced-models": z.unknown().optional(),
+	"remote-synced-models": z.unknown().optional()
+}).loose();
+const NonRemoteSyncedDependencies = z.array(z.number().int()).min(1);
+const RemoteSyncedDependent = z.record(z.string(), z.number().int());
+const RemoteSyncedDependents = z.array(RemoteSyncedDependent).min(1);
+const MAX_LISTED_REMOTE_SYNC_ENTRIES = 20;
+const REMOTE_SYNC_ENTRY_SEPARATOR = ", ";
+const NON_REMOTE_SYNCED_REMEDY = "Move that content into a synced collection first, or move the collection that holds it.";
+const REMOTE_SYNCED_REMEDY = "Update that content so it no longer uses this first, or move it out of sync along with this.";
+const FieldErrorNodeSchema = z.lazy(() => z.union([
+	z.string(),
+	z.array(z.string()),
+	z.record(z.string(), FieldErrorNodeSchema)
+]));
+const FieldErrorTree = z.record(z.string(), FieldErrorNodeSchema);
+const FIELD_MESSAGE_SEPARATOR = "; ";
+const MAX_EXTRACTED_MESSAGE_LEN = 500;
+const ELLIPSIS = "…";
+const GOT_VALUE_PATTERN = /got: ((?:[^"\\]|\\.)*)/g;
+const MAX_GOT_VALUE_LEN = 60;
+var HttpError = class extends MetabaseError {
+	category = "http";
+	status;
+	kind;
+	serverMessage;
+	developerDetail;
+	constructor(input) {
+		const sanitizedBody = sanitizeBody(input.rawBody, input.redactionContext);
+		const redactedHeaders = redactHeaders(input.responseHeaders);
+		const kind = classifyKind(input.status, sanitizedBody, redactedHeaders);
+		const said = {
+			envelope: parseEnvelopeMessage(sanitizedBody),
+			text: plainTextMessage(sanitizedBody, redactedHeaders)
+		};
+		super(input.overrideUserMessage ?? buildUserMessage(kind, input, said));
+		const fields = extractEnvelopeViews(sanitizedBody);
+		this.name = "HttpError";
+		this.status = input.status;
+		this.kind = kind;
+		this.serverMessage = said.envelope ?? said.text;
+		this.developerDetail = {
+			status: input.status,
+			statusText: input.statusText,
+			method: input.method,
+			url: input.url,
+			responseHeaders: redactedHeaders,
+			body: sanitizedBody,
+			fieldErrors: fields.fieldErrors,
+			specificFieldErrors: fields.specificFieldErrors,
+			errorCode: fields.errorCode,
+			nonRemoteSyncedDependencies: fields.nonRemoteSyncedDependencies,
+			remoteSyncedDependents: fields.remoteSyncedDependents
+		};
+	}
+	get isRetryable() {
+		return isRetryableStatus(this.status);
+	}
+	get fieldErrors() {
+		return this.developerDetail.fieldErrors;
+	}
+	get specificFieldErrors() {
+		return this.developerDetail.specificFieldErrors;
+	}
+	get errorCode() {
+		return this.developerDetail.errorCode;
+	}
+	get nonRemoteSyncedDependencies() {
+		return this.developerDetail.nonRemoteSyncedDependencies;
+	}
+	get remoteSyncedDependents() {
+		return this.developerDetail.remoteSyncedDependents;
+	}
+};
+function chainRequestFailure(cause, message) {
+	if (cause instanceof HttpError) return new HttpError({
+		status: cause.status,
+		statusText: cause.developerDetail.statusText,
+		method: cause.developerDetail.method,
+		url: cause.developerDetail.url,
+		responseHeaders: cause.developerDetail.responseHeaders,
+		rawBody: cause.developerDetail.body,
+		overrideUserMessage: message
+	});
+	return new ChainedRequestError(message, cause);
+}
+function isRetryableStatus(status) {
+	return STATUS_CLASSIFICATIONS[status]?.retryable === true;
+}
+function sanitizeBody(rawBody, ctx) {
+	if (rawBody === null) return null;
+	if (ctx === void 0) return rawBody;
+	return redactBody(rawBody, ctx);
+}
+function classifyKind(status, sanitizedBody, redactedHeaders) {
+	if (status === 401) return "auth";
+	if (status === 403) return "forbidden";
+	if (status === 409) return "conflict";
+	if (status === 404) return isRouteMissingResponse(sanitizedBody, redactedHeaders) ? "route-missing" : "resource-missing";
+	if (status === 429) return "rate-limit";
+	if (status >= SERVER_ERROR_STATUSES_START && status < SERVER_ERROR_STATUSES_END) return "server-error";
+	return "generic";
+}
+function isRouteMissingResponse(sanitizedBody, redactedHeaders) {
+	if (sanitizedBody?.includes(ROUTE_MISSING_LITERAL)) return true;
+	if (sanitizedBody?.includes(RESOURCE_MISSING_LITERAL)) return false;
+	if (redactedHeaders["content-type"]?.includes("application/json")) return false;
+	if (sanitizedBody === null || sanitizedBody.trim() === "") return true;
+	return parseEnvelope(sanitizedBody) === null;
+}
+function buildUserMessage(kind, input, said) {
+	if (kind === "route-missing") return buildRouteMissingMessage(input);
+	if (kind === "resource-missing") return `Not found: ${input.method} ${pathFromUrl(input.url)}.`;
+	if (said.envelope !== null) return said.envelope;
+	if (kind === "auth") return `Invalid or unauthorized API key (host: ${hostFromUrl(input.url)}).`;
+	if (said.text !== null) return said.text;
+	return defaultMessageForStatus(input.status);
+}
+function plainTextMessage(sanitizedBody, redactedHeaders) {
+	if (sanitizedBody === null || !redactedHeaders["content-type"]?.includes(TEXT_CONTENT_TYPE)) return null;
+	const trimmed = sanitizedBody.trim();
+	return trimmed === "" ? null : condenseMessage(trimmed);
+}
+function buildRouteMissingMessage(input) {
+	const path = pathFromUrl(input.url);
+	if (!input.serverTag) return `This endpoint is not available on the connected Metabase: ${input.method} ${path}.`;
+	return `This endpoint is not available on Metabase ${input.serverTag}: ${input.method} ${path}. It may require a newer Metabase major version.`;
+}
+function pathFromUrl(url) {
+	const parsed = new URL(url);
+	return parsed.pathname + parsed.search;
+}
+function hostFromUrl(url) {
+	return new URL(url).host;
+}
+function parseEnvelope(sanitizedBody) {
+	if (!sanitizedBody) return null;
+	const result = parseJsonResult(sanitizedBody, ErrorEnvelope);
+	return result.ok ? result.value : null;
+}
+const NO_ENVELOPE_VIEWS = {
+	fieldErrors: null,
+	specificFieldErrors: null,
+	errorCode: null,
+	nonRemoteSyncedDependencies: null,
+	remoteSyncedDependents: null
+};
+function extractEnvelopeViews(sanitizedBody) {
+	const envelope = parseEnvelope(sanitizedBody);
+	if (envelope === null) return NO_ENVELOPE_VIEWS;
+	return {
+		fieldErrors: parseFieldErrors(envelope.errors),
+		specificFieldErrors: parseFieldErrors(envelope["specific-errors"]),
+		errorCode: envelope["error-code"] ?? null,
+		nonRemoteSyncedDependencies: parseOrNull(NonRemoteSyncedDependencies, envelope["non-remote-synced-models"]),
+		remoteSyncedDependents: parseOrNull(RemoteSyncedDependents, envelope["remote-synced-models"])
+	};
+}
+function parseOrNull(schema, value) {
+	const parsed = schema.safeParse(value);
+	return parsed.success ? parsed.data : null;
+}
+function parseFieldErrors(value) {
+	const parsed = FieldErrorTree.safeParse(value);
+	if (!parsed.success) return null;
+	const entries = collectLeafEntries(parsed.data, []);
+	if (entries.length === 0) return null;
+	return Object.fromEntries(entries.map((entry) => [entry.path, entry.message]));
+}
+function parseEnvelopeMessage(sanitizedBody) {
+	const envelope = parseEnvelope(sanitizedBody);
+	if (envelope === null) return null;
+	const topLevel = envelope.message ?? envelope.error ?? envelope["error-message"];
+	if (topLevel) return appendRemoteSyncConflict(condenseMessage(topLevel), envelope);
+	const viaMessage = envelope.via?.find((entry) => entry.message)?.message;
+	if (viaMessage) return condenseMessage(viaMessage);
+	const specific = formatErrorTree(envelope["specific-errors"]);
+	if (specific) return condenseMessage(specific);
+	const generic = formatErrorTree(envelope.errors);
+	if (generic) return condenseMessage(generic);
+	return null;
+}
+function appendRemoteSyncConflict(message, envelope) {
+	const dependencies = parseOrNull(NonRemoteSyncedDependencies, envelope["non-remote-synced-models"]);
+	if (dependencies !== null) {
+		const ids = listRemoteSyncEntries(dependencies.map(String));
+		return `${withoutTrailingPeriod(message)}: ids ${ids}. ${NON_REMOTE_SYNCED_REMEDY}`;
+	}
+	const dependents = parseOrNull(RemoteSyncedDependents, envelope["remote-synced-models"]);
+	if (dependents !== null) {
+		const named = listRemoteSyncEntries([...new Set(dependents.map(formatRemoteSyncedDependent))]);
+		return `${withoutTrailingPeriod(message)}: ${named}. ${REMOTE_SYNCED_REMEDY}`;
+	}
+	return message;
+}
+function formatRemoteSyncedDependent(dependent) {
+	return Object.entries(dependent).map(([model, id]) => `${model} ${id}`).join(" / ");
+}
+function listRemoteSyncEntries(entries) {
+	const listed = entries.slice(0, MAX_LISTED_REMOTE_SYNC_ENTRIES).join(REMOTE_SYNC_ENTRY_SEPARATOR);
+	const unlisted = entries.length - MAX_LISTED_REMOTE_SYNC_ENTRIES;
+	return unlisted > 0 ? `${listed}${REMOTE_SYNC_ENTRY_SEPARATOR}and ${unlisted} more` : listed;
+}
+function withoutTrailingPeriod(message) {
+	return message.endsWith(".") ? message.slice(0, -1) : message;
+}
+function formatErrorTree(value) {
+	const entries = collectLeafEntries(value, []);
+	if (entries.length === 0) return null;
+	return entries.map(formatLeafEntry).join(FIELD_MESSAGE_SEPARATOR);
+}
+function formatLeafEntry(entry) {
+	return entry.path === "" ? entry.message : `${entry.path}: ${entry.message}`;
+}
+function collectLeafEntries(value, path) {
+	if (typeof value === "string") {
+		const trimmed = value.trim();
+		return trimmed === "" ? [] : [{
+			path: path.join("."),
+			message: trimmed
+		}];
+	}
+	if (Array.isArray(value)) {
+		const messages = value.filter((entry) => typeof entry === "string" && entry.trim() !== "");
+		if (messages.length === 0) return [];
+		return [{
+			path: path.join("."),
+			message: messages.join(FIELD_MESSAGE_SEPARATOR)
+		}];
+	}
+	if (isPlainObject(value)) return Object.entries(value).flatMap(([key, child]) => collectLeafEntries(child, [...path, key]));
+	return [];
+}
+function condenseMessage(message) {
+	const trimmed = message.replace(GOT_VALUE_PATTERN, trimGotValue);
+	if (trimmed.length <= MAX_EXTRACTED_MESSAGE_LEN) return trimmed;
+	return trimmed.slice(0, MAX_EXTRACTED_MESSAGE_LEN - 1) + ELLIPSIS;
+}
+function trimGotValue(match, value) {
+	if (value.length <= MAX_GOT_VALUE_LEN) return match;
+	return `got: ${value.slice(0, MAX_GOT_VALUE_LEN)}${ELLIPSIS}`;
+}
+function defaultMessageForStatus(status) {
+	return STATUS_CLASSIFICATIONS[status]?.message ?? `Metabase returned ${status}.`;
+}
+//#endregion
+//#region ../client/src/version/features.ts
+const FEATURE_RULES = {
+	dataActionCollections: { since: 65 },
+	dataActionsWithoutModel: { since: 65 },
+	transforms: { since: 59 },
+	transformJobActivation: { since: 61 },
+	measures: { since: 59 },
+	library: {
+		since: 59,
+		tokenFeature: "library"
+	},
+	libraryDashboards: { since: 65 },
+	remoteSync: {
+		since: 58,
+		tokenFeature: "remote_sync"
+	},
+	remoteSyncRemoteChanges: {
+		since: 59,
+		tokenFeature: "remote_sync"
+	},
+	remoteSyncCollectionsOnlyUpdate: { since: 60 },
+	remoteSyncExportPreflight: {
+		since: 63,
+		tokenFeature: "remote_sync"
+	},
+	remoteSyncBranchGuard: { since: 63 },
+	remoteSyncMerge: {
+		since: 63,
+		tokenFeature: "remote_sync"
+	},
+	contentTranslation: {
+		since: 58,
+		tokenFeature: "content_translation"
+	},
+	contentVerification: {
+		since: 58,
+		tokenFeature: "content_verification"
+	},
+	transformTargetTableId: { since: 61 },
+	transformTargetTableLinkedOnCreate: {
+		since: 61,
+		until: 61
+	},
+	transformJobRunIdIsNumeric: { since: 64 },
+	transformCheckpointReset: { since: 60 },
+	fieldDataSensitivity: { since: 64 },
+	fieldRemappingAppendsDisplayColumns: {
+		since: 58,
+		until: 59
+	},
+	transformDagRuns: { since: 64 },
+	unifiedTransformRuns: { since: 64 },
+	transformTests: {
+		since: 65,
+		tokenFeature: "transforms-testing"
+	},
+	libraryChildrenCarryType: { since: 62 },
+	collectionItemsTotalOnEmptyPage: { since: 64 },
+	invalidMbqlIsBadRequest: { since: 59 },
+	boxplotDisplay: { since: 59 },
+	nativeTableTemplateTag: { since: 59 },
+	smartLinkMeasureModel: { since: 60 },
+	dashboardSubscriptionFilters: {
+		since: 58,
+		tokenFeature: "dashboard_subscription_filters"
+	},
+	dependencyGraph: {
+		since: 58,
+		tokenFeature: "dependencies"
+	},
+	dependencyItemListings: {
+		since: 59,
+		tokenFeature: "dependencies"
+	},
+	dependencyAsyncBackfill: {
+		since: 60,
+		tokenFeature: "dependencies"
+	},
+	measureDependencyGraph: { since: 59 },
+	tableListAccessFilters: { since: 59 },
+	tableListTransformTargets: { since: 60 },
+	tableListPublishedFilter: { since: 63 },
+	tableUnusedFilter: {
+		since: 58,
+		tokenFeature: "dependencies"
+	},
+	tableDataLayerTiers: { since: 59 },
+	bulkTableEdit: { since: 59 },
+	tableUserValueWithdrawal: { since: 64 },
+	bulkTableSync: { since: 59 },
+	erd: {
+		since: 62,
+		tokenFeature: "schema-viewer"
+	},
+	documentCopy: { since: 59 },
+	transformInspector: {
+		since: 60,
+		tokenFeature: "transforms-python"
+	},
+	pythonLibrary: {
+		since: 58,
+		tokenFeature: "transforms-python"
+	},
+	pythonTestRun: {
+		since: 60,
+		tokenFeature: "transforms-python"
+	},
+	sourceReplacement: {
+		since: 60,
+		tokenFeature: "dependencies"
+	},
+	metricDefinitionQuery: { since: 60 },
+	metricDimensionListing: { since: 64 },
+	oauthFullAccessScopeUnadvertised: { since: 64 },
+	exportCsvByteOrderMark: { since: 63 }
+};
+function isFeatureName(name) {
+	return Object.hasOwn(FEATURE_RULES, name);
+}
+const FEATURE_NAMES = Object.keys(FEATURE_RULES).filter(isFeatureName);
+const Features = z.record(z.enum(FEATURE_NAMES), z.boolean());
+function evaluateFeatures(major, tokenFeatures) {
+	const entries = FEATURE_NAMES.map((name) => [name, ruleHolds(FEATURE_RULES[name], major, tokenFeatures)]);
+	return Features.parse(Object.fromEntries(entries));
+}
+function ruleHolds(rule, major, tokenFeatures) {
+	return ruleGap(rule, major, tokenFeatures) === null;
+}
+function ruleGap(rule, major, tokenFeatures) {
+	if (!versionHolds(rule, major)) return { kind: "version" };
+	if (rule.tokenFeature === void 0) return null;
+	return tokenFeatures !== null && tokenFeatures[rule.tokenFeature] === true ? null : {
+		kind: "token",
+		tokenFeature: rule.tokenFeature
+	};
+}
+function versionHolds(rule, major) {
+	if (major === "development") return rule.until === void 0;
+	return major >= rule.since && (rule.until === void 0 || major <= rule.until);
+}
+//#endregion
+//#region ../client/src/version/capability-error.ts
+const RequirementReason = z.enum([
+	"version-too-old",
+	"missing-token-feature",
+	"superseded-by-feature"
+]);
+const RequirementFailure = z.object({
+	reason: RequirementReason,
+	detail: z.string(),
+	feature: z.enum(FEATURE_NAMES),
+	since: z.number().int(),
+	tokenFeature: z.string().nullable(),
+	serverVersion: z.string()
+});
+function versionTooOldMessage(since, serverVersion) {
+	return `This operation requires Metabase v${since}+ (this server is ${serverVersion}). Upgrade Metabase to use it.`;
+}
+function missingTokenFeatureMessage(tokenFeature) {
+	return `This operation requires the '${tokenFeature}' premium feature (not enabled on this server).`;
+}
+var CapabilityError = class extends MetabaseError {
+	category = "capability";
+	isRetryable = false;
+	developerDetail;
+	constructor(failure, refusal = null) {
+		super(capabilityMessage(failure, refusal), refusal === null ? void 0 : { cause: refusal });
+		this.name = "CapabilityError";
+		this.developerDetail = failure;
+	}
+};
+function capabilityMessage(failure, refusal) {
+	if (refusal === null || refusal.status !== 400) return failure.detail;
+	const said = refusal.serverMessage;
+	if (said === null) return failure.detail;
+	return `${failure.detail}\nMetabase answered ${refusal.status}: ${said}`;
+}
+//#endregion
 //#region src/core/profile-refreshed-error.ts
 var ProfileRefreshedError = class extends MetabaseError {
 	category;
@@ -743,6 +1304,17 @@ function legacyEnvWarning(canonical) {
 function warn(message) {
 	process.stderr.write(message + "\n");
 }
+const PREFLIGHT_RISK = "may ignore or rewrite what it does not support and answer without saying so";
+const PREFLIGHT_SKIP_REMEDY = `If this server does support it, rerun with --skip-preflight; a server without it ${PREFLIGHT_RISK}.`;
+function preflightSkippedNotice(refusal) {
+	return `Skipped preflight: ${withoutFinalPeriod(refusal)}. A server without it ${PREFLIGHT_RISK}.`;
+}
+function preflightUncheckedNotice(reason) {
+	return `Skipped preflight: could not check the server (${withoutFinalPeriod(reason)}), so the request went out unchecked. A server without a feature it needs ${PREFLIGHT_RISK}.`;
+}
+function withoutFinalPeriod(text) {
+	return text.endsWith(".") ? text.slice(0, -1) : text;
+}
 const LIST_TRUNCATION_REMEDY = "narrow the selection or raise --max-bytes";
 function listTruncationNotice(bytes, nextOffset, hint) {
 	return `… cut at ${bytes} bytes; ${typeof nextOffset === "number" ? `continue with --offset ${nextOffset}, ` : ""}${hint ?? LIST_TRUNCATION_REMEDY}`;
@@ -845,23 +1417,6 @@ function jsonByteLength(value) {
 	return Buffer.byteLength(JSON.stringify(value), "utf8");
 }
 //#endregion
-//#region ../client/src/predicates.ts
-function isPlainObject(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-const JAVA_WHITESPACE = "	\n\v\f\r            \u2028\u2029 　";
-const UNICODE_ESCAPE_DIGITS = 4;
-function unicodeEscape(char) {
-	return `\\u${char.charCodeAt(0).toString(16).padStart(UNICODE_ESCAPE_DIGITS, "0")}`;
-}
-const JAVA_WHITESPACE_ESCAPED = [...JAVA_WHITESPACE].map(unicodeEscape).join("");
-/** Matches a string Metabase reads as not blank: one holding a character that is not Java whitespace. */
-const NOT_BLANK = new RegExp(`[^${JAVA_WHITESPACE_ESCAPED}]`);
-/** Whether Metabase reads `value` as blank: empty, or Java whitespace only. */
-function isBlank(value) {
-	return !NOT_BLANK.test(value);
-}
-//#endregion
 //#region src/output/projection.ts
 function projectForList(item, view, opts) {
 	const full = opts.format === "text" && opts.fields === void 0 ? false : opts.full;
@@ -1104,6 +1659,7 @@ function exitCodeFor(category) {
 		case "http":
 		case "validation":
 		case "response-shape":
+		case "partial-write":
 		case "timeout":
 		case "internal":
 		case "failed":
@@ -1125,11 +1681,15 @@ function isVersionTooOld(detail) {
 function isRouteMissing(handled) {
 	return "kind" in handled && handled.kind === ROUTE_MISSING_KIND;
 }
+function isRefusedBeforeSending(handled) {
+	return handled instanceof CapabilityError && handled.cause === void 0;
+}
 function remediesFor(handled) {
 	if (handled instanceof ProfileRefreshedError) return [];
-	if (isVersionTooOld(handled.developerDetail)) return [DOWNGRADE_REMEDY];
 	if (isRouteMissing(handled)) return [ROUTE_MISSING_REMEDY];
-	return [];
+	const downgrade = isVersionTooOld(handled.developerDetail) ? [DOWNGRADE_REMEDY] : [];
+	const skip = isRefusedBeforeSending(handled) ? [PREFLIGHT_SKIP_REMEDY] : [];
+	return [...downgrade, ...skip];
 }
 function writeTextError(handled, verbose) {
 	process.stderr.write(handled.userMessage + "\n");
@@ -1155,145 +1715,6 @@ function writeJsonError(handled, exitCode, verbose) {
 	process.stderr.write(serializeJson(envelope, stderrPretty()) + "\n");
 }
 //#endregion
-//#region ../client/src/version/features.ts
-const FEATURE_RULES = {
-	dataActionCollections: { since: 65 },
-	dataActionsWithoutModel: { since: 65 },
-	transforms: { since: 59 },
-	transformJobActivation: { since: 61 },
-	measures: { since: 59 },
-	library: {
-		since: 59,
-		tokenFeature: "library"
-	},
-	remoteSync: {
-		since: 60,
-		tokenFeature: "remote_sync"
-	},
-	remoteSyncExportPreflight: {
-		since: 63,
-		tokenFeature: "remote_sync"
-	},
-	remoteSyncBranchGuard: { since: 63 },
-	remoteSyncMerge: {
-		since: 63,
-		tokenFeature: "remote_sync"
-	},
-	contentTranslation: {
-		since: 58,
-		tokenFeature: "content_translation"
-	},
-	contentVerification: {
-		since: 58,
-		tokenFeature: "content_verification"
-	},
-	transformTargetTableId: { since: 61 },
-	transformTargetTableLinkedOnCreate: {
-		since: 61,
-		until: 61
-	},
-	transformJobRunIdIsNumeric: { since: 64 },
-	transformCheckpointReset: { since: 60 },
-	fieldDataSensitivity: { since: 64 },
-	fieldRemappingAppendsDisplayColumns: {
-		since: 58,
-		until: 59
-	},
-	transformDagRuns: { since: 64 },
-	unifiedTransformRuns: { since: 64 },
-	transformTests: {
-		since: 65,
-		tokenFeature: "transforms-testing"
-	},
-	libraryChildrenCarryType: { since: 62 },
-	collectionItemsTotalOnEmptyPage: { since: 64 },
-	invalidMbqlIsBadRequest: { since: 59 },
-	boxplotDisplay: { since: 59 },
-	nativeTableTemplateTag: { since: 59 },
-	compiledQueryOmitsCollection: {
-		since: 59,
-		until: 62
-	},
-	smartLinkMeasureModel: { since: 60 },
-	dashboardSubscriptionFilters: {
-		since: 58,
-		tokenFeature: "dashboard_subscription_filters"
-	},
-	dependencyGraph: {
-		since: 58,
-		tokenFeature: "dependencies"
-	},
-	dependencyItemListings: {
-		since: 59,
-		tokenFeature: "dependencies"
-	},
-	dependencyAsyncBackfill: {
-		since: 60,
-		tokenFeature: "dependencies"
-	},
-	measureDependencyGraph: { since: 59 },
-	tableListAccessFilters: { since: 59 },
-	tableListTransformTargets: { since: 60 },
-	tableListPublishedFilter: { since: 63 },
-	tableUnusedFilter: {
-		since: 58,
-		tokenFeature: "dependencies"
-	},
-	tableDataLayerTiers: { since: 59 },
-	bulkTableEdit: { since: 59 },
-	tableUserValueWithdrawal: { since: 64 },
-	bulkTableSync: { since: 59 },
-	erd: {
-		since: 62,
-		tokenFeature: "schema-viewer"
-	},
-	documentCopy: { since: 59 },
-	transformInspector: {
-		since: 60,
-		tokenFeature: "transforms-python"
-	},
-	pythonLibrary: {
-		since: 58,
-		tokenFeature: "transforms-python"
-	},
-	pythonTestRun: {
-		since: 60,
-		tokenFeature: "transforms-python"
-	},
-	sourceReplacement: {
-		since: 60,
-		tokenFeature: "dependencies"
-	},
-	metricDefinitionQuery: { since: 60 },
-	metricDimensionListing: { since: 64 },
-	oauthFullAccessScope: { since: 63 },
-	exportCsvByteOrderMark: { since: 63 }
-};
-function isFeatureName(name) {
-	return Object.hasOwn(FEATURE_RULES, name);
-}
-const FEATURE_NAMES = Object.keys(FEATURE_RULES).filter(isFeatureName);
-const Features = z.record(z.enum(FEATURE_NAMES), z.boolean());
-function evaluateFeatures(major, tokenFeatures) {
-	const entries = FEATURE_NAMES.map((name) => [name, ruleHolds(FEATURE_RULES[name], major, tokenFeatures)]);
-	return Features.parse(Object.fromEntries(entries));
-}
-function ruleHolds(rule, major, tokenFeatures) {
-	return ruleGap(rule, major, tokenFeatures) === null;
-}
-function ruleGap(rule, major, tokenFeatures) {
-	if (!versionHolds(rule, major)) return { kind: "version" };
-	if (rule.tokenFeature === void 0) return null;
-	return tokenFeatures !== null && tokenFeatures[rule.tokenFeature] === true ? null : {
-		kind: "token",
-		tokenFeature: rule.tokenFeature
-	};
-}
-function versionHolds(rule, major) {
-	if (major === "development") return rule.until === void 0;
-	return major >= rule.since && (rule.until === void 0 || major <= rule.until);
-}
-//#endregion
 //#region ../client/src/version/requirements.ts
 const METHOD_REQUIREMENTS = {
 	"card.list": [],
@@ -1364,7 +1785,7 @@ const METHOD_REQUIREMENTS = {
 	"gitSync.cancelTask": ["remoteSync"],
 	"gitSync.isDirty": ["remoteSync"],
 	"gitSync.dirty": ["remoteSync"],
-	"gitSync.hasRemoteChanges": ["remoteSync"],
+	"gitSync.hasRemoteChanges": ["remoteSyncRemoteChanges"],
 	"gitSync.import": ["remoteSync"],
 	"gitSync.export": ["remoteSync"],
 	"gitSync.exportPreflight": ["remoteSyncExportPreflight"],
@@ -1374,8 +1795,8 @@ const METHOD_REQUIREMENTS = {
 	"gitSync.setCollectionSynced": ["remoteSync"],
 	"gitSync.syncedCollections": ["remoteSync"],
 	"gitSync.remoteUrl": [],
-	"gitSync.branch": [],
-	"gitSync.trackedBranch": [],
+	"gitSync.branch": ["remoteSync"],
+	"gitSync.trackedBranch": ["remoteSync"],
 	"gitSync.waitForTask": ["remoteSync"],
 	"glossary.list": [],
 	"glossary.create": [],
@@ -1902,4 +2323,4 @@ run().catch((error) => {
 	reportError(error);
 });
 //#endregion
-export { assertArgv as $, warn as A, setMetabaseAugment as B, isBlank as C, promptSelect as D, promptPassword as E, ENV_SKIP_PREFLIGHT as F, listFlag as G, version as H, ENV_URL as I, outputFlags as J, listFlags as K, consumeLegacyEnvWarnings as L, ENV_DISABLE_KEYRING as M, ENV_PROFILE as N, promptText as O, ENV_SKILLS_DIR as P, listEnvelopeSchemaWithExtras as Q, readEnv as R, NOT_BLANK as S, promptConfirm as T, connectionFlags as U, name as V, formatFlags as W, DEFAULT_MAX_BYTES as X, profileFlag as Y, listEnvelopeSchema as Z, writeText as _, isFileNotFoundError as _t, Features as a, ChainedRequestError as at, renderRows as b, ruleGap as c, InternalError as ct, renderList as d, ResponseShapeError as dt, givenFlagKeys as et, renderListWithExtras as f, TimeoutError as ft, writeJson as g, formatZodIssue as gt, serializeJson as h, errorMessage as ht, FEATURE_RULES as i, AbortError as it, ENV_API_KEY as j, listTruncationNotice as k, reportError as l, MetabaseError as lt, renderSummaryWithinMaxBytes as m, ValidationError as mt, methodRequirements as n, parseEnum as nt, evaluateFeatures as o, ConfigError as ot, renderSummary as p, UnknownError as pt, listFlagsWithDefaultLimit as q, FEATURE_NAMES as r, parseEnumCsv as rt, isFeatureName as s, FailedResultError as st, interruptSignal as t, parseCsv as tt, renderItem as u, NetworkError as ut, MALFORMED_CELL as v, KNOWN_RANGE as vt, isPlainObject as w, projectForList as x, formatScalar as y, escapeJsonPointerSegment as yt, ProfileRefreshedError as z };
+export { parseJsonResult as $, ENV_URL as A, formatZodIssue as At, Features as B, preflightUncheckedNotice as C, NetworkError as Ct, ENV_PROFILE as D, UnknownError as Dt, ENV_DISABLE_KEYRING as E, TimeoutError as Et, RequirementFailure as F, chainRequestFailure as G, isFeatureName as H, missingTokenFeatureMessage as I, isBlank as J, isRetryableStatus as K, versionTooOldMessage as L, readEnv as M, isNonInterruptFailure as Mt, ProfileRefreshedError as N, KNOWN_RANGE as Nt, ENV_SKILLS_DIR as O, ValidationError as Ot, CapabilityError as P, escapeJsonPointerSegment as Pt, parseJsonOrPlain as Q, FEATURE_NAMES as R, preflightSkippedNotice as S, MetabaseError as St, ENV_API_KEY as T, ResponseShapeError as Tt, ruleGap as U, evaluateFeatures as V, HttpError as W, JSON_CONTENT_TYPE as X, isPlainObject as Y, parseJson as Z, promptConfirm as _, parseEnumCsv as _t, renderItem as a, listFlag as at, promptText as b, FailedResultError as bt, renderSummary as c, outputFlags as ct, writeJson as d, listEnvelopeSchema as dt, setMetabaseAugment as et, writeText as f, listEnvelopeSchemaWithExtras as ft, projectForList as g, parseEnum as gt, renderRows as h, parseCsv as ht, reportError as i, formatFlags as it, consumeLegacyEnvWarnings as j, isFileNotFoundError as jt, ENV_SKIP_PREFLIGHT as k, errorMessage as kt, renderSummaryWithinMaxBytes as l, profileFlag as lt, formatScalar as m, givenFlagKeys as mt, isMethodKey as n, version as nt, renderList as o, listFlags as ot, MALFORMED_CELL as p, assertArgv as pt, NOT_BLANK as q, methodRequirements as r, connectionFlags as rt, renderListWithExtras as s, listFlagsWithDefaultLimit as st, interruptSignal as t, name as tt, serializeJson as u, DEFAULT_MAX_BYTES as ut, promptPassword as v, AbortError as vt, warn as w, PartialWriteError as wt, listTruncationNotice as x, InternalError as xt, promptSelect as y, ConfigError as yt, FEATURE_RULES as z };