@metabase/cli 0.1.0 → 0.1.1

package/dist/validate-query-B07oGG4K.mjs

@@ -0,0 +1,37 @@
+import { writeJson } from "./render-DXv-D6fU.mjs";
+import { ConfigError } from "./predicates-DiIiS3k7.mjs";
+import { assertNotLegacyEnvelopeWrappingMbql5, isMbql5Query, validateQuery } from "./validate-DCYx6jdL.mjs";
+
+//#region src/commands/validate-query.ts
+const skipValidateFlag = { "skip-validate": {
+	type: "boolean",
+	description: "Skip the local MBQL 5 pre-flight validation; let the server be the authority. Use only when the bundled schema disagrees with what the server accepts."
+} };
+const CARD_DATASET_QUERY_LABELS = {
+	contextLabel: "card.dataset_query validation failed",
+	bodyNoun: "dataset_query"
+};
+const TRANSFORM_SOURCE_QUERY_LABELS = {
+	contextLabel: "transform.source.query validation failed",
+	bodyNoun: "source.query"
+};
+const MEASURE_DEFINITION_LABELS = {
+	contextLabel: "measure.definition validation failed",
+	bodyNoun: "definition"
+};
+const SEGMENT_DEFINITION_LABELS = {
+	contextLabel: "segment.definition validation failed",
+	bodyNoun: "definition"
+};
+function preflightMbql5Query(query, labels, options) {
+	if (options.skip) return;
+	assertNotLegacyEnvelopeWrappingMbql5(query, labels);
+	if (!isMbql5Query(query)) return;
+	const outcome = validateQuery(query);
+	if (outcome.ok) return;
+	writeJson(outcome);
+	throw new ConfigError(`${labels.contextLabel}: ${outcome.errors.length} error(s) — pass valid MBQL 5 or use the legacy format`);
+}
+
+//#endregion
+export { CARD_DATASET_QUERY_LABELS, MEASURE_DEFINITION_LABELS, SEGMENT_DEFINITION_LABELS, TRANSFORM_SOURCE_QUERY_LABELS, preflightMbql5Query, skipValidateFlag };

package/dist/values-Be6i0Fs9.mjs

@@ -0,0 +1,36 @@
+import "./package-DBsS7a5x.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { renderItem } from "./render-DXv-D6fU.mjs";
+import "./predicates-DiIiS3k7.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-D7jihh81.mjs";
+import { parseId } from "./parse-id-BUOZQqjp.mjs";
+import { FieldValues, fieldValuesView } from "./field-DciLbuv-.mjs";
+
+//#region src/commands/field/values.ts
+var values_default = defineMetabaseCommand({
+	meta: {
+		name: "values",
+		description: "Fetch the cached distinct values for a field (FieldValues list)"
+	},
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		id: {
+			type: "positional",
+			description: "Field id",
+			required: true
+		}
+	},
+	outputSchema: FieldValues,
+	examples: ["metabase field values 100", "metabase field values 100 --json"],
+	async run({ args, ctx, getClient }) {
+		const id = parseId(args.id);
+		const client = await getClient();
+		const values = await client.requestParsed(FieldValues, `/api/field/${id}/values`);
+		renderItem(values, fieldValuesView, ctx);
+	}
+});
+
+//#endregion
+export { values_default as default };

package/dist/{wait-Bugr9eXD.mjs → wait-BMqQD8k_.mjs}

