@genz-its/sevdesk-cli 0.1.3 → 0.1.5

package/dist/index.js

@@ -148,6 +148,17 @@ function contactLabel(ref) {
 	const personName = [ref.surename, ref.familyname].filter((part) => part).join(" ");
 	return ref.name || personName || ref.id || "-";
 }
+/**
+* Formats a service period (Leistungszeitraum) as plain dates, collapsing to a
+* single date when there is no end. The API returns local datetimes, so the
+* date part is sliced off instead of parsed, which would shift the day across
+* the UTC boundary.
+*/
+function servicePeriodLabel(from, until) {
+	if (!from) return "";
+	const start = from.slice(0, 10);
+	return until ? `${start} – ${until.slice(0, 10)}` : start;
+}
 function printJson(value) {
 	console.log(JSON.stringify(value, null, 2));
 }
@@ -190,40 +201,60 @@ var get_default$8 = defineCommand({
 	}
 });
 //#endregion
-//#region src/commands/accounts-datev/list.ts
+//#region src/pagination.ts
+/**
+* Rows requested per page. The sevdesk API defaults to 100 when no `limit` is
+* sent, which is why an unpaginated list silently stops at 100 rows.
+*/
 const PAGE_SIZE = 1e3;
+/**
+* Collects rows of a list endpoint across as many pages as needed.
+*
+* Paging stops on an empty page rather than a short one, so a server-side cap
+* on `limit` cannot truncate the result the way the API default does.
+*/
+async function fetchAll(fetchPage, options = {}) {
+	const { limit, keep } = options;
+	const items = [];
+	let offset = options.offset ?? 0;
+	while (limit === void 0 || items.length < limit) {
+		const page = await fetchPage({
+			limit: pageSize(limit, items.length, keep),
+			offset
+		});
+		if (page.length === 0) break;
+		offset += page.length;
+		items.push(...keep === void 0 ? page : page.filter(keep));
+	}
+	return limit === void 0 ? items : items.slice(0, limit);
+}
+/**
+* Without a `keep` filter every row counts towards `limit`, so a small `limit`
+* only needs a correspondingly small page.
+*/
+function pageSize(limit, collected, keep) {
+	if (limit === void 0 || keep !== void 0) return PAGE_SIZE;
+	return Math.min(limit - collected, PAGE_SIZE);
+}
+//#endregion
+//#region src/commands/accounts-datev/list.ts
 var list_default$9 = defineCommand({
 	description: "List booking accounts (AccountDatev). Covers only accounts visible in the sevdesk account picker; hidden accounts (for example some tax accounts) are reachable via accounts-datev:get. Backed by an undocumented sevdesk endpoint that may change without notice.",
 	options: defineOptions(z.object({
 		number: z.string().optional().describe("Only show accounts with this account number. Filtered client-side across all visible accounts."),
 		nameLike: z.string().optional().describe("Only show accounts whose name contains this text. Filtered client-side across all visible accounts."),
-		limit: z.coerce.number().optional().describe("Maximum number of accounts to return."),
-		offset: z.coerce.number().optional().describe("Number of accounts to skip. Ignored when a filter is used."),
+		limit: z.coerce.number().optional().describe("Maximum number of accounts to return. Defaults to all of them."),
+		offset: z.coerce.number().optional().describe("Number of accounts to skip before filtering."),
 		json: z.boolean().default(false).describe("Output in JSON format.")
 	})),
 	action: async (options) => {
 		const client = await requireClient();
-		const filtering = options.number !== void 0 || options.nameLike !== void 0;
-		let accounts;
-		if (filtering) {
-			accounts = [];
-			for (let offset = 0;; offset += PAGE_SIZE) {
-				const page = await client.accountsDatev.list({
-					limit: PAGE_SIZE,
-					offset
-				});
-				accounts.push(...page);
-				if (page.length < PAGE_SIZE) break;
-			}
-			if (options.number !== void 0) accounts = accounts.filter((account) => account.number === options.number);
-			if (options.nameLike !== void 0) {
-				const needle = options.nameLike.toLowerCase();
-				accounts = accounts.filter((account) => (account.name ?? "").toLowerCase().includes(needle));
-			}
-			if (options.limit !== void 0) accounts = accounts.slice(0, options.limit);
-		} else accounts = await client.accountsDatev.list({
+		const needle = options.nameLike?.toLowerCase();
+		const filtering = options.number !== void 0 || needle !== void 0;
+		const accounts = await fetchAll((page) => client.accountsDatev.list(page), {
 			limit: options.limit,
-			offset: options.offset
+			offset: options.offset,
+			keep: filtering ? (account) => (options.number === void 0 || account.number === options.number) && (needle === void 0 || (account.name ?? "").toLowerCase().includes(needle)) : void 0
 		});
 		if (options.json) {
 			printJson(accounts);
@@ -368,12 +399,13 @@ var get_default$7 = defineCommand({
 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."),
+		limit: z.coerce.number().optional().describe("The maximum number of check accounts to return. Defaults to all of them."),
 		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({
+		const client = await requireClient();
+		const checkAccounts = await fetchAll((page) => client.checkAccounts.list(page), {
 			limit: options.limit,
 			offset: options.offset
 		});
@@ -588,9 +620,36 @@ var delete_default$1 = defineCommand({
 	}
 });
 //#endregion
+//#region src/commands/contacts/delete-address.ts
+var delete_address_default = defineCommand({
+	description: "Delete an address of a contact.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("The contact address ID, as shown by contacts:get. 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 contactAddressId = await requireNumberOption({
+			value: options.id,
+			requirement: "a contact address ID via --id",
+			question: "Enter the contact address ID:"
+		});
+		if (!await confirmOrAbort({
+			message: `Delete contact address ${contactAddressId}?`,
+			yes: options.yes,
+			initial: false
+		})) return;
+		await client.contactAddresses.delete({ contactAddressId });
+		if (options.json) {
+			printJson({ deleted: true });
+			return;
+		}
+		consola.success("Contact address deleted.");
+	}
+});
+//#endregion
 //#region src/commands/contacts/get.ts
-/** The `/ContactAddress` endpoint cannot filter by contact, so we filter here. */
-const ADDRESS_LOOKUP_LIMIT = 100;
 var get_default$6 = defineCommand({
 	description: "Show a single contact with its addresses and communication ways.",
 	options: defineOptions(z.object({
@@ -605,8 +664,12 @@ var get_default$6 = defineCommand({
 			question: "Enter the contact ID:"
 		});
 		const contact = await client.contacts.get({ contactId });
-		const addresses = (await client.contactAddresses.list({ limit: ADDRESS_LOOKUP_LIMIT })).filter((address) => address.contact.id === String(contactId));
-		const communicationWays = await client.communicationWays.list({ contactId });
+		/** The `/ContactAddress` endpoint cannot filter by contact, so we filter here. */
+		const addresses = await fetchAll((page) => client.contactAddresses.list(page), { keep: (address) => address.contact.id === String(contactId) });
+		const communicationWays = await fetchAll((page) => client.communicationWays.list({
+			contactId,
+			...page
+		}));
 		if (options.json) {
 			printJson({
 				contact,
@@ -633,12 +696,14 @@ function printSection(title, lines) {
 	consola.info(title);
 	for (const line of lines.length === 0 ? ["-"] : lines) consola.info(`  ${line}`);
 }
+/** The id is shown because contacts:update-address and contacts:delete-address need it. */
 function formatAddress(address) {
-	return [
+	const parts = [
 		address.street,
 		[address.zip, address.city].filter((part) => part).join(" "),
 		`country ${address.country.id}`
-	].filter((part) => part).join(", ");
+	];
+	return `#${address.id} ${parts.filter((part) => part).join(", ")}`;
 }
 function formatCommunicationWay(communicationWay) {
 	const main = communicationWay.main === "1" ? " (main)" : "";
@@ -653,16 +718,19 @@ var list_default$7 = defineCommand({
 		customerNumber: z.string().optional().describe("Filter by customer number."),
 		depth: z.coerce.number().optional().describe("Contact depth: 0 returns only organizations, 1 organizations and persons. Defaults to 0."),
 		category: z.coerce.number().optional().describe("ID of the contact category to filter by: 2 supplier, 3 customer, 4 partner."),
-		limit: z.coerce.number().optional().describe("Maximum number of contacts to return."),
+		limit: z.coerce.number().optional().describe("Maximum number of contacts to return. Defaults to all of them."),
 		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({
+		const client = await requireClient();
+		const contacts = await fetchAll((page) => client.contacts.list({
 			name: options.name,
 			customerNumber: options.customerNumber,
 			depth: toDepth(options.depth),
 			categoryId: options.category,
+			...page
+		}), {
 			limit: options.limit,
 			offset: options.offset
 		});
@@ -732,6 +800,48 @@ var update_default = defineCommand({
 	}
 });
 //#endregion
+//#region src/commands/contacts/update-address.ts
+var update_address_default = defineCommand({
+	description: "Update an address of a contact.",
+	options: defineOptions(z.object({
+		id: z.coerce.number().optional().describe("The contact address ID, as shown by contacts:get. If omitted, you will be prompted."),
+		street: z.string().optional().describe("Street and house number."),
+		zip: z.string().optional().describe("Zip code."),
+		city: z.string().optional().describe("City name."),
+		country: z.coerce.number().optional().describe("ID of the country as a StaticCountry ID, for example 1 for Germany."),
+		category: z.coerce.number().optional().describe("ID of the address category."),
+		json: z.boolean().default(false).describe("Output in JSON format.")
+	})),
+	action: async (options) => {
+		const fields = {
+			street: options.street,
+			zip: options.zip,
+			city: options.city,
+			countryId: options.country,
+			categoryId: options.category
+		};
+		if (Object.values(fields).every((value) => value === void 0)) {
+			consola.error("You must provide at least one of --street, --zip, --city, --country or --category.");
+			process.exit(1);
+		}
+		const client = await requireClient();
+		const contactAddressId = await requireNumberOption({
+			value: options.id,
+			requirement: "a contact address ID via --id",
+			question: "Enter the contact address ID:"
+		});
+		const address = await client.contactAddresses.update({
+			contactAddressId,
+			...fields
+		});
+		if (options.json) {
+			printJson(address);
+			return;
+		}
+		consola.success(`Updated contact address ${address.id}.`);
+	}
+});
+//#endregion
 //#region src/commands/credit-notes/get.ts
 var get_default$5 = defineCommand({
 	description: "Show a single credit note.",
@@ -775,20 +885,23 @@ var list_default$6 = defineCommand({
 		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."),
+		limit: z.coerce.number().optional().describe("Maximum number of credit notes to return. Defaults to all of them."),
 		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({
+		const client = await requireClient();
+		const creditNotes = await fetchAll((page) => client.creditNotes.list({
 			status: options.status,
 			creditNoteNumber: options.creditNoteNumber,
 			startDate: options.startDate,
 			endDate: options.endDate,
 			contactId: options.contact,
+			embed: ["contact"],
+			...page
+		}), {
 			limit: options.limit,
-			offset: options.offset,
-			embed: ["contact"]
+			offset: options.offset
 		});
 		if (options.json) {
 			printJson(creditNotes);
@@ -1162,20 +1275,23 @@ var list_default$5 = defineCommand({
 		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."),
+		limit: z.coerce.number().optional().describe("Maximum number of invoices to return. Defaults to all of them."),
 		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({
+		const client = await requireClient();
+		const invoices = await fetchAll((page) => client.invoices.list({
 			status: options.status,
 			invoiceNumber: options.invoiceNumber,
 			startDate: options.startDate,
 			endDate: options.endDate,
 			contactId: options.contact,
+			embed: ["contact"],
+			...page
+		}), {
 			limit: options.limit,
-			offset: options.offset,
-			embed: ["contact"]
+			offset: options.offset
 		});
 		if (options.json) {
 			printJson(invoices);
@@ -1312,20 +1428,23 @@ var list_default$4 = defineCommand({
 		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."),
+		limit: z.coerce.number().optional().describe("Maximum number of orders to return. Defaults to all of them."),
 		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({
+		const client = await requireClient();
+		const orders = await fetchAll((page) => client.orders.list({
 			status: options.status,
 			orderNumber: options.orderNumber,
 			startDate: options.startDate,
 			endDate: options.endDate,
 			contactId: options.contact,
+			embed: ["contact"],
+			...page
+		}), {
 			limit: options.limit,
-			offset: options.offset,
-			embed: ["contact"]
+			offset: options.offset
 		});
 		if (options.json) {
 			printJson(orders);
@@ -1417,14 +1536,17 @@ var list_default$3 = defineCommand({
 	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."),
+		limit: z.coerce.number().optional().describe("Maximum number of parts to return. Defaults to all of them."),
 		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({
+		const client = await requireClient();
+		const parts = await fetchAll((page) => client.parts.list({
 			name: options.name,
 			partNumber: options.partNumber,
+			...page
+		}), {
 			limit: options.limit,
 			offset: options.offset
 		});
@@ -1533,12 +1655,13 @@ var delete_default = defineCommand({
 var list_default$2 = defineCommand({
 	description: "List tags.",
 	options: defineOptions(z.object({
-		limit: z.coerce.number().optional().describe("Maximum number of tags to return."),
+		limit: z.coerce.number().optional().describe("Maximum number of tags to return. Defaults to all of them."),
 		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({
+		const client = await requireClient();
+		const tags = await fetchAll((page) => client.tags.list(page), {
 			limit: options.limit,
 			offset: options.offset
 		});
@@ -1644,26 +1767,29 @@ 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 with status 100 (created). Filtered client-side because the sevdesk API ignores its isBooked=false filter, so a page fetched with --limit may yield fewer rows."),
+		unbooked: z.boolean().default(false).describe("Only show transactions with status 100 (created). Filtered client-side because the sevdesk API ignores its isBooked=false filter."),
 		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."),
+		limit: z.coerce.number().optional().describe("The maximum number of transactions to return. Defaults to all of them."),
 		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) => {
-		let transactions = await (await requireClient()).transactions.list({
+		const client = await requireClient();
+		const transactions = await fetchAll((page) => client.transactions.list({
 			checkAccountId: options.checkAccount,
 			startDate: options.startDate,
 			endDate: options.endDate,
 			payeePayerName: options.payee,
 			paymtPurpose: options.purpose,
+			...page
+		}), {
 			limit: options.limit,
-			offset: options.offset
+			offset: options.offset,
+			keep: options.unbooked ? (transaction) => transaction.status === "100" : void 0
 		});
-		if (options.unbooked) transactions = transactions.filter((transaction) => transaction.status === "100");
 		if (options.json) {
 			printJson(transactions);
 			return;
@@ -1756,6 +1882,8 @@ var create_default = defineCommand({
 		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."),
+		deliveryDate: z.string().optional().describe("Start of the service period, or the single service date, as dd.mm.yyyy or Unix timestamp."),
+		deliveryDateUntil: z.string().optional().describe("End of the service period as dd.mm.yyyy or Unix timestamp. Requires --delivery-date."),
 		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."),
@@ -1763,6 +1891,10 @@ var create_default = defineCommand({
 		json: z.boolean().default(false).describe("Output in JSON format.")
 	})),
 	action: async (options) => {
+		if (options.deliveryDateUntil !== void 0 && options.deliveryDate === void 0) {
+			consola.error("You must provide --delivery-date when using --delivery-date-until.");
+			process.exit(1);
+		}
 		const client = await requireClient();
 		const path = await requireStringOption({
 			value: options.file,
@@ -1802,6 +1934,8 @@ var create_default = defineCommand({
 				taxRuleId,
 				voucherDate: options.voucherDate,
 				payDate: options.payDate,
+				deliveryDate: options.deliveryDate,
+				deliveryDateUntil: options.deliveryDateUntil,
 				supplierId: options.supplierId,
 				supplierName,
 				description: options.description
@@ -1876,6 +2010,7 @@ var get_default = defineCommand({
 		consola.info(`ID: ${voucher.id}`);
 		consola.info(`Status: ${voucher.status ?? "-"}`);
 		consola.info(`Date: ${voucher.voucherDate ?? "-"}`);
+		consola.info(`Service period: ${servicePeriodLabel(voucher.deliveryDate, voucher.deliveryDateUntil) || "-"}`);
 		consola.info(`Supplier: ${voucher.supplierName ?? contactLabel(voucher.supplier)}`);
 		consola.info(`Description: ${voucher.description ?? "-"}`);
 		consola.info(`Net: ${voucher.sumNet}`);
@@ -1896,21 +2031,24 @@ var list_default = defineCommand({
 		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."),
+		limit: z.coerce.number().optional().describe("Maximum number of vouchers to return. Defaults to all of them."),
 		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({
+		const client = await requireClient();
+		const vouchers = await fetchAll((page) => client.vouchers.list({
 			status: options.status,
 			creditDebit: options.creditDebit,
 			descriptionLike: options.descriptionLike,
 			startDate: options.startDate,
 			endDate: options.endDate,
 			contactId: options.contact,
+			embed: ["supplier"],
+			...page
+		}), {
 			limit: options.limit,
-			offset: options.offset,
-			embed: ["supplier"]
+			offset: options.offset
 		});
 		if (options.json) {
 			printJson(vouchers);
@@ -1923,6 +2061,7 @@ var list_default = defineCommand({
 		printTable(vouchers.map((voucher) => ({
 			id: voucher.id,
 			date: voucher.voucherDate ?? "",
+			servicePeriod: servicePeriodLabel(voucher.deliveryDate, voucher.deliveryDateUntil),
 			supplier: voucher.supplierName ?? contactLabel(voucher.supplier),
 			description: voucher.description ?? "",
 			gross: voucher.sumGross,
@@ -1936,16 +2075,19 @@ var positions_default = defineCommand({
 	description: "List voucher positions.",
 	options: defineOptions(z.object({
 		voucher: z.coerce.number().optional().describe("ID of the voucher whose positions to list."),
-		limit: z.coerce.number().optional().describe("Maximum number of positions to return."),
+		limit: z.coerce.number().optional().describe("Maximum number of positions to return. Defaults to all of them."),
 		offset: z.coerce.number().optional().describe("Number of positions to skip."),
 		json: z.boolean().default(false).describe("Output in JSON format.")
 	})),
 	action: async (options) => {
-		const positions = await (await requireClient()).vouchers.listPositions({
+		const client = await requireClient();
+		const positions = await fetchAll((page) => client.vouchers.listPositions({
 			voucherId: options.voucher,
+			embed: ["accountDatev"],
+			...page
+		}), {
 			limit: options.limit,
-			offset: options.offset,
-			embed: ["accountDatev"]
+			offset: options.offset
 		});
 		if (options.json) {
 			printJson(positions);
@@ -2053,9 +2195,11 @@ const config = defineConfig({
 		"contacts:add-phone": add_phone_default,
 		"contacts:create": create_default$3,
 		"contacts:delete": delete_default$1,
+		"contacts:delete-address": delete_address_default,
 		"contacts:get": get_default$6,
 		"contacts:list": list_default$7,
 		"contacts:update": update_default,
+		"contacts:update-address": update_address_default,
 		"credit-notes:get": get_default$5,
 		"credit-notes:list": list_default$6,
 		"credit-notes:pdf": pdf_default$2,