@metabase/cli 0.5.1 → 0.5.3

package/dist/create-C3H9ljex.mjs

@@ -0,0 +1,34 @@
+import { c as renderSummary, ct as outputFlags, lt as profileFlag, rt as connectionFlags } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-Y4VFWmmr.mjs";
+import { t as readBody } from "./body-M5qsJoub.mjs";
+import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
+import { i as CreatedApiKey, r as ApiKeyCreateInput } from "./api-key-DbsqHlN6.mjs";
+import { n as createdApiKeyView } from "./api-key-9jVV67hF.mjs";
+//#region src/commands/api-key/create.ts
+var create_default = defineMetabaseCommand({
+	meta: {
+		name: "create",
+		description: "Create an API key acting as a member of a group"
+	},
+	details: "The JSON body needs `name` and `group_id` (2 is Administrators). The key is printed once, as `unmasked_key` under --json, and no later read returns it: store it where it is needed and never paste it into chat.",
+	requires: ["apiKey.create"],
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		...bodyInputFlags
+	},
+	inputSchema: ApiKeyCreateInput,
+	outputSchema: CreatedApiKey,
+	examples: ["mb api-key create --body '{\"name\":\"ci\",\"group_id\":2}' --json"],
+	async run({ args, ctx, getClient }) {
+		const body = await readBody({
+			flag: args.body,
+			file: args.file
+		}, ApiKeyCreateInput);
+		const created = await (await getClient()).apiKey.create(body);
+		renderSummary(created, createdApiKeyView, `Created API key ${created.id} "${created.name}": ${created.unmasked_key}`, ctx);
+	}
+});
+//#endregion
+export { create_default as default };

package/dist/{create-DxMmIHI4.mjs → create-CGE1D0Ay.mjs}

