@metabase/cli 0.1.15 → 0.1.17

package/dist/parameter-CiJ4CwWE.mjs

@@ -0,0 +1,118 @@
+import { z } from "zod";
+
+//#region src/domain/parameter.ts
+const ParameterType = z.enum([
+	"number",
+	"text",
+	"date",
+	"boolean",
+	"date/single",
+	"id",
+	"category",
+	"location/city",
+	"location/state",
+	"location/zip_code",
+	"location/country",
+	"date/range",
+	"date/month-year",
+	"date/quarter-year",
+	"date/relative",
+	"date/all-options",
+	"temporal-unit",
+	"number/!=",
+	"number/<=",
+	"number/=",
+	"number/>=",
+	"number/between",
+	"string/!=",
+	"string/=",
+	"string/contains",
+	"string/does-not-contain",
+	"string/ends-with",
+	"string/starts-with",
+	"boolean/="
+]);
+const TemporalUnit = z.enum([
+	"millisecond",
+	"second",
+	"minute",
+	"hour",
+	"day",
+	"week",
+	"month",
+	"quarter",
+	"year",
+	"second-of-minute",
+	"minute-of-hour",
+	"hour-of-day",
+	"day-of-week",
+	"day-of-month",
+	"day-of-year",
+	"week-of-year",
+	"month-of-year",
+	"quarter-of-year",
+	"year-of-era",
+	"default"
+]);
+const ValuesSourceType = z.enum(["static-list", "card"]);
+const ValuesQueryType = z.enum([
+	"list",
+	"search",
+	"none"
+]);
+const TemplateTagRef = z.tuple([z.literal("template-tag"), z.union([z.string(), z.object({ id: z.string() }).loose()])]);
+const FieldRefLike = z.tuple([z.string()]).rest(z.unknown());
+const DimensionTarget = z.tuple([z.literal("dimension"), z.union([TemplateTagRef, FieldRefLike])]).rest(z.unknown());
+const VariableTarget = z.tuple([z.literal("variable"), z.union([TemplateTagRef, FieldRefLike])]);
+const TextTagTarget = z.tuple([z.literal("text-tag"), z.string()]);
+const ParameterTarget = z.union([
+	DimensionTarget,
+	VariableTarget,
+	TextTagTarget,
+	z.number().int(),
+	FieldRefLike
+]);
+const ValuesSourceConfig = z.object({
+	values: z.array(z.unknown()).optional(),
+	card_id: z.number().int().optional(),
+	value_field: FieldRefLike.optional(),
+	label_field: FieldRefLike.optional()
+}).loose();
+const Parameter = z.object({
+	id: z.string(),
+	type: ParameterType,
+	name: z.string().optional(),
+	slug: z.string().optional(),
+	sectionId: z.string().optional(),
+	default: z.unknown().optional(),
+	required: z.boolean().optional(),
+	filteringParameters: z.array(z.string()).nullable().optional(),
+	target: ParameterTarget.optional(),
+	temporal_units: z.array(TemporalUnit).nullable().optional(),
+	values_query_type: ValuesQueryType.nullable().optional(),
+	values_source_type: ValuesSourceType.nullable().optional(),
+	values_source_config: ValuesSourceConfig.nullable().optional()
+}).loose();
+const ParameterMapping = z.object({
+	parameter_id: z.string(),
+	target: ParameterTarget,
+	card_id: z.number().int().nullable().optional()
+}).loose();
+const ParameterValues = z.object({
+	values: z.array(z.array(z.unknown())),
+	has_more_values: z.boolean()
+}).loose();
+const ParameterValuesCompact = ParameterValues.pick({
+	values: true,
+	has_more_values: true
+}).strip();
+const parameterValuesView = {
+	compactPick: ParameterValuesCompact,
+	tableColumns: [{
+		key: "has_more_values",
+		label: "More available"
+	}]
+};
+
+//#endregion
+export { Parameter, ParameterMapping, ParameterValues, parameterValuesView };

package/dist/parameter-values-D4J8Ctu0.mjs

