@metabase/cli 0.4.1-alpha.fix-transform-test-ee-path.b41b46c → 0.5.0

package/dist/cli.mjs

@@ -120,15 +120,6 @@ var InternalError = class extends MetabaseError {
 		this.name = "InternalError";
 	}
 };
-var FailedResultError = class extends MetabaseError {
-	category = "failed";
-	isRetryable = false;
-	developerDetail = null;
-	constructor(message) {
-		super(message);
-		this.name = "FailedResultError";
-	}
-};
 var AbortError = class extends MetabaseError {
 	category = "abort";
 	isRetryable = false;
@@ -138,6 +129,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 +159,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 +581,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 +627,7 @@ function trustSystemCa() {
 //#endregion
 //#region package.json
 var name = "@metabase/cli";
-var version = "0.4.1-alpha.fix-transform-test-ee-path.b41b46c";
+var version = "0.5.0";
 var description = "Metabase CLI";
 //#endregion
 //#region src/runtime/command-augment.ts
@@ -643,39 +647,38 @@ const main = defineCommand({
 		description
 	},
 	subCommands: {
-		auth: () => import("./auth-IQKgyb_x.mjs").then((mod) => mod.default),
-		db: () => import("./db-DNevs1XU.mjs").then((mod) => mod.default),
-		table: () => import("./table-8c-V5afO.mjs").then((mod) => mod.default),
-		field: () => import("./field-CcCQ0goz.mjs").then((mod) => mod.default),
-		upload: () => import("./upload-BqNErDXE.mjs").then((mod) => mod.default),
-		"content-translation": () => import("./content-translation-CSkaKlqa.mjs").then((mod) => mod.default),
-		card: () => import("./card-DmQO85ej.mjs").then((mod) => mod.default),
-		dashboard: () => import("./dashboard-c_wOMtS9.mjs").then((mod) => mod.default),
-		subscription: () => import("./subscription-C9alueg1.mjs").then((mod) => mod.default),
-		alert: () => import("./alert-DBTU8iHe.mjs").then((mod) => mod.default),
-		collection: () => import("./collection-BPVrTfTv.mjs").then((mod) => mod.default),
-		library: () => import("./library-DDrpsgMv.mjs").then((mod) => mod.default),
-		document: () => import("./document-DCqe5MO9.mjs").then((mod) => mod.default),
-		glossary: () => import("./glossary-LdAlftZW.mjs").then((mod) => mod.default),
-		transform: () => import("./transform-p-6_thIh.mjs").then((mod) => mod.default),
-		"transform-job": () => import("./transform-job-DALBzYVV.mjs").then((mod) => mod.default),
-		"transform-tag": () => import("./transform-tag-CIKnNaQH.mjs").then((mod) => mod.default),
-		"transform-test": () => import("./transform-test-C5Havg4o.mjs").then((mod) => mod.default),
-		setting: () => import("./setting-DMqvipRp.mjs").then((mod) => mod.default),
-		search: () => import("./search-CJYSB5eP.mjs").then((mod) => mod.default),
-		"git-sync": () => import("./git-sync-CO199xCu.mjs").then((mod) => mod.default),
-		setup: () => import("./setup-B2PC1NVz.mjs").then((mod) => mod.default),
-		snippet: () => import("./snippet-D-5bKT_U.mjs").then((mod) => mod.default),
-		segment: () => import("./segment-Tt8GaRnc.mjs").then((mod) => mod.default),
-		measure: () => import("./measure-c_VUyXFN.mjs").then((mod) => mod.default),
-		dependency: () => import("./dependency-D6DMbPVm.mjs").then((mod) => mod.default),
-		timeline: () => import("./timeline-BetOmLYk.mjs").then((mod) => mod.default),
-		"timeline-event": () => import("./timeline-event-DN3y8vwW.mjs").then((mod) => mod.default),
-		eid: () => import("./eid-BEc1p_um.mjs").then((mod) => mod.default),
-		query: () => import("./query-DNa-fGS7.mjs").then((mod) => mod.default),
-		uuid: () => import("./uuid-D9oozo8p.mjs").then((mod) => mod.default),
-		upgrade: () => import("./upgrade-o2DpB66j.mjs").then((mod) => mod.default),
-		skills: () => import("./skills-D7wu2iff.mjs").then((mod) => mod.default)
+		auth: () => import("./auth-DOz7KW5E.mjs").then((mod) => mod.default),
+		db: () => import("./db-C82M3Gpg.mjs").then((mod) => mod.default),
+		table: () => import("./table-qjgz2eek.mjs").then((mod) => mod.default),
+		field: () => import("./field-qF1KRJYB.mjs").then((mod) => mod.default),
+		upload: () => import("./upload-fcim1xtK.mjs").then((mod) => mod.default),
+		"content-translation": () => import("./content-translation-BlG41YrA.mjs").then((mod) => mod.default),
+		card: () => import("./card-Buc-X4Mh.mjs").then((mod) => mod.default),
+		dashboard: () => import("./dashboard-DH_soSQp.mjs").then((mod) => mod.default),
+		subscription: () => import("./subscription-CSR2t-xK.mjs").then((mod) => mod.default),
+		alert: () => import("./alert-DMlSjPEv.mjs").then((mod) => mod.default),
+		collection: () => import("./collection-D-sS0AFw.mjs").then((mod) => mod.default),
+		library: () => import("./library-D2ogEIfI.mjs").then((mod) => mod.default),
+		document: () => import("./document-WhSEyI-3.mjs").then((mod) => mod.default),
+		glossary: () => import("./glossary-BvVxqjxJ.mjs").then((mod) => mod.default),
+		transform: () => import("./transform-Y86R7_2F.mjs").then((mod) => mod.default),
+		"transform-job": () => import("./transform-job-Cg_1jzWI.mjs").then((mod) => mod.default),
+		"transform-tag": () => import("./transform-tag-DHg7j15d.mjs").then((mod) => mod.default),
+		setting: () => import("./setting-B-bxCkC0.mjs").then((mod) => mod.default),
+		search: () => import("./search-CB1A4HWx.mjs").then((mod) => mod.default),
+		"git-sync": () => import("./git-sync-BlgB_-8-.mjs").then((mod) => mod.default),
+		setup: () => import("./setup-Bvvqlz9d.mjs").then((mod) => mod.default),
+		snippet: () => import("./snippet-B7Kau5U8.mjs").then((mod) => mod.default),
+		segment: () => import("./segment-BEjaeLc5.mjs").then((mod) => mod.default),
+		measure: () => import("./measure-CUqJtDNm.mjs").then((mod) => mod.default),
+		dependency: () => import("./dependency-CLznxtLE.mjs").then((mod) => mod.default),
+		timeline: () => import("./timeline-CNkrY3e3.mjs").then((mod) => mod.default),
+		"timeline-event": () => import("./timeline-event-CSzx8EDP.mjs").then((mod) => mod.default),
+		eid: () => import("./eid-Ex4G-ZlN.mjs").then((mod) => mod.default),
+		query: () => import("./query-Ct697cY-.mjs").then((mod) => mod.default),
+		uuid: () => import("./uuid-DW30GY7B.mjs").then((mod) => mod.default),
+		upgrade: () => import("./upgrade-BBOEVIRa.mjs").then((mod) => mod.default),
+		skills: () => import("./skills-DxrO7HUz.mjs").then((mod) => mod.default)
 	}
 });
 setMetabaseAugment(main, {
@@ -693,6 +696,551 @@ 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 = {
+	transforms: { since: 59 },
+	transformJobActivation: { since: 61 },
+	measures: { since: 59 },
+	library: {
+		since: 59,
+		tokenFeature: "library"
+	},
+	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;
@@ -742,6 +1290,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}`;
@@ -844,23 +1403,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;
@@ -980,23 +1522,18 @@ function writeText(text) {
 	process.stdout.write(text + "\n");
 }
 function renderItem(item, view, opts) {
-	writeWithinMaxBytes(itemBody(item, view, opts), opts);
-}
-function itemBody(item, view, opts) {
-	return renderItemBody(item, view, applyProjection(item, view, opts.full, opts.fields), opts) + "\n";
+	const body = renderItemBody(item, view, applyProjection(item, view, opts.full, opts.fields), opts) + "\n";
+	assertItemWithinMaxBytes(body, opts);
+	process.stdout.write(body);
 }
 function renderSummary(item, view, summaryText, opts) {
-	writeWithinMaxBytes(summaryBody(item, view, summaryText, opts), opts);
-}
-function renderSummaryWithinMaxBytes(item, view, summaryText, opts) {
-	const body = summaryBody(item, view, summaryText, opts);
-	const oversize = oversizeMessage(body, opts);
-	if (oversize === null) process.stdout.write(body);
-	return oversize;
-}
-function summaryBody(item, view, summaryText, opts) {
-	if (opts.format === "json" || opts.fields !== void 0 || opts.full) return itemBody(item, view, opts);
-	return (typeof summaryText === "function" ? summaryText() : summaryText) + "\n";
+	if (opts.format === "json" || opts.fields !== void 0 || opts.full) {
+		renderItem(item, view, opts);
+		return;
+	}
+	const body = (typeof summaryText === "function" ? summaryText() : summaryText) + "\n";
+	assertItemWithinMaxBytes(body, opts);
+	process.stdout.write(body);
 }
 function renderList(envelope, view, opts) {
 	renderListWithExtras(envelope, {}, view, opts);
@@ -1075,16 +1612,11 @@ function renderKeyValueLines(pairs) {
 	const padding = Math.max(...pairs.map(([label]) => label.length));
 	return pairs.map(([label, value]) => `${label.padEnd(padding)}  ${value}`).join("\n");
 }
-function writeWithinMaxBytes(body, opts) {
-	const oversize = oversizeMessage(body, opts);
-	if (oversize !== null) throw new ConfigError(oversize);
-	process.stdout.write(body);
-}
-function oversizeMessage(body, opts) {
-	if (opts.maxBytes <= 0) return null;
+function assertItemWithinMaxBytes(body, opts) {
+	if (opts.maxBytes <= 0) return;
 	const bytes = Buffer.byteLength(body, "utf8");
-	if (bytes <= opts.maxBytes) return null;
-	return itemOversizeMessage(bytes, opts.maxBytes, opts.oversizeHint);
+	if (bytes <= opts.maxBytes) return;
+	throw new ConfigError(itemOversizeMessage(bytes, opts.maxBytes, opts.oversizeHint));
 }
 //#endregion
 //#region src/output/error.ts
@@ -1103,9 +1635,9 @@ function exitCodeFor(category) {
 		case "http":
 		case "validation":
 		case "response-shape":
+		case "partial-write":
 		case "timeout":
 		case "internal":
-		case "failed":
 		case "unknown": return FAILURE_EXIT_CODE;
 	}
 }
@@ -1124,11 +1656,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");
@@ -1154,143 +1690,6 @@ function writeJsonError(handled, exitCode, verbose) {
 	process.stderr.write(serializeJson(envelope, stderrPretty()) + "\n");
 }
 //#endregion
-//#region ../client/src/version/features.ts
-const FEATURE_RULES = {
-	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": [],
@@ -1354,7 +1753,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"],
@@ -1364,8 +1763,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": [],
@@ -1892,4 +2291,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 { setMetabaseAugment as $, consumeLegacyEnvWarnings as A, isNonInterruptFailure as At, evaluateFeatures as B, warn as C, ResponseShapeError as Ct, ENV_SKILLS_DIR as D, errorMessage as Dt, ENV_PROFILE as E, ValidationError as Et, missingTokenFeatureMessage as F, isRetryableStatus as G, ruleGap as H, versionTooOldMessage as I, isPlainObject as J, NOT_BLANK as K, FEATURE_NAMES as L, ProfileRefreshedError as M, escapeJsonPointerSegment as Mt, CapabilityError as N, ENV_SKIP_PREFLIGHT as O, formatZodIssue as Ot, RequirementFailure as P, parseJsonResult as Q, FEATURE_RULES as R, preflightUncheckedNotice as S, PartialWriteError as St, ENV_DISABLE_KEYRING as T, UnknownError as Tt, HttpError as U, isFeatureName as V, chainRequestFailure as W, parseJson as X, JSON_CONTENT_TYPE as Y, parseJsonOrPlain as Z, promptPassword as _, AbortError as _t, renderItem as a, listFlags as at, listTruncationNotice as b, MetabaseError as bt, renderSummary as c, profileFlag as ct, writeText as d, listEnvelopeSchemaWithExtras as dt, name as et, MALFORMED_CELL as f, assertArgv as ft, promptConfirm as g, parseEnumCsv as gt, projectForList as h, parseEnum as ht, reportError as i, listFlag as it, readEnv as j, KNOWN_RANGE as jt, ENV_URL as k, isFileNotFoundError as kt, serializeJson as l, DEFAULT_MAX_BYTES as lt, renderRows as m, parseCsv as mt, isMethodKey as n, connectionFlags as nt, renderList as o, listFlagsWithDefaultLimit as ot, formatScalar as p, givenFlagKeys as pt, isBlank as q, methodRequirements as r, formatFlags as rt, renderListWithExtras as s, outputFlags as st, interruptSignal as t, version as tt, writeJson as u, listEnvelopeSchema as ut, promptSelect as v, ConfigError as vt, ENV_API_KEY as w, TimeoutError as wt, preflightSkippedNotice as x, NetworkError as xt, promptText as y, InternalError as yt, Features as z };