@@ -1,6 +1,6 @@
 import { c as renderSummary, ct as outputFlags, lt as profileFlag, rt as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Ckns6TKK.mjs";
-import { t as readBody } from "./body-BkkQkGJg.mjs";
+import { t as defineMetabaseCommand } from "./runtime-Y4VFWmmr.mjs";
+import { t as readBody } from "./body-M5qsJoub.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
 import { r as DocumentCreateInput, t as Document } from "./document-UMG6me2P.mjs";
 import { t as documentView } from "./document-DVIu3Vj4.mjs";

package/dist/{create-CbT4SPHV.mjs → create-CGxxztoE.mjs}

@@ -1,6 +1,6 @@
 import { c as renderSummary, ct as outputFlags, lt as profileFlag, rt as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Ckns6TKK.mjs";
-import { t as readBody } from "./body-BkkQkGJg.mjs";
+import { t as defineMetabaseCommand } from "./runtime-Y4VFWmmr.mjs";
+import { t as readBody } from "./body-M5qsJoub.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
 import { i as TransformJobCreateInput, t as TransformJob } from "./transform-job-ClX8e5iO.mjs";
 import { t as transformJobView } from "./transform-job-BBZ5L46v.mjs";

package/dist/{create-CYoarNrb.mjs → create-CfXKNnkK.mjs}

@@ -1,9 +1,9 @@
 import { c as renderSummary, ct as outputFlags, lt as profileFlag, rt as connectionFlags } from "./cli.mjs";
 import { a as NotificationCreateInput, n as Notification } from "./notification-DaA4bBHW.mjs";
 import { t as notificationView } from "./notification-W2SVssyY.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Ckns6TKK.mjs";
+import { t as defineMetabaseCommand } from "./runtime-Y4VFWmmr.mjs";
 import { t as describeAlert } from "./summary-BytbDz6e.mjs";
-import { t as readBody } from "./body-BkkQkGJg.mjs";
+import { t as readBody } from "./body-M5qsJoub.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
 //#region src/commands/alert/create.ts
 var create_default = defineMetabaseCommand({

package/dist/{create-Bl9sS7v7.mjs → create-CjGEkSFz.mjs}

@@ -1,10 +1,10 @@
 import { c as renderSummary, ct as outputFlags, lt as profileFlag, rt as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Ckns6TKK.mjs";
-import { t as readBody } from "./body-BkkQkGJg.mjs";
+import { t as defineMetabaseCommand } from "./runtime-Y4VFWmmr.mjs";
+import { t as readBody } from "./body-M5qsJoub.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
-import { r as CardCreateInput, t as Card } from "./card-P5mBknsl.mjs";
-import { n as cardView } from "./card-CQNUT9pm.mjs";
-import { o as preflightMbql5Query, s as skipValidateFlag, t as CARD_DATASET_QUERY_LABELS } from "./validate-query-CYUvRvVM.mjs";
+import { i as CardDetail, r as CardCreateInput } from "./card-QR3zEu6E.mjs";
+import { n as cardView } from "./card-3NmUiU5F.mjs";
+import { o as preflightMbql5Query, s as skipValidateFlag, t as CARD_DATASET_QUERY_LABELS } from "./validate-query-YtH3d5BP.mjs";
 //#region src/commands/card/create.ts
 var create_default = defineMetabaseCommand({
 	meta: {
@@ -35,7 +35,7 @@ var create_default = defineMetabaseCommand({
 		...skipValidateFlag
 	},
 	inputSchema: CardCreateInput,
-	outputSchema: Card,
+	outputSchema: CardDetail,
 	examples: [
 		"cat card.json | mb card create",
 		"mb card create --file card.json",

package/dist/{create-Cdt8u1wF.mjs → create-DO4ic4Kx.mjs}

@@ -1,10 +1,10 @@
 import { c as renderSummary, ct as outputFlags, lt as profileFlag, rt as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Ckns6TKK.mjs";
-import { t as readBody } from "./body-BkkQkGJg.mjs";
+import { t as defineMetabaseCommand } from "./runtime-Y4VFWmmr.mjs";
+import { t as readBody } from "./body-M5qsJoub.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
-import { f as CollectionNamespace, o as CollectionCreateInput, r as Collection } from "./collection-B2wRXyTF.mjs";
-import { t as parseEnumFlag } from "./parse-enum-B2rGiC6p.mjs";
-import { n as collectionView } from "./collection-CTnYZ2Jj.mjs";
+import { f as CollectionNamespace, o as CollectionCreateInput, r as Collection } from "./collection-DNmFKALA.mjs";
+import { t as parseEnumFlag } from "./parse-enum-DAcTzG1q.mjs";
+import { n as collectionView } from "./collection-D5vt2IJ_.mjs";
 //#region src/commands/collection/create.ts
 var create_default = defineMetabaseCommand({
 	meta: {

package/dist/{create-BP39g5Jk.mjs → create-DQJ9h86G.mjs}

@@ -1,6 +1,6 @@
 import { c as renderSummary, ct as outputFlags, lt as profileFlag, rt as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Ckns6TKK.mjs";
-import { t as readBody } from "./body-BkkQkGJg.mjs";
+import { t as defineMetabaseCommand } from "./runtime-Y4VFWmmr.mjs";
+import { t as readBody } from "./body-M5qsJoub.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
 import { i as TimelineEvent, o as TimelineEventCreateInput } from "./timeline-DcsCXNUt.mjs";
 import { t as timelineEventView } from "./timeline-BgWz8DYK.mjs";

package/dist/{create-DBNxy5rN.mjs → create-YBDXZgyP.mjs}

@@ -1,6 +1,6 @@
 import { c as renderSummary, ct as outputFlags, lt as profileFlag, rt as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Ckns6TKK.mjs";
-import { t as readBody } from "./body-BkkQkGJg.mjs";
+import { t as defineMetabaseCommand } from "./runtime-Y4VFWmmr.mjs";
+import { t as readBody } from "./body-M5qsJoub.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
 import { r as TimelineCreateInput, t as Timeline } from "./timeline-DcsCXNUt.mjs";
 import { n as timelineView } from "./timeline-BgWz8DYK.mjs";

package/dist/{create-D5_c5SHo.mjs → create-YIC3Q0a-.mjs}

@@ -1,8 +1,8 @@
 import { c as renderSummary, ct as outputFlags, lt as profileFlag, rt as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Ckns6TKK.mjs";
+import { t as defineMetabaseCommand } from "./runtime-Y4VFWmmr.mjs";
 import { r as GlossaryCreateInput, t as Glossary } from "./glossary-QN-hHfOT.mjs";
 import { t as glossaryView } from "./glossary-BkGmCI4X.mjs";
-import { n as readEntryInput, t as entryFlags } from "./entry-flags-DjICpQkc.mjs";
+import { n as readEntryInput, t as entryFlags } from "./entry-flags-Cxn09krz.mjs";
 //#region src/commands/glossary/create.ts
 var create_default = defineMetabaseCommand({
 	meta: {

package/dist/create-_rOCx5b8.mjs

@@ -0,0 +1,38 @@
+import { c as renderSummary, ct as outputFlags, lt as profileFlag, rt as connectionFlags } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-Y4VFWmmr.mjs";
+import { t as readBody } from "./body-M5qsJoub.mjs";
+import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
+import { r as DataAppCreateInput, t as DataApp } from "./data-app-BUW-HlUo.mjs";
+import { t as dataAppView } from "./data-app-Blz61mG5.mjs";
+//#region src/commands/data-app/create.ts
+var create_default = defineMetabaseCommand({
+	meta: {
+		name: "create",
+		description: "Create a data app and its collection from JSON"
+	},
+	details: "The JSON body needs `name`, the slug. Optional: `display_name` (the slug by default), `description`, `allowed_hosts`, `enabled` (false by default), `bundle_path` and `version`. The app starts with an empty bundle; `mb data-app set-bundle` replaces it. The answer's `resource_collection_id` is the app's collection, where its questions and actions go. `mb data-app scaffold` copies the project template.",
+	skills: [{
+		skill: "data-app",
+		purpose: "how an app is created, built and published"
+	}],
+	requires: ["dataApp.create"],
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		...bodyInputFlags
+	},
+	inputSchema: DataAppCreateInput,
+	outputSchema: DataApp,
+	examples: ["mb data-app create --body '{\"name\":\"sales-overview\",\"display_name\":\"Sales overview\"}'", "mb data-app create --file app.json --json"],
+	async run({ args, ctx, getClient }) {
+		const body = await readBody({
+			flag: args.body,
+			file: args.file
+		}, DataAppCreateInput);
+		const created = await (await getClient()).dataApp.create(body);
+		renderSummary(created, dataAppView, `Created data app ${created.name} with collection ${created.resource_collection_id}.`, ctx);
+	}
+});
+//#endregion
+export { create_default as default };

package/dist/{create-branch-CUNFdKyB.mjs → create-branch-DBCBMDWh.mjs}

@@ -1,7 +1,7 @@
-import { c as renderSummary, ct as outputFlags, lt as profileFlag, rt as connectionFlags, yt as ConfigError } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Ckns6TKK.mjs";
-import { t as SyncBranchCreated } from "./git-sync-COokpYgc.mjs";
-import { n as syncBranchCreatedView } from "./git-sync-Ch1V1fEK.mjs";
+import { St as ConfigError, c as renderSummary, ct as outputFlags, lt as profileFlag, rt as connectionFlags } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-Y4VFWmmr.mjs";
+import { n as SyncBranchCreated } from "./git-sync-DP4wQFzm.mjs";
+import { n as syncBranchCreatedView } from "./git-sync-D1aKczo6.mjs";
 //#region src/commands/git-sync/create-branch.ts
 var create_branch_default = defineMetabaseCommand({
 	meta: {

package/dist/{create-CqF7vqXC.mjs → create-f0bBEfDI.mjs}

@@ -1,9 +1,9 @@
 import { c as renderSummary, ct as outputFlags, lt as profileFlag, rt as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Ckns6TKK.mjs";
-import { t as readBody } from "./body-BkkQkGJg.mjs";
+import { t as defineMetabaseCommand } from "./runtime-Y4VFWmmr.mjs";
+import { t as readBody } from "./body-M5qsJoub.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
 import { r as DataActionCreateInput, t as DataAction } from "./data-action-DZxVB_hD.mjs";
-import { n as DATA_ACTION_DATASET_QUERY_LABELS, o as preflightMbql5Query, s as skipValidateFlag } from "./validate-query-CYUvRvVM.mjs";
+import { n as DATA_ACTION_DATASET_QUERY_LABELS, o as preflightMbql5Query, s as skipValidateFlag } from "./validate-query-YtH3d5BP.mjs";
 import { n as dataActionView } from "./data-action-R9qxJDPA.mjs";
 //#region src/commands/data-action/create.ts
 var create_default = defineMetabaseCommand({
@@ -11,7 +11,7 @@ var create_default = defineMetabaseCommand({
 		name: "create",
 		description: "Create a data action from JSON"
 	},
-	details: "A data action is a parameterized native query that writes to a database, filed in a collection. The JSON body needs `name`, `type: \"query\"`, `database_id`, a native `dataset_query` whose `{{tag}}` placeholders are its inputs, and `parameters` targeting those tags; `collection_id` picks the collection (omit for the root). Data actions must be enabled on the database. An MBQL 5 `dataset_query` is checked against a bundled JSON Schema before sending; pass --skip-validate to bypass.",
+	details: "A data action is a parameterized native query that writes to a database, filed in a collection. The JSON body needs `name`, `type: \"query\"`, `database_id`, a native `dataset_query` whose `{{tag}}` placeholders are its inputs, and `parameters` targeting those tags; `collection_id` picks a collection in the `data-actions` or `data-apps` namespace (omit for the data actions root; a regular collection is refused). Data actions must be enabled on the database (`mb db set-data-actions <id> true`). An MBQL 5 `dataset_query` is checked against a bundled JSON Schema before sending; pass --skip-validate to bypass.",
 	skills: [{
 		skill: "data-action",
 		purpose: "author a data action and its parameters"

package/dist/{create-B3fm5I-l2.mjs → create-myJ8HR4B.mjs}

@@ -1,9 +1,9 @@
 import { c as renderSummary, ct as outputFlags, lt as profileFlag, rt as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Ckns6TKK.mjs";
-import { t as readBody } from "./body-BkkQkGJg.mjs";
+import { t as defineMetabaseCommand } from "./runtime-Y4VFWmmr.mjs";
+import { t as readBody } from "./body-M5qsJoub.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
-import { i as PulseCreateInput, t as Pulse } from "./pulse-Dz0ocv0l.mjs";
-import { t as pulseView } from "./pulse-CFj1WfIC.mjs";
+import { i as PulseCreateInput, t as Pulse } from "./pulse-CC81N2_0.mjs";
+import { t as pulseView } from "./pulse-JPrq6NFP.mjs";
 //#region src/commands/subscription/create.ts
 var create_default = defineMetabaseCommand({
 	meta: {

package/dist/{create-CrtIqtXN.mjs → create-vgP9K2eH2.mjs}

@@ -1,11 +1,11 @@
 import { c as renderSummary, ct as outputFlags, lt as profileFlag, rt as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Ckns6TKK.mjs";
-import { t as readBody } from "./body-BkkQkGJg.mjs";
+import { t as defineMetabaseCommand } from "./runtime-Y4VFWmmr.mjs";
+import { t as readBody } from "./body-M5qsJoub.mjs";
 import { t as bodyInputFlags } from "./body-flags-AqKpN01Y.mjs";
 import { r as TransformCreateInput, t as Transform } from "./transform-DiW7bREn.mjs";
-import { a as TRANSFORM_SOURCE_QUERY_LABELS, o as preflightMbql5Query, s as skipValidateFlag } from "./validate-query-CYUvRvVM.mjs";
+import { a as TRANSFORM_SOURCE_QUERY_LABELS, o as preflightMbql5Query, s as skipValidateFlag } from "./validate-query-YtH3d5BP.mjs";
 import { n as transformView } from "./transform-CWGJB8N_.mjs";
-import { t as enrichTransformCollectionError } from "./collection-namespace-B1OkM7p1.mjs";
+import { t as enrichTransformCollectionError } from "./collection-namespace-Dl8_7xII.mjs";
 //#region src/commands/transform/create.ts
 var create_default = defineMetabaseCommand({
 	meta: {

package/dist/{csv-CcnhKpuj.mjs → csv-Dtgy7sTg.mjs}

@@ -1,8 +1,8 @@
 import { c as renderSummary, ct as outputFlags, lt as profileFlag, rt as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Ckns6TKK.mjs";
-import { t as parseId } from "./parse-id-Cv5eM7sg.mjs";
+import { t as parseId } from "./parse-id-5BZGQ9Vd.mjs";
+import { t as defineMetabaseCommand } from "./runtime-Y4VFWmmr.mjs";
 import { t as UploadResult } from "./upload-DAtxBBms.mjs";
-import { n as requireUploadFilePath, t as readCsvFile } from "./upload-B6zBzMPW.mjs";
+import { n as requireUploadFilePath, t as readCsvFile } from "./upload-BF5pdKRN.mjs";
 import { t as uploadResultView } from "./upload-C3z5ZaXA.mjs";
 //#region src/commands/upload/csv.ts
 const ROOT_COLLECTION = "root";

package/dist/{current-task-nl2z8sHI.mjs → current-task-AwQisIT9.mjs}

@@ -1,7 +1,7 @@
 import { c as renderSummary, ct as outputFlags, lt as profileFlag, rt as connectionFlags } from "./cli.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Ckns6TKK.mjs";
-import { u as syncTaskView } from "./git-sync-Ch1V1fEK.mjs";
-import { n as formatSyncTask, r as syncTaskIdleView, t as SyncTaskOrIdle } from "./sync-task-DEzhiaU9.mjs";
+import { t as defineMetabaseCommand } from "./runtime-Y4VFWmmr.mjs";
+import { u as syncTaskView } from "./git-sync-D1aKczo6.mjs";
+import { n as formatSyncTask, r as syncTaskIdleView, t as SyncTaskOrIdle } from "./sync-task-DNKG9Bk4.mjs";
 //#region src/commands/git-sync/current-task.ts
 const CurrentTaskResult = SyncTaskOrIdle;
 var current_task_default = defineMetabaseCommand({

package/dist/{dashboard-BP0p62fp.mjs → dashboard-BZV-0Qjp.mjs}

@@ -18,17 +18,17 @@ var dashboard_default = defineCommandGroup({
 		}
 	],
 	subCommands: {
-		list: () => import("./list-6nGX0Rqc.mjs").then((mod) => mod.default),
-		get: () => import("./get-C_rjxpoe.mjs").then((mod) => mod.default),
-		cards: () => import("./cards-CSL8ukS1.mjs").then((mod) => mod.default),
-		"parameter-values": () => import("./parameter-values-IWi_DNhp.mjs").then((mod) => mod.default),
-		subscriptions: () => import("./subscriptions-CJ8Jdp9A.mjs").then((mod) => mod.default),
-		create: () => import("./create-Bnb1abv_.mjs").then((mod) => mod.default),
-		update: () => import("./update-C7Wmom6x.mjs").then((mod) => mod.default),
-		"update-dashcard": () => import("./update-dashcard-BmkfJ7t9.mjs").then((mod) => mod.default),
-		copy: () => import("./copy-BYukQEtf.mjs").then((mod) => mod.default),
-		verify: () => import("./verify-BdW-GExk.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-EhW6blNc.mjs").then((mod) => mod.default)
+		list: () => import("./list-CA939qkn.mjs").then((mod) => mod.default),
+		get: () => import("./get--1qTpTIQ.mjs").then((mod) => mod.default),
+		cards: () => import("./cards-DWJOtZoN.mjs").then((mod) => mod.default),
+		"parameter-values": () => import("./parameter-values-3eHpqznI.mjs").then((mod) => mod.default),
+		subscriptions: () => import("./subscriptions-DcCOA2p1.mjs").then((mod) => mod.default),
+		create: () => import("./create-Bh3q3eHg.mjs").then((mod) => mod.default),
+		update: () => import("./update-B1UXRPN-.mjs").then((mod) => mod.default),
+		"update-dashcard": () => import("./update-dashcard-m-hkIGUu.mjs").then((mod) => mod.default),
+		copy: () => import("./copy-BzBp5FaY.mjs").then((mod) => mod.default),
+		verify: () => import("./verify-cjUPMF_B.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-DZDkfhdH.mjs").then((mod) => mod.default)
 	}
 });
 //#endregion

package/dist/{dashboard-Phz3XpRM.mjs → dashboard-Chjy5GKR.mjs}

@@ -1,5 +1,5 @@
-import { t as EmbeddingParams } from "./embedding-i-KqpefC.mjs";
-import { n as ParameterMapping, t as Parameter } from "./parameter-Celg0wZa.mjs";
+import { t as Card, u as EmbeddingParams } from "./card-QR3zEu6E.mjs";
+import { n as ParameterMapping, t as Parameter } from "./parameter-DvRQMKd2.mjs";
 import { z } from "zod";
 //#region ../client/src/domain/dashboard.ts
 const DashboardWidth = z.enum(["fixed", "full"]);
@@ -30,8 +30,44 @@ const DashcardCompact = Dashcard.pick({
 	row: true,
 	col: true,
 	size_x: true,
-	size_y: true
+	size_y: true,
+	parameter_mappings: true
 }).strip();
+/**
+* What a dashcard that is not a chart of a card shows. `display` names it: `text`, `heading`,
+* `link`, `iframe`, `placeholder`, or `action` for an action button. The server stores the
+* settings without checking them, so `display` is an open string another client may leave out.
+*/
+const DashcardVirtualCard = z.object({ display: z.string().optional() }).loose();
+/**
+* A dashcard's visualization settings. Every key is free-form except the two that say what a
+* dashcard is when it is not a chart: `virtual_card`, and `text`, the Markdown a text or heading
+* dashcard shows.
+*/
+const DashcardVisualizationSettings = z.object({
+	virtual_card: DashcardVirtualCard.nullable().optional(),
+	text: z.string().nullable().optional()
+}).loose();
+/**
+* A card the caller cannot read. The server cuts it down to its `id` before answering, so a
+* dashboard the caller can read still lists it; a readable card always carries its `name`, which is
+* what tells the two apart.
+*/
+const UnreadableCard = z.object({
+	id: z.number().int(),
+	name: z.never().optional()
+}).loose();
+/**
+* A dashcard as a dashboard read or write returns it, with its card whole in `card`. An action
+* button bound to a model carries the model there and the action in `action_id`. A dashcard bound to
+* no card (a text, heading, link, iframe or placeholder dashcard, or an action button bound to no
+* model, which `visualization_settings.virtual_card` names) has `card_id` and `card` both `null`.
+*/
+const DashcardDetail = Dashcard.extend({
+	action_id: z.number().int().nullable(),
+	visualization_settings: DashcardVisualizationSettings,
+	card: z.union([Card, UnreadableCard]).nullable()
+});
 const DashboardTab = z.object({
 	id: z.number().int(),
 	dashboard_id: z.number().int(),
@@ -58,13 +94,14 @@ const Dashboard = z.object({
 	enable_embedding: z.boolean(),
 	public_uuid: z.string().nullable(),
 	cache_ttl: z.number().int().nullable(),
+	collection_position: z.number().int().nullable(),
 	parameters: z.array(Parameter).nullable(),
 	dashcards: z.array(Dashcard).optional(),
 	tabs: z.array(DashboardTab).optional()
 }).loose();
 const DashboardDetail = Dashboard.extend({
 	parameters: z.array(Parameter),
-	dashcards: z.array(Dashcard),
+	dashcards: z.array(DashcardDetail),
 	tabs: z.array(DashboardTab)
 });
 const DashboardCompact = Dashboard.pick({
@@ -142,5 +179,15 @@ z.object({
 const DashboardUncopiedCard = z.object({ id: z.number().int() }).loose();
 const DashboardCopy = Dashboard.extend({ uncopied: z.array(DashboardUncopiedCard).optional() });
 const DashboardCopyCompact = DashboardCompact.extend({ uncopied: z.array(DashboardUncopiedCard.pick({ id: true }).strip()).optional() });
+const ParameterConstraintValue = z.union([
+	z.string(),
+	z.number(),
+	z.boolean()
+]);
+/**
+* Values of other parameters on a dashboard, by parameter id, that narrow the values a linked
+* parameter offers. An array sets several values for one parameter.
+*/
+const DashboardParameterConstraints = z.record(z.string().min(1), z.union([ParameterConstraintValue, z.array(ParameterConstraintValue)]));
 //#endregion
-export { DashboardCreateInput as a, DashboardUpdateInput as c, DashcardPatchInput as d, DashboardCopyCompact as i, Dashcard as l, DashboardCompact as n, DashboardDetail as o, DashboardCopy as r, DashboardListFilter as s, Dashboard as t, DashcardCompact as u };
+export { DashboardCreateInput as a, DashboardParameterConstraints as c, DashcardCompact as d, DashcardDetail as f, DashboardCopyCompact as i, DashboardUpdateInput as l, DashboardCompact as n, DashboardDetail as o, DashcardPatchInput as p, DashboardCopy as r, DashboardListFilter as s, Dashboard as t, Dashcard as u };

package/dist/{dashboard-XSTr9QCr.mjs → dashboard-D5E3fMKh.mjs}

@@ -1,4 +1,4 @@
-import { i as DashboardCopyCompact, n as DashboardCompact, u as DashcardCompact } from "./dashboard-Phz3XpRM.mjs";
+import { d as DashcardCompact, i as DashboardCopyCompact, n as DashboardCompact } from "./dashboard-Chjy5GKR.mjs";
 //#region src/output/views/dashboard.ts
 const dashcardView = {
 	compactPick: DashcardCompact,

package/dist/{data-action-Cr17CfgE.mjs → data-action-B7kRpvCH.mjs}

@@ -11,13 +11,13 @@ var data_action_default = defineCommandGroup({
 		purpose: "the data action's native query and its template tags"
 	}],
 	subCommands: {
-		list: () => import("./list-CRXTfEFk.mjs").then((mod) => mod.default),
-		get: () => import("./get-okEsnkvC.mjs").then((mod) => mod.default),
-		create: () => import("./create-CqF7vqXC.mjs").then((mod) => mod.default),
-		update: () => import("./update-DZHgr6Gu.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-ULXc3xzI.mjs").then((mod) => mod.default),
-		delete: () => import("./delete-BOma6qIq.mjs").then((mod) => mod.default),
-		execute: () => import("./execute-H09Qus4_.mjs").then((mod) => mod.default)
+		list: () => import("./list-BiSwl56L.mjs").then((mod) => mod.default),
+		get: () => import("./get-B8xrmipw.mjs").then((mod) => mod.default),
+		create: () => import("./create-f0bBEfDI.mjs").then((mod) => mod.default),
+		update: () => import("./update-FfeHReec.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-3fdIvMsf.mjs").then((mod) => mod.default),
+		delete: () => import("./delete-BHX_F8Qu.mjs").then((mod) => mod.default),
+		execute: () => import("./execute-DBJGtHHG.mjs").then((mod) => mod.default)
 	}
 });
 //#endregion

package/dist/data-app-BIAvvV2P.mjs

@@ -0,0 +1,41 @@
+import { t as defineCommandGroup } from "./group-81zoQcEP.mjs";
+//#region src/commands/data-app/index.ts
+var data_app_default = defineCommandGroup({
+	name: "data-app",
+	description: "Manage Metabase data apps",
+	skills: [
+		{
+			skill: "data-app",
+			purpose: "create, preview, build and publish a data app"
+		},
+		{
+			skill: "data-app-ui",
+			purpose: "the app's UI: sandbox, layout, theme, charts, pages"
+		},
+		{
+			skill: "data-app-data",
+			purpose: "the questions a data app runs, and its read hooks"
+		},
+		{
+			skill: "data-app-filters",
+			purpose: "filter controls and date ranges"
+		},
+		{
+			skill: "data-app-actions",
+			purpose: "writes: actions, forms and refresh"
+		}
+	],
+	subCommands: {
+		scaffold: () => import("./scaffold-BuL0_ptz.mjs").then((mod) => mod.default),
+		list: () => import("./list-YFwmHXGG.mjs").then((mod) => mod.default),
+		get: () => import("./get-Bq_9VSTa.mjs").then((mod) => mod.default),
+		create: () => import("./create-_rOCx5b8.mjs").then((mod) => mod.default),
+		update: () => import("./update-DIBaY-fy.mjs").then((mod) => mod.default),
+		"typed-schema": () => import("./typed-schema-Bo0Q6C0S.mjs").then((mod) => mod.default),
+		"set-bundle": () => import("./set-bundle-DX5HqDji.mjs").then((mod) => mod.default),
+		"set-enabled": () => import("./set-enabled-0QI-CHAT.mjs").then((mod) => mod.default),
+		delete: () => import("./delete-BSgxmR3y.mjs").then((mod) => mod.default)
+	}
+});
+//#endregion
+export { data_app_default as default };

package/dist/data-app-BUW-HlUo.mjs

@@ -0,0 +1,52 @@
+import { z } from "zod";
+//#region ../client/src/domain/data-app.ts
+const DATA_APP_SLUG_MAX_LENGTH = 100;
+const RESERVED_DATA_APP_SLUGS = /* @__PURE__ */ new Set(["repo-status", "sandbox-host"]);
+const DataAppSlug = z.string().max(DATA_APP_SLUG_MAX_LENGTH, `must be at most ${DATA_APP_SLUG_MAX_LENGTH} characters`).regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "must be dash-cased: a-z, 0-9 and single dashes").refine((slug) => !RESERVED_DATA_APP_SLUGS.has(slug), "is reserved by Metabase");
+const DataApp = z.object({
+	id: z.number().int(),
+	name: z.string(),
+	display_name: z.string(),
+	description: z.string().nullable(),
+	version: z.number().int(),
+	outdated: z.boolean(),
+	bundle_path: z.string(),
+	enabled: z.boolean(),
+	allowed_hosts: z.array(z.string()),
+	resource_collection_id: z.number().int(),
+	bundle_hash: z.string().nullable(),
+	created_at: z.string(),
+	updated_at: z.string()
+}).loose();
+const DataAppSummary = z.object({
+	name: z.string(),
+	display_name: z.string()
+}).strict();
+const DataAppEntry = z.union([DataApp, DataAppSummary]);
+const DataAppCompact = DataApp.pick({
+	name: true,
+	display_name: true,
+	enabled: true,
+	resource_collection_id: true,
+	outdated: true
+}).strip().partial({
+	enabled: true,
+	resource_collection_id: true,
+	outdated: true
+});
+z.object({ available: z.boolean().optional() }).strict();
+const DataAppFields = {
+	display_name: z.string().min(1).optional(),
+	description: z.string().nullable().optional(),
+	version: z.number().int().positive().optional(),
+	bundle_path: z.string().min(1).optional(),
+	allowed_hosts: z.array(z.string()).optional(),
+	enabled: z.boolean().optional()
+};
+const DataAppCreateInput = z.object({
+	name: DataAppSlug,
+	...DataAppFields
+}).strict();
+const DataAppUpdateInput = z.object(DataAppFields).strict();
+//#endregion
+export { DataAppSlug as a, DataAppEntry as i, DataAppCompact as n, DataAppUpdateInput as o, DataAppCreateInput as r, DataApp as t };

package/dist/data-app-Blz61mG5.mjs

@@ -0,0 +1,29 @@
+import { n as DataAppCompact } from "./data-app-BUW-HlUo.mjs";
+//#region src/output/views/data-app.ts
+const dataAppView = {
+	compactPick: DataAppCompact,
+	tableColumns: [
+		{
+			key: "name",
+			label: "Slug"
+		},
+		{
+			key: "display_name",
+			label: "Name"
+		},
+		{
+			key: "enabled",
+			label: "Enabled"
+		},
+		{
+			key: "resource_collection_id",
+			label: "Collection"
+		},
+		{
+			key: "outdated",
+			label: "Outdated"
+		}
+	]
+};
+//#endregion
+export { dataAppView as t };

package/dist/data-app-project-BL4xpu_m.mjs

@@ -0,0 +1,57 @@
+import { Pt as isFileNotFoundError, St as ConfigError, Z as parseJson } from "./cli.mjs";
+import { z } from "zod";
+import { cp, mkdir, readFile, readdir, rename, stat, writeFile } from "node:fs/promises";
+import { basename, dirname, join, resolve } from "node:path";
+//#region src/runtime/data-app-project.ts
+const DEFAULT_BUNDLE_PATH = "dist/index.js";
+const PackageManifest = z.object({}).loose();
+const SHIPPED_GITIGNORE = "gitignore";
+async function readBundle(path) {
+	try {
+		return await readFile(path, "utf8");
+	} catch (error) {
+		if (isFileNotFoundError(error)) throw new ConfigError(`bundle not found: ${path} — build the app first (npm run build)`);
+		throw error;
+	}
+}
+async function writeProjectFile(path, text) {
+	await mkdir(dirname(path), { recursive: true });
+	await writeFile(path, text, "utf8");
+}
+async function statOrNull(path) {
+	try {
+		return await stat(path);
+	} catch (error) {
+		if (isFileNotFoundError(error)) return null;
+		throw error;
+	}
+}
+async function isMissingOrEmpty(dir) {
+	const entry = await statOrNull(dir);
+	if (entry === null) return true;
+	if (!entry.isDirectory()) throw new ConfigError(`${dir} is not a directory — scaffold into a new or empty directory`);
+	return (await readdir(dir)).length === 0;
+}
+function packageNameFor(dir) {
+	const name = basename(resolve(dir)).toLowerCase().replace(/[^a-z0-9._~-]+/g, "-").replace(/^[-._]+/, "").replace(/-+$/, "");
+	if (name === "") throw new ConfigError(`cannot name the package after ${dir} — scaffold into a directory whose name has a letter or a digit`);
+	return name;
+}
+async function renamePackage(dir, name) {
+	const path = join(dir, "package.json");
+	const manifest = parseJson(await readFile(path, "utf8"), PackageManifest);
+	await writeFile(path, `${JSON.stringify({
+		...manifest,
+		name
+	}, null, 2)}\n`, "utf8");
+}
+/** Copies the app template into `dir`, which must be missing or empty, and names its package after `dir`. */
+async function scaffoldDataAppProject({ dir, templateDir }) {
+	const packageName = packageNameFor(dir);
+	if (!await isMissingOrEmpty(dir)) throw new ConfigError(`${dir} is not empty — scaffold into a new or empty directory`);
+	await cp(templateDir, dir, { recursive: true });
+	await rename(join(dir, SHIPPED_GITIGNORE), join(dir, ".gitignore"));
+	await renamePackage(dir, packageName);
+}
+//#endregion
+export { writeProjectFile as i, readBundle as n, scaffoldDataAppProject as r, DEFAULT_BUNDLE_PATH as t };