@@ -0,0 +1,56 @@
+import { ConfigError } from "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import { ParameterValues, parameterValuesView } from "./parameter-CiJ4CwWE.mjs";
+import { parseId } from "./parse-id-D4LeTUsP.mjs";
+
+//#region src/commands/dashboard/parameter-values.ts
+var parameter_values_default = defineMetabaseCommand({
+	meta: {
+		name: "parameter-values",
+		description: "Fetch the selectable values for a dashboard parameter"
+	},
+	details: "Reads the chain-filter value endpoint. With --query the server returns only values containing the substring (first 1000 matches).",
+	skills: [{
+		skill: "core",
+		purpose: "dashboard parameters and mapping"
+	}],
+	capabilities: { minVersion: 58 },
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		"dashboard-id": {
+			type: "positional",
+			description: "Dashboard id",
+			required: true
+		},
+		"parameter-id": {
+			type: "positional",
+			description: "Parameter id (the parameter's id, not its slug)",
+			required: true
+		},
+		query: {
+			type: "string",
+			description: "Substring to search values for (server-side)"
+		}
+	},
+	outputSchema: ParameterValues,
+	examples: ["mb dashboard parameter-values 1 order_status --json", "mb dashboard parameter-values 1 order_status --query Cam --json"],
+	async run({ args, ctx, getClient }) {
+		const dashboardId = parseId(args["dashboard-id"], "dashboard-id");
+		const parameterId = args["parameter-id"];
+		if (parameterId === "") throw new ConfigError("parameter-id must not be empty");
+		const client = await getClient();
+		const base = `/api/dashboard/${dashboardId}/params/${encodeURIComponent(parameterId)}`;
+		const path = args.query === void 0 || args.query === "" ? `${base}/values` : `${base}/search/${encodeURIComponent(args.query)}`;
+		const result = await client.requestParsed(ParameterValues, path);
+		const more = result.has_more_values ? " (more available — narrow with --query)" : "";
+		renderSummary(result, parameterValuesView, `${result.values.length} value(s)${more}.`, ctx);
+	}
+});
+
+//#endregion
+export { parameter_values_default as default };

package/dist/{parse-enum-BatHQ-Gs.mjs → parse-enum-BL9i_brN.mjs}

