@metabase/cli 0.1.0 → 0.1.2

package/dist/list-DJN-OvTZ.mjs

@@ -0,0 +1,52 @@
+import "./package-DV6Asqim.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { renderList } from "./render-DXv-D6fU.mjs";
+import "./predicates-DiIiS3k7.mjs";
+import { connectionFlags, defineMetabaseCommand, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./runtime-cwBS8wwK.mjs";
+import { Collection, CollectionCompact, collectionView } from "./collection-B3sPXRLs.mjs";
+import { z } from "zod";
+
+//#region src/commands/collection/list.ts
+const CollectionApiList = z.array(Collection);
+const CollectionListFilter = z.enum([
+	"all",
+	"archived",
+	"personal"
+]);
+const COLLECTION_LIST_QUERY = {
+	all: {},
+	archived: { archived: true },
+	personal: { "personal-only": true }
+};
+const CollectionListEnvelope = listEnvelopeSchema(CollectionCompact);
+var list_default = defineMetabaseCommand({
+	meta: {
+		name: "list",
+		description: "List collections"
+	},
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		filter: {
+			type: "string",
+			description: `Filter preset: ${CollectionListFilter.options.join("|")}`,
+			default: "all"
+		}
+	},
+	outputSchema: CollectionListEnvelope,
+	examples: [
+		"metabase collection list",
+		"metabase collection list --json",
+		"metabase collection list --filter archived --json"
+	],
+	async run({ args, ctx, getClient }) {
+		const filter = CollectionListFilter.parse(args.filter);
+		const client = await getClient();
+		const items = await client.requestParsed(CollectionApiList, "/api/collection", { query: COLLECTION_LIST_QUERY[filter] });
+		renderList(wrapList(items), collectionView, ctx);
+	}
+});
+
+//#endregion
+export { list_default as default };

package/dist/list-DQj-QJAs.mjs

@@ -0,0 +1,40 @@
+import "./package-DV6Asqim.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { renderList } from "./render-DXv-D6fU.mjs";
+import "./predicates-DiIiS3k7.mjs";
+import { connectionFlags, defineMetabaseCommand, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./runtime-cwBS8wwK.mjs";
+import { Snippet, SnippetCompact, snippetView } from "./snippet-Dw0Sjzkr.mjs";
+import { z } from "zod";
+
+//#region src/commands/snippet/list.ts
+const SnippetApiList = z.array(Snippet);
+const SnippetListEnvelope = listEnvelopeSchema(SnippetCompact);
+var list_default = defineMetabaseCommand({
+	meta: {
+		name: "list",
+		description: "List native query snippets"
+	},
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		archived: {
+			type: "boolean",
+			description: "Show archived snippets instead of active ones"
+		}
+	},
+	outputSchema: SnippetListEnvelope,
+	examples: [
+		"metabase snippet list",
+		"metabase snippet list --json",
+		"metabase snippet list --archived --json"
+	],
+	async run({ args, ctx, getClient }) {
+		const client = await getClient();
+		const items = await client.requestParsed(SnippetApiList, "/api/native-query-snippet", { query: { archived: args.archived || void 0 } });
+		renderList(wrapList(items), snippetView, ctx);
+	}
+});
+
+//#endregion
+export { list_default as default };

package/dist/list-Di529OJD.mjs

@@ -0,0 +1,55 @@
+import "./package-DV6Asqim.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { renderList } from "./render-DXv-D6fU.mjs";
+import "./predicates-DiIiS3k7.mjs";
+import { defineMetabaseCommand, listEnvelopeSchema, listProfileNames, originOnly, outputFlags, readProfile, wrapList } from "./runtime-cwBS8wwK.mjs";
+import { z } from "zod";
+
+//#region src/commands/auth/list.ts
+const AuthProfile = z.object({
+	profile: z.string(),
+	url: z.string().nullable(),
+	present: z.boolean()
+});
+const AuthProfileListEnvelope = listEnvelopeSchema(AuthProfile);
+const authProfileView = {
+	compactPick: AuthProfile,
+	tableColumns: [
+		{
+			key: "profile",
+			label: "Profile"
+		},
+		{
+			key: "url",
+			label: "URL"
+		},
+		{
+			key: "present",
+			label: "Authenticated"
+		}
+	]
+};
+var list_default = defineMetabaseCommand({
+	meta: {
+		name: "list",
+		description: "List configured authentication profiles"
+	},
+	args: { ...outputFlags },
+	outputSchema: AuthProfileListEnvelope,
+	examples: ["metabase auth list", "metabase auth list --json"],
+	async run({ ctx }) {
+		const names = await listProfileNames();
+		const items = await Promise.all(names.map(async (name) => {
+			const profile = await readProfile(name);
+			return {
+				profile: name,
+				url: profile === null ? null : originOnly(profile.url),
+				present: profile !== null
+			};
+		}));
+		renderList(wrapList(items), authProfileView, ctx);
+	}
+});
+
+//#endregion
+export { list_default as default };

