@metabase/cli 0.1.8 → 0.1.10

package/dist/{branches-DjiGsjAz.mjs → branches-Jpv-FNds.mjs}

@@ -1,10 +1,9 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-CTVL5CdB.mjs";
-import { defineMetabaseCommand } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { renderList } from "./render-0_GsapXa.mjs";
-import { REMOTE_SYNC_PATHS } from "./poll-task-D8mG49IN.mjs";
-import "./poll-DxpnK1wW.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-BWXBhqLW.mjs";
+import { defineMetabaseCommand } from "./runtime-colqvhLf.mjs";
+import { renderList } from "./capabilities-7L9GVMd_.mjs";
+import "./poll-BucRFJT-.mjs";
+import { REMOTE_SYNC_PATHS } from "./poll-task-DTzKB3T3.mjs";
 import { z } from "zod";
 
 //#region src/commands/git-sync/branches.ts

package/dist/{cancel-BwtDQ2MR.mjs → cancel-ChC4lFd4.mjs}

@@ -1,9 +1,8 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CTVL5CdB.mjs";
-import { defineMetabaseCommand } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { renderSummary } from "./render-0_GsapXa.mjs";
-import { parseId } from "./parse-id-D1LTTt9L.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BWXBhqLW.mjs";
+import { defineMetabaseCommand } from "./runtime-colqvhLf.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import { parseId } from "./parse-id--iVTCKSo.mjs";
 import { z } from "zod";
 
 //#region src/commands/transform/cancel.ts

package/dist/{cancel-task-uJp18RvR.mjs → cancel-task-DyhIkNaL.mjs}

