@ktmcp-cli/billingo 1.0.0

package/src/commands/bank-accounts.js

@@ -0,0 +1,131 @@
+/**
+ * Bank Account Commands
+ *
+ * Manage bank accounts for invoicing
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { get, post, put, del, formatOutput } from '../lib/api.js';
+import { readFileSync } from 'fs';
+
+export function registerBankAccountCommands(program) {
+  const bankAccounts = new Command('bank-accounts')
+    .alias('banks')
+    .description('Manage bank accounts');
+
+  bankAccounts
+    .command('list')
+    .description('List all bank accounts')
+    .option('-p, --page <number>', 'Page number', '1')
+    .option('--per-page <number>', 'Results per page', '25')
+    .option('-f, --format <format>', 'Output format (json, pretty)', 'pretty')
+    .action(async (options) => {
+      const spinner = ora('Fetching bank accounts...').start();
+      try {
+        const data = await get('/bank-accounts', {
+          page: options.page,
+          per_page: options.perPage,
+        });
+        spinner.succeed('Bank accounts retrieved');
+        console.log(formatOutput(data, options.format));
+      } catch (error) {
+        spinner.fail('Failed to fetch bank accounts');
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  bankAccounts
+    .command('get <id>')
+    .description('Get bank account by ID')
+    .option('-f, --format <format>', 'Output format (json, pretty)', 'pretty')
+    .action(async (id, options) => {
+      const spinner = ora(`Fetching bank account ${id}...`).start();
+      try {
+        const data = await get(`/bank-accounts/${id}`);
+        spinner.succeed('Bank account retrieved');
+        console.log(formatOutput(data, options.format));
+      } catch (error) {
+        spinner.fail('Failed to fetch bank account');
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  bankAccounts
+    .command('create')
+    .description('Create a new bank account')
+    .option('-f, --file <path>', 'JSON file with bank account data')
+    .option('-d, --data <json>', 'JSON string with bank account data')
+    .action(async (options) => {
+      const spinner = ora('Creating bank account...').start();
+      try {
+        let data;
+        if (options.file) {
+          data = JSON.parse(readFileSync(options.file, 'utf-8'));
+        } else if (options.data) {
+          data = JSON.parse(options.data);
+        } else {
+          spinner.fail('No data provided');
+          console.error(chalk.red('Error: Provide data with --file or --data'));
+          process.exit(1);
+        }
+
+        const result = await post('/bank-accounts', data);
+        spinner.succeed('Bank account created');
+        console.log(formatOutput(result, 'pretty'));
+      } catch (error) {
+        spinner.fail('Failed to create bank account');
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  bankAccounts
+    .command('update <id>')
+    .description('Update a bank account')
+    .option('-f, --file <path>', 'JSON file with bank account data')
+    .option('-d, --data <json>', 'JSON string with bank account data')
+    .action(async (id, options) => {
+      const spinner = ora(`Updating bank account ${id}...`).start();
+      try {
+        let data;
+        if (options.file) {
+          data = JSON.parse(readFileSync(options.file, 'utf-8'));
+        } else if (options.data) {
+          data = JSON.parse(options.data);
+        } else {
+          spinner.fail('No data provided');
+          console.error(chalk.red('Error: Provide data with --file or --data'));
+          process.exit(1);
+        }
+
+        const result = await put(`/bank-accounts/${id}`, data);
+        spinner.succeed('Bank account updated');
+        console.log(formatOutput(result, 'pretty'));
+      } catch (error) {
+        spinner.fail('Failed to update bank account');
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  bankAccounts
+    .command('delete <id>')
+    .description('Delete a bank account')
+    .action(async (id) => {
+      const spinner = ora(`Deleting bank account ${id}...`).start();
+      try {
+        await del(`/bank-accounts/${id}`);
+        spinner.succeed('Bank account deleted');
+      } catch (error) {
+        spinner.fail('Failed to delete bank account');
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  program.addCommand(bankAccounts);
+}

package/src/commands/config.js

@@ -0,0 +1,73 @@
+/**
+ * Configuration Commands
+ *
+ * Manage CLI configuration (API key, base URL, etc.)
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { getConfig, setConfig, getAllConfig, clearConfig } from '../lib/config.js';
+
+export function registerConfigCommands(program) {
+  const config = new Command('config')
+    .description('Manage CLI configuration');
+
+  config
+    .command('set <key> <value>')
+    .description('Set a configuration value')
+    .action((key, value) => {
+      try {
+        setConfig(key, value);
+        console.log(chalk.green(`✓ Configuration updated: ${key} = ${value}`));
+      } catch (error) {
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  config
+    .command('get <key>')
+    .description('Get a configuration value')
+    .action((key) => {
+      try {
+        const value = getConfig(key);
+        if (value === undefined) {
+          console.log(chalk.yellow(`Configuration key "${key}" not found`));
+        } else {
+          console.log(value);
+        }
+      } catch (error) {
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  config
+    .command('list')
+    .description('List all configuration')
+    .action(() => {
+      try {
+        const allConfig = getAllConfig();
+        console.log(chalk.cyan('Current configuration:'));
+        console.log(JSON.stringify(allConfig, null, 2));
+      } catch (error) {
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  config
+    .command('clear')
+    .description('Clear all configuration')
+    .action(() => {
+      try {
+        clearConfig();
+        console.log(chalk.green('✓ Configuration cleared'));
+      } catch (error) {
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  program.addCommand(config);
+}

package/src/commands/currencies.js

@@ -0,0 +1,40 @@
+/**
+ * Currency Commands
+ *
+ * Get currency conversion rates
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { get, formatOutput } from '../lib/api.js';
+
+export function registerCurrencyCommands(program) {
+  const currencies = new Command('currencies')
+    .alias('currency')
+    .description('Get currency conversion rates');
+
+  currencies
+    .command('convert')
+    .description('Get conversion rate between currencies')
+    .requiredOption('--from <currency>', 'Source currency code (e.g., HUF)')
+    .requiredOption('--to <currency>', 'Target currency code (e.g., EUR)')
+    .option('-f, --format <format>', 'Output format (json, pretty)', 'pretty')
+    .action(async (options) => {
+      const spinner = ora(`Getting conversion rate ${options.from} → ${options.to}...`).start();
+      try {
+        const data = await get('/currencies', {
+          from: options.from,
+          to: options.to,
+        });
+        spinner.succeed('Conversion rate retrieved');
+        console.log(formatOutput(data, options.format));
+      } catch (error) {
+        spinner.fail('Failed to get conversion rate');
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  program.addCommand(currencies);
+}

package/src/commands/document-blocks.js

@@ -0,0 +1,40 @@
+/**
+ * Document Block Commands
+ *
+ * Manage document blocks (invoice pads)
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { get, formatOutput } from '../lib/api.js';
+
+export function registerDocumentBlockCommands(program) {
+  const documentBlocks = new Command('document-blocks')
+    .alias('blocks')
+    .description('Manage document blocks (invoice pads)');
+
+  documentBlocks
+    .command('list')
+    .description('List all document blocks')
+    .option('-p, --page <number>', 'Page number', '1')
+    .option('--per-page <number>', 'Results per page', '25')
+    .option('-f, --format <format>', 'Output format (json, pretty)', 'pretty')
+    .action(async (options) => {
+      const spinner = ora('Fetching document blocks...').start();
+      try {
+        const data = await get('/document-blocks', {
+          page: options.page,
+          per_page: options.perPage,
+        });
+        spinner.succeed('Document blocks retrieved');
+        console.log(formatOutput(data, options.format));
+      } catch (error) {
+        spinner.fail('Failed to fetch document blocks');
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  program.addCommand(documentBlocks);
+}

package/src/commands/documents.js

@@ -0,0 +1,248 @@
+/**
+ * Document Commands
+ *
+ * Manage invoices and other financial documents
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { get, post, put, del, downloadFile, formatOutput } from '../lib/api.js';
+import { readFileSync, writeFileSync } from 'fs';
+
+export function registerDocumentCommands(program) {
+  const documents = new Command('documents')
+    .alias('docs')
+    .description('Manage documents (invoices)');
+
+  documents
+    .command('list')
+    .description('List all documents')
+    .option('-p, --page <number>', 'Page number', '1')
+    .option('--per-page <number>', 'Results per page', '25')
+    .option('--block-id <id>', 'Filter by document block ID')
+    .option('--partner-id <id>', 'Filter by partner ID')
+    .option('--payment-method <method>', 'Filter by payment method')
+    .option('--payment-status <status>', 'Filter by payment status')
+    .option('--start-date <date>', 'Filter by start date (YYYY-MM-DD)')
+    .option('--end-date <date>', 'Filter by end date (YYYY-MM-DD)')
+    .option('--start-number <number>', 'Filter by start document number')
+    .option('--end-number <number>', 'Filter by end document number')
+    .option('--start-year <year>', 'Filter by start year')
+    .option('--end-year <year>', 'Filter by end year')
+    .option('-f, --format <format>', 'Output format (json, pretty)', 'pretty')
+    .action(async (options) => {
+      const spinner = ora('Fetching documents...').start();
+      try {
+        const params = {
+          page: options.page,
+          per_page: options.perPage,
+        };
+
+        // Add optional filters
+        if (options.blockId) params.block_id = options.blockId;
+        if (options.partnerId) params.partner_id = options.partnerId;
+        if (options.paymentMethod) params.payment_method = options.paymentMethod;
+        if (options.paymentStatus) params.payment_status = options.paymentStatus;
+        if (options.startDate) params.start_date = options.startDate;
+        if (options.endDate) params.end_date = options.endDate;
+        if (options.startNumber) params.start_number = options.startNumber;
+        if (options.endNumber) params.end_number = options.endNumber;
+        if (options.startYear) params.start_year = options.startYear;
+        if (options.endYear) params.end_year = options.endYear;
+
+        const data = await get('/documents', params);
+        spinner.succeed('Documents retrieved');
+        console.log(formatOutput(data, options.format));
+      } catch (error) {
+        spinner.fail('Failed to fetch documents');
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  documents
+    .command('get <id>')
+    .description('Get document by ID')
+    .option('-f, --format <format>', 'Output format (json, pretty)', 'pretty')
+    .action(async (id, options) => {
+      const spinner = ora(`Fetching document ${id}...`).start();
+      try {
+        const data = await get(`/documents/${id}`);
+        spinner.succeed('Document retrieved');
+        console.log(formatOutput(data, options.format));
+      } catch (error) {
+        spinner.fail('Failed to fetch document');
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  documents
+    .command('create')
+    .description('Create a new document')
+    .option('-f, --file <path>', 'JSON file with document data')
+    .option('-d, --data <json>', 'JSON string with document data')
+    .action(async (options) => {
+      const spinner = ora('Creating document...').start();
+      try {
+        let data;
+        if (options.file) {
+          data = JSON.parse(readFileSync(options.file, 'utf-8'));
+        } else if (options.data) {
+          data = JSON.parse(options.data);
+        } else {
+          spinner.fail('No data provided');
+          console.error(chalk.red('Error: Provide data with --file or --data'));
+          process.exit(1);
+        }
+
+        const result = await post('/documents', data);
+        spinner.succeed('Document created');
+        console.log(formatOutput(result, 'pretty'));
+      } catch (error) {
+        spinner.fail('Failed to create document');
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  documents
+    .command('cancel <id>')
+    .description('Cancel a document')
+    .action(async (id) => {
+      const spinner = ora(`Canceling document ${id}...`).start();
+      try {
+        const result = await post(`/documents/${id}/cancel`);
+        spinner.succeed('Document canceled');
+        console.log(formatOutput(result, 'pretty'));
+      } catch (error) {
+        spinner.fail('Failed to cancel document');
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  documents
+    .command('download <id>')
+    .description('Download document as PDF')
+    .option('-o, --output <path>', 'Output file path', 'document.pdf')
+    .action(async (id, options) => {
+      const spinner = ora(`Downloading document ${id}...`).start();
+      try {
+        const buffer = await downloadFile(`/documents/${id}/download`);
+        writeFileSync(options.output, buffer);
+        spinner.succeed(`Document saved to ${options.output}`);
+      } catch (error) {
+        spinner.fail('Failed to download document');
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  documents
+    .command('send <id>')
+    .description('Send document via email')
+    .option('-e, --emails <emails>', 'Comma-separated email addresses')
+    .option('-s, --subject <subject>', 'Email subject')
+    .option('-m, --message <message>', 'Email message')
+    .action(async (id, options) => {
+      const spinner = ora(`Sending document ${id}...`).start();
+      try {
+        const data = {};
+        if (options.emails) data.emails = options.emails.split(',');
+        if (options.subject) data.subject = options.subject;
+        if (options.message) data.message = options.message;
+
+        const result = await post(`/documents/${id}/send`, data);
+        spinner.succeed('Document sent');
+        console.log(formatOutput(result, 'pretty'));
+      } catch (error) {
+        spinner.fail('Failed to send document');
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  documents
+    .command('public-url <id>')
+    .description('Get public download URL for document')
+    .option('-f, --format <format>', 'Output format (json, pretty)', 'pretty')
+    .action(async (id, options) => {
+      const spinner = ora(`Getting public URL for document ${id}...`).start();
+      try {
+        const data = await get(`/documents/${id}/public-url`);
+        spinner.succeed('Public URL retrieved');
+        console.log(formatOutput(data, options.format));
+      } catch (error) {
+        spinner.fail('Failed to get public URL');
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  documents
+    .command('payments <id>')
+    .description('Get payment history for document')
+    .option('-f, --format <format>', 'Output format (json, pretty)', 'pretty')
+    .action(async (id, options) => {
+      const spinner = ora(`Fetching payments for document ${id}...`).start();
+      try {
+        const data = await get(`/documents/${id}/payments`);
+        spinner.succeed('Payments retrieved');
+        console.log(formatOutput(data, options.format));
+      } catch (error) {
+        spinner.fail('Failed to fetch payments');
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  documents
+    .command('update-payments <id>')
+    .description('Update payment history for document')
+    .option('-f, --file <path>', 'JSON file with payment data')
+    .option('-d, --data <json>', 'JSON string with payment data')
+    .action(async (id, options) => {
+      const spinner = ora(`Updating payments for document ${id}...`).start();
+      try {
+        let data;
+        if (options.file) {
+          data = JSON.parse(readFileSync(options.file, 'utf-8'));
+        } else if (options.data) {
+          data = JSON.parse(options.data);
+        } else {
+          spinner.fail('No data provided');
+          console.error(chalk.red('Error: Provide data with --file or --data'));
+          process.exit(1);
+        }
+
+        const result = await put(`/documents/${id}/payments`, data);
+        spinner.succeed('Payments updated');
+        console.log(formatOutput(result, 'pretty'));
+      } catch (error) {
+        spinner.fail('Failed to update payments');
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  documents
+    .command('online-szamla <id>')
+    .description('Check Online Számla status')
+    .option('-f, --format <format>', 'Output format (json, pretty)', 'pretty')
+    .action(async (id, options) => {
+      const spinner = ora(`Checking Online Számla status for document ${id}...`).start();
+      try {
+        const data = await get(`/documents/${id}/online-szamla`);
+        spinner.succeed('Status retrieved');
+        console.log(formatOutput(data, options.format));
+      } catch (error) {
+        spinner.fail('Failed to check status');
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  program.addCommand(documents);
+}

package/src/commands/organization.js

@@ -0,0 +1,35 @@
+/**
+ * Organization Commands
+ *
+ * Retrieve organization information
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { get, formatOutput } from '../lib/api.js';
+
+export function registerOrganizationCommands(program) {
+  const organization = new Command('organization')
+    .alias('org')
+    .description('Retrieve organization information');
+
+  organization
+    .command('get')
+    .description('Get organization data')
+    .option('-f, --format <format>', 'Output format (json, pretty)', 'pretty')
+    .action(async (options) => {
+      const spinner = ora('Fetching organization data...').start();
+      try {
+        const data = await get('/organization');
+        spinner.succeed('Organization data retrieved');
+        console.log(formatOutput(data, options.format));
+      } catch (error) {
+        spinner.fail('Failed to fetch organization data');
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+    });
+
+  program.addCommand(organization);
+}