noxctl 0.1.0 → 0.2.0

package/dist/cli.js

@@ -3,18 +3,95 @@ import { Command, Option } from 'commander';
 import { readFileSync } from 'node:fs';
 import { createInterface } from 'node:readline/promises';
 import { isJsonMode, outputList, outputDetail, outputConfirmation, formatTaxReport, formatFinancialReport, } from './formatter.js';
-import { invoiceListColumns, invoiceDetailColumns, invoiceConfirmColumns, customerListColumns, customerDetailColumns, voucherListColumns, voucherDetailColumns, voucherRowColumns, accountListColumns, companyDetailColumns, articleListColumns, articleDetailColumns, supplierListColumns, supplierDetailColumns, supplierInvoiceListColumns, supplierInvoiceDetailColumns, supplierInvoiceConfirmColumns, } from './views.js';
+import { readActivePointer, readActivePointerOutcome, writeActivePointer, deleteActivePointer, readProfileIndex, resolveProfile, } from './profiles.js';
+import { setResolvedProfile } from './auth.js';
+import { DEFAULT_PROFILE, InvalidProfileNameError } from './profile-name.js';
+import { invoiceListColumns, invoiceDetailColumns, invoiceConfirmColumns, customerListColumns, customerDetailColumns, voucherListColumns, voucherDetailColumns, voucherRowColumns, accountListColumns, companyDetailColumns, articleListColumns, articleDetailColumns, supplierListColumns, supplierDetailColumns, supplierInvoiceListColumns, supplierInvoiceDetailColumns, supplierInvoiceConfirmColumns, invoicePaymentListColumns, invoicePaymentDetailColumns, supplierInvoicePaymentListColumns, supplierInvoicePaymentDetailColumns, offerListColumns, offerDetailColumns, orderListColumns, orderDetailColumns, projectListColumns, projectDetailColumns, costCenterListColumns, costCenterDetailColumns, taxReductionListColumns, taxReductionDetailColumns, priceListListColumns, priceListDetailColumns, priceListColumns, priceDetailColumns, } from './views.js';
 const program = new Command();
 program
     .name('noxctl')
     .description('CLI and MCP server for Fortnox accounting')
-    .version('0.1.0')
+    .version('0.2.0')
     .addOption(new Option('-o, --output <format>', 'Output format')
     .choices(['json', 'table'])
-    .default(undefined));
+    .default(undefined))
+    .option('--profile <name>', 'Profile to operate on (overrides NOXCTL_PROFILE and active pointer)');
 function json() {
     return isJsonMode(program.opts());
 }