@@ -1,10 +1,9 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CTVL5CdB.mjs";
-import { defineMetabaseCommand } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { renderSummary } from "./render-0_GsapXa.mjs";
-import { REMOTE_SYNC_PATHS, SyncTask, syncTaskView } from "./poll-task-D8mG49IN.mjs";
-import "./poll-DxpnK1wW.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BWXBhqLW.mjs";
+import { defineMetabaseCommand } from "./runtime-colqvhLf.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import "./poll-BucRFJT-.mjs";
+import { REMOTE_SYNC_PATHS, SyncTask, syncTaskView } from "./poll-task-DTzKB3T3.mjs";
 
 //#region src/commands/git-sync/cancel-task.ts
 var cancel_task_default = defineMetabaseCommand({

package/dist/{render-0_GsapXa.mjs → capabilities-7L9GVMd_.mjs}

@@ -1,7 +1,25 @@
 import { ConfigError } from "./command-augment-BH9qgQ5u.mjs";
-import { isPlainObject, itemOversizeMessage, listTruncationNotice, warn } from "./capabilities-7e9MgquN.mjs";
+import { z } from "zod";
 import Table from "cli-table3";
 
+//#region src/runtime/predicates.ts
+function isPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+//#endregion
+//#region src/output/notice.ts
+function warn(message) {
+	process.stderr.write(message + "\n");
+}
+function listTruncationNotice(bytes) {
+	return `… cut at ${bytes} bytes; rerun with --max-bytes 0`;
+}
+function itemOversizeMessage(bytes, maxBytes) {
+	return `output is ${bytes} bytes, over the ${maxBytes}-byte --max-bytes cap; narrow with --fields, or pass --max-bytes 0 to disable`;
+}
+
+//#endregion
 //#region src/output/cap.ts
 function capListEnvelope(envelope, maxBytes) {
 	if (maxBytes <= 0) return envelope;
@@ -160,7 +178,7 @@ function renderList(envelope, view, opts) {
 	if (capped.truncated !== void 0) warn(listTruncationNotice(capped.truncated.bytes));
 }
 function renderProjectedTable(envelope, view, fields, maxBytes) {
-	const projectedItems = envelope.data.map((item) => applyProjection(item, view, false, fields));
+	const projectedItems = projectListItems(envelope.data, view, false, fields);
 	const capped = capListEnvelope({
 		...envelope,
 		data: projectedItems
@@ -169,8 +187,23 @@ function renderProjectedTable(envelope, view, fields, maxBytes) {
 	process.stdout.write(renderRows(fields, rows) + "\n");
 	if (capped.truncated !== void 0) warn(listTruncationNotice(capped.truncated.bytes));
 }
+function projectListItems(items, view, full, fields) {
+	try {
+		return items.map((item) => applyProjection(item, view, full, fields));
+	} catch (error) {
+		throw enrichListFieldPathError(error, fields);
+	}
+}
+function enrichListFieldPathError(error, fields) {
+	if (fields === void 0 || !(error instanceof ConfigError) || !error.message.startsWith("unknown field path")) return error;
+	const prefix = "data.";
+	const culprit = fields.find((field) => field === "data" || field.startsWith(prefix));
+	if (culprit === void 0) return error;
+	const suggestion = culprit.startsWith(prefix) ? culprit.slice(prefix.length) : "<field>";
+	return new ConfigError(`${error.message} — on list commands --fields paths are relative to each item in \`data\`, not the envelope. Drop the \`data.\` prefix (e.g. use \`${suggestion}\` instead of \`${culprit}\`).`);
+}
 function renderJsonEnvelope(envelope, view, opts) {
-	const projectedItems = envelope.data.map((item) => applyProjection(item, view, opts.full, opts.fields));
+	const projectedItems = projectListItems(envelope.data, view, opts.full, opts.fields);
 	const projectedEnvelope = {
 		...envelope,
 		data: projectedItems
@@ -207,4 +240,12 @@ function assertItemWithinMaxBytes(body, maxBytes) {
 }
 
 //#endregion
-export { formatScalar, renderItem, renderList, renderRows, renderSummary, writeJson, writeText };
+//#region src/runtime/capabilities.ts
+const Capabilities = z.object({
+	minVersion: z.number(),
+	tokenFeature: z.string().optional()
+});
+const BASELINE_CAPABILITIES = Object.freeze({ minVersion: 58 });
+
+//#endregion
+export { BASELINE_CAPABILITIES, Capabilities, formatScalar, isPlainObject, renderItem, renderList, renderRows, renderSummary, warn, writeJson, writeText };

package/dist/card-ClvGX6dQ.mjs

@@ -0,0 +1,20 @@
+import { defineCommand } from "citty";
+
+//#region src/commands/card/index.ts
+var card_default = defineCommand({
+	meta: {
+		name: "card",
+		description: "Manage Metabase cards (questions, models, metrics)"
+	},
+	subCommands: {
+		list: () => import("./list-CGdOC9zX.mjs").then((mod) => mod.default),
+		get: () => import("./get-BYw3xS0X.mjs").then((mod) => mod.default),
+		query: () => import("./query-BVZkK6Qk.mjs").then((mod) => mod.default),
+		create: () => import("./create-CvYKJOcE.mjs").then((mod) => mod.default),
+		update: () => import("./update-BkMWBzvk.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-44EWiXud.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { card_default as default };

package/dist/{card-ezYiriML.mjs → card-DnIeMmUn.mjs}

@@ -1,4 +1,4 @@
-import { FieldBaseType, FieldSemanticType } from "./field-E0IBy4Uw.mjs";
+import { FieldBaseType, FieldSemanticType } from "./field-MGxpNQUH.mjs";
 import { z } from "zod";
 
 //#region src/domain/card.ts
@@ -120,8 +120,24 @@ const CardQueryResult = z.object({
 	error: z.string().nullable().optional(),
 	error_type: z.string().nullable().optional()
 }).loose();
+const QueryColumnCompact = QueryColumn.pick({
+	name: true,
+	display_name: true,
+	base_type: true,
+	semantic_type: true
+}).strip();
+const CardQueryDataCompact = z.object({
+	rows: z.array(z.unknown()),
+	cols: z.array(QueryColumnCompact)
+}).strip();
+const CardQueryResultCompact = CardQueryResult.pick({
+	status: true,
+	row_count: true,
+	error: true,
+	error_type: true
+}).strip().extend({ data: CardQueryDataCompact.optional() });
 const cardQueryView = {
-	compactPick: CardQueryResult,
+	compactPick: CardQueryResultCompact,
 	tableColumns: [{
 		key: "status",
 		label: "Status"

package/dist/{cards-z68PANDD.mjs → cards-O-nKkQKP.mjs}

@@ -1,10 +1,9 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-CTVL5CdB.mjs";
-import { defineMetabaseCommand } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { renderList } from "./render-0_GsapXa.mjs";
-import { parseId } from "./parse-id-D1LTTt9L.mjs";
-import { DashboardDetail, DashcardCompact, dashcardView } from "./dashboard-B4bn3z6t.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-BWXBhqLW.mjs";
+import { defineMetabaseCommand } from "./runtime-colqvhLf.mjs";
+import { renderList } from "./capabilities-7L9GVMd_.mjs";
+import { parseId } from "./parse-id--iVTCKSo.mjs";
+import { DashboardDetail, DashcardCompact, dashcardView } from "./dashboard-FY5UzJ_Z.mjs";
 
 //#region src/commands/dashboard/cards.ts
 const DashcardListEnvelope = listEnvelopeSchema(DashcardCompact);

package/dist/cli.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { ConfigError, flagConsumesValue, getMetabaseAugment, normalizeFlag, resolveCitty, toAliasArray } from "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, package_default, profileFlag, reportError } from "./error-CTVL5CdB.mjs";
+import { connectionFlags, outputFlags, package_default, profileFlag, reportError } from "./error-BWXBhqLW.mjs";
 import { defineCommand, renderUsage, runMain } from "citty";
 
 //#region src/commands/global-flags.ts
@@ -58,29 +58,29 @@ const main = defineCommand({
 		description: package_default.description
 	},
 	subCommands: {
-		auth: () => import("./auth-B9B4pUaH.mjs").then((mod) => mod.default),
-		db: () => import("./db-CBCj8sBg.mjs").then((mod) => mod.default),
-		table: () => import("./table-B0fRQv91.mjs").then((mod) => mod.default),
-		field: () => import("./field-DJmQ2pul.mjs").then((mod) => mod.default),
-		card: () => import("./card-D54unw6r.mjs").then((mod) => mod.default),
-		dashboard: () => import("./dashboard-lw6IFfOs.mjs").then((mod) => mod.default),
-		collection: () => import("./collection-B5kIKRTL.mjs").then((mod) => mod.default),
-		transform: () => import("./transform-K_kp6Rdm.mjs").then((mod) => mod.default),
-		"transform-job": () => import("./transform-job-CuNN8zgv.mjs").then((mod) => mod.default),
-		setting: () => import("./setting-mKzZJpQY.mjs").then((mod) => mod.default),
-		search: () => import("./search-h78uOYec.mjs").then((mod) => mod.default),
-		"git-sync": () => import("./git-sync-rmjYOGFK.mjs").then((mod) => mod.default),
-		workspace: () => import("./workspace-Bt8n3ojY.mjs").then((mod) => mod.default),
-		setup: () => import("./setup-WTIT2WbM.mjs").then((mod) => mod.default),
-		snippet: () => import("./snippet-B84H3tfp.mjs").then((mod) => mod.default),
-		segment: () => import("./segment-CoElN2b-.mjs").then((mod) => mod.default),
-		measure: () => import("./measure-BfgxqewH.mjs").then((mod) => mod.default),
-		eid: () => import("./eid-CwQ_smOD.mjs").then((mod) => mod.default),
-		query: () => import("./query-OIuumiXN.mjs").then((mod) => mod.default),
-		uuid: () => import("./uuid-BWCaWG4O.mjs").then((mod) => mod.default),
-		upgrade: () => import("./upgrade-UqdvTikR.mjs").then((mod) => mod.default),
-		skills: () => import("./skills-tMYd5d9v.mjs").then((mod) => mod.default),
-		__manifest: () => import("./manifest-BNh0Lw6p.mjs").then((mod) => mod.createManifestCommand(main))
+		auth: () => import("./auth-cFC5m69m.mjs").then((mod) => mod.default),
+		db: () => import("./db-CSH1kwQr.mjs").then((mod) => mod.default),
+		table: () => import("./table-pK4OkVtL.mjs").then((mod) => mod.default),
+		field: () => import("./field-CTFnZI8G.mjs").then((mod) => mod.default),
+		card: () => import("./card-ClvGX6dQ.mjs").then((mod) => mod.default),
+		dashboard: () => import("./dashboard-BFeURTOw.mjs").then((mod) => mod.default),
+		collection: () => import("./collection-DjvowSJC.mjs").then((mod) => mod.default),
+		document: () => import("./document-KdT_Xj6r.mjs").then((mod) => mod.default),
+		transform: () => import("./transform-D60veFH8.mjs").then((mod) => mod.default),
+		"transform-job": () => import("./transform-job-DXt5LsrY.mjs").then((mod) => mod.default),
+		setting: () => import("./setting-DSGXJehQ.mjs").then((mod) => mod.default),
+		search: () => import("./search-BWo7xSPP.mjs").then((mod) => mod.default),
+		"git-sync": () => import("./git-sync-C2vib8rx.mjs").then((mod) => mod.default),
+		setup: () => import("./setup-aJLGLrIT.mjs").then((mod) => mod.default),
+		snippet: () => import("./snippet-Df2TrP7-.mjs").then((mod) => mod.default),
+		segment: () => import("./segment-DMuYvFjg.mjs").then((mod) => mod.default),
+		measure: () => import("./measure-Dw1QpRZa.mjs").then((mod) => mod.default),
+		eid: () => import("./eid-CzLhHZMW.mjs").then((mod) => mod.default),
+		query: () => import("./query-DG_jygDF.mjs").then((mod) => mod.default),
+		uuid: () => import("./uuid-DpinhSxA.mjs").then((mod) => mod.default),
+		upgrade: () => import("./upgrade-CFkZ4USY.mjs").then((mod) => mod.default),
+		skills: () => import("./skills-Q2AFsYvc.mjs").then((mod) => mod.default),
+		__manifest: () => import("./manifest-BPHqF5LY.mjs").then((mod) => mod.createManifestCommand(main))
 	}
 });
 var main_default = main;
@@ -97,7 +97,6 @@ const OPTIONS_HEADER = "OPTIONS";
 const LINE_PREFIX = "  ";
 const COLUMN_GAP = "  ";
 const COMMAND_PLACEHOLDER = "<command> [options]";
-const MANIFEST_COMMAND = "__manifest";
 const CLI_NAME = "mb";
 const HELP_FLAG_SPEC = "-h, --help";
 const HELP_FLAG_DESCRIPTION = "Show help for this command";
@@ -111,7 +110,6 @@ async function showUsage(cmd, parent, breadcrumb) {
 	const cittyName = parentMeta?.name ? `${parentMeta.name} ${cmdName}` : cmdName;
 	const hasSubCommands = Boolean(cmd.subCommands);
 	const isRoot = parent === void 0 && hasSubCommands;
-	const isManifest = cmdName === MANIFEST_COMMAND;
 	const augment = getMetabaseAugment(cmd);
 	const details = augment?.details ?? null;
 	const examples = augment?.examples ?? [];
@@ -124,7 +122,6 @@ async function showUsage(cmd, parent, breadcrumb) {
 	const sections = [body];
 	if (examples.length > 0) sections.push(renderExamples(examples));
 	if (isRoot) sections.push(GETTING_STARTED_HINT);
-	if (!isManifest) sections.push(renderSchemaHint());
 	process.stdout.write(sections.join("\n\n") + "\n");
 }
 function transformBody(lines, rewrite) {
@@ -193,13 +190,6 @@ function renderExamples(examples) {
 		...examples.map((example) => `${LINE_PREFIX}${example}`)
 	].join("\n");
 }
-function renderSchemaHint() {
-	return [
-		"SCHEMA",
-		"",
-		`${LINE_PREFIX}${CLI_NAME} ${MANIFEST_COMMAND}      # machine-readable command manifest (flags, output, examples)`
-	].join("\n");
-}
 async function walkCommandPath(root, rawArgs) {
 	const rootMeta = await resolveCitty(root.meta);
 	const segments = rootMeta?.name === void 0 ? [] : [rootMeta.name];

package/dist/{collection-Bcy8cWYH.mjs → collection-BPTlcFw5.mjs}

@@ -11,7 +11,13 @@ const CollectionType = z.enum([
 	"library-metrics",
 	"tenant-specific-root-collection"
 ]);
-const CollectionNamespace = z.string().min(1);
+const CollectionNamespace = z.enum([
+	"transforms",
+	"snippets",
+	"analytics",
+	"shared-tenant-collection",
+	"tenant-specific"
+]);
 const COLLECTION_ITEM_FILTER_MODELS = [
 	"card",
 	"dataset",
@@ -160,4 +166,4 @@ const CollectionCreateInput = z.object({
 }).loose();
 
 //#endregion
-export { COLLECTION_ITEM_FILTER_MODELS, COLLECTION_PINNED_STATES, Collection, CollectionCompact, CollectionCreateInput, CollectionItem, CollectionItemCompact, CollectionItemFilterModel, CollectionPinnedState, CollectionTreeNode, collectionItemView, collectionView };
+export { COLLECTION_ITEM_FILTER_MODELS, COLLECTION_PINNED_STATES, Collection, CollectionCompact, CollectionCreateInput, CollectionItem, CollectionItemCompact, CollectionItemFilterModel, CollectionNamespace, CollectionPinnedState, CollectionTreeNode, collectionItemView, collectionView };

package/dist/collection-DjvowSJC.mjs

@@ -0,0 +1,20 @@
+import { defineCommand } from "citty";
+
+//#region src/commands/collection/index.ts
+var collection_default = defineCommand({
+	meta: {
+		name: "collection",
+		description: "Manage Metabase collections"
+	},
+	subCommands: {
+		list: () => import("./list-36H-dvJZ.mjs").then((mod) => mod.default),
+		get: () => import("./get-reSMTfQi.mjs").then((mod) => mod.default),
+		items: () => import("./items-hgbRYsYD.mjs").then((mod) => mod.default),
+		tree: () => import("./tree-MOQOBeAP.mjs").then((mod) => mod.default),
+		create: () => import("./create-DS52EhPd.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-BZfpjMir.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { collection_default as default };

package/dist/collection-namespace-7724zUMx.mjs

@@ -0,0 +1,12 @@
+import { ConfigError } from "./command-augment-BH9qgQ5u.mjs";
+import { HttpError } from "./runtime-colqvhLf.mjs";
+
+//#region src/commands/transform/collection-namespace.ts
+const TRANSFORMS_NAMESPACE_HINT = "transforms can only be filed in a :transforms-namespace collection. Create one with `mb collection create --body '{\"name\":\"…\"}' --namespace transforms` and pass its id as collection_id, or omit collection_id to leave the transform uncollected.";
+function enrichTransformCollectionError(error) {
+	if (error instanceof HttpError && error.status === 400 && /:transforms namespace/i.test(error.message)) return new ConfigError(`${error.message} — ${TRANSFORMS_NAMESPACE_HINT}`);
+	return error;
+}
+
+//#endregion
+export { enrichTransformCollectionError };

package/dist/{create-BzK59YlR.mjs → create-B4f4Pldw.mjs}

@@ -1,16 +1,15 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CTVL5CdB.mjs";
-import { defineMetabaseCommand } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { renderSummary } from "./render-0_GsapXa.mjs";
-import "./input-cMSEqISy.mjs";
-import "./field-E0IBy4Uw.mjs";
-import "./card-ezYiriML.mjs";
-import { readBody } from "./body-DDYKoyMt.mjs";
-import { bodyInputFlags } from "./body-flags-D7q87Btw.mjs";
-import "./validate-dPEOnOf8.mjs";
-import { Dashboard, DashboardCreateInput, DashboardDetail, dashboardView } from "./dashboard-B4bn3z6t.mjs";
-import { preflightDashcardCardReferences, wrapChainedDashboardWriteError } from "./preflight-Df_FqJ6o.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BWXBhqLW.mjs";
+import { defineMetabaseCommand } from "./runtime-colqvhLf.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import "./input-xewHccej.mjs";
+import "./field-MGxpNQUH.mjs";
+import "./card-DnIeMmUn.mjs";
+import { readBody } from "./body-BdRyuvU4.mjs";
+import { bodyInputFlags } from "./body-flags-D78h_-Ua.mjs";
+import "./validate-B62TRDGV.mjs";
+import { Dashboard, DashboardCreateInput, DashboardDetail, dashboardView } from "./dashboard-FY5UzJ_Z.mjs";
+import { preflightDashcardCardReferences, wrapChainedDashboardWriteError } from "./preflight-CzqVX0PP.mjs";
 
 //#region src/commands/dashboard/create.ts
 var create_default = defineMetabaseCommand({

package/dist/{create-4EAGYVyp.mjs → create-BbF9zVFP.mjs}

@@ -1,14 +1,14 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CTVL5CdB.mjs";
-import { defineMetabaseCommand } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { renderSummary } from "./render-0_GsapXa.mjs";
-import "./input-cMSEqISy.mjs";
-import { readBody } from "./body-DDYKoyMt.mjs";
-import { bodyInputFlags } from "./body-flags-D7q87Btw.mjs";
-import "./validate-dPEOnOf8.mjs";
-import { TRANSFORM_SOURCE_QUERY_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-CYvOP8Ld.mjs";
-import { Transform, TransformCreateInput, transformView } from "./transform-BKahefz_.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BWXBhqLW.mjs";
+import { defineMetabaseCommand } from "./runtime-colqvhLf.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import "./input-xewHccej.mjs";
+import { readBody } from "./body-BdRyuvU4.mjs";
+import { bodyInputFlags } from "./body-flags-D78h_-Ua.mjs";
+import "./validate-B62TRDGV.mjs";
+import { TRANSFORM_SOURCE_QUERY_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-BpiN1CFu.mjs";
+import { Transform, TransformCreateInput, transformView } from "./transform--dviwMA1.mjs";
+import { enrichTransformCollectionError } from "./collection-namespace-7724zUMx.mjs";
 
 //#region src/commands/transform/create.ts
 var create_default = defineMetabaseCommand({
@@ -41,6 +41,8 @@ var create_default = defineMetabaseCommand({
 		const created = await client.requestParsed(Transform, "/api/transform", {
 			method: "POST",
 			body
+		}).catch((error) => {
+			throw enrichTransformCollectionError(error);
 		});
 		renderSummary(created, transformView, `Created transform ${created.id} "${created.name}".`, ctx);
 	}

package/dist/{create-Dd_Gyg_F.mjs → create-BnFHcnlL.mjs}

@@ -1,12 +1,11 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CTVL5CdB.mjs";
-import { defineMetabaseCommand } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { renderSummary } from "./render-0_GsapXa.mjs";
-import "./input-cMSEqISy.mjs";
-import { readBody } from "./body-DDYKoyMt.mjs";
-import { bodyInputFlags } from "./body-flags-D7q87Btw.mjs";
-import { TransformJob, TransformJobCreateInput, transformJobView } from "./transform-job-DjhoJbiV.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BWXBhqLW.mjs";
+import { defineMetabaseCommand } from "./runtime-colqvhLf.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import "./input-xewHccej.mjs";
+import { readBody } from "./body-BdRyuvU4.mjs";
+import { bodyInputFlags } from "./body-flags-D78h_-Ua.mjs";
+import { TransformJob, TransformJobCreateInput, transformJobView } from "./transform-job-n8W6tLqF.mjs";
 
 //#region src/commands/transform-job/create.ts
 var create_default = defineMetabaseCommand({

package/dist/{create-GVfCQU3B.mjs → create-BuKx7kw6.mjs}

@@ -1,12 +1,11 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CTVL5CdB.mjs";
-import { defineMetabaseCommand } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { renderSummary } from "./render-0_GsapXa.mjs";
-import "./input-cMSEqISy.mjs";
-import { readBody } from "./body-DDYKoyMt.mjs";
-import { bodyInputFlags } from "./body-flags-D7q87Btw.mjs";
-import { Snippet, SnippetCreateInput, snippetView } from "./snippet-bi_0XbNT.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BWXBhqLW.mjs";
+import { defineMetabaseCommand } from "./runtime-colqvhLf.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import "./input-xewHccej.mjs";
+import { readBody } from "./body-BdRyuvU4.mjs";
+import { bodyInputFlags } from "./body-flags-D78h_-Ua.mjs";
+import { Snippet, SnippetCreateInput, snippetView } from "./snippet-BZvo05ua.mjs";
 
 //#region src/commands/snippet/create.ts
 var create_default = defineMetabaseCommand({

package/dist/{create-CQ4Vg4Ge.mjs → create-BxRsXQrm.mjs}

@@ -1,14 +1,13 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CTVL5CdB.mjs";
-import { defineMetabaseCommand } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { renderSummary } from "./render-0_GsapXa.mjs";
-import "./input-cMSEqISy.mjs";
-import { readBody } from "./body-DDYKoyMt.mjs";
-import { bodyInputFlags } from "./body-flags-D7q87Btw.mjs";
-import "./validate-dPEOnOf8.mjs";
-import { SEGMENT_DEFINITION_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-CYvOP8Ld.mjs";
-import { Segment, SegmentCreateInput, segmentView } from "./segment-DhBmcr_E.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BWXBhqLW.mjs";
+import { defineMetabaseCommand } from "./runtime-colqvhLf.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import "./input-xewHccej.mjs";
+import { readBody } from "./body-BdRyuvU4.mjs";
+import { bodyInputFlags } from "./body-flags-D78h_-Ua.mjs";
+import "./validate-B62TRDGV.mjs";
+import { SEGMENT_DEFINITION_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-BpiN1CFu.mjs";
+import { Segment, SegmentCreateInput, segmentView } from "./segment-d-708KKO.mjs";
 
 //#region src/commands/segment/create.ts
 var create_default = defineMetabaseCommand({

package/dist/{create-7JOWFxqu.mjs → create-CvYKJOcE.mjs}

@@ -1,15 +1,14 @@
 import "./command-augment-BH9qgQ5u.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-CTVL5CdB.mjs";
-import { defineMetabaseCommand } from "./runtime-B40L_bj8.mjs";
-import "./capabilities-7e9MgquN.mjs";
-import { renderSummary } from "./render-0_GsapXa.mjs";
-import "./input-cMSEqISy.mjs";
-import "./field-E0IBy4Uw.mjs";
-import { Card, CardCreateInput, cardView } from "./card-ezYiriML.mjs";
-import { readBody } from "./body-DDYKoyMt.mjs";
-import { bodyInputFlags } from "./body-flags-D7q87Btw.mjs";
-import "./validate-dPEOnOf8.mjs";
-import { CARD_DATASET_QUERY_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-CYvOP8Ld.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BWXBhqLW.mjs";
+import { defineMetabaseCommand } from "./runtime-colqvhLf.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import "./input-xewHccej.mjs";
+import "./field-MGxpNQUH.mjs";
+import { Card, CardCreateInput, cardView } from "./card-DnIeMmUn.mjs";
+import { readBody } from "./body-BdRyuvU4.mjs";
+import { bodyInputFlags } from "./body-flags-D78h_-Ua.mjs";
+import "./validate-B62TRDGV.mjs";
+import { CARD_DATASET_QUERY_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-BpiN1CFu.mjs";
 
 //#region src/commands/card/create.ts
 var create_default = defineMetabaseCommand({

package/dist/create-D45uFXlo.mjs

@@ -0,0 +1,44 @@
+import "./command-augment-BH9qgQ5u.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BWXBhqLW.mjs";
+import { defineMetabaseCommand } from "./runtime-colqvhLf.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import "./input-xewHccej.mjs";
+import { readBody } from "./body-BdRyuvU4.mjs";
+import { bodyInputFlags } from "./body-flags-D78h_-Ua.mjs";
+import { Document, DocumentCreateInput, documentView } from "./document-CcfiiV3b.mjs";
+
+//#region src/commands/document/create.ts
+var create_default = defineMetabaseCommand({
+	meta: {
+		name: "create",
+		description: "Create a document"
+	},
+	capabilities: { minVersion: 58 },
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		...bodyInputFlags
+	},
+	outputSchema: Document,
+	examples: [
+		"cat doc.json | mb document create",
+		"mb document create --file doc.json",
+		"mb document create --body '{\"name\":\"Notes\",\"document\":{\"type\":\"doc\",\"content\":[]}}'"
+	],
+	async run({ args, ctx, getClient }) {
+		const body = await readBody({
+			flag: args.body,
+			file: args.file
+		}, DocumentCreateInput);
+		const client = await getClient();
+		const created = await client.requestParsed(Document, "/api/document", {
+			method: "POST",
+			body
+		});
+		renderSummary(created, documentView, `Created document ${created.id} "${created.name}".`, ctx);
+	}
+});
+
+//#endregion
+export { create_default as default };

package/dist/create-DS52EhPd.mjs

@@ -0,0 +1,52 @@
+import "./command-augment-BH9qgQ5u.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-BWXBhqLW.mjs";
+import { defineMetabaseCommand } from "./runtime-colqvhLf.mjs";
+import { renderSummary } from "./capabilities-7L9GVMd_.mjs";
+import "./input-xewHccej.mjs";
+import { readBody } from "./body-BdRyuvU4.mjs";
+import { bodyInputFlags } from "./body-flags-D78h_-Ua.mjs";
+import { parseEnumFlag } from "./parse-enum-Dr7ACrTR.mjs";
+import { Collection, CollectionCreateInput, CollectionNamespace, collectionView } from "./collection-BPTlcFw5.mjs";
+
+//#region src/commands/collection/create.ts
+var create_default = defineMetabaseCommand({
+	meta: {
+		name: "create",
+		description: "Create a collection from a JSON spec"
+	},
+	details: "Body keys: `name` (required), `description`, `parent_id`, `authority_level`, `namespace`. Most collections use the default namespace (omit it). Pass `namespace: \"transforms\"` (or `--namespace transforms`) to create the kind of collection a transform's `collection_id` can point at — a regular collection is rejected there.",
+	capabilities: { minVersion: 58 },
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		...bodyInputFlags,
+		namespace: {
+			type: "string",
+			description: `Collection namespace: ${CollectionNamespace.options.join("|")} (omit for a normal collection)`
+		}
+	},
+	outputSchema: Collection,
+	examples: [
+		"cat collection.json | mb collection create",
+		"mb collection create --file collection.json",
+		"mb collection create --body '{\"name\":\"My Collection\",\"parent_id\":4}'",
+		"mb collection create --body '{\"name\":\"ETL\"}' --namespace transforms"
+	],
+	async run({ args, ctx, getClient }) {
+		const body = await readBody({
+			flag: args.body,
+			file: args.file
+		}, CollectionCreateInput);
+		if (typeof args.namespace === "string" && args.namespace !== "") body.namespace = parseEnumFlag(args.namespace, CollectionNamespace, "namespace");
+		const client = await getClient();
+		const created = await client.requestParsed(Collection, "/api/collection", {
+			method: "POST",
+			body
+		});
+		renderSummary(created, collectionView, `Created collection ${created.id} "${created.name}".`, ctx);
+	}
+});
+
+//#endregion
+export { create_default as default };