package/dist/{list-C4Ajrw8f.mjs → list-DlKzgnqo.mjs}

@@ -1,7 +1,10 @@
-import "./package-BGfw4ZWJ.mjs";
+import "./package-DV6Asqim.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
-import { connectionFlags, defineMetabaseCommand, listEnvelopeSchema, outputFlags, profileFlag, renderList, wrapList } from "./runtime-C9CEZhcn.mjs";
-import { Card, CardCompact, cardView } from "./card-CsXk8T6A.mjs";
+import { renderList } from "./render-DXv-D6fU.mjs";
+import "./predicates-DiIiS3k7.mjs";
+import { connectionFlags, defineMetabaseCommand, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./runtime-cwBS8wwK.mjs";
+import "./field-B3gvaqpK.mjs";
+import { Card, CardCompact, cardView } from "./card-CQxvHeyP.mjs";
 import { z } from "zod";
 
 //#region src/commands/card/list.ts

package/dist/list-GFfR9SuT.mjs

@@ -0,0 +1,32 @@
+import "./package-DV6Asqim.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { renderList } from "./render-DXv-D6fU.mjs";
+import "./predicates-DiIiS3k7.mjs";
+import { connectionFlags, defineMetabaseCommand, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./runtime-cwBS8wwK.mjs";
+import { Segment, SegmentCompact, segmentView } from "./segment-BMrUBz94.mjs";
+import { z } from "zod";
+
+//#region src/commands/segment/list.ts
+const SegmentApiList = z.array(Segment);
+const SegmentListEnvelope = listEnvelopeSchema(SegmentCompact);
+var list_default = defineMetabaseCommand({
+	meta: {
+		name: "list",
+		description: "List segments"
+	},
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags
+	},
+	outputSchema: SegmentListEnvelope,
+	examples: ["metabase segment list", "metabase segment list --json"],
+	async run({ ctx, getClient }) {
+		const client = await getClient();
+		const items = await client.requestParsed(SegmentApiList, "/api/segment");
+		renderList(wrapList(items), segmentView, ctx);
+	}
+});
+
+//#endregion
+export { list_default as default };

package/dist/{list-CWt3fqrZ.mjs → list-iFVEdi2J.mjs}

@@ -1,7 +1,9 @@
-import "./package-BGfw4ZWJ.mjs";
+import "./package-DV6Asqim.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
-import { connectionFlags, defineMetabaseCommand, listEnvelopeSchema, outputFlags, profileFlag, renderList, wrapList } from "./runtime-C9CEZhcn.mjs";
-import { Transform, TransformCompact, transformView } from "./transform-B5uRpg1G.mjs";
+import { renderList } from "./render-DXv-D6fU.mjs";
+import "./predicates-DiIiS3k7.mjs";
+import { connectionFlags, defineMetabaseCommand, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./runtime-cwBS8wwK.mjs";
+import { Transform, TransformCompact, transformView } from "./transform-IEX4Mx3X.mjs";
 import { z } from "zod";
 
 //#region src/commands/transform/list.ts

package/dist/{login-C9WTwNn6.mjs → login-DxgkosGx.mjs}

@@ -1,8 +1,10 @@
-import "./package-BGfw4ZWJ.mjs";
+import "./package-DV6Asqim.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
-import { ConfigError, HttpError, MetabaseError, connectionFlags, createClient, defineMetabaseCommand, errorMessage, normalizeUrl, outputFlags, profileFlag, readEnvCredentials, renderItem, resolveProfileName, warn, writeProfile } from "./runtime-C9CEZhcn.mjs";
-import { promptPassword, promptText } from "./prompt-DpT8yAVy.mjs";
-import { readInput } from "./input-Dojr-RTw.mjs";
+import { renderItem, warn } from "./render-DXv-D6fU.mjs";
+import { ConfigError, MetabaseError, errorMessage } from "./predicates-DiIiS3k7.mjs";
+import { readInput } from "./input-ikCiip6x.mjs";
+import { DEFAULT_PROFILE, HttpError, clearRejection, connectionFlags, createClient, defineMetabaseCommand, explicitProfileName, normalizeUrl, outputFlags, profileFlag, readEnvCredentials, recordRejection, writeProfile } from "./runtime-cwBS8wwK.mjs";
+import { promptPassword, promptText } from "./prompt-Bf3DQ-qE.mjs";
 import { z } from "zod";
 
 //#region src/domain/user.ts
@@ -69,15 +71,16 @@ const loginView = {
 		},
 		{
 			key: "url",
-			label: "URL"
+			label: "Metabase URL"
 		},
 		{
 			key: "authenticated",
-			label: "Authenticated"
+			label: "Status",
+			format: (value) => value === true ? "credentials verified" : "saved without verification"
 		},
 		{
 			key: "email",
-			label: "Email"
+			label: "Logged in as"
 		}
 	]
 };