+let resolvedProfileInfo = { name: DEFAULT_PROFILE, source: 'default' };
+export function getResolvedProfileInfo() {
+    return resolvedProfileInfo;
+}
+// Commands that don't need (and shouldn't require) a resolved profile.
+const PROFILE_RESOLUTION_SKIP = new Set(['help']);
+program.hook('preAction', async (thisCommand, actionCommand) => {
+    const name = actionCommand.name();
+    if (PROFILE_RESOLUTION_SKIP.has(name))
+        return;
+    const flag = program.opts().profile ?? undefined;
+    const env = process.env['NOXCTL_PROFILE'] ?? undefined;
+    // Typed pointer resolution so we can distinguish "no pointer" (silent
+    // default) from "pointer unreadable/corrupt" (must surface). 2s bound
+    // catches wedged filesystems; the AbortSignal cancels the underlying read.
+    const outcome = await readActivePointerOutcome({ timeoutMs: 2000 });
+    let pointer = null;
+    if (outcome.kind === 'valid') {
+        pointer = outcome.name;
+    }
+    else if (outcome.kind !== 'missing') {
+        const desc = describePointerFault(outcome);
+        // Only fail closed when the pointer is the winning source (no flag/env)
+        // AND we're about to start the MCP server. For any other command, warn
+        // loudly but continue so `doctor` / `profile use` can repair the state.
+        const wouldRelyOnPointer = !flag && !env;
+        if (wouldRelyOnPointer && name === 'serve') {
+            console.error(`Active profile pointer ${desc}. Refusing to start MCP server with ambiguous profile. Run \`noxctl doctor\` or set NOXCTL_PROFILE explicitly.`);
+            process.exit(2);
+        }
+        process.stderr.write(`[warning: active-profile pointer ${desc}; ignoring]\n`);
+    }
+    try {
+        resolvedProfileInfo = resolveProfile({ flag, env, pointer });
+    }
+    catch (err) {
+        if (err instanceof InvalidProfileNameError) {
+            console.error(err.message);
+            process.exit(2);
+        }
+        throw err;
+    }
+    setResolvedProfile(resolvedProfileInfo.name);
+    // Banner ownership: MCP `serve` prints its own banner in bindStartupProfile
+    // so host logs (Claude Desktop) always see it. Suppress here to avoid a
+    // duplicate on TTY invocations like `noxctl --profile X serve`.
+    if (resolvedProfileInfo.name.toLowerCase() !== DEFAULT_PROFILE &&
+        process.stderr.isTTY &&
+        name !== 'current' &&
+        name !== 'serve') {
+        process.stderr.write(`[profile: ${resolvedProfileInfo.name}]\n`);
+    }
+});
+function describePointerFault(outcome) {
+    switch (outcome.kind) {
+        case 'invalid-content':
+            return `contains an invalid profile name: "${outcome.raw}"`;
+        case 'read-error':
+            return `could not be read (${outcome.error.message})`;
+        case 'timeout':
+            return 'read timed out';
+    }
+}
+async function fetchCompanyHint() {
+    try {
+        const { loadCredentials } = await import('./auth.js');
+        const creds = await loadCredentials();
+        return creds?.company_name;
+    }
+    catch {
+        return undefined;
+    }
+}
 async function confirmMutation(action, opts, payload) {
     if (opts.dryRun) {
         console.log(`Dry run: ${action}. No request was sent to Fortnox.`);
@@ -29,12 +106,14 @@ async function confirmMutation(action, opts, payload) {
     if (!process.stdin.isTTY || !process.stdout.isTTY) {
         throw new Error(`Confirmation required to ${action}. Re-run with --yes, or --dry-run first.`);
     }
+    const company = await fetchCompanyHint();
+    const suffix = company ? ` (${company})` : '';
     const rl = createInterface({
         input: process.stdin,
         output: process.stdout,
     });
     try {
-        const answer = await rl.question(`${action}. Continue? [y/N] `);
+        const answer = await rl.question(`${action}. Continue?${suffix} [y/N] `);
         return ['y', 'yes'].includes(answer.trim().toLowerCase());
     }
     finally {
@@ -45,10 +124,28 @@ async function confirmMutation(action, opts, payload) {
 program
     .command('init')
     .description('Interactive setup wizard — recommended onboarding path')
-    .action(async () => {
+    .option('--profile <name>', 'Profile to create/re-auth (defaults to resolved profile or "default")')
+    .action(async (initOpts) => {
     const { loadCredentials, runOAuthSetup } = await import('./auth.js');
+    const { validateProfileName } = await import('./profile-name.js');
+    let targetProfile;
+    try {
+        targetProfile = validateProfileName(initOpts.profile ?? resolvedProfileInfo.name);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(2);
+    }
+    // If `init --profile <name>` names a different profile than the preAction
+    // hook resolved, rebind the in-process resolved profile so downstream work
+    // (verification via getCompanyInfo, runOAuthSetup's internal saveCredentials
+    // call chain) targets the profile being initialized — not a stale pointer.
+    if (targetProfile.toLowerCase() !== resolvedProfileInfo.name.toLowerCase()) {
+        setResolvedProfile(targetProfile);
+        resolvedProfileInfo = { name: targetProfile, source: 'flag' };
+    }
     // Step 1: Check if already configured
-    const existing = await loadCredentials();
+    const existing = await loadCredentials(targetProfile);
     if (existing) {
         console.log('Existing credentials found.');
         if (process.stdin.isTTY && process.stdout.isTTY) {
@@ -181,7 +278,20 @@ program
         }
     }
     // Step 6: Run OAuth flow
-    await runOAuthSetup({ clientId, clientSecret, serviceAccount });
+    await runOAuthSetup({ clientId, clientSecret, serviceAccount }, targetProfile);
+    // Step 6b: Set the active pointer if this is the first profile or no pointer exists.
+    try {
+        const idx = await readProfileIndex();
+        const existingPointer = await readActivePointer();
+        const firstProfile = idx.profiles.length <= 1;
+        if (firstProfile || !existingPointer) {
+            await writeActivePointer(targetProfile);
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.warn(`Warning: could not update active profile pointer: ${msg}`);
+    }
     // Step 7: Verify by fetching company info
     try {
         const { getCompanyInfo } = await import('./operations/company.js');
@@ -267,28 +377,139 @@ program
 // --- logout ---
 program
     .command('logout')
-    .description('Remove stored Fortnox credentials')
+    .description('Remove stored Fortnox credentials for the resolved profile')
     .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--all', 'Remove credentials for every profile (and the legacy slot)')
     .action(async (opts) => {
-    const { loadCredentials } = await import('./auth.js');
     const { deleteCredentialBlob } = await import('./credentials-store.js');
-    const existing = await loadCredentials();
+    const { removeProfile } = await import('./profiles.js');
+    if (opts.all) {
+        if (!(await confirmMutation('Remove stored Fortnox credentials for ALL profiles', opts))) {
+            return;
+        }
+        const idx = await readProfileIndex();
+        const names = new Set(idx.profiles.map((p) => p.name));
+        names.add(DEFAULT_PROFILE);
+        let removedAny = false;
+        for (const name of names) {
+            const deleted = await deleteCredentialBlob(name);
+            if (deleted)
+                removedAny = true;
+            try {
+                await removeProfile(name);
+            }
+            catch {
+                // best-effort — index cleanup must not abort logout
+            }
+        }
+        try {
+            await deleteActivePointer();
+        }
+        catch {
+            // ignore
+        }
+        if (removedAny) {
+            console.log('Removed credentials for all profiles.');
+        }
+        else {
+            console.log('No credentials found to remove.');
+        }
+        return;
+    }
+    const target = resolvedProfileInfo.name;
+    const { loadCredentials } = await import('./auth.js');
+    const existing = await loadCredentials(target);
     if (!existing) {
-        console.log('No credentials found. Nothing to remove.');
+        console.log(`No credentials found for profile "${target}". Nothing to remove.`);
         return;
     }
-    if (!(await confirmMutation('Remove stored Fortnox credentials', opts))) {
+    if (!(await confirmMutation(`Remove stored credentials for profile "${target}"`, opts))) {
         return;
     }
-    const deleted = await deleteCredentialBlob();
+    const deleted = await deleteCredentialBlob(target);
+    try {
+        await removeProfile(target);
+    }
+    catch {
+        // best-effort
+    }
+    try {
+        const pointer = await readActivePointer();
+        if (pointer && pointer.toLowerCase() === target.toLowerCase()) {
+            await deleteActivePointer();
+        }
+    }
+    catch {
+        // ignore
+    }
     if (deleted) {
-        console.log('Credentials removed.');
+        console.log(`Credentials for profile "${target}" removed.`);
     }
     else {
         console.log('Could not remove credentials from the system keychain.');
         console.log('They may have already been removed, or you may need to remove them manually.');
     }
 });
+// --- profile ---
+const profile = program.command('profile').description('Manage noxctl profiles');
+profile
+    .command('use <name>')
+    .description('Set the active profile (writes ~/.fortnox-mcp/active-profile)')
+    .action(async (name) => {
+    const { validateProfileName } = await import('./profile-name.js');
+    let validated;
+    try {
+        validated = validateProfileName(name);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(2);
+    }
+    const { loadCredentials } = await import('./auth.js');
+    const creds = await loadCredentials(validated);
+    if (!creds) {
+        console.error(`No credentials found for profile "${validated}". Run \`noxctl init --profile ${validated}\` first.`);
+        process.exit(1);
+    }
+    await writeActivePointer(validated);
+    if (json()) {
+        console.log(JSON.stringify({ name: validated, source: 'pointer' }));
+    }
+    else {
+        console.log(`Active profile set to "${validated}".`);
+    }
+});
+profile
+    .command('current')
+    .description('Show the currently resolved profile and where it came from')
+    .action(() => {
+    if (json()) {
+        console.log(JSON.stringify(resolvedProfileInfo));
+    }
+    else {
+        console.log(`${resolvedProfileInfo.name} (source: ${resolvedProfileInfo.source})`);
+    }
+});
+profile
+    .command('list')
+    .description('List known profiles from the index')
+    .action(async () => {
+    const idx = await readProfileIndex();
+    if (json()) {
+        console.log(JSON.stringify(idx.profiles, null, 2));
+        return;
+    }
+    if (idx.profiles.length === 0) {
+        console.log('No profiles registered. Run `noxctl init` to create one.');
+        return;
+    }
+    for (const p of idx.profiles) {
+        const marker = p.name.toLowerCase() === resolvedProfileInfo.name.toLowerCase() ? '*' : ' ';
+        const company = p.company_name ? ` — ${p.company_name}` : '';
+        const tenant = p.tenant_id ? ` [tenant ${p.tenant_id}]` : '';
+        console.log(`${marker} ${p.name}${company}${tenant}`);
+    }
+});
 // --- doctor ---
 program
     .command('doctor')
@@ -320,14 +541,51 @@ program
             ? 'Windows DPAPI'
             : 'Linux Secret Service';
     pass('Credential store', storeBackend);
+    // 2b. Profile resolution
+    pass('Profile', `${resolvedProfileInfo.name} (source: ${resolvedProfileInfo.source})`);
+    // 2c. Active pointer health — surface a corrupt pointer file even though
+    // readActivePointer() degrades silently.
+    try {
+        const { paths } = await import('./profiles.js');
+        const fsp = await import('node:fs/promises');
+        const raw = await fsp.readFile(paths.activePointerFile, 'utf-8').catch(() => null);
+        if (raw !== null) {
+            const trimmed = raw.trim();
+            if (trimmed.length > 0) {
+                const { validateProfileName } = await import('./profile-name.js');
+                try {
+                    validateProfileName(trimmed);
+                    const idx = await readProfileIndex();
+                    const known = idx.profiles.some((p) => p.name.toLowerCase() === trimmed.toLowerCase());
+                    if (known) {
+                        pass('Active pointer', trimmed);
+                    }
+                    else {
+                        fail('Active pointer', `points to unknown profile "${trimmed}" — run \`noxctl profile use <name>\` to fix`);
+                    }
+                }
+                catch {
+                    fail('Active pointer', 'contains an invalid name — delete to reset');
+                }
+            }
+        }
+    }
+    catch {
+        // best-effort diagnostic — don't block doctor on filesystem issues
+    }
     // 3. Credentials exist
     const creds = await loadCredentials();
     if (!creds) {
-        fail('Credentials', 'not found — run `noxctl init` to set up');
+        fail('Credentials', `not found for profile "${resolvedProfileInfo.name}" — run \`noxctl init${resolvedProfileInfo.name === DEFAULT_PROFILE
+            ? ''
+            : ` --profile ${resolvedProfileInfo.name}`}\` to set up`);
         console.log(`\n${ok ? 'All checks passed.' : 'Some checks failed.'}`);
         return;
     }
     pass('Credentials', 'found');
+    if (creds.company_name) {
+        pass('Company (cached)', creds.company_name);
+    }
     // 4. Client ID present
     if (creds.client_id) {
         pass('Client ID', `${creds.client_id.slice(0, 8)}...`);
@@ -372,6 +630,7 @@ program
         article: 'articles?limit=1',
         customer: 'customers?limit=1',
         invoice: 'invoices?limit=1',
+        payment: 'invoicepayments?limit=1',
         supplier: 'suppliers?limit=1',
         supplierinvoice: 'supplierinvoices?limit=1',
         bookkeeping: 'vouchers?limit=1',
@@ -408,7 +667,7 @@ program
     .description('Start the MCP server (stdio transport)')
     .action(async () => {
     const { startMcpServer } = await import('./index.js');
-    await startMcpServer();
+    await startMcpServer({ profile: resolvedProfileInfo.name });
 });
 // --- invoices ---
 const invoices = program.command('invoices').description('Invoice operations');
@@ -990,6 +1249,679 @@ Examples:
     const data = await createVoucher(params);
     outputDetail(data, voucherDetailColumns, json());
 });
+// --- invoice-payments ---
+const invoicePayments = program
+    .command('invoice-payments')
+    .alias('ip')
+    .description('Invoice payment operations (inbetalningar)');
+invoicePayments
+    .command('list')
+    .description('List invoice payments')
+    .option('--invoice <number>', 'Filter by invoice number')
+    .option('--page <number>', 'Page number', parseInt)
+    .option('--limit <number>', 'Results per page', parseInt)
+    .option('-a, --all', 'Fetch all pages')
+    .action(async (opts) => {
+    const { listInvoicePayments } = await import('./operations/invoice-payments.js');
+    const data = await listInvoicePayments({
+        invoiceNumber: opts.invoice,
+        page: opts.page,
+        limit: opts.limit,
+        all: opts.all,
+    });
+    const envelope = data;
+    outputList(envelope.InvoicePayments ?? [], invoicePaymentListColumns, json(), data, envelope.MetaInformation);
+});
+invoicePayments
+    .command('get <paymentNumber>')
+    .description('Get a single invoice payment')
+    .action(async (paymentNumber) => {
+    const { getInvoicePayment } = await import('./operations/invoice-payments.js');
+    const data = await getInvoicePayment(paymentNumber);
+    outputDetail(data, invoicePaymentDetailColumns, json());
+});
+invoicePayments
+    .command('create')
+    .description('Register a payment against an invoice')
+    .requiredOption('--invoice <number>', 'Invoice number')
+    .requiredOption('--amount <amount>', 'Payment amount', parseFloat)
+    .requiredOption('--date <date>', 'Payment date (YYYY-MM-DD)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .addHelpText('after', `
+Examples:
+  noxctl invoice-payments create --invoice 1001 --amount 5000 --date 2026-03-20 --dry-run
+  noxctl ip create --invoice 1001 --amount 5000 --date 2026-03-20 --yes`)
+    .action(async (opts) => {
+    const { createInvoicePayment } = await import('./operations/invoice-payments.js');
+    const params = {
+        InvoiceNumber: parseInt(opts.invoice, 10),
+        Amount: opts.amount,
+        PaymentDate: opts.date,
+    };
+    if (!(await confirmMutation(`Register payment of ${opts.amount} for invoice ${opts.invoice}`, opts, {
+        InvoicePayment: params,
+    }))) {
+        return;
+    }
+    const data = await createInvoicePayment(params);
+    outputDetail(data, invoicePaymentDetailColumns, json());
+});
+invoicePayments
+    .command('delete <paymentNumber>')
+    .description('Delete an invoice payment')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the action without sending it')
+    .action(async (paymentNumber, opts) => {
+    const { deleteInvoicePayment } = await import('./operations/invoice-payments.js');
+    if (!(await confirmMutation(`Delete invoice payment ${paymentNumber}`, opts))) {
+        return;
+    }
+    await deleteInvoicePayment(paymentNumber);
+    outputConfirmation(`Invoice payment ${paymentNumber} deleted.`, json(), {});
+});
+invoicePayments
+    .command('bookkeep <paymentNumber>')
+    .description('Bookkeep an invoice payment')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the action without sending it')
+    .action(async (paymentNumber, opts) => {
+    const { bookkeepInvoicePayment } = await import('./operations/invoice-payments.js');
+    if (!(await confirmMutation(`Bookkeep invoice payment ${paymentNumber}`, opts))) {
+        return;
+    }
+    const result = await bookkeepInvoicePayment(paymentNumber);
+    outputConfirmation(`Invoice payment ${paymentNumber} bookkeept.`, json(), result);
+});
+// --- supplier-invoice-payments ---
+const supplierInvoicePayments = program
+    .command('supplier-invoice-payments')
+    .alias('sip')
+    .description('Supplier invoice payment operations (utbetalningar)');
+supplierInvoicePayments
+    .command('list')
+    .description('List supplier invoice payments')
+    .option('--invoice <number>', 'Filter by invoice number')
+    .option('--page <number>', 'Page number', parseInt)
+    .option('--limit <number>', 'Results per page', parseInt)
+    .option('-a, --all', 'Fetch all pages')
+    .action(async (opts) => {
+    const { listSupplierInvoicePayments } = await import('./operations/supplier-invoice-payments.js');
+    const data = await listSupplierInvoicePayments({
+        invoiceNumber: opts.invoice,
+        page: opts.page,
+        limit: opts.limit,
+        all: opts.all,
+    });
+    const envelope = data;
+    outputList(envelope.SupplierInvoicePayments ?? [], supplierInvoicePaymentListColumns, json(), data, envelope.MetaInformation);
+});
+supplierInvoicePayments
+    .command('get <paymentNumber>')
+    .description('Get a single supplier invoice payment')
+    .action(async (paymentNumber) => {
+    const { getSupplierInvoicePayment } = await import('./operations/supplier-invoice-payments.js');
+    const data = await getSupplierInvoicePayment(paymentNumber);
+    outputDetail(data, supplierInvoicePaymentDetailColumns, json());
+});
+supplierInvoicePayments
+    .command('create')
+    .description('Register a payment against a supplier invoice')
+    .requiredOption('--invoice <number>', 'Supplier invoice number')
+    .requiredOption('--amount <amount>', 'Payment amount', parseFloat)
+    .requiredOption('--date <date>', 'Payment date (YYYY-MM-DD)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .addHelpText('after', `
+Examples:
+  noxctl supplier-invoice-payments create --invoice 501 --amount 3000 --date 2026-03-20 --dry-run
+  noxctl sip create --invoice 501 --amount 3000 --date 2026-03-20 --yes`)
+    .action(async (opts) => {
+    const { createSupplierInvoicePayment } = await import('./operations/supplier-invoice-payments.js');
+    const params = {
+        InvoiceNumber: opts.invoice,
+        Amount: opts.amount,
+        PaymentDate: opts.date,
+    };
+    if (!(await confirmMutation(`Register payment of ${opts.amount} for supplier invoice ${opts.invoice}`, opts, { SupplierInvoicePayment: params }))) {
+        return;
+    }
+    const data = await createSupplierInvoicePayment(params);
+    outputDetail(data, supplierInvoicePaymentDetailColumns, json());
+});
+supplierInvoicePayments
+    .command('delete <paymentNumber>')
+    .description('Delete a supplier invoice payment')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the action without sending it')
+    .action(async (paymentNumber, opts) => {
+    const { deleteSupplierInvoicePayment } = await import('./operations/supplier-invoice-payments.js');
+    if (!(await confirmMutation(`Delete supplier invoice payment ${paymentNumber}`, opts))) {
+        return;
+    }
+    await deleteSupplierInvoicePayment(paymentNumber);
+    outputConfirmation(`Supplier invoice payment ${paymentNumber} deleted.`, json(), {});
+});
+// --- offers ---
+const offers = program.command('offers').description('Offer/quote operations (offerter)');
+offers
+    .command('list')
+    .description('List/filter offers')
+    .option('--filter <filter>', 'Filter: cancelled, expired, ordercreated, invoicecreated')
+    .option('--customer <number>', 'Filter by customer number')
+    .option('--from <date>', 'From date (YYYY-MM-DD)')
+    .option('--to <date>', 'To date (YYYY-MM-DD)')
+    .option('--page <number>', 'Page number', parseInt)
+    .option('--limit <number>', 'Results per page', parseInt)
+    .option('-a, --all', 'Fetch all pages')
+    .action(async (opts) => {
+    const { listOffers } = await import('./operations/offers.js');
+    const data = await listOffers({
+        filter: opts.filter,
+        customerNumber: opts.customer,
+        fromDate: opts.from,
+        toDate: opts.to,
+        page: opts.page,
+        limit: opts.limit,
+        all: opts.all,
+    });
+    const envelope = data;
+    outputList(envelope.Offers ?? [], offerListColumns, json(), data, envelope.MetaInformation);
+});
+offers
+    .command('get <documentNumber>')
+    .description('Get a single offer')
+    .action(async (documentNumber) => {
+    const { getOffer } = await import('./operations/offers.js');
+    const data = await getOffer(documentNumber);
+    outputDetail(data, offerDetailColumns, json());
+});
+offers
+    .command('create')
+    .description('Create an offer')
+    .requiredOption('--customer <number>', 'Customer number')
+    .requiredOption('--input <file>', 'Offer data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .addHelpText('after', `
+Examples:
+  echo '{"OfferRows":[{"Description":"Consulting","DeliveredQuantity":10,"Price":1200}]}' | noxctl offers create --customer 25 --input - --dry-run`)
+    .action(async (opts) => {
+    const { createOffer } = await import('./operations/offers.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const input = JSON.parse(raw);
+    const params = { CustomerNumber: opts.customer, ...input };
+    if (!(await confirmMutation(`Create offer for customer ${opts.customer}`, opts, {
+        Offer: params,
+    }))) {
+        return;
+    }
+    const data = await createOffer(params);
+    outputDetail(data, offerDetailColumns, json());
+});
+offers
+    .command('update <documentNumber>')
+    .description('Update an offer')
+    .requiredOption('--input <file>', 'Offer data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (documentNumber, opts) => {
+    const { updateOffer } = await import('./operations/offers.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const fields = JSON.parse(raw);
+    if (!(await confirmMutation(`Update offer ${documentNumber}`, opts, { Offer: fields }))) {
+        return;
+    }
+    const data = await updateOffer(documentNumber, fields);
+    outputDetail(data, offerDetailColumns, json());
+});
+offers
+    .command('create-invoice <documentNumber>')
+    .description('Create an invoice from an offer')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the action without sending it')
+    .action(async (documentNumber, opts) => {
+    const { createInvoiceFromOffer } = await import('./operations/offers.js');
+    if (!(await confirmMutation(`Create invoice from offer ${documentNumber}`, opts))) {
+        return;
+    }
+    const data = await createInvoiceFromOffer(documentNumber);
+    outputConfirmation(`Invoice created from offer ${documentNumber}.`, json(), data, invoiceConfirmColumns);
+});
+offers
+    .command('create-order <documentNumber>')
+    .description('Create an order from an offer')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the action without sending it')
+    .action(async (documentNumber, opts) => {
+    const { createOrderFromOffer } = await import('./operations/offers.js');
+    if (!(await confirmMutation(`Create order from offer ${documentNumber}`, opts))) {
+        return;
+    }
+    const data = await createOrderFromOffer(documentNumber);
+    outputConfirmation(`Order created from offer ${documentNumber}.`, json(), data);
+});
+// --- orders ---
+const orders = program.command('orders').description('Order operations (ordrar)');
+orders
+    .command('list')
+    .description('List/filter orders')
+    .option('--filter <filter>', 'Filter: cancelled, invoicecreated, invoicenotcreated')
+    .option('--customer <number>', 'Filter by customer number')
+    .option('--from <date>', 'From date (YYYY-MM-DD)')
+    .option('--to <date>', 'To date (YYYY-MM-DD)')
+    .option('--page <number>', 'Page number', parseInt)
+    .option('--limit <number>', 'Results per page', parseInt)
+    .option('-a, --all', 'Fetch all pages')
+    .action(async (opts) => {
+    const { listOrders } = await import('./operations/orders.js');
+    const data = await listOrders({
+        filter: opts.filter,
+        customerNumber: opts.customer,
+        fromDate: opts.from,
+        toDate: opts.to,
+        page: opts.page,
+        limit: opts.limit,
+        all: opts.all,
+    });
+    const envelope = data;
+    outputList(envelope.Orders ?? [], orderListColumns, json(), data, envelope.MetaInformation);
+});
+orders
+    .command('get <documentNumber>')
+    .description('Get a single order')
+    .action(async (documentNumber) => {
+    const { getOrder } = await import('./operations/orders.js');
+    const data = await getOrder(documentNumber);
+    outputDetail(data, orderDetailColumns, json());
+});
+orders
+    .command('create')
+    .description('Create an order')
+    .requiredOption('--customer <number>', 'Customer number')
+    .requiredOption('--input <file>', 'Order data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .addHelpText('after', `
+Examples:
+  echo '{"OrderRows":[{"Description":"Consulting","DeliveredQuantity":10,"Price":1200}]}' | noxctl orders create --customer 25 --input - --dry-run`)
+    .action(async (opts) => {
+    const { createOrder } = await import('./operations/orders.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const input = JSON.parse(raw);
+    const params = { CustomerNumber: opts.customer, ...input };
+    if (!(await confirmMutation(`Create order for customer ${opts.customer}`, opts, {
+        Order: params,
+    }))) {
+        return;
+    }
+    const data = await createOrder(params);
+    outputDetail(data, orderDetailColumns, json());
+});
+orders
+    .command('update <documentNumber>')
+    .description('Update an order')
+    .requiredOption('--input <file>', 'Order data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (documentNumber, opts) => {
+    const { updateOrder } = await import('./operations/orders.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const fields = JSON.parse(raw);
+    if (!(await confirmMutation(`Update order ${documentNumber}`, opts, { Order: fields }))) {
+        return;
+    }
+    const data = await updateOrder(documentNumber, fields);
+    outputDetail(data, orderDetailColumns, json());
+});
+orders
+    .command('create-invoice <documentNumber>')
+    .description('Create an invoice from an order')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the action without sending it')
+    .action(async (documentNumber, opts) => {
+    const { createInvoiceFromOrder } = await import('./operations/orders.js');
+    if (!(await confirmMutation(`Create invoice from order ${documentNumber}`, opts))) {
+        return;
+    }
+    const data = await createInvoiceFromOrder(documentNumber);
+    outputConfirmation(`Invoice created from order ${documentNumber}.`, json(), data, invoiceConfirmColumns);
+});
+// --- projects ---
+const projects = program.command('projects').description('Project operations');
+projects
+    .command('list')
+    .description('List projects')
+    .option('--page <number>', 'Page number', parseInt)
+    .option('--limit <number>', 'Results per page', parseInt)
+    .option('-a, --all', 'Fetch all pages')
+    .action(async (opts) => {
+    const { listProjects } = await import('./operations/projects.js');
+    const data = await listProjects({
+        page: opts.page,
+        limit: opts.limit,
+        all: opts.all,
+    });
+    const envelope = data;
+    outputList(envelope.Projects ?? [], projectListColumns, json(), data, envelope.MetaInformation);
+});
+projects
+    .command('get <projectNumber>')
+    .description('Get a single project')
+    .action(async (projectNumber) => {
+    const { getProject } = await import('./operations/projects.js');
+    const data = await getProject(projectNumber);
+    outputDetail(data, projectDetailColumns, json());
+});
+projects
+    .command('create')
+    .description('Create a project')
+    .requiredOption('--description <text>', 'Project description')
+    .option('--project-number <number>', 'Project number (auto-generated if omitted)')
+    .option('--status <status>', 'Status (ONGOING or COMPLETED)')
+    .option('--input <file>', 'Project data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (opts) => {
+    const { createProject } = await import('./operations/projects.js');
+    let input = {};
+    if (opts.input) {
+        const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+        input = JSON.parse(raw);
+    }
+    const params = { ...input, Description: opts.description };
+    if (opts.projectNumber)
+        params.ProjectNumber = opts.projectNumber;
+    if (opts.status)
+        params.Status = opts.status;
+    if (!(await confirmMutation(`Create project "${opts.description}"`, opts, { Project: params }))) {
+        return;
+    }
+    const data = await createProject(params);
+    outputDetail(data, projectDetailColumns, json());
+});
+projects
+    .command('update <projectNumber>')
+    .description('Update a project')
+    .requiredOption('--input <file>', 'Project data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (projectNumber, opts) => {
+    const { updateProject } = await import('./operations/projects.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const fields = JSON.parse(raw);
+    if (!(await confirmMutation(`Update project ${projectNumber}`, opts, { Project: fields }))) {
+        return;
+    }
+    const data = await updateProject(projectNumber, fields);
+    outputDetail(data, projectDetailColumns, json());
+});
+// --- cost centers ---
+const costcenters = program.command('costcenters').description('Cost center operations');
+costcenters
+    .command('list')
+    .description('List cost centers')
+    .option('--page <number>', 'Page number', parseInt)
+    .option('--limit <number>', 'Results per page', parseInt)
+    .option('-a, --all', 'Fetch all pages')
+    .action(async (opts) => {
+    const { listCostCenters } = await import('./operations/costcenters.js');
+    const data = await listCostCenters({
+        page: opts.page,
+        limit: opts.limit,
+        all: opts.all,
+    });
+    const envelope = data;
+    outputList(envelope.CostCenters ?? [], costCenterListColumns, json(), data, envelope.MetaInformation);
+});
+costcenters
+    .command('get <code>')
+    .description('Get a single cost center')
+    .action(async (code) => {
+    const { getCostCenter } = await import('./operations/costcenters.js');
+    const data = await getCostCenter(code);
+    outputDetail(data, costCenterDetailColumns, json());
+});
+costcenters
+    .command('create')
+    .description('Create a cost center')
+    .requiredOption('--code <code>', 'Cost center code')
+    .requiredOption('--description <text>', 'Description')
+    .option('--input <file>', 'Cost center data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (opts) => {
+    const { createCostCenter } = await import('./operations/costcenters.js');
+    let input = {};
+    if (opts.input) {
+        const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+        input = JSON.parse(raw);
+    }
+    const params = {
+        ...input,
+        Code: opts.code,
+        Description: opts.description,
+    };
+    if (!(await confirmMutation(`Create cost center "${opts.code}"`, opts, { CostCenter: params }))) {
+        return;
+    }
+    const data = await createCostCenter(params);
+    outputDetail(data, costCenterDetailColumns, json());
+});
+costcenters
+    .command('update <code>')
+    .description('Update a cost center')
+    .requiredOption('--input <file>', 'Cost center data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (code, opts) => {
+    const { updateCostCenter } = await import('./operations/costcenters.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const fields = JSON.parse(raw);
+    if (!(await confirmMutation(`Update cost center ${code}`, opts, { CostCenter: fields }))) {
+        return;
+    }
+    const data = await updateCostCenter(code, fields);
+    outputDetail(data, costCenterDetailColumns, json());
+});
+costcenters
+    .command('delete <code>')
+    .description('Delete a cost center')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (code, opts) => {
+    const { deleteCostCenter } = await import('./operations/costcenters.js');
+    if (!(await confirmMutation(`Delete cost center ${code}`, opts))) {
+        return;
+    }
+    await deleteCostCenter(code);
+    console.log(`Cost center ${code} deleted.`);
+});
+// --- tax reductions (ROT/RUT) ---
+const taxreductions = program
+    .command('tax-reductions')
+    .description('Tax reduction (ROT/RUT) operations');
+taxreductions
+    .command('list')
+    .description('List tax reductions')
+    .option('--filter <type>', 'Filter by document type (invoices, offers, orders)')
+    .option('--page <number>', 'Page number', parseInt)
+    .option('--limit <number>', 'Results per page', parseInt)
+    .option('-a, --all', 'Fetch all pages')
+    .action(async (opts) => {
+    const { listTaxReductions } = await import('./operations/taxreductions.js');
+    const data = await listTaxReductions({
+        filter: opts.filter,
+        page: opts.page,
+        limit: opts.limit,
+        all: opts.all,
+    });
+    const envelope = data;
+    outputList(envelope.TaxReductions ?? [], taxReductionListColumns, json(), data, envelope.MetaInformation);
+});
+taxreductions
+    .command('get <id>')
+    .description('Get a single tax reduction')
+    .action(async (id) => {
+    const { getTaxReduction } = await import('./operations/taxreductions.js');
+    const data = await getTaxReduction(parseInt(id, 10));
+    outputDetail(data, taxReductionDetailColumns, json());
+});
+taxreductions
+    .command('create')
+    .description('Create a tax reduction (ROT/RUT)')
+    .requiredOption('--reference <number>', 'Reference number (e.g. invoice number)')
+    .requiredOption('--type <type>', 'Type of reduction (rot or rut)')
+    .requiredOption('--document-type <type>', 'Document type (INVOICE, OFFER, ORDER)')
+    .requiredOption('--customer-name <name>', 'Customer name')
+    .requiredOption('--amount <amount>', 'Asked amount in öre', parseInt)
+    .option('--property <designation>', 'Property designation (required for ROT)')
+    .option('--input <file>', 'Tax reduction data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (opts) => {
+    const { createTaxReduction } = await import('./operations/taxreductions.js');
+    let input = {};
+    if (opts.input) {
+        const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+        input = JSON.parse(raw);
+    }
+    const params = {
+        ...input,
+        ReferenceNumber: opts.reference,
+        ReferenceDocumentType: opts.documentType,
+        TypeOfReduction: opts.type,
+        CustomerName: opts.customerName,
+        AskedAmount: opts.amount,
+    };
+    if (opts.property)
+        params.PropertyDesignation = opts.property;
+    if (!(await confirmMutation(`Create ${opts.type.toUpperCase()} tax reduction for ref ${opts.reference}`, opts, { TaxReduction: params }))) {
+        return;
+    }
+    const data = await createTaxReduction(params);
+    outputDetail(data, taxReductionDetailColumns, json());
+});
+// --- price lists ---
+const pricelists = program.command('pricelists').description('Price list operations');
+pricelists
+    .command('list')
+    .description('List price lists')
+    .option('--page <number>', 'Page number', parseInt)
+    .option('--limit <number>', 'Results per page', parseInt)
+    .option('-a, --all', 'Fetch all pages')
+    .action(async (opts) => {
+    const { listPriceLists } = await import('./operations/pricelists.js');
+    const data = await listPriceLists({
+        page: opts.page,
+        limit: opts.limit,
+        all: opts.all,
+    });
+    const envelope = data;
+    outputList(envelope.PriceLists ?? [], priceListListColumns, json(), data, envelope.MetaInformation);
+});
+pricelists
+    .command('get <code>')
+    .description('Get a single price list')
+    .action(async (code) => {
+    const { getPriceList } = await import('./operations/pricelists.js');
+    const data = await getPriceList(code);
+    outputDetail(data, priceListDetailColumns, json());
+});
+pricelists
+    .command('create')
+    .description('Create a price list')
+    .requiredOption('--code <code>', 'Price list code')
+    .requiredOption('--description <text>', 'Description')
+    .option('--input <file>', 'Price list data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (opts) => {
+    const { createPriceList } = await import('./operations/pricelists.js');
+    let input = {};
+    if (opts.input) {
+        const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+        input = JSON.parse(raw);
+    }
+    const params = {
+        ...input,
+        Code: opts.code,
+        Description: opts.description,
+    };
+    if (!(await confirmMutation(`Create price list "${opts.code}"`, opts, { PriceList: params }))) {
+        return;
+    }
+    const data = await createPriceList(params);
+    outputDetail(data, priceListDetailColumns, json());
+});
+pricelists
+    .command('update <code>')
+    .description('Update a price list')
+    .requiredOption('--input <file>', 'Price list data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (code, opts) => {
+    const { updatePriceList } = await import('./operations/pricelists.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const fields = JSON.parse(raw);
+    if (!(await confirmMutation(`Update price list ${code}`, opts, { PriceList: fields }))) {
+        return;
+    }
+    const data = await updatePriceList(code, fields);
+    outputDetail(data, priceListDetailColumns, json());
+});
+// --- prices ---
+const prices = program.command('prices').description('Price operations within price lists');
+prices
+    .command('list')
+    .description('List prices in a price list')
+    .requiredOption('--pricelist <code>', 'Price list code')
+    .option('--article <number>', 'Filter by article number')
+    .option('--page <number>', 'Page number', parseInt)
+    .option('--limit <number>', 'Results per page', parseInt)
+    .action(async (opts) => {
+    const { listPrices } = await import('./operations/pricelists.js');
+    const data = await listPrices({
+        priceListCode: opts.pricelist,
+        articleNumber: opts.article,
+        page: opts.page,
+        limit: opts.limit,
+    });
+    const envelope = data;
+    outputList(envelope.Prices ?? [], priceListColumns, json(), data, envelope.MetaInformation);
+});
+prices
+    .command('get')
+    .description('Get a specific price')
+    .requiredOption('--pricelist <code>', 'Price list code')
+    .requiredOption('--article <number>', 'Article number')
+    .option('--from-quantity <number>', 'From quantity (default 0)', parseInt)
+    .action(async (opts) => {
+    const { getPrice } = await import('./operations/pricelists.js');
+    const data = await getPrice(opts.pricelist, opts.article, opts.fromQuantity);
+    outputDetail(data, priceDetailColumns, json());
+});
+prices
+    .command('update')
+    .description('Update a price')
+    .requiredOption('--pricelist <code>', 'Price list code')
+    .requiredOption('--article <number>', 'Article number')
+    .option('--from-quantity <number>', 'From quantity (default 0)', parseInt)
+    .requiredOption('--input <file>', 'Price data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (opts) => {
+    const { updatePrice } = await import('./operations/pricelists.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const fields = JSON.parse(raw);
+    if (!(await confirmMutation(`Update price ${opts.pricelist}/${opts.article}`, opts, {
+        Price: fields,
+    }))) {
+        return;
+    }
+    const data = await updatePrice(opts.pricelist, opts.article, fields, opts.fromQuantity);
+    outputDetail(data, priceDetailColumns, json());
+});
 // Error handling
 program.exitOverride();
 try {