@@ -1,4 +1,4 @@
-import { ConfigError } from "./command-augment-CAur0XOQ.mjs";
+import { ConfigError } from "./notice-DyVl5aYB.mjs";
 
 //#region src/commands/parse-enum.ts
 function parseEnumFlag(value, schema, name) {

package/dist/{parse-id-DNPeV0Iu.mjs → parse-id-D4LeTUsP.mjs}

@@ -1,4 +1,4 @@
-import { parseInteger } from "./runtime-C1QgWHM7.mjs";
+import { parseInteger } from "./runtime-BJtuxWM8.mjs";
 
 //#region src/commands/parse-id.ts
 function parseId(value, name = "id") {

package/dist/{parse-ref-CZr1bYIl.mjs → parse-ref-CB_KvF9h.mjs}

@@ -1,4 +1,4 @@
-import { ConfigError } from "./command-augment-CAur0XOQ.mjs";
+import { ConfigError } from "./notice-DyVl5aYB.mjs";
 
 //#region src/commands/collection/parse-ref.ts
 const SPECIAL_TOKENS = new Set(["root", "trash"]);

package/dist/{path-BflajM08.mjs → path-5nQgdvrs.mjs}

@@ -1,8 +1,9 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { listEnvelopeSchema, outputFlags, wrapList } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderList } from "./capabilities-BX1rnVuH.mjs";
-import { findSkillByName, loadAllSkills, loadVisibleSkills } from "./skills-CJ8g8fhQ.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { listEnvelopeSchema, outputFlags, wrapList } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderList } from "./capabilities-N0jo5U7S.mjs";
+import { findSkillByName, loadAllSkills, loadVisibleSkills } from "./skills-B6gfH0iR.mjs";
 import { z } from "zod";
 
 //#region src/commands/skills/path.ts

package/dist/{poll-CYkX02Bm.mjs → poll-BpAJpvb-.mjs}

@@ -1,5 +1,5 @@
-import { TimeoutError } from "./command-augment-CAur0XOQ.mjs";
-import { combineAborts, throwIfAborted } from "./runtime-C1QgWHM7.mjs";
+import { TimeoutError } from "./notice-DyVl5aYB.mjs";
+import { combineAborts, throwIfAborted } from "./runtime-BJtuxWM8.mjs";
 import { setTimeout } from "node:timers/promises";
 
 //#region src/runtime/poll.ts

package/dist/{poll-task-oXpl3wzp.mjs → poll-task-TilgciQn.mjs}

@@ -1,5 +1,5 @@
-import { parseJsonOrPlain } from "./runtime-C1QgWHM7.mjs";
-import { pollUntil } from "./poll-CYkX02Bm.mjs";
+import { parseJsonOrPlain } from "./runtime-BJtuxWM8.mjs";
+import { pollUntil } from "./poll-BpAJpvb-.mjs";
 import { z } from "zod";
 
 //#region src/domain/git-sync.ts

package/dist/{preflight-BdJr2amA.mjs → preflight-OfHU3Toi.mjs}

@@ -1,7 +1,7 @@
-import { ChainedRequestError, ConfigError, MetabaseError } from "./command-augment-CAur0XOQ.mjs";
-import { HttpError } from "./runtime-C1QgWHM7.mjs";
-import { writeJson } from "./capabilities-BX1rnVuH.mjs";
-import { Card } from "./card-wCPcuKSi.mjs";
+import { ChainedRequestError, ConfigError, MetabaseError } from "./notice-DyVl5aYB.mjs";
+import { HttpError } from "./runtime-BJtuxWM8.mjs";
+import { writeJson } from "./capabilities-N0jo5U7S.mjs";
+import { Card } from "./card-DEmcRlNO.mjs";
 import { z } from "zod";
 
 //#region src/commands/dashboard/preflight.ts

package/dist/{process-DsGf7Mg5.mjs → process-j8UHMHc2.mjs}

@@ -1,4 +1,4 @@
-import { isNotFoundError } from "./command-augment-CAur0XOQ.mjs";
+import { isNotFoundError } from "./notice-DyVl5aYB.mjs";
 import { spawn } from "node:child_process";
 
 //#region src/runtime/process.ts

package/dist/{prompt-Bc_bHSD0.mjs → prompt-C85xd9HR.mjs}

@@ -1,4 +1,4 @@
-import { AbortError, ConfigError } from "./command-augment-CAur0XOQ.mjs";
+import { AbortError, ConfigError } from "./notice-DyVl5aYB.mjs";
 import { confirm, isCancel, password, select, text } from "@clack/prompts";
 
 //#region src/output/prompt.ts

package/dist/publish-DKiqyDwo.mjs

@@ -0,0 +1,67 @@
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import "./parse-id-D4LeTUsP.mjs";
+import { Collection, CollectionCompact } from "./collection-DrLpA1SO.mjs";
+import { ensureLibraryDataCollectionId } from "./resolve-Dj2MTBkn.mjs";
+import { parseTableSelectors, tableSelectorFlags } from "./selectors-DlmZpo2L.mjs";
+import { z } from "zod";
+
+//#region src/commands/library/publish.ts
+const PUBLISH_TABLES_PATH = "/api/ee/data-studio/table/publish-tables";
+const LibraryPublishResult = z.object({ target_collection: Collection.nullable() });
+const LibraryPublishResultCompact = z.object({ target_collection: CollectionCompact.nullable() });
+const libraryPublishResultView = {
+	compactPick: LibraryPublishResultCompact,
+	tableColumns: [{
+		key: "target_collection",
+		label: "Target collection"
+	}]
+};
+var publish_default = defineMetabaseCommand({
+	meta: {
+		name: "publish",
+		description: "Publish tables (and their upstream dependencies) to the Library Data collection"
+	},
+	details: "Sets each selected table and every upstream table it depends on into the Library Data collection, so they appear first in data pickers and rank up in search. The Library Data collection is resolved automatically (and the Library is created if it doesn't exist yet). Select with --table-ids, --db-ids, or --schemas (each schema id is \"<db-id>:<schema>\", e.g. 1:public); the filters are combined.",
+	capabilities: {
+		minVersion: 59,
+		tokenFeature: "library"
+	},
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		...tableSelectorFlags
+	},
+	outputSchema: LibraryPublishResult,
+	examples: [
+		"mb library publish --table-ids 1,2,3",
+		"mb library publish --db-ids 1 --json",
+		"mb library publish --schemas 1:public,1:analytics"
+	],
+	async run({ args, ctx, getClient }) {
+		const selectors = parseTableSelectors(args);
+		const client = await getClient();
+		const collectionId = await ensureLibraryDataCollectionId(client);
+		const body = {
+			collection_id: collectionId,
+			...selectors
+		};
+		const result = await client.requestParsed(LibraryPublishResult, PUBLISH_TABLES_PATH, {
+			method: "POST",
+			body
+		});
+		renderSummary(result, libraryPublishResultView, summaryLine(result), ctx);
+	}
+});
+function summaryLine(result) {
+	const collection = result.target_collection;
+	if (collection === null) return "Published tables to the Library.";
+	return `Published tables to the Library (collection ${collection.id} "${collection.name}").`;
+}
+
+//#endregion
+export { publish_default as default };