@@ -103,7 +106,7 @@ var login_default = defineMetabaseCommand({
 		"metabase auth login --profile staging --url https://staging.example.com"
 	],
 	async run({ args, ctx }) {
-		const profileName = resolveProfileName(args.profile);
+		const profileName = await resolveLoginProfile(args.profile);
 		const env = readEnvCredentials();
 		if (args.apiKey) warn("warning: --api-key is visible in shell history and process listings — pipe the key on stdin or set METABASE_API_KEY instead");
 		const url = await resolveUrl(args.url, env.url);
@@ -112,7 +115,13 @@ var login_default = defineMetabaseCommand({
 		let authenticated = false;
 		if (!args["skip-verify"]) {
 			const result = await verifyCredentials(url, apiKey);
-			if (!result.ok) throw new ConfigError(`verification failed: ${result.message}`);
+			if (!result.ok) {
+				await recordRejection(profileName, {
+					reason: result.message,
+					url
+				});
+				throw new ConfigError(`verification failed: ${result.message} — credentials were not saved for profile "${profileName}"`);
+			}
 			email = result.user.email;
 			authenticated = true;
 		}
@@ -120,6 +129,7 @@ var login_default = defineMetabaseCommand({
 			url,
 			apiKey
 		}, profileName);
+		await clearRejection(profileName);
 		if (location.backend === "file") warn(`warning: OS keychain unavailable; credentials stored as plaintext at ${location.path}`);
 		renderItem({
 			profile: profileName,
@@ -129,6 +139,17 @@ var login_default = defineMetabaseCommand({
 		}, loginView, ctx);
 	}
 });
+async function resolveLoginProfile(flagProfile) {
+	const explicit = explicitProfileName(flagProfile);
+	if (explicit !== null) return explicit;
+	if (!process.stdin.isTTY) return DEFAULT_PROFILE;
+	return promptText({
+		message: "Profile name",
+		placeholder: DEFAULT_PROFILE,
+		initialValue: DEFAULT_PROFILE,
+		validate: (input) => input ? void 0 : "Profile name is required"
+	});
+}
 async function resolveUrl(flagUrl, envUrl) {
 	if (flagUrl) return normalizeUrl(flagUrl);
 	if (envUrl) return normalizeUrl(envUrl);

package/dist/{logout-oLszGCOg.mjs → logout-BlVwqBog.mjs}

@@ -1,7 +1,9 @@
-import "./package-BGfw4ZWJ.mjs";
+import "./package-DV6Asqim.mjs";
 import "./command-augment-D9pI9Vbh.mjs";
-import { ConfigError, clearProfile, defineMetabaseCommand, outputFlags, profileFlag, renderItem, resolveProfileName } from "./runtime-C9CEZhcn.mjs";
-import { promptConfirm } from "./prompt-DpT8yAVy.mjs";
+import { renderItem } from "./render-DXv-D6fU.mjs";
+import "./predicates-DiIiS3k7.mjs";
+import { clearProfile, clearRejection, defineMetabaseCommand, outputFlags, profileFlag, resolveProfileName } from "./runtime-cwBS8wwK.mjs";
+import { promptConfirm } from "./prompt-Bf3DQ-qE.mjs";
 import { z } from "zod";
 
 //#region src/commands/auth/logout.ts
@@ -45,8 +47,7 @@ var logout_default = defineMetabaseCommand({
 	examples: ["metabase auth logout --yes", "metabase auth logout --profile staging --yes"],
 	async run({ args, ctx }) {
 		const profileName = resolveProfileName(args.profile);
-		if (!args.yes) {
-			if (!process.stdin.isTTY) throw new ConfigError("--yes required to clear credentials non-interactively");
+		if (!args.yes && process.stdin.isTTY === true) {
 			const ok = await promptConfirm({
 				message: `Clear stored credentials for profile "${profileName}"?`,
 				initialValue: false
@@ -60,7 +61,7 @@ var logout_default = defineMetabaseCommand({
 				return;
 			}
 		}
-		const cleared = await clearProfile(profileName);
+		const [cleared] = await Promise.all([clearProfile(profileName), clearRejection(profileName)]);
 		renderItem({
 			profile: profileName,
 			cleared,

package/dist/logs-CudNEkT4.mjs

@@ -0,0 +1,58 @@
+import "./package-DV6Asqim.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { ConfigError } from "./predicates-DiIiS3k7.mjs";
+import { defineMetabaseCommand, outputFlags, parseInteger } from "./runtime-cwBS8wwK.mjs";
+import { parseId } from "./parse-id-B38zTlYs.mjs";
+import "./poll-Bh6oAifO.mjs";
+import { checkDockerReady, containerLifecycleStatus, containerNameFor, streamLogs } from "./docker-CHpV8PRz.mjs";
+
+//#region src/commands/workspace/logs.ts
+const DEFAULT_TAIL = 200;
+var logs_default = defineMetabaseCommand({
+	meta: {
+		name: "logs",
+		description: "Stream the local container's logs (passthrough to `docker logs`)"
+	},
+	args: {
+		...outputFlags,
+		id: {
+			type: "positional",
+			description: "Workspace id",
+			required: true
+		},
+		follow: {
+			type: "boolean",
+			alias: "f",
+			description: "Follow log output (stream indefinitely; Ctrl-C to exit)",
+			default: false
+		},
+		tail: {
+			type: "string",
+			description: `Number of lines from the end of the logs (default: ${DEFAULT_TAIL})`,
+			default: String(DEFAULT_TAIL)
+		}
+	},
+	examples: [
+		"metabase workspace logs 1",
+		"metabase workspace logs 1 --follow",
+		"metabase workspace logs 1 --tail 500"
+	],
+	async run({ args }) {
+		const workspaceId = parseId(args.id);
+		const containerName = containerNameFor(workspaceId);
+		const tail = parseInteger(args.tail ?? String(DEFAULT_TAIL), {
+			name: "--tail",
+			min: 0
+		});
+		await checkDockerReady();
+		const status = await containerLifecycleStatus(containerName);
+		if (status === "missing") throw new ConfigError(`no container for workspace ${workspaceId} — run \`metabase workspace start ${workspaceId}\` first`);
+		await streamLogs(containerName, {
+			follow: args.follow === true,
+			tail
+		});
+	}
+});
+
+//#endregion
+export { logs_default as default };

package/dist/{manifest-CAdjQYH8.mjs → manifest-Dv5B9Blc.mjs}

@@ -1,13 +1,9 @@
 import { getMetabaseAugment } from "./command-augment-D9pI9Vbh.mjs";
+import { writeJson } from "./render-DXv-D6fU.mjs";
+import "./predicates-DiIiS3k7.mjs";
 import { defineCommand } from "citty";
 import { z } from "zod";
 
-//#region src/output/manifest.ts
-function writeManifest(manifest) {
-	process.stdout.write(JSON.stringify(manifest, null, 2) + "\n");
-}
-
-//#endregion
 //#region src/runtime/manifest.ts
 const ManifestArg = z.object({
 	name: z.string(),
@@ -115,7 +111,7 @@ function createManifestCommand(root) {
 		args: {},
 		async run() {
 			const manifest = await buildManifest(root);
-			writeManifest(manifest);
+			writeJson(manifest);
 		}
 	});
 }

package/dist/measure-BEQfnLdN.mjs

@@ -0,0 +1,67 @@
+import { z } from "zod";
+
+//#region src/domain/measure.ts
+const Measure = z.object({
+	id: z.number().int(),
+	name: z.string(),
+	description: z.string().nullable(),
+	archived: z.boolean(),
+	table_id: z.number().int(),
+	definition: z.unknown(),
+	creator_id: z.number().int(),
+	entity_id: z.string().nullable(),
+	dimensions: z.array(z.unknown()).nullable(),
+	dimension_mappings: z.array(z.unknown()).nullable(),
+	definition_description: z.string().nullable().optional(),
+	result_column_name: z.string().nullable().optional(),
+	created_at: z.string(),
+	updated_at: z.string()
+}).loose();
+const MeasureCompact = Measure.pick({
+	id: true,
+	name: true,
+	description: true,
+	archived: true,
+	table_id: true
+}).strip();
+const measureView = {
+	compactPick: MeasureCompact,
+	tableColumns: [
+		{
+			key: "id",
+			label: "ID"
+		},
+		{
+			key: "name",
+			label: "Name"
+		},
+		{
+			key: "description",
+			label: "Description"
+		},
+		{
+			key: "table_id",
+			label: "Table"
+		},
+		{
+			key: "archived",
+			label: "Archived"
+		}
+	]
+};
+const MeasureCreateInput = z.object({
+	name: z.string().min(1),
+	table_id: z.number().int().positive(),
+	definition: z.record(z.string(), z.unknown()),
+	description: z.string().nullable().optional()
+}).loose();
+const MeasureUpdateInput = z.object({
+	name: z.string().min(1).optional(),
+	definition: z.record(z.string(), z.unknown()).optional(),
+	revision_message: z.string().min(1),
+	archived: z.boolean().optional(),
+	description: z.string().nullable().optional()
+}).loose();
+
+//#endregion
+export { Measure, MeasureCompact, MeasureCreateInput, MeasureUpdateInput, measureView };

package/dist/measure-C7SbdYQk.mjs

@@ -0,0 +1,19 @@
+import { defineCommand } from "citty";
+
+//#region src/commands/measure/index.ts
+var measure_default = defineCommand({
+	meta: {
+		name: "measure",
+		description: "Inspect Metabase measures"
+	},
+	subCommands: {
+		list: () => import("./list-DAZP-IM5.mjs").then((mod) => mod.default),
+		get: () => import("./get-bYc7eGYe.mjs").then((mod) => mod.default),
+		create: () => import("./create-Cbh1cGj9.mjs").then((mod) => mod.default),
+		update: () => import("./update-1Di9hbPo.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-Cq4WKmJt.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { measure_default as default };

package/dist/metadata-B2Td415K.mjs

@@ -0,0 +1,38 @@
+import "./package-DV6Asqim.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { renderItem } from "./render-DXv-D6fU.mjs";
+import "./predicates-DiIiS3k7.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-cwBS8wwK.mjs";
+import { parseId } from "./parse-id-B38zTlYs.mjs";
+import "./field-B3gvaqpK.mjs";
+import "./table-B-PYcgGb.mjs";
+import { Database, databaseView } from "./database-vvig8k4x.mjs";
+
+//#region src/commands/db/metadata.ts
+var metadata_default = defineMetabaseCommand({
+	meta: {
+		name: "metadata",
+		description: "Get a database with its tables and fields hydrated"
+	},
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		id: {
+			type: "positional",
+			description: "Database id",
+			required: true
+		}
+	},
+	outputSchema: Database,
+	examples: ["metabase db metadata 1", "metabase db metadata 1 --json"],
+	async run({ args, ctx, getClient }) {
+		const id = parseId(args.id);
+		const client = await getClient();
+		const database = await client.requestParsed(Database, `/api/database/${id}/metadata`);
+		renderItem(database, databaseView, ctx);
+	}
+});
+
+//#endregion
+export { metadata_default as default };

package/dist/metadata-BTJAFVvZ.mjs

@@ -0,0 +1,37 @@
+import "./package-DV6Asqim.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { renderItem } from "./render-DXv-D6fU.mjs";
+import "./predicates-DiIiS3k7.mjs";
+import { connectionFlags, defineMetabaseCommand, outputFlags, profileFlag } from "./runtime-cwBS8wwK.mjs";
+import { parseId } from "./parse-id-B38zTlYs.mjs";
+import "./field-B3gvaqpK.mjs";
+import { TableQueryMetadata, tableView } from "./table-B-PYcgGb.mjs";
+
+//#region src/commands/table/metadata.ts
+var metadata_default = defineMetabaseCommand({
+	meta: {
+		name: "metadata",
+		description: "Get a table with its fields, FKs, and dimensions hydrated"
+	},
+	args: {
+		...outputFlags,
+		...profileFlag,
+		...connectionFlags,
+		id: {
+			type: "positional",
+			description: "Table id",
+			required: true
+		}
+	},
+	outputSchema: TableQueryMetadata,
+	examples: ["metabase table metadata 42", "metabase table metadata 42 --json"],
+	async run({ args, ctx, getClient }) {
+		const id = parseId(args.id);
+		const client = await getClient();
+		const table = await client.requestParsed(TableQueryMetadata, `/api/table/${id}/query_metadata`);
+		renderItem(table, tableView, ctx);
+	}
+});
+
+//#endregion
+export { metadata_default as default };

package/dist/{package-BGfw4ZWJ.mjs → package-DV6Asqim.mjs}

@@ -1,6 +1,6 @@
 //#region package.json
 var name = "@metabase/cli";
-var version = "0.1.0";
+var version = "0.1.2";
 var description = "Metabase CLI";
 var license = "AGPL-3.0";
 var repository = {
@@ -31,19 +31,25 @@ var scripts = {
 	"lint:fix": "oxlint --fix",
 	"format": "oxfmt",
 	"format:check": "oxfmt --check",
+	"sync:representations": "bun run scripts/sync-representations.ts",
 	"prepublishOnly": "tsdown && publint"
 };
 var 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"
 };
 var 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/paginate-CTSfuYiF.mjs

@@ -0,0 +1,49 @@
+import { z } from "zod";
+
+//#region src/runtime/paginate.ts
+const DEFAULT_PAGE_SIZE = 50;
+async function* paginate(client, path, itemSchema, opts = {}) {
+	const envelopeSchema = paginatedEnvelopeSchema(itemSchema);
+	const pageSize = opts.pageSize ?? DEFAULT_PAGE_SIZE;
+	const baseQuery = opts.query ?? {};
+	const cap = opts.max;
+	let offset = 0;
+	let yielded = 0;
+	while (true) {
+		const remaining = cap === void 0 ? Number.POSITIVE_INFINITY : cap - yielded;
+		if (remaining <= 0) return;
+		const requested = Math.min(pageSize, remaining);
+		const envelope = await client.requestParsed(envelopeSchema, path, {
+			query: {
+				...baseQuery,
+				limit: requested,
+				offset
+			},
+			...opts.signal !== void 0 && { signal: opts.signal }
+		});
+		for (const item of envelope.data) {
+			yield item;
+			yielded += 1;
+			if (cap !== void 0 && yielded >= cap) return;
+		}
+		if (envelope.data.length < requested) return;
+		if (envelope.total !== void 0 && envelope.total !== null && offset + envelope.data.length >= envelope.total) return;
+		offset += envelope.data.length;
+	}
+}
+async function collectPaginated(client, path, itemSchema, opts = {}) {
+	const items = [];
+	for await (const item of paginate(client, path, itemSchema, opts)) items.push(item);
+	return items;
+}
+function paginatedEnvelopeSchema(itemSchema) {
+	return z.object({
+		data: z.array(itemSchema),
+		total: z.number().int().nonnegative().nullable().optional(),
+		limit: z.number().int().nonnegative().optional(),
+		offset: z.number().int().nonnegative().optional()
+	}).passthrough();
+}
+
+//#endregion
+export { collectPaginated };

package/dist/parse-id-B38zTlYs.mjs

@@ -0,0 +1,12 @@
+import { parseInteger } from "./runtime-cwBS8wwK.mjs";
+
+//#region src/commands/parse-id.ts
+function parseId(value, name = "id") {
+	return parseInteger(value, {
+		name,
+		min: 1
+	});
+}
+
+//#endregion
+export { parseId };