noxctl 0.1.0

package/dist/cli.js

@@ -0,0 +1,1012 @@
+#!/usr/bin/env node
+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';
+const program = new Command();
+program
+    .name('noxctl')
+    .description('CLI and MCP server for Fortnox accounting')
+    .version('0.1.0')
+    .addOption(new Option('-o, --output <format>', 'Output format')
+    .choices(['json', 'table'])
+    .default(undefined));
+function json() {
+    return isJsonMode(program.opts());
+}
+async function confirmMutation(action, opts, payload) {
+    if (opts.dryRun) {
+        console.log(`Dry run: ${action}. No request was sent to Fortnox.`);
+        if (payload !== undefined) {
+            console.log('\nRequest payload:');
+            console.log(JSON.stringify(payload, null, 2));
+        }
+        return false;
+    }
+    if (opts.yes)
+        return true;
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        throw new Error(`Confirmation required to ${action}. Re-run with --yes, or --dry-run first.`);
+    }
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    try {
+        const answer = await rl.question(`${action}. Continue? [y/N] `);
+        return ['y', 'yes'].includes(answer.trim().toLowerCase());
+    }
+    finally {
+        rl.close();
+    }
+}
+// --- init (interactive setup wizard) ---
+program
+    .command('init')
+    .description('Interactive setup wizard — recommended onboarding path')
+    .action(async () => {
+    const { loadCredentials, runOAuthSetup } = await import('./auth.js');
+    // Step 1: Check if already configured
+    const existing = await loadCredentials();
+    if (existing) {
+        console.log('Existing credentials found.');
+        if (process.stdin.isTTY && process.stdout.isTTY) {
+            const rlExisting = createInterface({
+                input: process.stdin,
+                output: process.stdout,
+            });
+            try {
+                const answer = (await rlExisting.question('Re-run setup? This will replace your current credentials. [y/N] '))
+                    .trim()
+                    .toLowerCase();
+                if (answer !== 'y' && answer !== 'yes') {
+                    console.log('Run `noxctl company info` to verify your current connection.');
+                    return;
+                }
+            }
+            finally {
+                rlExisting.close();
+            }
+        }
+        else {
+            console.log('Run `noxctl company info` to verify, or re-run interactively to reconfigure.');
+            return;
+        }
+    }
+    // Step 2: Welcome message
+    console.log('Welcome to noxctl init!');
+    console.log('');
+    console.log("You'll need a Fortnox app from developer.fortnox.se with:");
+    console.log('  - Redirect URI: http://localhost:9876/callback');
+    console.log('  - Scopes (Behörigheter): Artikel, Bokföring, Faktura, Företagsinformation, Inställningar, Kund, Leverantör, Leverantörsfaktura');
+    console.log('  - Service account enabled (recommended)');
+    console.log('');
+    console.log('See the README for detailed portal instructions.');
+    console.log('');
+    const isTTY = process.stdin.isTTY && process.stdout.isTTY;
+    let clientId;
+    let clientSecret;
+    let serviceAccount;
+    if (!isTTY) {
+        // CI / non-interactive mode: fall back to env vars
+        clientId = process.env.FORTNOX_CLIENT_ID ?? '';
+        clientSecret = process.env.FORTNOX_CLIENT_SECRET ?? '';
+        serviceAccount = process.env.FORTNOX_SERVICE_ACCOUNT === '1';
+        if (!clientId || !clientSecret) {
+            console.error('Error: stdin is not a TTY. Set FORTNOX_CLIENT_ID and FORTNOX_CLIENT_SECRET env vars to run non-interactively.');
+            process.exit(1);
+        }
+    }
+    else {
+        let rl = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        try {
+            // Step 3: Prompt for Client ID
+            const envClientId = process.env.FORTNOX_CLIENT_ID;
+            const clientIdPrompt = envClientId ? `Client ID [${envClientId}]: ` : 'Client ID: ';
+            const clientIdAnswer = (await rl.question(clientIdPrompt)).trim();
+            clientId = clientIdAnswer || envClientId || '';
+            if (!clientId) {
+                console.error('Error: Client ID is required.');
+                process.exit(1);
+            }
+            // Step 4: Prompt for Client Secret (masked input)
+            const envClientSecret = process.env.FORTNOX_CLIENT_SECRET;
+            if (envClientSecret) {
+                process.stdout.write('Client Secret [env var set — press Enter to use it]: ');
+            }
+            else {
+                process.stdout.write('Client Secret: ');
+            }
+            // Temporarily close rl so we can use raw mode for masked input
+            rl.close();
+            const clientSecretAnswer = await new Promise((resolve) => {
+                let buf = '';
+                const stdin = process.stdin;
+                stdin.setRawMode(true);
+                stdin.resume();
+                stdin.setEncoding('utf-8');
+                const onData = (chunk) => {
+                    for (const ch of chunk) {
+                        if (ch === '\r' || ch === '\n') {
+                            stdin.setRawMode(false);
+                            stdin.removeListener('data', onData);
+                            process.stdout.write('\n');
+                            resolve(buf.trim());
+                            return;
+                        }
+                        else if (ch === '\u007f' || ch === '\b') {
+                            if (buf.length > 0) {
+                                buf = buf.slice(0, -1);
+                                process.stdout.write('\b \b');
+                            }
+                        }
+                        else if (ch === '\u0003') {
+                            // Ctrl-C
+                            process.exit(1);
+                        }
+                        else {
+                            buf += ch;
+                        }
+                    }
+                };
+                stdin.on('data', onData);
+            });
+            // Re-create rl for subsequent questions
+            rl = createInterface({
+                input: process.stdin,
+                output: process.stdout,
+            });
+            clientSecret = clientSecretAnswer || envClientSecret || '';
+            if (!clientSecret) {
+                console.error('Error: Client Secret is required.');
+                process.exit(1);
+            }
+            // Step 5: Service account question — default yes
+            console.log('');
+            console.log('Service account mode lets noxctl refresh tokens automatically without');
+            console.log('opening a browser each time. Enable it in the Fortnox developer portal');
+            console.log('under your app\'s OAuth settings ("Möjliggör auktorisering som servicekonto").');
+            console.log('');
+            const saAnswer = (await rl.question('Is service account mode enabled for your app? [Y/n] '))
+                .trim()
+                .toLowerCase();
+            serviceAccount = saAnswer === '' || saAnswer === 'y' || saAnswer === 'yes';
+        }
+        finally {
+            rl.close();
+        }
+    }
+    // Step 6: Run OAuth flow
+    await runOAuthSetup({ clientId, clientSecret, serviceAccount });
+    // Step 7: Verify by fetching company info
+    try {
+        const { getCompanyInfo } = await import('./operations/company.js');
+        const data = await getCompanyInfo();
+        const company = data;
+        console.log('');
+        console.log('Connected successfully!');
+        if (company['CompanyName']) {
+            console.log(`  Company: ${company['CompanyName']}`);
+        }
+        if (company['OrganizationNumber']) {
+            console.log(`  Org number: ${company['OrganizationNumber']}`);
+        }
+    }
+    catch {
+        console.log('');
+        console.log('OAuth completed. Could not verify company info — you can run `noxctl company info` manually.');
+    }
+    // Step 8: Offer to register MCP server with Claude Code
+    if (process.stdin.isTTY && process.stdout.isTTY) {
+        const rl2 = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        try {
+            // Detect whether we're running via npx or from a local build.
+            const argv0 = process.argv[1] ?? '';
+            const useNpx = argv0.includes('npx') || argv0.includes('.bin/noxctl');
+            console.log('');
+            const mcpAnswer = (await rl2.question('Register the MCP server with Claude Code? [Y/n] '))
+                .trim()
+                .toLowerCase();
+            const doRegister = mcpAnswer === '' || mcpAnswer === 'y' || mcpAnswer === 'yes';
+            if (doRegister) {
+                const { execFile } = await import('node:child_process');
+                // All arguments below are static constants — no user input is interpolated.
+                const mcpArgs = useNpx
+                    ? ['mcp', 'add', 'fortnox', '--', 'npx', 'noxctl', 'serve']
+                    : ['mcp', 'add', 'fortnox', '--', 'node', argv0, 'serve'];
+                await new Promise((resolve) => {
+                    execFile('claude', mcpArgs, (err) => {
+                        if (err) {
+                            const fallbackCmd = ['claude', ...mcpArgs].join(' ');
+                            console.log('Could not register automatically. Run this manually:');
+                            console.log(`  ${fallbackCmd}`);
+                        }
+                        else {
+                            console.log('MCP server registered. Restart Claude Code to pick it up.');
+                        }
+                        resolve();
+                    });
+                });
+            }
+            // Offer npm link for local clone users so `noxctl` is in PATH
+            if (!useNpx) {
+                console.log('');
+                const linkAnswer = (await rl2.question('Add `noxctl` to your PATH via npm link? [Y/n] '))
+                    .trim()
+                    .toLowerCase();
+                const doLink = linkAnswer === '' || linkAnswer === 'y' || linkAnswer === 'yes';
+                if (doLink) {
+                    const { execFile: execFileLink } = await import('node:child_process');
+                    await new Promise((resolve) => {
+                        execFileLink('npm', ['link'], { cwd: process.cwd() }, (err) => {
+                            if (err) {
+                                console.log('Could not link automatically. Run this manually:');
+                                console.log('  npm link');
+                            }
+                            else {
+                                console.log('Done! `noxctl` is now available globally.');
+                            }
+                            resolve();
+                        });
+                    });
+                }
+            }
+        }
+        finally {
+            rl2.close();
+        }
+    }
+});
+// --- logout ---
+program
+    .command('logout')
+    .description('Remove stored Fortnox credentials')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .action(async (opts) => {
+    const { loadCredentials } = await import('./auth.js');
+    const { deleteCredentialBlob } = await import('./credentials-store.js');
+    const existing = await loadCredentials();
+    if (!existing) {
+        console.log('No credentials found. Nothing to remove.');
+        return;
+    }
+    if (!(await confirmMutation('Remove stored Fortnox credentials', opts))) {
+        return;
+    }
+    const deleted = await deleteCredentialBlob();
+    if (deleted) {
+        console.log('Credentials 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.');
+    }
+});
+// --- doctor ---
+program
+    .command('doctor')
+    .description('Check setup: credentials, token, API connectivity, and scopes')
+    .action(async () => {
+    const { loadCredentials } = await import('./auth.js');
+    let ok = true;
+    function pass(label, detail) {
+        console.log(`  ✓ ${label}${detail ? ` — ${detail}` : ''}`);
+    }
+    function fail(label, detail) {
+        ok = false;
+        console.log(`  ✗ ${label}${detail ? ` — ${detail}` : ''}`);
+    }
+    console.log('Checking noxctl configuration...\n');
+    // 1. Node version
+    const nodeVersion = process.versions.node;
+    const major = parseInt(nodeVersion.split('.')[0], 10);
+    if (major >= 20) {
+        pass('Node.js', `v${nodeVersion}`);
+    }
+    else {
+        fail('Node.js', `v${nodeVersion} (need 20+)`);
+    }
+    // 2. Credential store backend
+    const storeBackend = process.platform === 'darwin'
+        ? 'macOS Keychain'
+        : process.platform === 'win32'
+            ? 'Windows DPAPI'
+            : 'Linux Secret Service';
+    pass('Credential store', storeBackend);
+    // 3. Credentials exist
+    const creds = await loadCredentials();
+    if (!creds) {
+        fail('Credentials', 'not found — run `noxctl init` to set up');
+        console.log(`\n${ok ? 'All checks passed.' : 'Some checks failed.'}`);
+        return;
+    }
+    pass('Credentials', 'found');
+    // 4. Client ID present
+    if (creds.client_id) {
+        pass('Client ID', `${creds.client_id.slice(0, 8)}...`);
+    }
+    else {
+        fail('Client ID', 'missing');
+    }
+    // 5. Tenant ID (service account)
+    if (creds.tenant_id) {
+        pass('Service account', `tenant ${creds.tenant_id}`);
+    }
+    else {
+        pass('Service account', 'not configured (using refresh token flow)');
+    }
+    // 6. Token expiry
+    const now = Date.now();
+    if (creds.expires_at > now) {
+        const minutesLeft = Math.round((creds.expires_at - now) / 60000);
+        pass('Access token', `valid for ~${minutesLeft} min`);
+    }
+    else {
+        pass('Access token', 'expired (will auto-refresh on next request)');
+    }
+    // 7. API connectivity — try fetching company info
+    try {
+        const { getCompanyInfo } = await import('./operations/company.js');
+        const data = await getCompanyInfo();
+        const company = data;
+        const name = company['CompanyName'] || 'unknown';
+        pass('API connection', `${name}`);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        fail('API connection', msg);
+        console.log(`\n${ok ? 'All checks passed.' : 'Some checks failed.'}`);
+        return;
+    }
+    // 8. Scope validation — probe each scope with a lightweight GET
+    const { SCOPES } = await import('./auth.js');
+    const { fortnoxRequest, FortnoxApiError } = await import('./fortnox-client.js');
+    const scopeEndpoints = {
+        article: 'articles?limit=1',
+        customer: 'customers?limit=1',
+        invoice: 'invoices?limit=1',
+        supplier: 'suppliers?limit=1',
+        supplierinvoice: 'supplierinvoices?limit=1',
+        bookkeeping: 'vouchers?limit=1',
+        companyinformation: 'companyinformation',
+        settings: 'settings/company',
+    };
+    const required = SCOPES.split(' ');
+    const missing = [];
+    for (const scope of required) {
+        const endpoint = scopeEndpoints[scope];
+        if (!endpoint)
+            continue;
+        try {
+            await fortnoxRequest(endpoint);
+        }
+        catch (err) {
+            if (err instanceof FortnoxApiError && err.statusCode === 403) {
+                missing.push(scope);
+            }
+            // Non-403 errors (e.g. 500) are not scope problems — ignore here
+        }
+    }
+    if (missing.length === 0) {
+        pass('Scopes', `all ${required.length} scopes authorized`);
+    }
+    else {
+        fail('Scopes', `missing: ${missing.join(', ')}. Enable them in your Fortnox app at developer.fortnox.se`);
+    }
+    console.log(`\n${ok ? 'All checks passed.' : 'Some checks failed.'}`);
+});
+// --- serve (default command) ---
+program
+    .command('serve', { isDefault: true })
+    .description('Start the MCP server (stdio transport)')
+    .action(async () => {
+    const { startMcpServer } = await import('./index.js');
+    await startMcpServer();
+});
+// --- invoices ---
+const invoices = program.command('invoices').description('Invoice operations');
+invoices
+    .command('list')
+    .description('List/filter invoices')
+    .option('--filter <filter>', 'Filter: cancelled, fullypaid, unpaid, unpaidoverdue, unbooked')
+    .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 { listInvoices } = await import('./operations/invoices.js');
+    const data = await listInvoices({
+        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.Invoices ?? [], invoiceListColumns, json(), data, envelope.MetaInformation);
+});
+invoices
+    .command('get <documentNumber>')
+    .description('Get a single invoice')
+    .action(async (documentNumber) => {
+    const { getInvoice } = await import('./operations/invoices.js');
+    const data = await getInvoice(documentNumber);
+    outputDetail(data, invoiceDetailColumns, json());
+});
+invoices
+    .command('create')
+    .description('Create an invoice')
+    .requiredOption('--customer <number>', 'Customer number')
+    .requiredOption('--input <file>', 'Invoice 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 '{"InvoiceRows":[{"ArticleNumber":"1","DeliveredQuantity":10,"Price":1500}]}' | noxctl invoices create --customer 25 --input - --dry-run
+
+  # Minimal JSON (Description instead of ArticleNumber):
+  echo '{"InvoiceRows":[{"Description":"Consulting","DeliveredQuantity":8,"Price":1200,"AccountNumber":3001,"VAT":25}]}' | noxctl invoices create --customer 25 --input - --yes`)
+    .action(async (opts) => {
+    const { createInvoice } = await import('./operations/invoices.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 invoice for customer ${opts.customer}`, opts, {
+        Invoice: params,
+    }))) {
+        return;
+    }
+    const data = await createInvoice(params);
+    outputDetail(data, invoiceDetailColumns, json());
+});
+invoices
+    .command('update <documentNumber>')
+    .description('Update an invoice (not yet bookkeept)')
+    .requiredOption('--input <file>', 'Invoice 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 '{"DueDate":"2026-04-30","OurReference":"Casey Example"}' | noxctl invoices update 28 --input - --dry-run
+  echo '{"InvoiceRows":[{"ArticleNumber":"1","DeliveredQuantity":5,"Price":2000}]}' | noxctl invoices update 28 --input - --yes`)
+    .action(async (documentNumber, opts) => {
+    const { updateInvoice } = await import('./operations/invoices.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const fields = JSON.parse(raw);
+    if (!(await confirmMutation(`Update invoice ${documentNumber}`, opts, { Invoice: fields }))) {
+        return;
+    }
+    const data = await updateInvoice(documentNumber, fields);
+    outputDetail(data, invoiceDetailColumns, json());
+});
+invoices
+    .command('send <documentNumber>')
+    .description('Send an invoice')
+    .addOption(new Option('--method <method>', 'Send method: email, print, einvoice')
+    .choices(['email', 'print', 'einvoice'])
+    .default('email'))
+    .option('--subject <subject>', 'Email subject (default: keeps existing)')
+    .option('--body <body>', 'Email body text')
+    .option('--bcc <email>', 'BCC email address')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the action without sending it')
+    .action(async (documentNumber, opts) => {
+    const { sendInvoice } = await import('./operations/invoices.js');
+    if (!(await confirmMutation(`Send invoice ${documentNumber} via ${opts.method}`, opts))) {
+        return;
+    }
+    const emailOptions = opts.subject || opts.body || opts.bcc
+        ? { subject: opts.subject, body: opts.body, bcc: opts.bcc }
+        : undefined;
+    const data = await sendInvoice(documentNumber, opts.method, emailOptions);
+    outputConfirmation(`Invoice ${documentNumber} sent via ${opts.method}.`, json(), data, invoiceConfirmColumns);
+});
+invoices
+    .command('bookkeep <documentNumber>')
+    .description('Bookkeep an invoice')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the action without sending it')
+    .action(async (documentNumber, opts) => {
+    const { bookkeepInvoice } = await import('./operations/invoices.js');
+    if (!(await confirmMutation(`Bookkeep invoice ${documentNumber}`, opts))) {
+        return;
+    }
+    const data = await bookkeepInvoice(documentNumber);
+    outputConfirmation(`Invoice ${documentNumber} bookkeept.`, json(), data, invoiceConfirmColumns);
+});
+invoices
+    .command('credit <documentNumber>')
+    .description('Credit an invoice')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the action without sending it')
+    .action(async (documentNumber, opts) => {
+    const { creditInvoice } = await import('./operations/invoices.js');
+    if (!(await confirmMutation(`Credit invoice ${documentNumber}`, opts))) {
+        return;
+    }
+    const data = await creditInvoice(documentNumber);
+    outputConfirmation(`Invoice ${documentNumber} credited.`, json(), data, invoiceConfirmColumns);
+});
+// --- tax ---
+const tax = program.command('tax').description('Tax operations');
+tax
+    .command('report')
+    .description('Generate VAT tax report for a period')
+    .requiredOption('--from <date>', 'From date (YYYY-MM-DD)')
+    .requiredOption('--to <date>', 'To date (YYYY-MM-DD)')
+    .option('--year <number>', 'Financial year', parseInt)
+    .action(async (opts) => {
+    const { generateTaxReport } = await import('./operations/tax.js');
+    const data = await generateTaxReport({
+        fromDate: opts.from,
+        toDate: opts.to,
+        financialYear: opts.year,
+    });
+    if (json()) {
+        console.log(JSON.stringify(data, null, 2));
+    }
+    else {
+        console.log(formatTaxReport(data));
+    }
+});
+// --- reports ---
+const reports = program
+    .command('reports')
+    .description('Financial reports (resultat/balansräkning)');
+reports
+    .command('income')
+    .alias('resultat')
+    .description('Income statement (resultaträkning)')
+    .option('--year <number>', 'Financial year', parseInt)
+    .option('--from <date>', 'From date (YYYY-MM-DD)')
+    .option('--to <date>', 'To date (YYYY-MM-DD)')
+    .action(async (opts) => {
+    const { getIncomeStatement } = await import('./operations/financial-reports.js');
+    const data = await getIncomeStatement({
+        financialYear: opts.year,
+        fromDate: opts.from,
+        toDate: opts.to,
+    });
+    if (json()) {
+        console.log(JSON.stringify(data, null, 2));
+    }
+    else {
+        console.log(formatFinancialReport(data));
+    }
+});
+reports
+    .command('balance')
+    .alias('balans')
+    .description('Balance sheet (balansräkning)')
+    .option('--year <number>', 'Financial year', parseInt)
+    .option('--to <date>', 'As-of date (YYYY-MM-DD)')
+    .action(async (opts) => {
+    const { getBalanceSheet } = await import('./operations/financial-reports.js');
+    const data = await getBalanceSheet({ financialYear: opts.year, toDate: opts.to });
+    if (json()) {
+        console.log(JSON.stringify(data, null, 2));
+    }
+    else {
+        console.log(formatFinancialReport(data));
+    }
+});
+// --- accounts ---
+const accounts = program.command('accounts').description('Chart of accounts operations');
+accounts
+    .command('list')
+    .description('List accounts')
+    .option('--search <term>', 'Search by account name or number')
+    .option('--year <number>', 'Financial year', parseInt)
+    .option('--page <number>', 'Page number', parseInt)
+    .option('--limit <number>', 'Results per page', parseInt)
+    .option('-a, --all', 'Fetch all pages')
+    .action(async (opts) => {
+    const { listAccounts } = await import('./operations/accounts.js');
+    const data = await listAccounts({
+        search: opts.search,
+        financialYear: opts.year,
+        page: opts.page,
+        limit: opts.limit,
+        all: opts.all,
+    });
+    outputList(data.Accounts ?? [], accountListColumns, json(), data, data.MetaInformation);
+});
+// --- customers ---
+const customers = program.command('customers').description('Customer operations');
+customers
+    .command('list')
+    .description('List/search customers')
+    .option('--search <term>', 'Search by name')
+    .option('--page <number>', 'Page number', parseInt)
+    .option('--limit <number>', 'Results per page', parseInt)
+    .option('-a, --all', 'Fetch all pages')
+    .action(async (opts) => {
+    const { listCustomers } = await import('./operations/customers.js');
+    const data = await listCustomers({
+        search: opts.search,
+        page: opts.page,
+        limit: opts.limit,
+        all: opts.all,
+    });
+    const envelope = data;
+    outputList(envelope.Customers ?? [], customerListColumns, json(), data, envelope.MetaInformation);
+});
+customers
+    .command('get <customerNumber>')
+    .description('Get a single customer')
+    .action(async (customerNumber) => {
+    const { getCustomer } = await import('./operations/customers.js');
+    const data = await getCustomer(customerNumber);
+    outputDetail(data, customerDetailColumns, json());
+});
+customers
+    .command('create')
+    .description('Create a customer')
+    .requiredOption('--name <name>', 'Customer name')
+    .option('--input <file>', 'Customer 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:
+  noxctl customers create --name "Acme AB" --yes
+  echo '{"OrganisationNumber":"556677-8899","Email":"info@acme.se","City":"Stockholm"}' | noxctl customers create --name "Acme AB" --input - --yes`)
+    .action(async (opts) => {
+    const { createCustomer } = await import('./operations/customers.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, Name: opts.name };
+    if (!(await confirmMutation(`Create customer "${opts.name}"`, opts, { Customer: params }))) {
+        return;
+    }
+    const data = await createCustomer(params);
+    outputDetail(data, customerDetailColumns, json());
+});
+customers
+    .command('update <customerNumber>')
+    .description('Update a customer')
+    .requiredOption('--input <file>', 'Customer 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 '{"Email":"new@acme.se","Phone":"08-123456"}' | noxctl customers update 25 --input - --yes`)
+    .action(async (customerNumber, opts) => {
+    const { updateCustomer } = await import('./operations/customers.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const fields = JSON.parse(raw);
+    if (!(await confirmMutation(`Update customer ${customerNumber}`, opts, { Customer: fields }))) {
+        return;
+    }
+    const data = await updateCustomer(customerNumber, fields);
+    outputDetail(data, customerDetailColumns, json());
+});
+// --- articles ---
+const articles = program.command('articles').description('Article operations');
+articles
+    .command('list')
+    .description('List/search articles')
+    .option('--search <term>', 'Search by description')
+    .option('--page <number>', 'Page number', parseInt)
+    .option('--limit <number>', 'Results per page', parseInt)
+    .option('-a, --all', 'Fetch all pages')
+    .action(async (opts) => {
+    const { listArticles } = await import('./operations/articles.js');
+    const data = await listArticles({
+        search: opts.search,
+        page: opts.page,
+        limit: opts.limit,
+        all: opts.all,
+    });
+    const envelope = data;
+    outputList(envelope.Articles ?? [], articleListColumns, json(), data, envelope.MetaInformation);
+});
+articles
+    .command('get <articleNumber>')
+    .description('Get a single article')
+    .action(async (articleNumber) => {
+    const { getArticle } = await import('./operations/articles.js');
+    const data = await getArticle(articleNumber);
+    outputDetail(data, articleDetailColumns, json());
+});
+articles
+    .command('create')
+    .description('Create an article')
+    .requiredOption('--description <text>', 'Article description')
+    .option('--article-number <number>', 'Article number (auto-generated if omitted)')
+    .option('--input <file>', 'Article 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:
+  noxctl articles create --description "Konsulttimme" --yes
+  echo '{"SalesPrice":1500,"Unit":"tim","SalesAccount":3001,"VAT":25}' | noxctl articles create --description "Konsulttimme" --input - --yes`)
+    .action(async (opts) => {
+    const { createArticle } = await import('./operations/articles.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.articleNumber)
+        params.ArticleNumber = opts.articleNumber;
+    if (!(await confirmMutation(`Create article "${opts.description}"`, opts, { Article: params }))) {
+        return;
+    }
+    const data = await createArticle(params);
+    outputDetail(data, articleDetailColumns, json());
+});
+articles
+    .command('update <articleNumber>')
+    .description('Update an article')
+    .requiredOption('--input <file>', 'Article 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 '{"SalesPrice":1800}' | noxctl articles update 1 --input - --yes`)
+    .action(async (articleNumber, opts) => {
+    const { updateArticle } = await import('./operations/articles.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const fields = JSON.parse(raw);
+    if (!(await confirmMutation(`Update article ${articleNumber}`, opts, { Article: fields }))) {
+        return;
+    }
+    const data = await updateArticle(articleNumber, fields);
+    outputDetail(data, articleDetailColumns, json());
+});
+// --- suppliers ---
+const suppliers = program.command('suppliers').description('Supplier operations');
+suppliers
+    .command('list')
+    .description('List/search suppliers')
+    .option('--search <term>', 'Search by name')
+    .option('--page <number>', 'Page number', parseInt)
+    .option('--limit <number>', 'Results per page', parseInt)
+    .option('-a, --all', 'Fetch all pages')
+    .action(async (opts) => {
+    const { listSuppliers } = await import('./operations/suppliers.js');
+    const data = await listSuppliers({
+        search: opts.search,
+        page: opts.page,
+        limit: opts.limit,
+        all: opts.all,
+    });
+    const envelope = data;
+    outputList(envelope.Suppliers ?? [], supplierListColumns, json(), data, envelope.MetaInformation);
+});
+suppliers
+    .command('get <supplierNumber>')
+    .description('Get a single supplier')
+    .action(async (supplierNumber) => {
+    const { getSupplier } = await import('./operations/suppliers.js');
+    const data = await getSupplier(supplierNumber);
+    outputDetail(data, supplierDetailColumns, json());
+});
+suppliers
+    .command('create')
+    .description('Create a supplier')
+    .requiredOption('--name <name>', 'Supplier name')
+    .option('--input <file>', 'Supplier 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:
+  noxctl suppliers create --name "Dustin AB" --yes
+  echo '{"OrganisationNumber":"556123-4567","BG":"123-4567","Email":"faktura@dustin.se"}' | noxctl suppliers create --name "Dustin AB" --input - --yes`)
+    .action(async (opts) => {
+    const { createSupplier } = await import('./operations/suppliers.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, Name: opts.name };
+    if (!(await confirmMutation(`Create supplier "${opts.name}"`, opts, { Supplier: params }))) {
+        return;
+    }
+    const data = await createSupplier(params);
+    outputDetail(data, supplierDetailColumns, json());
+});
+suppliers
+    .command('update <supplierNumber>')
+    .description('Update a supplier')
+    .requiredOption('--input <file>', 'Supplier 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 '{"Email":"new@dustin.se","BG":"765-4321"}' | noxctl suppliers update 1 --input - --yes`)
+    .action(async (supplierNumber, opts) => {
+    const { updateSupplier } = await import('./operations/suppliers.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const fields = JSON.parse(raw);
+    if (!(await confirmMutation(`Update supplier ${supplierNumber}`, opts, { Supplier: fields }))) {
+        return;
+    }
+    const data = await updateSupplier(supplierNumber, fields);
+    outputDetail(data, supplierDetailColumns, json());
+});
+// --- supplier-invoices ---
+const supplierInvoices = program
+    .command('supplier-invoices')
+    .alias('si')
+    .description('Supplier invoice operations (leverantörsfakturor)');
+supplierInvoices
+    .command('list')
+    .description('List/filter supplier invoices')
+    .option('--filter <filter>', 'Filter: cancelled, fullypaid, unpaid, unpaidoverdue, unbooked, pendingpayment')
+    .option('--supplier <number>', 'Filter by supplier 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 { listSupplierInvoices } = await import('./operations/supplier-invoices.js');
+    const data = await listSupplierInvoices({
+        filter: opts.filter,
+        supplierNumber: opts.supplier,
+        fromDate: opts.from,
+        toDate: opts.to,
+        page: opts.page,
+        limit: opts.limit,
+        all: opts.all,
+    });
+    const envelope = data;
+    outputList(envelope.SupplierInvoices ?? [], supplierInvoiceListColumns, json(), data, envelope.MetaInformation);
+});
+supplierInvoices
+    .command('get <givenNumber>')
+    .description('Get a single supplier invoice')
+    .action(async (givenNumber) => {
+    const { getSupplierInvoice } = await import('./operations/supplier-invoices.js');
+    const data = await getSupplierInvoice(givenNumber);
+    outputDetail(data, supplierInvoiceDetailColumns, json());
+});
+supplierInvoices
+    .command('create')
+    .description('Create a supplier invoice')
+    .requiredOption('--supplier <number>', 'Supplier number')
+    .requiredOption('--input <file>', 'Invoice 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 '{"InvoiceDate":"2026-03-01","DueDate":"2026-03-30","Total":1250,"OCR":"12345","SupplierInvoiceRows":[{"Account":6570,"Debit":1000,"Credit":0},{"Account":2641,"Debit":250,"Credit":0},{"Account":2440,"Debit":0,"Credit":1250}]}' | noxctl supplier-invoices create --supplier 1 --input - --dry-run`)
+    .action(async (opts) => {
+    const { createSupplierInvoice } = await import('./operations/supplier-invoices.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const input = JSON.parse(raw);
+    const params = { SupplierNumber: opts.supplier, ...input };
+    if (!(await confirmMutation(`Create supplier invoice for supplier ${opts.supplier}`, opts, {
+        SupplierInvoice: params,
+    }))) {
+        return;
+    }
+    const data = await createSupplierInvoice(params);
+    outputDetail(data, supplierInvoiceDetailColumns, json());
+});
+supplierInvoices
+    .command('bookkeep <givenNumber>')
+    .description('Bookkeep a supplier invoice')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the action without sending it')
+    .action(async (givenNumber, opts) => {
+    const { bookkeepSupplierInvoice } = await import('./operations/supplier-invoices.js');
+    if (!(await confirmMutation(`Bookkeep supplier invoice ${givenNumber}`, opts))) {
+        return;
+    }
+    const data = await bookkeepSupplierInvoice(givenNumber);
+    outputConfirmation(`Supplier invoice ${givenNumber} bookkeept.`, json(), data, supplierInvoiceConfirmColumns);
+});
+// --- company ---
+const company = program.command('company').description('Company operations');
+company
+    .command('info')
+    .description('Get company information')
+    .action(async () => {
+    const { getCompanyInfo } = await import('./operations/company.js');
+    const data = await getCompanyInfo();
+    outputDetail(data, companyDetailColumns, json());
+});
+// --- vouchers ---
+const vouchers = program.command('vouchers').description('Voucher operations');
+vouchers
+    .command('list')
+    .description('List vouchers')
+    .option('--series <series>', 'Voucher series (e.g. "A")')
+    .option('--from <date>', 'From date (YYYY-MM-DD)')
+    .option('--to <date>', 'To date (YYYY-MM-DD)')
+    .option('--year <number>', 'Financial year', parseInt)
+    .option('--page <number>', 'Page number', parseInt)
+    .option('--limit <number>', 'Results per page', parseInt)
+    .option('-a, --all', 'Fetch all pages')
+    .action(async (opts) => {
+    const { listVouchers } = await import('./operations/vouchers.js');
+    const data = await listVouchers({
+        series: opts.series,
+        fromDate: opts.from,
+        toDate: opts.to,
+        financialYear: opts.year,
+        page: opts.page,
+        limit: opts.limit,
+        all: opts.all,
+    });
+    const envelope = data;
+    outputList(envelope.Vouchers ?? [], voucherListColumns, json(), data, envelope.MetaInformation);
+});
+vouchers
+    .command('get <series> <voucherNumber>')
+    .description('Get a single voucher with rows (account, debit, credit)')
+    .option('--year <number>', 'Financial year', parseInt)
+    .action(async (series, voucherNumber, opts) => {
+    const { getVoucher } = await import('./operations/vouchers.js');
+    const data = await getVoucher(series, voucherNumber, opts.year);
+    if (json()) {
+        console.log(JSON.stringify(data, null, 2));
+    }
+    else {
+        outputDetail(data, voucherDetailColumns, false);
+        const rows = data.VoucherRows;
+        if (rows?.length) {
+            console.log('\nRows:');
+            outputList(rows, voucherRowColumns, false, rows);
+        }
+    }
+});
+vouchers
+    .command('create')
+    .description('Create a voucher')
+    .requiredOption('--input <file>', 'Voucher 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 '{"Description":"Bankkostnad","TransactionDate":"2026-03-01","VoucherRows":[{"Account":6570,"Debit":500},{"Account":1930,"Credit":500}]}' | noxctl vouchers create --input - --dry-run`)
+    .action(async (opts) => {
+    const { createVoucher } = await import('./operations/vouchers.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const params = JSON.parse(raw);
+    if (!(await confirmMutation(`Create voucher "${String(params.Description || '')}"`, opts, {
+        Voucher: params,
+    }))) {
+        return;
+    }
+    const data = await createVoucher(params);
+    outputDetail(data, voucherDetailColumns, json());
+});
+// Error handling
+program.exitOverride();
+try {
+    await program.parseAsync(process.argv);
+}
+catch (err) {
+    if (err instanceof Error && 'code' in err) {
+        const code = err.code;
+        // Commander throws for --help and --version with exitCode 0
+        if (code === 'commander.helpDisplayed' || code === 'commander.version') {
+            process.exit(0);
+        }
+        if (code === 'commander.unknownCommand' || code === 'commander.missingMandatoryOptionValue') {
+            process.exit(1);
+        }
+    }
+    console.error(err instanceof Error ? err.message : err);
+    process.exit(1);
+}
+//# sourceMappingURL=cli.js.map