@@ -1,16 +1,18 @@
-import "./package-BGfw4ZWJ.mjs";
+import "./package-DBsS7a5x.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag, renderItem } from "./runtime-C9CEZhcn.mjs";
-import { parseId } from "./parse-id-BhmmfyCP.mjs";
-import { SyncTaskOrIdle, pollSyncTask, syncTaskIdleView, syncTaskView, throwIfFailedTask } from "./poll-task-DbpsiQhl.mjs";
-import { DEFAULT_INTERVAL_MS, DEFAULT_TIMEOUT_MS } from "./poll-ILanYysl.mjs";
+import { renderItem } from "./render-DXv-D6fU.mjs";
+import "./predicates-DiIiS3k7.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-D7jihh81.mjs";
+import { parseId } from "./parse-id-BUOZQqjp.mjs";
+import { SyncTaskOrIdle, pollSyncTask, syncTaskIdleView, syncTaskView, throwIfFailedTask } from "./poll-task-2Ckiwp8U.mjs";
+import { DEFAULT_INTERVAL_MS, DEFAULT_TIMEOUT_MS } from "./poll-DMmmZWvi.mjs";
 
-//#region src/commands/sync/wait.ts
+//#region src/commands/git-sync/wait.ts
 const WaitResult = SyncTaskOrIdle;
 var wait_default = defineMetabaseCommand({
 	meta: {
 		name: "wait",
-		description: "Poll the current sync task until it reaches a terminal status"
+		description: "Poll the current git-sync task until it reaches a terminal status"
 	},
 	args: {
 		...outputFlags,
@@ -28,7 +30,7 @@ var wait_default = defineMetabaseCommand({
 		}
 	},
 	outputSchema: WaitResult,
-	examples: ["metabase sync wait", "metabase sync wait --timeout 300000 --json"],
+	examples: ["metabase git-sync wait", "metabase git-sync wait --timeout 300000 --json"],
 	async run({ args, ctx, getClient }) {
 		const timeoutMs = parseId(args.timeout, "timeout");
 		const intervalMs = parseId(args.interval, "interval");

package/dist/wait-CWizX_sR.mjs

@@ -0,0 +1,19 @@
+import { pollUntil } from "./poll-DMmmZWvi.mjs";
+import { Workspace } from "./workspace-DVuqKJGG.mjs";
+
+//#region src/commands/workspace/database/wait.ts
+async function waitForDatabaseProvisioned(client, workspaceId, databaseId, schedule) {
+	return pollUntil(() => client.requestParsed(Workspace, `/api/ee/workspace-manager/${workspaceId}`), (workspace) => {
+		const entry = workspace.databases?.find((row) => row.database_id === databaseId);
+		return entry !== void 0 && entry.status === "provisioned";
+	}, schedule);
+}
+async function waitForDatabaseGone(client, workspaceId, databaseId, schedule) {
+	await pollUntil(() => client.requestParsed(Workspace, `/api/ee/workspace-manager/${workspaceId}`), (workspace) => {
+		const entry = workspace.databases?.find((row) => row.database_id === databaseId);
+		return entry === void 0;
+	}, schedule);
+}
+
+//#endregion
+export { waitForDatabaseGone, waitForDatabaseProvisioned };

package/dist/wait-flags-DO3ar2tf.mjs

@@ -0,0 +1,35 @@
+import { parseId } from "./parse-id-BUOZQqjp.mjs";
+import { DEFAULT_INTERVAL_MS, DEFAULT_TIMEOUT_MS } from "./poll-DMmmZWvi.mjs";
+
+//#region src/commands/wait-flags.ts
+const waitFlags = {
+	wait: {
+		type: "boolean",
+		description: "Poll until the operation reaches a terminal state",
+		default: false
+	},
+	timeout: {
+		type: "string",
+		description: "Polling timeout in ms (used with --wait)",
+		default: String(DEFAULT_TIMEOUT_MS)
+	},
+	interval: {
+		type: "string",
+		description: "Polling interval in ms (used with --wait)",
+		default: String(DEFAULT_INTERVAL_MS)
+	}
+};
+function parseWaitFlags(args) {
+	const interval = args.interval ?? String(DEFAULT_INTERVAL_MS);
+	const timeout = args.timeout ?? String(DEFAULT_TIMEOUT_MS);
+	return {
+		enabled: args.wait === true,
+		schedule: {
+			intervalMs: parseId(interval, "interval"),
+			timeoutMs: parseId(timeout, "timeout")
+		}
+	};
+}
+
+//#endregion
+export { parseWaitFlags, waitFlags };

package/dist/workspace-CG1xyJ86.mjs

@@ -0,0 +1,24 @@
+import { defineCommand } from "citty";
+
+//#region src/commands/workspace/index.ts
+var workspace_default = defineCommand({
+	meta: {
+		name: "workspace",
+		description: "Manage Metabase workspaces (workspace-manager)"
+	},
+	subCommands: {
+		list: () => import("./list-CpyNn1Zn.mjs").then((mod) => mod.default),
+		create: () => import("./create-C4OCclBD.mjs").then((mod) => mod.default),
+		database: () => import("./database-BMTb0CzV.mjs").then((mod) => mod.default),
+		start: () => import("./start-BokXnb0V.mjs").then((mod) => mod.default),
+		stop: () => import("./stop-BRuF_Cg1.mjs").then((mod) => mod.default),
+		remove: () => import("./remove-BAUbcwuF.mjs").then((mod) => mod.default),
+		logs: () => import("./logs-CQxKJ3HG.mjs").then((mod) => mod.default),
+		url: () => import("./url-x4wn_l3k.mjs").then((mod) => mod.default),
+		credentials: () => import("./credentials-CwRKvdP2.mjs").then((mod) => mod.default),
+		ps: () => import("./ps-BUNHygf-.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { workspace_default as default };

package/dist/workspace-DVuqKJGG.mjs

@@ -0,0 +1,72 @@
+import { z } from "zod";
+
+//#region src/domain/workspace.ts
+const WorkspaceDatabaseStatus = z.enum([
+	"unprovisioned",
+	"provisioning",
+	"provisioned",
+	"deprovisioning"
+]);
+const WorkspaceDatabase = z.object({
+	database_id: z.number().int(),
+	output_namespace: z.string(),
+	input_schemas: z.array(z.string().min(1)),
+	status: WorkspaceDatabaseStatus
+}).loose();
+const WorkspaceCreator = z.object({
+	id: z.number().int(),
+	first_name: z.string().nullable(),
+	last_name: z.string().nullable(),
+	email: z.string(),
+	common_name: z.string().nullable().optional()
+}).loose();
+const Workspace = z.object({
+	id: z.number().int(),
+	name: z.string(),
+	creator: WorkspaceCreator.nullable(),
+	created_at: z.string(),
+	updated_at: z.string(),
+	databases: z.array(WorkspaceDatabase).optional()
+}).loose();
+const WorkspaceCompact = Workspace.pick({
+	id: true,
+	name: true,
+	databases: true
+}).strip();
+const WorkspaceDatabaseList = z.array(WorkspaceDatabase);
+const workspaceView = {
+	compactPick: WorkspaceCompact,
+	tableColumns: [
+		{
+			key: "id",
+			label: "ID"
+		},
+		{
+			key: "name",
+			label: "Name"
+		},
+		{
+			key: "databases",
+			label: "Databases",
+			format: (value) => formatDatabases(value)
+		}
+	]
+};
+const WorkspaceCreateInput = z.object({ name: z.string().min(1) }).loose();
+const WorkspaceProvisionInput = z.object({
+	database_id: z.number().int().positive(),
+	input_schemas: z.array(z.string().min(1)).min(1)
+}).loose();
+const WorkspaceUpdateDatabaseInput = z.object({ input_schemas: z.array(z.string().min(1)).min(1) }).loose();
+function formatDatabases(value) {
+	if (value === void 0) return "";
+	const parsed = WorkspaceDatabaseList.safeParse(value);
+	if (!parsed.success || parsed.data.length === 0) return "(none)";
+	return parsed.data.map((entry) => {
+		const schemas = entry.input_schemas.length === 0 ? "" : ` [${entry.input_schemas.join(", ")}]`;
+		return `${entry.database_id} (${entry.status})${schemas}`;
+	}).join("; ");
+}
+
+//#endregion
+export { Workspace, WorkspaceCompact, WorkspaceCreateInput, WorkspaceProvisionInput, WorkspaceUpdateDatabaseInput, workspaceView };

package/dist/workspace-credentials-B6BL-X0d.mjs

@@ -0,0 +1,139 @@
+import { ConfigError, ValidationError, errorMessage } from "./predicates-DiIiS3k7.mjs";
+import { z } from "zod";
+import { randomBytes } from "node:crypto";
+import { YAMLParseError, parse, stringify } from "yaml";
+
+//#region src/runtime/yaml.ts
+function parseYaml(input, schema, opts = {}) {
+	const result = parseYamlResult(input, schema, opts);
+	if (!result.ok) throw result.error;
+	return result.value;
+}
+function parseYamlResult(input, schema, opts = {}) {
+	const sourcePrefix = opts.source ? `${opts.source}: ` : "";
+	let raw;
+	try {
+		raw = parse(input);
+	} catch (error) {
+		if (error instanceof YAMLParseError) return {
+			ok: false,
+			error: new ConfigError(`${sourcePrefix}invalid YAML: ${error.message}`)
+		};
+		return {
+			ok: false,
+			error: new ConfigError(`${sourcePrefix}invalid YAML: ${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 stringifyYaml(value) {
+	return stringify(value, { lineWidth: 0 });
+}
+
+//#endregion
+//#region src/core/workspace-credentials.ts
+const API_KEY_NAME = "Workspace API Key";
+const API_KEY_GROUP = "admin";
+const PASSWORD_BYTE_LENGTH = 18;
+const API_KEY_BYTE_LENGTH = 32;
+const WorkspaceCredentials = z.object({
+	workspace_id: z.number().int().positive(),
+	user: z.object({
+		first_name: z.string().min(1),
+		last_name: z.string().min(1),
+		password: z.string().min(1),
+		email: z.string().min(1)
+	}),
+	api_key: z.object({
+		name: z.string().min(1),
+		group: z.enum(["admin", "all-users"]),
+		creator: z.string().min(1),
+		key: z.string().regex(/^mb_[A-Za-z0-9+/=]+$/)
+	})
+});
+function generateWorkspaceCredentials(workspaceId) {
+	const email = `workspace-${workspaceId}@workspace.local`;
+	return {
+		workspace_id: workspaceId,
+		user: {
+			first_name: "Workspace",
+			last_name: "Admin",
+			password: randomBase64Url(PASSWORD_BYTE_LENGTH),
+			email
+		},
+		api_key: {
+			name: API_KEY_NAME,
+			group: API_KEY_GROUP,
+			creator: email,
+			key: `mb_${randomBytes(API_KEY_BYTE_LENGTH).toString("base64")}`
+		}
+	};
+}
+const credentialsJsonEncoder = new TextEncoder();
+function buildCredentialsJson(credentials) {
+	return credentialsJsonEncoder.encode(`${JSON.stringify(credentials, null, 2)}\n`);
+}
+const ConfigEnvelopeShape = z.object({
+	version: z.number().int(),
+	config: z.looseObject({})
+}).loose();
+function injectCredentialsIntoConfig(yamlInput, credentials) {
+	const envelope = parseYaml(yamlInput, ConfigEnvelopeShape, { source: "config.yml" });
+	if ("users" in envelope.config || "api-keys" in envelope.config) throw new ConfigError("config.yml already declares users or api-keys — refusing to overwrite parent-supplied credentials");
+	const merged = {
+		...envelope,
+		config: {
+			...envelope.config,
+			users: [credentials.user],
+			"api-keys": [credentials.api_key]
+		}
+	};
+	return stringifyYaml(merged);
+}
+const REPO_SYNC_MODES = ["read-write", "read-only"];
+const RepoSyncMode = z.enum(REPO_SYNC_MODES);
+const ConfigEnvelopeWithSettingsShape = z.object({
+	version: z.number().int(),
+	config: z.object({ settings: z.looseObject({}).optional() }).loose()
+}).loose();
+const REMOTE_SYNC_KEYS = [
+	"remote-sync-url",
+	"remote-sync-branch",
+	"remote-sync-type"
+];
+function injectRepoSettingsIntoConfig(yamlInput, repo) {
+	const envelope = parseYaml(yamlInput, ConfigEnvelopeWithSettingsShape, { source: "config.yml" });
+	const existingSettings = envelope.config.settings ?? {};
+	const conflicts = REMOTE_SYNC_KEYS.filter((key) => key in existingSettings);
+	if (conflicts.length > 0) throw new ConfigError(`config.yml already declares remote-sync settings (${conflicts.join(", ")}) — refusing to overwrite parent-supplied values`);
+	const merged = {
+		...envelope,
+		config: {
+			...envelope.config,
+			settings: {
+				...existingSettings,
+				"remote-sync-url": repo.url,
+				"remote-sync-branch": repo.branch,
+				"remote-sync-type": repo.mode
+			}
+		}
+	};
+	return stringifyYaml(merged);
+}
+function randomBase64Url(byteLength) {
+	return randomBytes(byteLength).toString("base64url");
+}
+
+//#endregion
+export { REPO_SYNC_MODES, RepoSyncMode, WorkspaceCredentials, buildCredentialsJson, generateWorkspaceCredentials, injectCredentialsIntoConfig, injectRepoSettingsIntoConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metabase/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Metabase CLI",
   "license": "AGPL-3.0",
   "repository": {
@@ -35,19 +35,25 @@
     "lint:fix": "oxlint --fix",
     "format": "oxfmt",
     "format:check": "oxfmt --check",
+    "sync:representations": "bun run scripts/sync-representations.ts",
     "prepublishOnly": "tsdown && publint"
   },
   "dependencies": {
     "@clack/prompts": "^0.8.2",
     "@napi-rs/keyring": "^1.3.0",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
     "citty": "^0.2.2",
     "cli-table3": "^0.6.5",
+    "yaml": "^2.8.4",
     "zod": "^4.0.0"
   },
   "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.10.0",
     "execa": "^9.5.2",
     "fast-check": "^4.7.0",
+    "js-yaml": "^4.1.0",
     "oxfmt": "^0.47.0",
     "oxlint": "^1.62.0",
     "publint": "^0.3.0",

package/dist/auth-BF7IjZIH.mjs

@@ -1,18 +0,0 @@
-import { defineCommand } from "citty";
-
-//#region src/commands/auth/index.ts
-var auth_default = defineCommand({
-	meta: {
-		name: "auth",
-		description: "Authenticate against a Metabase instance"
-	},
-	default: "login",
-	subCommands: {
-		login: () => import("./login-C9WTwNn6.mjs").then((m) => m.default),
-		status: () => import("./status-CUcs8XBH.mjs").then((m) => m.default),
-		logout: () => import("./logout-oLszGCOg.mjs").then((m) => m.default)
-	}
-});
-
-//#endregion
-export { auth_default as default };

package/dist/card-_Ta7zdYe.mjs

@@ -1,19 +0,0 @@
-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-C4Ajrw8f.mjs").then((mod) => mod.default),
-		get: () => import("./get-Cl8-IauC.mjs").then((mod) => mod.default),
-		query: () => import("./query-PihYi-UZ.mjs").then((mod) => mod.default),
-		create: () => import("./create-DdbU3TLX.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-CsWeHXle.mjs").then((mod) => mod.default)
-	}
-});
-
-//#endregion
-export { card_default as default };

package/dist/create-CI2Cunq5.mjs

@@ -1,38 +0,0 @@
-import "./package-BGfw4ZWJ.mjs";
-import "./command-augment-D9pI9Vbh.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag, renderItem } from "./runtime-C9CEZhcn.mjs";
-import "./input-Dojr-RTw.mjs";
-import { readBody } from "./body-Dv9hQ0Qk.mjs";
-import { bodyInputFlags } from "./body-flags-BUA9XV1u.mjs";
-import { Transform, TransformCreateInput, transformView } from "./transform-B5uRpg1G.mjs";
-
-//#region src/commands/transform/create.ts
-var create_default = defineMetabaseCommand({
-	meta: {
-		name: "create",
-		description: "Create a transform"
-	},
-	args: {
-		...outputFlags,
-		...profileFlag,
-		...connectionFlags,
-		...bodyInputFlags
-	},
-	outputSchema: Transform,
-	examples: ["cat transform.json | metabase transform create", "metabase transform create --file transform.json"],
-	async run({ args, ctx, getClient }) {
-		const body = await readBody({
-			flag: args.body,
-			file: args.file
-		}, TransformCreateInput);
-		const client = await getClient();
-		const created = await client.requestParsed(Transform, "/api/transform", {
-			method: "POST",
-			body
-		});
-		renderItem(created, transformView, ctx);
-	}
-});
-
-//#endregion
-export { create_default as default };

package/dist/create-DdbU3TLX.mjs

@@ -1,42 +0,0 @@
-import "./package-BGfw4ZWJ.mjs";
-import "./command-augment-D9pI9Vbh.mjs";
-import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag, renderItem } from "./runtime-C9CEZhcn.mjs";
-import "./input-Dojr-RTw.mjs";
-import { Card, CardCreateInput, cardView } from "./card-CsXk8T6A.mjs";
-import { readBody } from "./body-Dv9hQ0Qk.mjs";
-import { bodyInputFlags } from "./body-flags-BUA9XV1u.mjs";
-
-//#region src/commands/card/create.ts
-var create_default = defineMetabaseCommand({
-	meta: {
-		name: "create",
-		description: "Create a card from a JSON spec"
-	},
-	args: {
-		...outputFlags,
-		...profileFlag,
-		...connectionFlags,
-		...bodyInputFlags
-	},
-	outputSchema: Card,
-	examples: [
-		"cat card.json | metabase card create",
-		"metabase card create --file card.json",
-		"metabase card create --body '{\"name\":\"x\",\"display\":\"table\",\"dataset_query\":{...},\"visualization_settings\":{}}'"
-	],
-	async run({ args, ctx, getClient }) {
-		const body = await readBody({
-			flag: args.body,
-			file: args.file
-		}, CardCreateInput);
-		const client = await getClient();
-		const created = await client.requestParsed(Card, "/api/card", {
-			method: "POST",
-			body
-		});
-		renderItem(created, cardView, ctx);
-	}
-});
-
-//#endregion
-export { create_default as default };

package/dist/database-PA9Goi25.mjs

@@ -1,33 +0,0 @@
-import { z } from "zod";
-
-//#region src/domain/database.ts
-const Database = z.object({
-	id: z.number().int(),
-	name: z.string(),
-	engine: z.string()
-}).loose();
-const DatabaseCompact = Database.pick({
-	id: true,
-	name: true,
-	engine: true
-}).strip();
-const databaseView = {
-	compactPick: DatabaseCompact,
-	tableColumns: [
-		{
-			key: "id",
-			label: "ID"
-		},
-		{
-			key: "name",
-			label: "Name"
-		},
-		{
-			key: "engine",
-			label: "Engine"
-		}
-	]
-};
-
-//#endregion
-export { Database, DatabaseCompact, databaseView };

package/dist/db-DMghzgb6.mjs

@@ -1,17 +0,0 @@
-import { defineCommand } from "citty";
-
-//#region src/commands/db/index.ts
-var db_default = defineCommand({
-	meta: {
-		name: "db",
-		description: "Inspect Metabase databases",
-		alias: "database"
-	},
-	subCommands: {
-		list: () => import("./list-CBSBHtK-.mjs").then((m) => m.default),
-		get: () => import("./get-Dh_acl8q.mjs").then((m) => m.default)
-	}
-});
-
-//#endregion
-export { db_default as default };