package/dist/{query-CxTjguwp.mjs → query-BWJ5h1g3.mjs}

@@ -1,15 +1,17 @@
-import { ConfigError } from "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderSummary, writeJson } from "./capabilities-BX1rnVuH.mjs";
-import "./input-BXWgdKiS.mjs";
-import "./field-E0IBy4Uw.mjs";
-import { CardQueryResult, cardQueryView } from "./card-wCPcuKSi.mjs";
-import { readBody } from "./body-B9XTTDEu.mjs";
-import { bodyInputFlags } from "./body-flags-D7q87Btw.mjs";
-import { assertNotLegacyEnvelopeWrappingMbql5, getQuerySchemaBundle, isMbql5Query, validateQuery } from "./validate-VawhJ5Sc.mjs";
-import { skipValidateFlag } from "./validate-query-CSV-TTnd.mjs";
-import { formatQueryResult } from "./query-result-L5_NrwQR.mjs";
+import { ConfigError } from "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderSummary, writeJson } from "./capabilities-N0jo5U7S.mjs";
+import "./input-7Sj85_K7.mjs";
+import "./field-CMY_LWUe.mjs";
+import "./parameter-CiJ4CwWE.mjs";
+import { CardQueryResult, cardQueryView } from "./card-DEmcRlNO.mjs";
+import { readBody } from "./body-IcJ5kFtk.mjs";
+import { bodyInputFlags } from "./body-flags-DWTTxJpP.mjs";
+import { assertNotLegacyEnvelopeWrappingMbql5, getQuerySchemaBundle, isMbql5Query, validateQuery } from "./validate-BqNW4Sk1.mjs";
+import { skipValidateFlag } from "./validate-query-CcZVKYPV.mjs";
+import { formatQueryResult } from "./query-result-D6mfoVfQ.mjs";
 import { z } from "zod";
 
 //#region src/commands/query.ts
