@genz-its/sevdesk-cli 0.0.0

package/dist/index.js

@@ -0,0 +1,1794 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+import { ZliError, defineCommand, defineConfig, defineOptions, processConfig } from "@robingenz/zli";
+import { consola } from "consola";
+import { z } from "zod";
+import { SevDesk, SevDeskError } from "@genz-its/sevdesk-sdk";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, join, resolve } from "node:path";
+//#region src/config.ts
+function configDir() {
+	const xdgConfigHome = process.env["XDG_CONFIG_HOME"];
+	const base = xdgConfigHome ? xdgConfigHome : join(homedir(), ".config");
+	return join(base, "sevdesk");
+}
+function configPath() {
+	return join(configDir(), "config.json");
+}
+async function readConfig() {
+	try {
+		return JSON.parse(await readFile(configPath(), "utf8"));
+	} catch {
+		return {};
+	}
+}
+async function writeConfig(config) {
+	await mkdir(configDir(), { recursive: true });
+	await writeFile(configPath(), `${JSON.stringify(config, null, 2)}\n`, { mode: 384 });
+}
+async function resolveToken() {
+	const environmentToken = process.env["SEVDESK_TOKEN"]?.trim();
+	if (environmentToken) return {
+		token: environmentToken,
+		source: "environment"
+	};
+	const configToken = (await readConfig()).token?.trim();
+	if (configToken) return {
+		token: configToken,
+		source: "config"
+	};
+	return { source: "none" };
+}
+//#endregion
+//#region src/package.ts
+const pkg = createRequire(import.meta.url)("../package.json");
+//#endregion
+//#region src/client.ts
+function createClient(token) {
+	return new SevDesk({
+		token,
+		userAgent: `${pkg.name}/${pkg.version}`
+	});
+}
+/**
+* Resolves the API token and returns a ready-to-use client. Exits with an
+* explanation when no token is available.
+*/
+async function requireClient() {
+	const { token } = await resolveToken();
+	if (!token) {
+		consola.error("You must be logged in. Run `sevdesk login` or set the SEVDESK_TOKEN environment variable.");
+		process.exit(1);
+	}
+	return createClient(token);
+}
+//#endregion
+//#region src/interactive.ts
+function isInteractive() {
+	return process.stdin.isTTY === true && process.stdout.isTTY === true && !process.env["CI"];
+}
+//#endregion
+//#region src/prompt.ts
+async function promptText(message) {
+	const response = await consola.prompt(message, {
+		type: "text",
+		cancel: "symbol"
+	});
+	if (typeof response === "symbol") process.exit(0);
+	return response;
+}
+async function promptConfirm(message, initial = true) {
+	const response = await consola.prompt(message, {
+		type: "confirm",
+		initial,
+		cancel: "symbol"
+	});
+	if (typeof response === "symbol") process.exit(0);
+	return response;
+}
+//#endregion
+//#region src/options.ts
+/**
+* Returns the option value, asking for it when it is missing. Exits when the
+* value is missing in a non-interactive environment.
+*/
+async function requireStringOption(options) {
+	const value = options.value?.trim();
+	if (value) return value;
+	requireInteractive(options.requirement);
+	const answer = (await promptText(options.question)).trim();
+	if (!answer) {
+		consola.error("The value must not be empty.");
+		process.exit(1);
+	}
+	return answer;
+}
+/**
+* Returns the option value, asking for it when it is missing. Exits when the
+* value is missing in a non-interactive environment or is not a number.
+*/
+async function requireNumberOption(options) {
+	if (options.value !== void 0) return options.value;
+	requireInteractive(options.requirement);
+	const answer = (await promptText(options.question)).trim();
+	const value = Number(answer);
+	if (!answer || !Number.isFinite(value)) {
+		consola.error("The value must be a number.");
+		process.exit(1);
+	}
+	return value;
+}
+/**
+* Asks for confirmation unless `yes` is set. Returns `false` when the user
+* declines, in which case the command must stop. Exits when the confirmation
+* is missing in a non-interactive environment.
+*/
+async function confirmOrAbort(options) {
+	if (options.yes) return true;
+	if (!isInteractive()) {
+		consola.error("You must pass --yes to confirm this action when running in a non-interactive environment.");
+		process.exit(1);
+	}
+	const confirmed = options.initial === void 0 ? await promptConfirm(options.message) : await promptConfirm(options.message, options.initial);
+	if (!confirmed) consola.info("Aborted.");
+	return confirmed;
+}
+function requireInteractive(requirement) {
+	if (!isInteractive()) {
+		consola.error(`You must provide ${requirement} when running in a non-interactive environment.`);
+		process.exit(1);
+	}
+}
+//#endregion
+//#region src/output.ts
+function printJson(value) {
+	console.log(JSON.stringify(value, null, 2));
+}
+function printTable(rows) {
+	const first = rows[0];
+	if (!first) return;
+	const columns = Object.keys(first);
+	const widths = columns.map((column) => Math.max(column.length, ...rows.map((row) => (row[column] ?? "").length)));
+	const line = (values) => values.map((value, index) => value.padEnd(widths[index] ?? 0)).join("  ");
+	console.log(line(columns.map((column) => column.toUpperCase())));
+	for (const row of rows) console.log(line(columns.map((column) => row[column] ?? "")));
+}
+//#endregion
+//#region src/commands/accounts/balance.ts
+var balance_default = defineCommand({
+	description: "Show the balance of a check account at a given date.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("The check account ID. If omitted, you will be prompted."),
+		date: z.string().default(() => (/* @__PURE__ */ new Date()).toISOString().slice(0, 10)).describe("The date to calculate the balance for (YYYY-MM-DD)."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const checkAccountId = await requireNumberOption({
+			value: options.id,
+			requirement: "a check account ID via --id",
+			question: "Enter the check account ID:"
+		});
+		const balance = await client.checkAccounts.getBalanceAtDate({
+			checkAccountId,
+			date: options.date
+		});
+		if (options.json) {
+			printJson({
+				checkAccountId,
+				date: options.date,
+				balance
+			});
+			return;
+		}
+		consola.info(`Balance at ${options.date}: ${balance}`);
+	}
+});
+//#endregion
+//#region src/commands/accounts/create-clearing.ts
+var create_clearing_default = defineCommand({
+	description: "Create a clearing check account.",
+	options: defineOptions(z.object({
+		name: z.string().optional().describe("The name of the check account. If omitted, you will be prompted."),
+		accountingNumber: z.coerce.number().optional().describe("The booking account number of the check account."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const name = await requireStringOption({
+			value: options.name,
+			requirement: "a name via --name",
+			question: "Enter the name of the check account:"
+		});
+		const checkAccount = await client.checkAccounts.createClearingAccount({
+			name,
+			accountingNumber: options.accountingNumber
+		});
+		if (options.json) {
+			printJson(checkAccount);
+			return;
+		}
+		consola.success(`Created clearing account ${checkAccount.id}.`);
+	}
+});
+//#endregion
+//#region src/commands/accounts/create-file-import.ts
+var create_file_import_default = defineCommand({
+	description: "Create a check account that imports its transactions from files.",
+	options: defineOptions(z.object({
+		name: z.string().optional().describe("The name of the check account. If omitted, you will be prompted."),
+		importType: z.enum(["CSV", "MT940"]).default("CSV").describe("The file format used to import transactions. Supported values are CSV and MT940."),
+		accountingNumber: z.coerce.number().optional().describe("The booking account number of the check account."),
+		iban: z.string().optional().describe("The IBAN of the check account."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const name = await requireStringOption({
+			value: options.name,
+			requirement: "a name via --name",
+			question: "Enter the name of the check account:"
+		});
+		const checkAccount = await client.checkAccounts.createFileImportAccount({
+			name,
+			importType: options.importType,
+			accountingNumber: options.accountingNumber,
+			iban: options.iban
+		});
+		if (options.json) {
+			printJson(checkAccount);
+			return;
+		}
+		consola.success(`Created file import account ${checkAccount.id}.`);
+	}
+});
+//#endregion
+//#region src/commands/accounts/get.ts
+var get_default$7 = defineCommand({
+	description: "Show a single check account.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("The check account ID. If omitted, you will be prompted."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const checkAccountId = await requireNumberOption({
+			value: options.id,
+			requirement: "a check account ID via --id",
+			question: "Enter the check account ID:"
+		});
+		const checkAccount = await client.checkAccounts.get({ checkAccountId });
+		if (options.json) {
+			printJson(checkAccount);
+			return;
+		}
+		consola.info(`ID: ${checkAccount.id}`);
+		consola.info(`Name: ${checkAccount.name}`);
+		consola.info(`Type: ${checkAccount.type}`);
+		consola.info(`Import type: ${checkAccount.importType ?? "-"}`);
+		consola.info(`IBAN: ${checkAccount.iban ?? "-"}`);
+		consola.info(`Accounting number: ${checkAccount.accountingNumber ?? "-"}`);
+		consola.info(`Currency: ${checkAccount.currency}`);
+		consola.info(`Balance: ${checkAccount.balance ?? "-"}`);
+		consola.info(`Status: ${checkAccount.status}`);
+	}
+});
+//#endregion
+//#region src/commands/accounts/list.ts
+var list_default$8 = defineCommand({
+	description: "List your check accounts.",
+	options: defineOptions(z.object({
+		limit: z.coerce.number().optional().describe("The maximum number of check accounts to return."),
+		offset: z.coerce.number().optional().describe("The number of check accounts to skip."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const checkAccounts = await (await requireClient()).checkAccounts.list({
+			limit: options.limit,
+			offset: options.offset
+		});
+		if (options.json) {
+			printJson(checkAccounts);
+			return;
+		}
+		if (checkAccounts.length === 0) {
+			consola.info("No check accounts found.");
+			return;
+		}
+		printTable(checkAccounts.map((checkAccount) => ({
+			id: checkAccount.id,
+			name: checkAccount.name,
+			type: checkAccount.type,
+			importType: checkAccount.importType ?? "",
+			accountingNumber: checkAccount.accountingNumber ?? "",
+			currency: checkAccount.currency,
+			status: checkAccount.status
+		})));
+	}
+});
+//#endregion
+//#region src/commands/contacts/create.ts
+var create_default$3 = defineCommand({
+	description: "Create a contact.",
+	options: defineOptions(z.object({
+		name: z.string().optional().describe("Name of the organization. Not to be used for persons. If both --name and --familyname are omitted, you will be prompted for the organization name."),
+		surename: z.string().optional().describe("First name of the person. Not to be used for organizations."),
+		familyname: z.string().optional().describe("Last name of the person. Not to be used for organizations."),
+		category: z.coerce.number().default(3).describe("ID of the contact category: 2 supplier, 3 customer, 4 partner."),
+		customerNumber: z.string().optional().describe("Customer number of the contact."),
+		description: z.string().optional().describe("Description of the contact."),
+		vatNumber: z.string().optional().describe("VAT number of the contact."),
+		taxNumber: z.string().optional().describe("Tax number of the contact."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const name = !options.name && !options.familyname ? await requireStringOption({
+			value: void 0,
+			requirement: "a name via --name or --familyname",
+			question: "Enter the organization name:"
+		}) : options.name;
+		const contact = await client.contacts.create({
+			categoryId: options.category,
+			name,
+			surename: options.surename,
+			familyname: options.familyname,
+			customerNumber: options.customerNumber,
+			description: options.description,
+			vatNumber: options.vatNumber,
+			taxNumber: options.taxNumber
+		});
+		if (options.json) {
+			printJson(contact);
+			return;
+		}
+		consola.success(`Created contact ${contact.id}.`);
+	}
+});
+//#endregion
+//#region src/commands/contacts/delete.ts
+var delete_default$1 = defineCommand({
+	description: "Delete a contact.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("The contact ID. If omitted, you will be prompted."),
+		yes: z.boolean().default(false).describe("Skip the confirmation prompt."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const contactId = await requireNumberOption({
+			value: options.id,
+			requirement: "a contact ID via --id",
+			question: "Enter the contact ID:"
+		});
+		if (!await confirmOrAbort({
+			message: `Delete contact ${contactId}?`,
+			yes: options.yes,
+			initial: false
+		})) return;
+		await client.contacts.delete({ contactId });
+		if (options.json) {
+			printJson({ deleted: true });
+			return;
+		}
+		consola.success("Contact deleted.");
+	}
+});
+//#endregion
+//#region src/commands/contacts/get.ts
+var get_default$6 = defineCommand({
+	description: "Show a single contact.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("The contact ID. If omitted, you will be prompted."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const contactId = await requireNumberOption({
+			value: options.id,
+			requirement: "a contact ID via --id",
+			question: "Enter the contact ID:"
+		});
+		const contact = await client.contacts.get({ contactId });
+		if (options.json) {
+			printJson(contact);
+			return;
+		}
+		consola.info(`ID: ${contact.id}`);
+		consola.info(`Name: ${contact.name ?? "-"}`);
+		consola.info(`First name: ${contact.surename ?? "-"}`);
+		consola.info(`Last name: ${contact.familyname ?? "-"}`);
+		consola.info(`Customer number: ${contact.customerNumber ?? "-"}`);
+		consola.info(`Category: ${contact.category.id}`);
+		consola.info(`Status: ${contact.status ?? "-"}`);
+		consola.info(`Description: ${contact.description ?? "-"}`);
+		consola.info(`VAT number: ${contact.vatNumber ?? "-"}`);
+		consola.info(`Tax number: ${contact.taxNumber ?? "-"}`);
+	}
+});
+//#endregion
+//#region src/commands/contacts/list.ts
+var list_default$7 = defineCommand({
+	description: "List contacts.",
+	options: defineOptions(z.object({
+		name: z.string().optional().describe("Filter by organization, first or last name."),
+		customerNumber: z.string().optional().describe("Filter by customer number."),
+		limit: z.coerce.number().optional().describe("Maximum number of contacts to return."),
+		offset: z.coerce.number().optional().describe("Number of contacts to skip."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const contacts = await (await requireClient()).contacts.list({
+			name: options.name,
+			customerNumber: options.customerNumber,
+			limit: options.limit,
+			offset: options.offset
+		});
+		if (options.json) {
+			printJson(contacts);
+			return;
+		}
+		if (contacts.length === 0) {
+			consola.info("No contacts found.");
+			return;
+		}
+		printTable(contacts.map((contact) => ({
+			id: contact.id,
+			number: contact.customerNumber ?? "",
+			name: formatContactName(contact),
+			status: contact.status ?? "",
+			category: contact.category.id
+		})));
+	}
+});
+function formatContactName(contact) {
+	return contact.name ?? [contact.surename, contact.familyname].filter(Boolean).join(" ");
+}
+//#endregion
+//#region src/commands/contacts/update.ts
+var update_default = defineCommand({
+	description: "Update a contact.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("The contact ID. If omitted, you will be prompted."),
+		name: z.string().optional().describe("Name of the organization. Not to be used for persons."),
+		surename: z.string().optional().describe("First name of the person. Not to be used for organizations."),
+		familyname: z.string().optional().describe("Last name of the person. Not to be used for organizations."),
+		category: z.coerce.number().optional().describe("ID of the contact category: 2 supplier, 3 customer, 4 partner."),
+		customerNumber: z.string().optional().describe("Customer number of the contact."),
+		description: z.string().optional().describe("Description of the contact."),
+		vatNumber: z.string().optional().describe("VAT number of the contact."),
+		taxNumber: z.string().optional().describe("Tax number of the contact."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const contactId = await requireNumberOption({
+			value: options.id,
+			requirement: "a contact ID via --id",
+			question: "Enter the contact ID:"
+		});
+		const contact = await client.contacts.update({
+			contactId,
+			categoryId: options.category,
+			name: options.name,
+			surename: options.surename,
+			familyname: options.familyname,
+			customerNumber: options.customerNumber,
+			description: options.description,
+			vatNumber: options.vatNumber,
+			taxNumber: options.taxNumber
+		});
+		if (options.json) {
+			printJson(contact);
+			return;
+		}
+		consola.success(`Updated contact ${contact.id}.`);
+	}
+});
+//#endregion
+//#region src/commands/credit-notes/get.ts
+var get_default$5 = defineCommand({
+	description: "Show a single credit note.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("ID of the credit note. If omitted, you will be prompted."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const creditNoteId = await requireNumberOption({
+			value: options.id,
+			requirement: "a credit note ID via --id",
+			question: "Enter the credit note ID:"
+		});
+		const creditNote = await client.creditNotes.get({ creditNoteId });
+		if (options.json) {
+			printJson(creditNote);
+			return;
+		}
+		consola.info(`ID: ${creditNote.id}`);
+		consola.info(`Number: ${creditNote.creditNoteNumber ?? "-"}`);
+		consola.info(`Date: ${creditNote.creditNoteDate}`);
+		consola.info(`Status: ${creditNote.status}`);
+		consola.info(`Contact: ${creditNote.contact?.id ?? "-"}`);
+		consola.info(`Net: ${creditNote.sumNet}`);
+		consola.info(`Tax: ${creditNote.sumTax}`);
+		consola.info(`Gross: ${creditNote.sumGross}`);
+		consola.info(`Currency: ${creditNote.currency ?? "-"}`);
+	}
+});
+//#endregion
+//#region src/commands/credit-notes/list.ts
+var list_default$6 = defineCommand({
+	description: "List credit notes.",
+	options: defineOptions(z.object({
+		status: z.coerce.number().optional().describe("Filter by status: 100 draft, 200 open, 750 partially paid, 1000 paid."),
+		creditNoteNumber: z.string().optional().describe("Filter by credit note number."),
+		startDate: z.string().optional().describe("Only credit notes on or after this date as dd.mm.yyyy or Unix timestamp."),
+		endDate: z.string().optional().describe("Only credit notes on or before this date as dd.mm.yyyy or Unix timestamp."),
+		contact: z.coerce.number().optional().describe("ID of the contact whose credit notes to list."),
+		limit: z.coerce.number().optional().describe("Maximum number of credit notes to return."),
+		offset: z.coerce.number().optional().describe("Number of credit notes to skip."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const creditNotes = await (await requireClient()).creditNotes.list({
+			status: options.status,
+			creditNoteNumber: options.creditNoteNumber,
+			startDate: options.startDate,
+			endDate: options.endDate,
+			contactId: options.contact,
+			limit: options.limit,
+			offset: options.offset
+		});
+		if (options.json) {
+			printJson(creditNotes);
+			return;
+		}
+		if (creditNotes.length === 0) {
+			consola.info("No credit notes found.");
+			return;
+		}
+		printTable(creditNotes.map((creditNote) => ({
+			id: creditNote.id,
+			number: creditNote.creditNoteNumber ?? "",
+			date: creditNote.creditNoteDate,
+			contact: creditNote.contact?.id ?? "",
+			gross: creditNote.sumGross,
+			status: creditNote.status
+		})));
+	}
+});
+//#endregion
+//#region src/commands/credit-notes/pdf.ts
+var pdf_default$2 = defineCommand({
+	description: "Download the PDF of a credit note.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("ID of the credit note. If omitted, you will be prompted."),
+		output: z.string().optional().describe("Path to write the PDF to. Defaults to the file name reported by the API."),
+		preventSendBy: z.boolean().default(false).describe("Do not mark the credit note as sent by download."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const creditNoteId = await requireNumberOption({
+			value: options.id,
+			requirement: "a credit note ID via --id",
+			question: "Enter the credit note ID:"
+		});
+		const pdf = await client.creditNotes.getPdf({
+			creditNoteId,
+			preventSendBy: options.preventSendBy
+		});
+		const path = resolve(options.output ?? pdf.filename);
+		await writeFile(path, Buffer.from(pdf.content, "base64"));
+		if (options.json) {
+			printJson({
+				filename: pdf.filename,
+				path
+			});
+			return;
+		}
+		consola.success(`Saved ${path}.`);
+	}
+});
+//#endregion
+//#region src/errors.ts
+function formatError(error) {
+	if (error instanceof ZliError) return error.message;
+	if (error instanceof z.ZodError) return error.issues.map((issue) => `${issue.path.join(".") || "input"}: ${issue.message}`).join("\n");
+	if (error instanceof SevDeskError) {
+		if (error.status === 401) return "Authentication failed. Check your API token or run `sevdesk login` again.";
+		return error.message;
+	}
+	return error instanceof Error ? error.message : String(error);
+}
+//#endregion
+//#region src/commands/doctor.ts
+var doctor_default = defineCommand({
+	description: "Check the CLI setup and the connection to the sevdesk API.",
+	options: defineOptions(z.object({ json: z.boolean().default(false).describe("Output in JSON format.") })),
+	action: async (options) => {
+		const { token, source } = await resolveToken();
+		let bookkeepingSystemVersion;
+		let apiError;
+		if (token) try {
+			bookkeepingSystemVersion = await createClient(token).basics.getBookkeepingSystemVersion();
+		} catch (error) {
+			apiError = formatError(error);
+		}
+		if (options.json) printJson({
+			cliVersion: pkg.version,
+			nodeVersion: process.version,
+			tokenSource: source,
+			bookkeepingSystemVersion: bookkeepingSystemVersion ?? null,
+			apiError: apiError ?? null
+		});
+		else {
+			consola.info(`CLI version: ${pkg.version}`);
+			consola.info(`Node.js version: ${process.version}`);
+			consola.info(`Token source: ${source}`);
+			if (!token) consola.warn("No API token found. Run `sevdesk login` or set the SEVDESK_TOKEN environment variable.");
+			else if (apiError) consola.error(`API connection failed: ${apiError}`);
+			else consola.success(`API connection succeeded. Bookkeeping system version: ${bookkeepingSystemVersion}`);
+		}
+		if (bookkeepingSystemVersion === "1.0") {
+			consola.warn("This sevdesk account still uses bookkeeping system version 1.0, which is not supported.");
+			process.exitCode = 1;
+		} else if (!token || apiError) process.exitCode = 1;
+	}
+});
+//#endregion
+//#region src/commands/export/contacts.ts
+var contacts_default = defineCommand({
+	description: "Export contacts as a CSV file.",
+	options: defineOptions(z.object({
+		output: z.string().optional().describe("Path to write the CSV file to. Defaults to the filename of the export."),
+		limit: z.coerce.number().optional().describe("The maximum number of contacts to export."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const file = await (await requireClient()).exports.exportContactsCsv({ limit: options.limit });
+		const path = options.output ?? file.filename;
+		await writeFile(path, file.base64Encoded ? Buffer.from(file.content, "base64") : file.content);
+		if (options.json) {
+			printJson({
+				filename: file.filename,
+				path
+			});
+			return;
+		}
+		consola.success(`Saved ${path}.`);
+	}
+});
+//#endregion
+//#region src/commands/export/datev.ts
+const POLL_INTERVAL = 3e3;
+var datev_default = defineCommand({
+	description: "Export accounting data in the DATEV format as a ZIP archive.",
+	options: defineOptions(z.object({
+		startDate: z.string().optional().describe("Start of the export period as dd.mm.yyyy or Unix timestamp. If omitted, you will be prompted."),
+		endDate: z.string().optional().describe("End of the export period as dd.mm.yyyy or Unix timestamp. If omitted, you will be prompted."),
+		format: z.enum(["csv", "xml"]).default("csv").describe("The DATEV export format. Supported values are csv and xml."),
+		scope: z.string().default("EXTCD").describe("The models to include as a string of letters: E (earnings), X (expenditure), T (transactions), C (cash register) and D (assets). XML exports support only E and X."),
+		output: z.string().optional().describe("Path to write the ZIP archive to. Defaults to the filename of the export."),
+		timeout: z.coerce.number().default(300).describe("Maximum number of seconds to wait for the export job."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const jobOptions = {
+			startDate: await requireStringOption({
+				value: options.startDate,
+				requirement: "a start date via --start-date",
+				question: "Enter the start date (dd.mm.yyyy):"
+			}),
+			endDate: await requireStringOption({
+				value: options.endDate,
+				requirement: "an end date via --end-date",
+				question: "Enter the end date (dd.mm.yyyy):"
+			}),
+			scope: options.scope
+		};
+		const jobId = options.format === "csv" ? await client.exports.createDatevCsvZipExportJob(jobOptions) : await client.exports.createDatevXmlZipExportJob(jobOptions);
+		if (!options.json) consola.start("Waiting for the export job to finish...");
+		const info = await waitForDownloadInfo(client, jobId, options.timeout);
+		if (!info) {
+			consola.error(`The export job did not finish within ${options.timeout} seconds.`);
+			process.exit(1);
+		}
+		const response = await fetch(info.link);
+		if (!response.ok) {
+			consola.error(`The export file could not be downloaded (status ${response.status}).`);
+			process.exit(1);
+		}
+		const path = options.output ?? info.filename;
+		await writeFile(path, new Uint8Array(await response.arrayBuffer()));
+		if (options.json) {
+			printJson({
+				jobId,
+				filename: info.filename,
+				path
+			});
+			return;
+		}
+		consola.success(`Saved ${path}.`);
+	}
+});
+async function waitForDownloadInfo(client, jobId, timeoutSeconds) {
+	const deadline = Date.now() + timeoutSeconds * 1e3;
+	while (Date.now() < deadline) {
+		const info = await getDownloadInfo(client, jobId);
+		if (info) return info;
+		await delay(POLL_INTERVAL);
+	}
+}
+async function getDownloadInfo(client, jobId) {
+	try {
+		const [info] = await client.exports.getJobDownloadInfo({ jobId });
+		return info?.link ? info : void 0;
+	} catch (error) {
+		if (error instanceof SevDeskError) return;
+		throw error;
+	}
+}
+function delay(milliseconds) {
+	return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+//#endregion
+//#region src/commands/export/invoices.ts
+var invoices_default = defineCommand({
+	description: "Export invoices as a CSV file.",
+	options: defineOptions(z.object({
+		output: z.string().optional().describe("Path to write the CSV file to. Defaults to the filename of the export."),
+		limit: z.coerce.number().optional().describe("The maximum number of invoices to export."),
+		startDate: z.string().optional().describe("Only export invoices on or after this date (ISO 8601)."),
+		endDate: z.string().optional().describe("Only export invoices on or before this date (ISO 8601)."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const file = await (await requireClient()).exports.exportInvoicesCsv({
+			limit: options.limit,
+			filter: {
+				startDate: options.startDate,
+				endDate: options.endDate
+			}
+		});
+		const path = options.output ?? file.filename;
+		await writeFile(path, file.base64Encoded ? Buffer.from(file.content, "base64") : file.content);
+		if (options.json) {
+			printJson({
+				filename: file.filename,
+				path
+			});
+			return;
+		}
+		consola.success(`Saved ${path}.`);
+	}
+});
+//#endregion
+//#region src/commands/export/transactions.ts
+var transactions_default = defineCommand({
+	description: "Export transactions as a CSV file.",
+	options: defineOptions(z.object({
+		output: z.string().optional().describe("Path to write the CSV file to. Defaults to the filename of the export."),
+		limit: z.coerce.number().optional().describe("The maximum number of transactions to export."),
+		startDate: z.string().optional().describe("Only export transactions on or after this date (ISO 8601)."),
+		endDate: z.string().optional().describe("Only export transactions on or before this date (ISO 8601)."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const file = await (await requireClient()).exports.exportTransactionsCsv({
+			limit: options.limit,
+			filter: {
+				startDate: options.startDate,
+				endDate: options.endDate
+			}
+		});
+		const path = options.output ?? file.filename;
+		await writeFile(path, file.base64Encoded ? Buffer.from(file.content, "base64") : file.content);
+		if (options.json) {
+			printJson({
+				filename: file.filename,
+				path
+			});
+			return;
+		}
+		consola.success(`Saved ${path}.`);
+	}
+});
+//#endregion
+//#region src/commands/export/vouchers.ts
+var vouchers_default = defineCommand({
+	description: "Export vouchers as a CSV file.",
+	options: defineOptions(z.object({
+		output: z.string().optional().describe("Path to write the CSV file to. Defaults to the filename of the export."),
+		limit: z.coerce.number().optional().describe("The maximum number of vouchers to export."),
+		startDate: z.string().optional().describe("Only export vouchers on or after this date (ISO 8601)."),
+		endDate: z.string().optional().describe("Only export vouchers on or before this date (ISO 8601)."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const file = await (await requireClient()).exports.exportVouchersCsv({
+			limit: options.limit,
+			filter: {
+				startDate: options.startDate,
+				endDate: options.endDate
+			}
+		});
+		const path = options.output ?? file.filename;
+		await writeFile(path, file.base64Encoded ? Buffer.from(file.content, "base64") : file.content);
+		if (options.json) {
+			printJson({
+				filename: file.filename,
+				path
+			});
+			return;
+		}
+		consola.success(`Saved ${path}.`);
+	}
+});
+//#endregion
+//#region src/commands/guidance/accounts.ts
+const MAX_TAX_RULES = 3;
+function formatTaxRules(taxRules) {
+	const names = taxRules.map((taxRule) => taxRule.name);
+	if (names.length > MAX_TAX_RULES) return `${names.slice(0, MAX_TAX_RULES).join(", ")}, …`;
+	return names.join(", ");
+}
+var accounts_default = defineCommand({
+	description: "List bookable accounts and their allowed tax rules. The first matching filter wins: --account-number, --tax-rule, --revenue, --expense. Without a filter, all accounts are listed.",
+	options: defineOptions(z.object({
+		accountNumber: z.string().optional().describe("Only show the account with this datev account number."),
+		taxRule: z.string().optional().describe("Tax rule name, for example USTPFL_UMS_EINN."),
+		revenue: z.boolean().default(false).describe("Only show accounts that can be used for revenue."),
+		expense: z.boolean().default(false).describe("Only show accounts that can be used for expenses."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		let guides;
+		if (options.accountNumber) guides = await client.receiptGuidance.forAccountNumber({ accountNumber: options.accountNumber });
+		else if (options.taxRule) guides = await client.receiptGuidance.forTaxRule({ taxRule: options.taxRule });
+		else if (options.revenue) guides = await client.receiptGuidance.forRevenue();
+		else if (options.expense) guides = await client.receiptGuidance.forExpense();
+		else guides = await client.receiptGuidance.forAllAccounts();
+		if (options.json) {
+			printJson(guides);
+			return;
+		}
+		if (guides.length === 0) {
+			consola.info("No accounts found.");
+			return;
+		}
+		printTable(guides.map((guide) => ({
+			id: String(guide.accountDatevId),
+			number: guide.accountNumber,
+			name: guide.accountName,
+			taxRules: formatTaxRules(guide.allowedTaxRules)
+		})));
+	}
+});
+//#endregion
+//#region src/commands/invoices/get.ts
+var get_default$4 = defineCommand({
+	description: "Show a single invoice.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("ID of the invoice. If omitted, you will be prompted."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const invoiceId = await requireNumberOption({
+			value: options.id,
+			requirement: "an invoice ID via --id",
+			question: "Enter the invoice ID:"
+		});
+		const invoice = await client.invoices.get({ invoiceId });
+		if (options.json) {
+			printJson(invoice);
+			return;
+		}
+		consola.info(`ID: ${invoice.id}`);
+		consola.info(`Number: ${invoice.invoiceNumber ?? "-"}`);
+		consola.info(`Date: ${invoice.invoiceDate}`);
+		consola.info(`Status: ${invoice.status}`);
+		consola.info(`Contact: ${invoice.contact?.id ?? "-"}`);
+		consola.info(`Net: ${invoice.sumNet}`);
+		consola.info(`Tax: ${invoice.sumTax}`);
+		consola.info(`Gross: ${invoice.sumGross}`);
+		consola.info(`Currency: ${invoice.currency}`);
+	}
+});
+//#endregion
+//#region src/commands/invoices/list.ts
+var list_default$5 = defineCommand({
+	description: "List invoices.",
+	options: defineOptions(z.object({
+		status: z.coerce.number().optional().describe("Filter by status: 50 deactivated recurring, 100 draft, 200 open, 750 partially paid, 1000 paid."),
+		invoiceNumber: z.string().optional().describe("Filter by invoice number."),
+		startDate: z.string().optional().describe("Only invoices on or after this date as dd.mm.yyyy or Unix timestamp."),
+		endDate: z.string().optional().describe("Only invoices on or before this date as dd.mm.yyyy or Unix timestamp."),
+		contact: z.coerce.number().optional().describe("ID of the contact whose invoices to list."),
+		limit: z.coerce.number().optional().describe("Maximum number of invoices to return."),
+		offset: z.coerce.number().optional().describe("Number of invoices to skip."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const invoices = await (await requireClient()).invoices.list({
+			status: options.status,
+			invoiceNumber: options.invoiceNumber,
+			startDate: options.startDate,
+			endDate: options.endDate,
+			contactId: options.contact,
+			limit: options.limit,
+			offset: options.offset
+		});
+		if (options.json) {
+			printJson(invoices);
+			return;
+		}
+		if (invoices.length === 0) {
+			consola.info("No invoices found.");
+			return;
+		}
+		printTable(invoices.map((invoice) => ({
+			id: invoice.id,
+			number: invoice.invoiceNumber ?? "",
+			date: invoice.invoiceDate,
+			contact: invoice.contact?.id ?? "",
+			gross: invoice.sumGross,
+			status: invoice.status
+		})));
+	}
+});
+//#endregion
+//#region src/commands/invoices/pdf.ts
+var pdf_default$1 = defineCommand({
+	description: "Download the PDF of an invoice.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("ID of the invoice. If omitted, you will be prompted."),
+		output: z.string().optional().describe("Path to write the PDF to. Defaults to the file name reported by the API."),
+		preventSendBy: z.boolean().default(false).describe("Do not mark the invoice as sent by download."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const invoiceId = await requireNumberOption({
+			value: options.id,
+			requirement: "an invoice ID via --id",
+			question: "Enter the invoice ID:"
+		});
+		const pdf = await client.invoices.getPdf({
+			invoiceId,
+			preventSendBy: options.preventSendBy
+		});
+		const path = resolve(options.output ?? pdf.filename);
+		await writeFile(path, Buffer.from(pdf.content, "base64"));
+		if (options.json) {
+			printJson({
+				filename: pdf.filename,
+				path
+			});
+			return;
+		}
+		consola.success(`Saved ${path}.`);
+	}
+});
+//#endregion
+//#region src/commands/login.ts
+var login_default = defineCommand({
+	description: "Log in with your sevdesk API token.",
+	options: defineOptions(z.object({ token: z.string().optional().describe("The sevdesk API token. If omitted, you will be prompted.") })),
+	action: async (options) => {
+		let token = options.token?.trim();
+		if (!token) {
+			if (!isInteractive()) {
+				consola.error("You must provide a token via --token when running in a non-interactive environment.");
+				process.exit(1);
+			}
+			consola.info("You can find your API token in sevdesk under Settings > User > API token.");
+			token = (await promptText("Enter your sevdesk API token:")).trim();
+		}
+		if (await createClient(token).basics.getBookkeepingSystemVersion() === "1.0") {
+			consola.error("This sevdesk account still uses bookkeeping system version 1.0, which is not supported. Please update your account to sevdesk-Update 2.0.");
+			process.exit(1);
+		}
+		await writeConfig({
+			...await readConfig(),
+			token
+		});
+		consola.success(`Logged in. Token stored in ${configPath()}.`);
+	}
+});
+//#endregion
+//#region src/commands/logout.ts
+var logout_default = defineCommand({
+	description: "Log out by removing the stored API token.",
+	action: async () => {
+		const { token, ...config } = await readConfig();
+		if (!token) consola.info("You are not logged in.");
+		else {
+			await writeConfig(config);
+			consola.success("Logged out.");
+		}
+		if (process.env["SEVDESK_TOKEN"]) consola.warn("The SEVDESK_TOKEN environment variable is still set and will be used for authentication.");
+	}
+});
+//#endregion
+//#region src/commands/orders/get.ts
+var get_default$3 = defineCommand({
+	description: "Show a single order.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("ID of the order. If omitted, you will be prompted."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const orderId = await requireNumberOption({
+			value: options.id,
+			requirement: "an order ID via --id",
+			question: "Enter the order ID:"
+		});
+		const order = await client.orders.get({ orderId });
+		if (options.json) {
+			printJson(order);
+			return;
+		}
+		consola.info(`ID: ${order.id}`);
+		consola.info(`Number: ${order.orderNumber}`);
+		consola.info(`Date: ${order.orderDate}`);
+		consola.info(`Status: ${order.status}`);
+		consola.info(`Contact: ${order.contact?.id ?? "-"}`);
+		consola.info(`Net: ${order.sumNet}`);
+		consola.info(`Tax: ${order.sumTax}`);
+		consola.info(`Gross: ${order.sumGross}`);
+		consola.info(`Currency: ${order.currency}`);
+	}
+});
+//#endregion
+//#region src/commands/orders/list.ts
+var list_default$4 = defineCommand({
+	description: "List orders.",
+	options: defineOptions(z.object({
+		status: z.coerce.number().optional().describe("Filter by status: 100 draft, 200 delivered, 300 rejected, 500 accepted, 750 partially calculated, 1000 calculated."),
+		orderNumber: z.string().optional().describe("Filter by order number."),
+		startDate: z.string().optional().describe("Only orders on or after this date as dd.mm.yyyy or Unix timestamp."),
+		endDate: z.string().optional().describe("Only orders on or before this date as dd.mm.yyyy or Unix timestamp."),
+		contact: z.coerce.number().optional().describe("ID of the contact whose orders to list."),
+		limit: z.coerce.number().optional().describe("Maximum number of orders to return."),
+		offset: z.coerce.number().optional().describe("Number of orders to skip."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const orders = await (await requireClient()).orders.list({
+			status: options.status,
+			orderNumber: options.orderNumber,
+			startDate: options.startDate,
+			endDate: options.endDate,
+			contactId: options.contact,
+			limit: options.limit,
+			offset: options.offset
+		});
+		if (options.json) {
+			printJson(orders);
+			return;
+		}
+		if (orders.length === 0) {
+			consola.info("No orders found.");
+			return;
+		}
+		printTable(orders.map((order) => ({
+			id: order.id,
+			number: order.orderNumber,
+			date: order.orderDate,
+			contact: order.contact?.id ?? "",
+			gross: order.sumGross,
+			status: order.status
+		})));
+	}
+});
+//#endregion
+//#region src/commands/orders/pdf.ts
+var pdf_default = defineCommand({
+	description: "Download the PDF of an order.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("ID of the order. If omitted, you will be prompted."),
+		output: z.string().optional().describe("Path to write the PDF to. Defaults to the file name reported by the API."),
+		preventSendBy: z.boolean().default(false).describe("Do not mark the order as sent by download."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const orderId = await requireNumberOption({
+			value: options.id,
+			requirement: "an order ID via --id",
+			question: "Enter the order ID:"
+		});
+		const pdf = await client.orders.getPdf({
+			orderId,
+			preventSendBy: options.preventSendBy
+		});
+		const path = resolve(options.output ?? pdf.filename);
+		await writeFile(path, Buffer.from(pdf.content, "base64"));
+		if (options.json) {
+			printJson({
+				filename: pdf.filename,
+				path
+			});
+			return;
+		}
+		consola.success(`Saved ${path}.`);
+	}
+});
+//#endregion
+//#region src/commands/parts/get.ts
+var get_default$2 = defineCommand({
+	description: "Show a single part.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("The part ID. If omitted, you will be prompted."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const partId = await requireNumberOption({
+			value: options.id,
+			requirement: "a part ID via --id",
+			question: "Enter the part ID:"
+		});
+		const part = await client.parts.get({ partId });
+		if (options.json) {
+			printJson(part);
+			return;
+		}
+		consola.info(`ID: ${part.id}`);
+		consola.info(`Part number: ${part.partNumber}`);
+		consola.info(`Name: ${part.name}`);
+		consola.info(`Text: ${part.text ?? "-"}`);
+		consola.info(`Price: ${part.price ?? "-"}`);
+		consola.info(`Price net: ${part.priceNet ?? "-"}`);
+		consola.info(`Price gross: ${part.priceGross ?? "-"}`);
+		consola.info(`Tax rate: ${part.taxRate}`);
+		consola.info(`Stock: ${part.stock}`);
+		consola.info(`Status: ${part.status ?? "-"}`);
+	}
+});
+//#endregion
+//#region src/commands/parts/list.ts
+var list_default$3 = defineCommand({
+	description: "List parts.",
+	options: defineOptions(z.object({
+		name: z.string().optional().describe("Filter by part name."),
+		partNumber: z.string().optional().describe("Filter by part number."),
+		limit: z.coerce.number().optional().describe("Maximum number of parts to return."),
+		offset: z.coerce.number().optional().describe("Number of parts to skip."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const parts = await (await requireClient()).parts.list({
+			name: options.name,
+			partNumber: options.partNumber,
+			limit: options.limit,
+			offset: options.offset
+		});
+		if (options.json) {
+			printJson(parts);
+			return;
+		}
+		if (parts.length === 0) {
+			consola.info("No parts found.");
+			return;
+		}
+		printTable(parts.map((part) => ({
+			id: part.id,
+			partNumber: part.partNumber,
+			name: part.name,
+			price: part.price ?? "",
+			taxRate: part.taxRate,
+			status: part.status ?? "",
+			stock: part.stock
+		})));
+	}
+});
+//#endregion
+//#region src/commands/tags/create.ts
+const OBJECT_TYPES = [
+	"Invoice",
+	"Voucher",
+	"Order",
+	"CreditNote"
+];
+var create_default$2 = defineCommand({
+	description: "Create a tag and attach it to a document.",
+	options: defineOptions(z.object({
+		name: z.string().optional().describe("Name of the tag. If omitted, you will be prompted."),
+		objectType: z.string().optional().describe("Type of the document to tag: Invoice, Voucher, Order or CreditNote. If omitted, you will be prompted."),
+		objectId: z.coerce.number().optional().describe("ID of the document to tag. If omitted, you will be prompted."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const name = await requireStringOption({
+			value: options.name,
+			requirement: "a tag name via --name",
+			question: "Enter the tag name:"
+		});
+		const objectType = await requireStringOption({
+			value: options.objectType,
+			requirement: "a document type via --object-type",
+			question: `Enter the document type (${OBJECT_TYPES.join(", ")}):`
+		});
+		if (!isTagObjectType(objectType)) {
+			consola.error(`The document type must be one of: ${OBJECT_TYPES.join(", ")}.`);
+			process.exit(1);
+		}
+		const objectId = await requireNumberOption({
+			value: options.objectId,
+			requirement: "a document ID via --object-id",
+			question: "Enter the document ID:"
+		});
+		const relation = await client.tags.create({
+			name,
+			objectId,
+			objectName: objectType
+		});
+		if (options.json) {
+			printJson(relation);
+			return;
+		}
+		consola.success(`Created tag ${relation.tag.id}.`);
+	}
+});
+function isTagObjectType(value) {
+	return OBJECT_TYPES.some((objectType) => objectType === value);
+}
+//#endregion
+//#region src/commands/tags/delete.ts
+var delete_default = defineCommand({
+	description: "Delete a tag.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("The tag ID. If omitted, you will be prompted."),
+		yes: z.boolean().default(false).describe("Skip the confirmation prompt."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const tagId = await requireNumberOption({
+			value: options.id,
+			requirement: "a tag ID via --id",
+			question: "Enter the tag ID:"
+		});
+		if (!await confirmOrAbort({
+			message: `Delete tag ${tagId}?`,
+			yes: options.yes,
+			initial: false
+		})) return;
+		await client.tags.delete({ tagId });
+		if (options.json) {
+			printJson({ deleted: true });
+			return;
+		}
+		consola.success("Tag deleted.");
+	}
+});
+//#endregion
+//#region src/commands/tags/list.ts
+var list_default$2 = defineCommand({
+	description: "List tags.",
+	options: defineOptions(z.object({
+		limit: z.coerce.number().optional().describe("Maximum number of tags to return."),
+		offset: z.coerce.number().optional().describe("Number of tags to skip."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const tags = await (await requireClient()).tags.list({
+			limit: options.limit,
+			offset: options.offset
+		});
+		if (options.json) {
+			printJson(tags);
+			return;
+		}
+		if (tags.length === 0) {
+			consola.info("No tags found.");
+			return;
+		}
+		printTable(tags.map((tag) => ({
+			id: tag.id,
+			name: tag.name
+		})));
+	}
+});
+//#endregion
+//#region src/commands/transactions/create.ts
+/**
+* Creates a transaction manually. This should only be used on check accounts
+* of type online, preferably on accounts that import their transactions from
+* files, because transactions of connected bank accounts are synchronized by
+* sevdesk itself.
+*/
+var create_default$1 = defineCommand({
+	description: "Create a transaction. Only use this on file import (online) check accounts.",
+	options: defineOptions(z.object({
+		checkAccount: z.coerce.number().optional().describe("The ID of the check account the transaction belongs to. If omitted, you will be prompted."),
+		amount: z.coerce.number().optional().describe("The amount of the transaction. Negative for expenses. If omitted, you will be prompted."),
+		payee: z.string().optional().describe("The name of the payee or payer. If omitted, you will be prompted."),
+		valueDate: z.string().default(() => (/* @__PURE__ */ new Date()).toISOString()).describe("The date the transaction was booked (ISO 8601)."),
+		entryDate: z.string().optional().describe("The date the transaction was imported (ISO 8601)."),
+		purpose: z.string().optional().describe("The payment purpose of the transaction."),
+		status: z.coerce.number().default(100).describe("100 created, 200 linked, 300 private, 400 booked."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const checkAccountId = await requireNumberOption({
+			value: options.checkAccount,
+			requirement: "a check account ID via --check-account",
+			question: "Enter the check account ID:"
+		});
+		const amount = await requireNumberOption({
+			value: options.amount,
+			requirement: "an amount via --amount",
+			question: "Enter the amount:"
+		});
+		const payee = await requireStringOption({
+			value: options.payee,
+			requirement: "a payee via --payee",
+			question: "Enter the payee or payer name:"
+		});
+		const transaction = await client.transactions.create({
+			checkAccountId,
+			amount,
+			payeePayerName: payee,
+			valueDate: options.valueDate,
+			entryDate: options.entryDate,
+			paymtPurpose: options.purpose,
+			status: options.status
+		});
+		if (options.json) {
+			printJson(transaction);
+			return;
+		}
+		consola.success(`Created transaction ${transaction.id}.`);
+	}
+});
+//#endregion
+//#region src/commands/transactions/get.ts
+var get_default$1 = defineCommand({
+	description: "Show a single transaction.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("The transaction ID. If omitted, you will be prompted."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const transactionId = await requireNumberOption({
+			value: options.id,
+			requirement: "a transaction ID via --id",
+			question: "Enter the transaction ID:"
+		});
+		const transaction = await client.transactions.get({ transactionId });
+		if (options.json) {
+			printJson(transaction);
+			return;
+		}
+		consola.info(`ID: ${transaction.id}`);
+		consola.info(`Value date: ${transaction.valueDate}`);
+		consola.info(`Amount: ${transaction.amount}`);
+		consola.info(`Payee: ${transaction.payeePayerName ?? "-"}`);
+		consola.info(`Purpose: ${transaction.paymtPurpose ?? "-"}`);
+		consola.info(`Status: ${transaction.status}`);
+		consola.info(`Check account: ${transaction.checkAccount.id}`);
+	}
+});
+//#endregion
+//#region src/commands/transactions/list.ts
+var list_default$1 = defineCommand({
+	description: "List transactions of your check accounts.",
+	options: defineOptions(z.object({
+		checkAccount: z.coerce.number().optional().describe("Only show transactions of this check account ID."),
+		unbooked: z.boolean().default(false).describe("Only show transactions that are not yet booked."),
+		startDate: z.string().optional().describe("Only show transactions on or after this date (ISO 8601)."),
+		endDate: z.string().optional().describe("Only show transactions on or before this date (ISO 8601)."),
+		payee: z.string().optional().describe("Only show transactions with this payee or payer name."),
+		purpose: z.string().optional().describe("Only show transactions with this payment purpose."),
+		limit: z.coerce.number().optional().describe("The maximum number of transactions to return."),
+		offset: z.coerce.number().optional().describe("The number of transactions to skip."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const transactions = await (await requireClient()).transactions.list({
+			checkAccountId: options.checkAccount,
+			isBooked: options.unbooked ? false : void 0,
+			startDate: options.startDate,
+			endDate: options.endDate,
+			payeePayerName: options.payee,
+			paymtPurpose: options.purpose,
+			limit: options.limit,
+			offset: options.offset
+		});
+		if (options.json) {
+			printJson(transactions);
+			return;
+		}
+		if (transactions.length === 0) {
+			consola.info("No transactions found.");
+			return;
+		}
+		printTable(transactions.map((transaction) => ({
+			id: transaction.id,
+			valueDate: transaction.valueDate,
+			payee: transaction.payeePayerName ?? "",
+			purpose: transaction.paymtPurpose ?? "",
+			amount: transaction.amount,
+			status: transaction.status
+		})));
+	}
+});
+//#endregion
+//#region src/commands/vouchers/book.ts
+var book_default = defineCommand({
+	description: "Book a payment on a voucher.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("ID of the voucher."),
+		amount: z.coerce.number().optional().describe("Amount to book. Can also be a partial amount."),
+		date: z.string().default(() => (/* @__PURE__ */ new Date()).toISOString()).describe("Booking date as ISO 8601. Defaults to now."),
+		type: z.enum([
+			"FULL_PAYMENT",
+			"N",
+			"CB",
+			"O",
+			"OF",
+			"MTC"
+		]).default("FULL_PAYMENT").describe("Type of the booking. Supported values are FULL_PAYMENT, N (partial), CB (cash discount), O (other), OF (reminder charges) and MTC (monetary traffic costs)."),
+		checkAccount: z.coerce.number().optional().describe("ID of the check account."),
+		transaction: z.coerce.number().optional().describe("ID of the bank transaction to link. Required for online check accounts, omit for clearing accounts."),
+		createFeed: z.boolean().optional().describe("Create a feed entry for the booking."),
+		yes: z.boolean().default(false).describe("Skip the confirmation prompt."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const voucherId = await requireNumberOption({
+			value: options.id,
+			requirement: "a voucher via --id",
+			question: "Enter the voucher ID:"
+		});
+		const amount = await requireNumberOption({
+			value: options.amount,
+			requirement: "an amount via --amount",
+			question: "Enter the amount to book:"
+		});
+		const checkAccountId = await requireNumberOption({
+			value: options.checkAccount,
+			requirement: "a check account via --check-account",
+			question: "Enter the check account ID:"
+		});
+		if (!await confirmOrAbort({
+			message: `Book ${amount} on voucher ${voucherId}?`,
+			yes: options.yes
+		})) return;
+		const result = await client.vouchers.book({
+			voucherId,
+			amount,
+			date: options.date,
+			type: options.type,
+			checkAccountId,
+			checkAccountTransactionId: options.transaction,
+			createFeed: options.createFeed
+		});
+		if (options.json) {
+			printJson(result);
+			return;
+		}
+		consola.success(`Booked ${amount} on voucher ${voucherId}. Status changed from ${result.fromStatus} to ${result.toStatus}.`);
+	}
+});
+//#endregion
+//#region src/commands/vouchers/create.ts
+var create_default = defineCommand({
+	description: "Create a voucher from a receipt file.",
+	options: defineOptions(z.object({
+		file: z.string().optional().describe("Path to the receipt file to attach, for example a PDF, an image or an XML invoice."),
+		status: z.enum(["draft", "open"]).default("open").describe("Status of the created voucher. Supported values are draft and open."),
+		creditDebit: z.enum(["C", "D"]).default("C").describe("C for expense (credit), D for income (debit) vouchers."),
+		taxRule: z.coerce.number().optional().describe("ID of the tax rule, for example 9 for deductible input tax expenses."),
+		accountDatev: z.coerce.number().optional().describe("ID of the booking account (AccountDatev). Find it with guidance:accounts."),
+		amount: z.coerce.number().optional().describe("Amount of the voucher position."),
+		net: z.boolean().default(false).describe("Treat the amount as net instead of gross."),
+		taxRate: z.coerce.number().default(19).describe("Tax rate of the voucher position in percent."),
+		voucherDate: z.string().optional().describe("Date as dd.mm.yyyy or Unix timestamp."),
+		payDate: z.string().optional().describe("Date as dd.mm.yyyy or Unix timestamp."),
+		supplierId: z.coerce.number().optional().describe("ID of the supplier contact."),
+		supplierName: z.string().optional().describe("Name of the supplier, used when no supplier ID is given."),
+		description: z.string().optional().describe("The voucher number."),
+		comment: z.string().optional().describe("Comment for the voucher position."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const path = await requireStringOption({
+			value: options.file,
+			requirement: "a file via --file",
+			question: "Enter the path to the receipt file:"
+		});
+		const taxRuleId = await requireNumberOption({
+			value: options.taxRule,
+			requirement: "a tax rule via --tax-rule",
+			question: "Enter the tax rule ID:"
+		});
+		const accountDatevId = await requireNumberOption({
+			value: options.accountDatev,
+			requirement: "a booking account via --account-datev",
+			question: "Enter the booking account ID:"
+		});
+		const amount = await requireNumberOption({
+			value: options.amount,
+			requirement: "an amount via --amount",
+			question: "Enter the amount:"
+		});
+		const supplierName = options.supplierId === void 0 && !options.supplierName ? await requireStringOption({
+			value: void 0,
+			requirement: "a supplier via --supplier-id or --supplier-name",
+			question: "Enter the supplier name:"
+		}) : options.supplierName;
+		const file = await readFile(path).catch(() => {
+			consola.error(`The file "${path}" could not be read. Check that the path is correct.`);
+			process.exit(1);
+		});
+		const result = await client.vouchers.createFromFile({
+			file,
+			filename: basename(path),
+			voucher: {
+				status: options.status === "draft" ? 50 : 100,
+				creditDebit: options.creditDebit,
+				taxRuleId,
+				voucherDate: options.voucherDate,
+				payDate: options.payDate,
+				supplierId: options.supplierId,
+				supplierName,
+				description: options.description
+			},
+			positions: [{
+				accountDatevId,
+				taxRate: options.taxRate,
+				net: options.net,
+				...options.net ? { sumNet: amount } : { sumGross: amount },
+				comment: options.comment
+			}]
+		});
+		if (options.json) {
+			printJson(result);
+			return;
+		}
+		consola.success(`Created voucher ${result.voucher.id} with status ${result.voucher.status}.`);
+	}
+});
+//#endregion
+//#region src/commands/vouchers/enshrine.ts
+var enshrine_default = defineCommand({
+	description: "Enshrine a voucher so that it can no longer be changed.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("ID of the voucher."),
+		yes: z.boolean().default(false).describe("Skip the confirmation prompt."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const voucherId = await requireNumberOption({
+			value: options.id,
+			requirement: "a voucher ID via --id",
+			question: "Enter the voucher ID:"
+		});
+		if (!await confirmOrAbort({
+			message: `Enshrine voucher ${voucherId}? This cannot be undone.`,
+			yes: options.yes,
+			initial: false
+		})) return;
+		await client.vouchers.enshrine({ voucherId });
+		if (options.json) {
+			printJson({ enshrined: true });
+			return;
+		}
+		consola.success(`Enshrined voucher ${voucherId}.`);
+	}
+});
+//#endregion
+//#region src/commands/vouchers/get.ts
+var get_default = defineCommand({
+	description: "Show a single voucher.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("ID of the voucher."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const voucherId = await requireNumberOption({
+			value: options.id,
+			requirement: "a voucher ID via --id",
+			question: "Enter the voucher ID:"
+		});
+		const voucher = await client.vouchers.get({ voucherId });
+		if (options.json) {
+			printJson(voucher);
+			return;
+		}
+		consola.info(`ID: ${voucher.id}`);
+		consola.info(`Status: ${voucher.status ?? "-"}`);
+		consola.info(`Date: ${voucher.voucherDate ?? "-"}`);
+		consola.info(`Supplier: ${voucher.supplierName ?? voucher.supplier?.id ?? "-"}`);
+		consola.info(`Description: ${voucher.description ?? "-"}`);
+		consola.info(`Net: ${voucher.sumNet}`);
+		consola.info(`Tax: ${voucher.sumTax}`);
+		consola.info(`Gross: ${voucher.sumGross}`);
+		consola.info(`Currency: ${voucher.currency ?? "-"}`);
+		consola.info(`Enshrined: ${voucher.enshrined ?? "no"}`);
+	}
+});
+//#endregion
+//#region src/commands/vouchers/list.ts
+var list_default = defineCommand({
+	description: "List vouchers.",
+	options: defineOptions(z.object({
+		status: z.coerce.number().optional().describe("Filter by status: 50 draft, 100 open, 150 transferred, 750 partially paid, 1000 paid."),
+		creditDebit: z.enum(["C", "D"]).optional().describe("Filter by C for expense or D for income vouchers."),
+		descriptionLike: z.string().optional().describe("Filter by voucher number, matching partially."),
+		startDate: z.string().optional().describe("Only vouchers on or after this date as dd.mm.yyyy or Unix timestamp."),
+		endDate: z.string().optional().describe("Only vouchers on or before this date as dd.mm.yyyy or Unix timestamp."),
+		contact: z.coerce.number().optional().describe("ID of the contact whose vouchers to list."),
+		limit: z.coerce.number().optional().describe("Maximum number of vouchers to return."),
+		offset: z.coerce.number().optional().describe("Number of vouchers to skip."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const vouchers = await (await requireClient()).vouchers.list({
+			status: options.status,
+			creditDebit: options.creditDebit,
+			descriptionLike: options.descriptionLike,
+			startDate: options.startDate,
+			endDate: options.endDate,
+			contactId: options.contact,
+			limit: options.limit,
+			offset: options.offset
+		});
+		if (options.json) {
+			printJson(vouchers);
+			return;
+		}
+		if (vouchers.length === 0) {
+			consola.info("No vouchers found.");
+			return;
+		}
+		printTable(vouchers.map((voucher) => ({
+			id: voucher.id,
+			date: voucher.voucherDate ?? "",
+			supplier: voucher.supplierName ?? voucher.supplier?.id ?? "",
+			description: voucher.description ?? "",
+			gross: voucher.sumGross,
+			status: voucher.status ?? ""
+		})));
+	}
+});
+//#endregion
+//#region src/commands/vouchers/reset-to-draft.ts
+var reset_to_draft_default = defineCommand({
+	description: "Reset a voucher to the draft status.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("ID of the voucher."),
+		yes: z.boolean().default(false).describe("Skip the confirmation prompt."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const voucherId = await requireNumberOption({
+			value: options.id,
+			requirement: "a voucher ID via --id",
+			question: "Enter the voucher ID:"
+		});
+		if (!await confirmOrAbort({
+			message: `Reset voucher ${voucherId} to draft? This unlinks existing payments.`,
+			yes: options.yes,
+			initial: false
+		})) return;
+		const voucher = await client.vouchers.resetToDraft({ voucherId });
+		if (options.json) {
+			printJson(voucher);
+			return;
+		}
+		consola.success(`Reset voucher ${voucher.id}. New status: ${voucher.status ?? "-"}.`);
+	}
+});
+//#endregion
+//#region src/commands/vouchers/reset-to-open.ts
+var reset_to_open_default = defineCommand({
+	description: "Reset a voucher to the open status.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("ID of the voucher."),
+		yes: z.boolean().default(false).describe("Skip the confirmation prompt."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const client = await requireClient();
+		const voucherId = await requireNumberOption({
+			value: options.id,
+			requirement: "a voucher ID via --id",
+			question: "Enter the voucher ID:"
+		});
+		if (!await confirmOrAbort({
+			message: `Reset voucher ${voucherId} to open? This unlinks existing payments.`,
+			yes: options.yes,
+			initial: false
+		})) return;
+		const voucher = await client.vouchers.resetToOpen({ voucherId });
+		if (options.json) {
+			printJson(voucher);
+			return;
+		}
+		consola.success(`Reset voucher ${voucher.id}. New status: ${voucher.status ?? "-"}.`);
+	}
+});
+//#endregion
+//#region src/index.ts
+const config = defineConfig({
+	meta: {
+		name: "sevdesk",
+		version: pkg.version,
+		description: pkg.description
+	},
+	commands: {
+		login: login_default,
+		logout: logout_default,
+		doctor: doctor_default,
+		"accounts:balance": balance_default,
+		"accounts:create-clearing": create_clearing_default,
+		"accounts:create-file-import": create_file_import_default,
+		"accounts:get": get_default$7,
+		"accounts:list": list_default$8,
+		"contacts:create": create_default$3,
+		"contacts:delete": delete_default$1,
+		"contacts:get": get_default$6,
+		"contacts:list": list_default$7,
+		"contacts:update": update_default,
+		"credit-notes:get": get_default$5,
+		"credit-notes:list": list_default$6,
+		"credit-notes:pdf": pdf_default$2,
+		"export:contacts": contacts_default,
+		"export:datev": datev_default,
+		"export:invoices": invoices_default,
+		"export:transactions": transactions_default,
+		"export:vouchers": vouchers_default,
+		"guidance:accounts": accounts_default,
+		"invoices:get": get_default$4,
+		"invoices:list": list_default$5,
+		"invoices:pdf": pdf_default$1,
+		"orders:get": get_default$3,
+		"orders:list": list_default$4,
+		"orders:pdf": pdf_default,
+		"parts:get": get_default$2,
+		"parts:list": list_default$3,
+		"tags:create": create_default$2,
+		"tags:delete": delete_default,
+		"tags:list": list_default$2,
+		"transactions:create": create_default$1,
+		"transactions:get": get_default$1,
+		"transactions:list": list_default$1,
+		"vouchers:book": book_default,
+		"vouchers:create": create_default,
+		"vouchers:enshrine": enshrine_default,
+		"vouchers:get": get_default,
+		"vouchers:list": list_default,
+		"vouchers:reset-to-draft": reset_to_draft_default,
+		"vouchers:reset-to-open": reset_to_open_default
+	}
+});
+try {
+	const result = processConfig(config, process.argv.slice(2));
+	await result.command.action(result.options, result.args);
+} catch (error) {
+	consola.error(formatError(error));
+	process.exitCode = 1;
+}
+//#endregion
+export {};
+
+//# sourceMappingURL=index.js.map