@@ -20,7 +22,11 @@ var query_default = defineMetabaseCommand({
 		name: "query",
 		description: "Run an ad-hoc MBQL or native query"
 	},
-	details: "Reads a JSON query body from --body, --file, or stdin and runs it. MBQL 5 is Metabase's structured query format, shaped {\"lib/type\":\"mbql/query\", \"database\": <id>, \"stages\": [...]}; it is checked against a bundled JSON Schema before sending — --print-schema prints that schema, and --dry-run reports any errors as {ok, errors:[{path, message}]} and exits 2 without sending. Legacy MBQL 4 and native-SQL bodies are not checked and run as-is. Run `mb skills get mbql` for the body shape, clause rules, and the iterate-with-dry-run loop.",
+	details: "Reads a JSON query body from --body, --file, or stdin and runs it. MBQL 5 is Metabase's structured query format, shaped {\"lib/type\":\"mbql/query\", \"database\": <id>, \"stages\": [...]}; it is checked against a bundled JSON Schema before sending — --print-schema prints that schema, and --dry-run reports any errors as {ok, errors:[{path, message}]} and exits 2 without sending. Legacy MBQL 4 and native-SQL bodies are not checked and run as-is.",
+	skills: [{
+		skill: "mbql",
+		purpose: "body shape, clause rules, and the dry-run loop"
+	}],
 	capabilities: { minVersion: 58 },
 	args: {
 		...outputFlags,

package/dist/{query-DWQaN7hO.mjs → query-CQ3xXa9P.mjs}

@@ -1,11 +1,13 @@
-import { ConfigError } from "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand, parseJson } from "./runtime-C1QgWHM7.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import "./field-E0IBy4Uw.mjs";
-import { CardQueryResult, cardQueryView } from "./card-wCPcuKSi.mjs";
-import { parseId } from "./parse-id-DNPeV0Iu.mjs";
-import { formatQueryResult } from "./query-result-L5_NrwQR.mjs";
+import { ConfigError } from "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand, parseJson } from "./runtime-BJtuxWM8.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import "./field-CMY_LWUe.mjs";
+import "./parameter-CiJ4CwWE.mjs";
+import { CardQueryResult, cardQueryView } from "./card-DEmcRlNO.mjs";
+import { parseId } from "./parse-id-D4LeTUsP.mjs";
+import { formatQueryResult } from "./query-result-D6mfoVfQ.mjs";
 import { z } from "zod";
 import { Writable } from "node:stream";
 

package/dist/{query-result-L5_NrwQR.mjs → query-result-D6mfoVfQ.mjs}

@@ -1,4 +1,4 @@
-import { formatScalar, renderRows } from "./capabilities-BX1rnVuH.mjs";
+import { formatScalar, renderRows } from "./capabilities-N0jo5U7S.mjs";
 
 //#region src/output/query-result.ts
 function formatQueryResult(result) {

package/dist/{remove-collection-BwcFi8Fs.mjs → remove-collection-CO-aMzTO.mjs}

@@ -1,11 +1,12 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-DNPeV0Iu.mjs";
-import "./poll-CYkX02Bm.mjs";
-import "./poll-task-oXpl3wzp.mjs";
-import { SyncSettingsUpdateResult, setCollectionRemoteSynced, syncSettingsUpdateView } from "./add-collection-CXhrMjXU.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import { parseId } from "./parse-id-D4LeTUsP.mjs";
+import "./poll-BpAJpvb-.mjs";
+import "./poll-task-TilgciQn.mjs";
+import { SyncSettingsUpdateResult, setCollectionRemoteSynced, syncSettingsUpdateView } from "./add-collection-C-t9SQBk.mjs";
 
 //#region src/commands/git-sync/remove-collection.ts
 var remove_collection_default = defineMetabaseCommand({

package/dist/{rescan-values-B9Qtsd32.mjs → rescan-values-DpL6LGAK.mjs}

@@ -1,11 +1,12 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import "./field-E0IBy4Uw.mjs";
-import { parseId } from "./parse-id-DNPeV0Iu.mjs";
-import "./table-qDD2kApF.mjs";
-import { DatabaseSyncResult, DatabaseTaskAck, databaseSyncResultView } from "./database-BmsxuRmO.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import "./field-CMY_LWUe.mjs";
+import { parseId } from "./parse-id-D4LeTUsP.mjs";
+import "./table-DE3i82T_.mjs";
+import { DatabaseSyncResult, DatabaseTaskAck, databaseSyncResultView } from "./database-D9fftP-i.mjs";
 
 //#region src/commands/db/rescan-values.ts
 var rescan_values_default = defineMetabaseCommand({

package/dist/resolve-Dj2MTBkn.mjs

@@ -0,0 +1,84 @@
+import { Collection } from "./collection-DrLpA1SO.mjs";
+import { z } from "zod";
+
+//#region src/domain/library.ts
+const LibraryChild = Collection.pick({
+	id: true,
+	name: true,
+	type: true,
+	description: true
+}).strip();
+const Library = Collection.extend({ effective_children: z.array(LibraryChild) }).loose();
+const LibraryCompact = Library.pick({
+	id: true,
+	name: true,
+	type: true,
+	effective_children: true
+}).strip();
+const libraryView = {
+	compactPick: LibraryCompact,
+	tableColumns: [
+		{
+			key: "id",
+			label: "ID"
+		},
+		{
+			key: "name",
+			label: "Name"
+		},
+		{
+			key: "type",
+			label: "Type"
+		}
+	]
+};
+
+//#endregion
+//#region src/commands/library/resolve.ts
+const LIBRARY_ROOT_PATH = "/api/ee/library/";
+const COLLECTION_LIST_PATH = "/api/collection";
+const LIBRARY_DATA_TYPE = "library-data";
+const AbsentLibrary = z.object({ data: z.null() });
+const LibraryOrAbsent = z.union([Library, AbsentLibrary]);
+const LibraryCollectionEntry = Collection.pick({
+	id: true,
+	type: true
+}).strip();
+const LibraryCollections = z.array(LibraryCollectionEntry);
+async function fetchLibrary(client) {
+	const result = await client.requestParsed(LibraryOrAbsent, LIBRARY_ROOT_PATH);
+	if (!("effective_children" in result)) return null;
+	const typeById = await fetchLibraryCollectionTypes(client);
+	const effective_children = result.effective_children.map((child) => typeof child.id === "number" ? {
+		...child,
+		type: typeById.get(child.id) ?? child.type
+	} : child);
+	return {
+		...result,
+		effective_children
+	};
+}
+async function fetchLibraryCollectionTypes(client) {
+	const collections = await client.requestParsed(LibraryCollections, COLLECTION_LIST_PATH, { query: { "include-library": true } });
+	const typeById = new Map();
+	for (const collection of collections) if (typeof collection.id === "number" && collection.type != null) typeById.set(collection.id, collection.type);
+	return typeById;
+}
+async function createLibrary(client) {
+	const existing = await fetchLibrary(client);
+	if (existing !== null) return existing;
+	await client.requestRaw(LIBRARY_ROOT_PATH, { method: "POST" });
+	const created = await fetchLibrary(client);
+	if (created === null) throw new Error(`Library was not created after POST ${LIBRARY_ROOT_PATH}`);
+	return created;
+}
+async function ensureLibraryDataCollectionId(client) {
+	const library = await createLibrary(client);
+	const data = library.effective_children.find((child) => child.type === LIBRARY_DATA_TYPE);
+	if (data === void 0) throw new Error("Library has no Data collection to publish into");
+	if (typeof data.id !== "number") throw new Error(`Library Data collection has a non-numeric id ${String(data.id)}`);
+	return data.id;
+}
+
+//#endregion
+export { Library, createLibrary, ensureLibraryDataCollectionId, fetchLibrary, libraryView };

package/dist/{run-C-vftXCu.mjs → run-DUcdaZs3.mjs}

@@ -1,8 +1,9 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-DNPeV0Iu.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import { parseId } from "./parse-id-D4LeTUsP.mjs";
 import { z } from "zod";
 
 //#region src/commands/transform-job/run.ts

package/dist/{run-3eFtdI2Z.mjs → run-QYJ-mAaG.mjs}

@@ -1,11 +1,12 @@
-import { TimeoutError } from "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderSummary } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-DNPeV0Iu.mjs";
-import { pollUntil } from "./poll-CYkX02Bm.mjs";
-import { parseWaitFlags, waitFlags } from "./wait-flags-DQrxnlwv.mjs";
-import { Transform, TransformRun } from "./transform-n376akp8.mjs";
+import { TimeoutError } from "./notice-DyVl5aYB.mjs";
+import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
+import { parseId } from "./parse-id-D4LeTUsP.mjs";
+import { pollUntil } from "./poll-BpAJpvb-.mjs";
+import { parseWaitFlags, waitFlags } from "./wait-flags-Ybpt98PK.mjs";
+import { Transform, TransformRun } from "./transform-DEF38FWe.mjs";
 import { z } from "zod";
 
 //#region src/commands/transform/run.ts

package/dist/{runs-CpRTkn1W.mjs → runs-DgasTnGd.mjs}

@@ -1,10 +1,11 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderList } from "./capabilities-BX1rnVuH.mjs";
-import { parseId } from "./parse-id-DNPeV0Iu.mjs";
-import { collectPaginated } from "./paginate-BexjkjbY.mjs";
-import { TransformRun, TransformRunCompact, transformRunView } from "./transform-n376akp8.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderList } from "./capabilities-N0jo5U7S.mjs";
+import { parseId } from "./parse-id-D4LeTUsP.mjs";
+import { collectPaginated } from "./paginate-FVZUxL4J.mjs";
+import { TransformRun, TransformRunCompact, transformRunView } from "./transform-DEF38FWe.mjs";
 
 //#region src/commands/transform/runs.ts
 const TransformRunListEnvelope = listEnvelopeSchema(TransformRunCompact);

package/dist/{runtime-C1QgWHM7.mjs → runtime-BJtuxWM8.mjs}

@@ -1,6 +1,7 @@
-import { AbortError, ConfigError, MetabaseError, NetworkError, ResponseShapeError, TimeoutError, ValidationError, errorMessage, flagConsumesValue, isNotFoundError, normalizeFlag, setMetabaseAugment, toAliasArray, warn } from "./command-augment-CAur0XOQ.mjs";
-import { DEFAULT_MAX_BYTES, ENV_API_KEY, ENV_DISABLE_KEYRING, ENV_PROFILE, ENV_SKIP_PREFLIGHT, ENV_URL, consumeLegacyEnvWarnings, package_default, readEnv, reportError } from "./error-D5bZ5BUX.mjs";
-import { BASELINE_CAPABILITIES, isPlainObject } from "./capabilities-BX1rnVuH.mjs";
+import { AbortError, ConfigError, MetabaseError, NetworkError, ResponseShapeError, TimeoutError, ValidationError, errorMessage, flagConsumesValue, isNotFoundError, normalizeFlag, toAliasArray, warn } from "./notice-DyVl5aYB.mjs";
+import { DEFAULT_MAX_BYTES, ENV_API_KEY, ENV_DISABLE_KEYRING, ENV_PROFILE, ENV_SKIP_PREFLIGHT, ENV_URL, consumeLegacyEnvWarnings, package_default, readEnv, reportError } from "./error-5H_tcfL8.mjs";
+import { setMetabaseAugment } from "./command-augment-DdZIfx1V.mjs";
+import { BASELINE_CAPABILITIES, isPlainObject } from "./capabilities-N0jo5U7S.mjs";
 import { defineCommand } from "citty";
 import { z } from "zod";
 import { promises } from "node:fs";
@@ -1627,6 +1628,7 @@ function defineMetabaseCommand(def) {
 	setMetabaseAugment(cmd, {
 		examples: def.examples ?? [],
 		details: def.details ? def.details : null,
+		skills: def.skills ?? [],
 		outputSchema: def.outputSchema ?? null,
 		capabilities: required
 	});

package/dist/{schema-tables-rdeupgsu.mjs → schema-tables-ooYjimrV.mjs}

@@ -1,10 +1,11 @@
-import "./command-augment-CAur0XOQ.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-D5bZ5BUX.mjs";
-import { defineMetabaseCommand } from "./runtime-C1QgWHM7.mjs";
-import { renderList } from "./capabilities-BX1rnVuH.mjs";
-import "./field-E0IBy4Uw.mjs";
-import { parseId } from "./parse-id-DNPeV0Iu.mjs";
-import { Table, TableCompact, tableView } from "./table-qDD2kApF.mjs";
+import "./notice-DyVl5aYB.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-5H_tcfL8.mjs";
+import "./command-augment-DdZIfx1V.mjs";
+import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
+import { renderList } from "./capabilities-N0jo5U7S.mjs";
+import "./field-CMY_LWUe.mjs";
+import { parseId } from "./parse-id-D4LeTUsP.mjs";
+import { Table, TableCompact, tableView } from "./table-DE3i82T_.mjs";
 import { z } from "zod";
 
 //#region src/commands/db/schema-tables.ts