bkper 3.8.1 → 4.0.0

package/lib/cli.js

@@ -8,95 +8,899 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import program from "commander";
-import { login, logout } from "./auth/local-auth-service.js";
-import { setupBkper } from "./mcp/bkper-factory.js";
-import { listApps, createApp, updateApp } from "./commands/apps.js";
-import dotenv from "dotenv";
-dotenv.config();
+import 'dotenv/config'; // Must be first to load env vars before other imports
+import { program } from 'commander';
+import { BooksDataTableBuilder, AccountsDataTableBuilder, GroupsDataTableBuilder, } from 'bkper-js';
+import { login, logout } from './auth/local-auth-service.js';
+import { setupBkper } from './bkper-factory.js';
+import { listApps, syncApp, deployApp, undeployApp, statusApp, initApp, secretsPut, secretsList, secretsDelete, dev, build, installApp, uninstallApp, } from './commands/apps/index.js';
+import { listBooks, getBook, createBook, updateBook } from './commands/books/index.js';
+import { listAccounts, getAccount, createAccount, updateAccount, deleteAccount, } from './commands/accounts/index.js';
+import { listGroups, getGroup, createGroup, updateGroup, deleteGroup, } from './commands/groups/index.js';
+import { listTransactions, createTransaction, updateTransaction, postTransaction, checkTransaction, trashTransaction, mergeTransactions, } from './commands/transactions/index.js';
+import { getBalancesMatrix } from './commands/balances/index.js';
+import { listCollections, getCollection, createCollection, updateCollection, deleteCollection, addBookToCollection, removeBookFromCollection, } from './commands/collections/index.js';
+import { renderTable, renderItem } from './render/index.js';
+function collectProperty(value, previous) {
+    return previous ? [...previous, value] : [value];
+}
+// Global --json option
+program.option('--json', 'Output as JSON');
+function isJson() {
+    return program.opts().json === true;
+}
 program
-    .command("login")
-    .description("Login Bkper")
+    .command('login')
+    .description('Login Bkper')
     .action(() => __awaiter(void 0, void 0, void 0, function* () {
     yield login();
 }));
 program
-    .command("logout")
-    .description("Logout Bkper")
+    .command('logout')
+    .description('Logout Bkper')
     .action(() => {
     logout();
 });
-// New 'apps' command group (plural, standard)
-const appsCommand = program.command("apps").description("Manage Bkper Apps");
-appsCommand
-    .command("list")
-    .description("List all apps you have access to")
+// 'app' command group (singular, modern pattern)
+const appCommand = program.command('app').description('Manage Bkper Apps');
+appCommand
+    .command('init <name>')
+    .description('Create a new Bkper app from template')
+    .action((name) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        yield initApp(name);
+    }
+    catch (err) {
+        console.error('Error initializing app:', err);
+        process.exit(1);
+    }
+}));
+appCommand
+    .command('list')
+    .description('List all apps you have access to')
     .action(() => __awaiter(void 0, void 0, void 0, function* () {
     try {
         setupBkper();
         const apps = yield listApps();
+        if (isJson()) {
+            console.log(JSON.stringify(apps, null, 2));
+            return;
+        }
         if (apps.length === 0) {
-            console.log("No apps found.");
+            console.log('No results found.');
             return;
         }
-        // Table-style output
-        console.log("\nApps:\n");
-        console.log("ID".padEnd(25) + "Name".padEnd(30) + "Published");
-        console.log("-".repeat(65));
+        const matrix = [['ID', 'Name', 'Published']];
         for (const app of apps) {
-            const id = (app.id || "").padEnd(25);
-            const name = (app.name || "").padEnd(30);
-            const published = app.published ? "Yes" : "No";
-            console.log(`${id}${name}${published}`);
+            matrix.push([app.id || '', app.name || '', app.published ? 'Yes' : 'No']);
         }
-        console.log(`\nTotal: ${apps.length} app(s)`);
+        renderTable(matrix, false);
     }
     catch (err) {
-        console.error("Error listing apps:", err);
+        console.error('Error listing apps:', err);
         process.exit(1);
     }
 }));
-appsCommand
-    .command("create")
-    .description("Create a new App from bkperapp.json or bkperapp.yaml")
+appCommand
+    .command('sync')
+    .description('Sync app config to Bkper (creates if new, updates if exists)')
     .action(() => __awaiter(void 0, void 0, void 0, function* () {
     try {
         setupBkper();
-        const app = yield createApp();
-        console.log(`Created ${app.getId()} successfully.`);
+        const result = yield syncApp();
+        console.log(`Synced ${result.id} (${result.action})`);
+    }
+    catch (err) {
+        console.error('Error syncing app:', err);
+        process.exit(1);
+    }
+}));
+appCommand
+    .command('deploy')
+    .description('Deploy app to Bkper Platform')
+    .option('-p, --preview', 'Deploy to preview environment')
+    .option('--events', 'Deploy events handler instead of web handler')
+    .action((options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        yield deployApp(options);
     }
     catch (err) {
-        console.error("Error creating app:", err);
+        console.error('Error deploying app:', err);
         process.exit(1);
     }
 }));
-appsCommand
-    .command("update")
-    .description("Update an existing App from bkperapp.json or bkperapp.yaml")
+appCommand
+    .command('undeploy')
+    .description('Remove app from Bkper Platform')
+    .option('-p, --preview', 'Remove from preview environment')
+    .option('--events', 'Remove events handler instead of web handler')
+    .option('--delete-data', 'Permanently delete all associated data (requires confirmation)')
+    .option('--force', 'Skip confirmation prompts (use with --delete-data for automation)')
+    .action((options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        yield undeployApp(options);
+    }
+    catch (err) {
+        console.error('Error undeploying app:', err);
+        process.exit(1);
+    }
+}));
+appCommand
+    .command('status')
+    .description('Show deployment status for all handlers')
     .action(() => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        yield statusApp();
+    }
+    catch (err) {
+        console.error('Error getting app status:', err);
+        process.exit(1);
+    }
+}));
+// Development server command
+appCommand
+    .command('dev')
+    .description('Start the development server')
+    .option('--cp, --client-port <port>', 'Client dev server port', '5173')
+    .option('--sp, --server-port <port>', 'Server simulation port', '8787')
+    .option('--ep, --events-port <port>', 'Events handler port', '8791')
+    .option('-w, --web', 'Run only the web handler')
+    .option('-e, --events', 'Run only the events handler')
+    .option('--no-open', 'Do not open browser on startup')
+    .action((options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        yield dev({
+            clientPort: parseInt(options.clientPort, 10),
+            serverPort: parseInt(options.serverPort, 10),
+            eventsPort: parseInt(options.eventsPort, 10),
+            web: options.web,
+            events: options.events,
+            open: options.open,
+        });
+    }
+    catch (err) {
+        console.error('Error starting dev server:', err);
+        process.exit(1);
+    }
+}));
+// Build command
+appCommand
+    .command('build')
+    .description('Build all configured handlers for deployment')
+    .action(() => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        yield build();
+    }
+    catch (err) {
+        console.error('Error building app:', err);
+        process.exit(1);
+    }
+}));
+// Secrets subcommand
+const secretsCommand = appCommand.command('secrets').description('Manage app secrets');
+secretsCommand
+    .command('put <name>')
+    .description('Set a secret value')
+    .option('-p, --preview', 'Set in preview environment')
+    .action((name, options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        yield secretsPut(name, options);
+    }
+    catch (err) {
+        console.error('Error setting secret:', err);
+        process.exit(1);
+    }
+}));
+secretsCommand
+    .command('list')
+    .description('List all secrets')
+    .option('-p, --preview', 'List from preview environment')
+    .action((options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        yield secretsList(options);
+    }
+    catch (err) {
+        console.error('Error listing secrets:', err);
+        process.exit(1);
+    }
+}));
+secretsCommand
+    .command('delete <name>')
+    .description('Delete a secret')
+    .option('-p, --preview', 'Delete from preview environment')
+    .action((name, options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        yield secretsDelete(name, options);
+    }
+    catch (err) {
+        console.error('Error deleting secret:', err);
+        process.exit(1);
+    }
+}));
+appCommand
+    .command('install <appId>')
+    .description('Install an app into a book')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .action((appId, options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const integration = yield installApp(options.book, appId);
+        renderItem(integration.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error installing app:', err);
+        process.exit(1);
+    }
+}));
+appCommand
+    .command('uninstall <appId>')
+    .description('Uninstall an app from a book')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .action((appId, options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const integration = yield uninstallApp(options.book, appId);
+        renderItem(integration.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error uninstalling app:', err);
+        process.exit(1);
+    }
+}));
+// 'book' command group
+const bookCommand = program.command('book').description('Manage Books');
+bookCommand
+    .command('list')
+    .description('List all books')
+    .option('-q, --query <query>', 'Search query')
+    .action((options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const books = yield listBooks(options.query);
+        if (isJson()) {
+            console.log(JSON.stringify(books.map(b => b.json()), null, 2));
+        }
+        else {
+            const matrix = new BooksDataTableBuilder(books).ids(true).build();
+            renderTable(matrix, false);
+        }
+    }
+    catch (err) {
+        console.error('Error listing books:', err);
+        process.exit(1);
+    }
+}));
+bookCommand
+    .command('get <bookId>')
+    .description('Get a book by ID')
+    .action((bookId) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const book = yield getBook(bookId);
+        renderItem(book.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error getting book:', err);
+        process.exit(1);
+    }
+}));
+bookCommand
+    .command('create')
+    .description('Create a new book')
+    .requiredOption('--name <name>', 'Book name')
+    .option('--fraction-digits <digits>', 'Number of decimal places (0-8)', parseInt)
+    .option('--date-pattern <pattern>', 'Date format pattern (dd/MM/yyyy, MM/dd/yyyy, or yyyy/MM/dd)')
+    .option('--decimal-separator <separator>', 'Decimal separator (DOT or COMMA)')
+    .option('--time-zone <timezone>', 'IANA time zone (e.g. America/New_York, UTC)')
+    .option('--period <period>', 'Period (MONTH, QUARTER, or YEAR)')
+    .option('-p, --property <key=value>', 'Set a property (repeatable)', collectProperty)
+    .action((options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const book = yield createBook({
+            name: options.name,
+            fractionDigits: options.fractionDigits,
+            datePattern: options.datePattern,
+            decimalSeparator: options.decimalSeparator,
+            timeZone: options.timeZone,
+            period: options.period,
+            property: options.property,
+        });
+        renderItem(book.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error creating book:', err);
+        process.exit(1);
+    }
+}));
+bookCommand
+    .command('update <bookId>')
+    .description('Update a book')
+    .option('--name <name>', 'Book name')
+    .option('--fraction-digits <digits>', 'Number of decimal places (0-8)', parseInt)
+    .option('--date-pattern <pattern>', 'Date format pattern (dd/MM/yyyy, MM/dd/yyyy, or yyyy/MM/dd)')
+    .option('--decimal-separator <separator>', 'Decimal separator (DOT or COMMA)')
+    .option('--time-zone <timezone>', 'IANA time zone (e.g. America/New_York, UTC)')
+    .option('--lock-date <date>', 'Lock date in ISO format (yyyy-MM-dd)')
+    .option('--closing-date <date>', 'Closing date in ISO format (yyyy-MM-dd)')
+    .option('--period <period>', 'Period (MONTH, QUARTER, or YEAR)')
+    .option('-p, --property <key=value>', 'Set a property (repeatable, empty value deletes)', collectProperty)
+    .action((bookId, options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const book = yield updateBook(bookId, {
+            name: options.name,
+            fractionDigits: options.fractionDigits,
+            datePattern: options.datePattern,
+            decimalSeparator: options.decimalSeparator,
+            timeZone: options.timeZone,
+            lockDate: options.lockDate,
+            closingDate: options.closingDate,
+            period: options.period,
+            property: options.property,
+        });
+        renderItem(book.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error updating book:', err);
+        process.exit(1);
+    }
+}));
+// 'account' command group
+const accountCommand = program.command('account').description('Manage Accounts');
+accountCommand
+    .command('list')
+    .description('List all accounts in a book')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .action((options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const bookId = options.book;
+        const accounts = yield listAccounts(bookId);
+        if (isJson()) {
+            console.log(JSON.stringify(accounts.map(a => a.json()), null, 2));
+        }
+        else {
+            const matrix = yield new AccountsDataTableBuilder(accounts)
+                .ids(true)
+                .groups(true)
+                .build();
+            renderTable(matrix, false);
+        }
+    }
+    catch (err) {
+        console.error('Error listing accounts:', err);
+        process.exit(1);
+    }
+}));
+accountCommand
+    .command('get <idOrName>')
+    .description('Get an account by ID or name')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .action((idOrName, options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const bookId = options.book;
+        const account = yield getAccount(bookId, idOrName);
+        renderItem(account.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error getting account:', err);
+        process.exit(1);
+    }
+}));
+accountCommand
+    .command('create')
+    .description('Create a new account')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .requiredOption('--name <name>', 'Account name')
+    .option('--type <type>', 'Account type (ASSET, LIABILITY, INCOMING, OUTGOING)')
+    .option('--description <description>', 'Account description')
+    .option('--groups <groups>', 'Comma-separated group names')
+    .option('-p, --property <key=value>', 'Set a property (repeatable)', collectProperty)
+    .action((options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const bookId = options.book;
+        const account = yield createAccount(bookId, {
+            name: options.name,
+            type: options.type,
+            description: options.description,
+            groups: options.groups
+                ? options.groups.split(',').map((g) => g.trim())
+                : undefined,
+            property: options.property,
+        });
+        renderItem(account.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error creating account:', err);
+        process.exit(1);
+    }
+}));
+accountCommand
+    .command('update <idOrName>')
+    .description('Update an account')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .option('--name <name>', 'Account name')
+    .option('--type <type>', 'Account type (ASSET, LIABILITY, INCOMING, OUTGOING)')
+    .option('--archived <archived>', 'Archive status (true/false)')
+    .option('-p, --property <key=value>', 'Set a property (repeatable)', collectProperty)
+    .action((idOrName, options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const bookId = options.book;
+        const account = yield updateAccount(bookId, idOrName, {
+            name: options.name,
+            type: options.type,
+            archived: options.archived !== undefined ? options.archived === 'true' : undefined,
+            property: options.property,
+        });
+        renderItem(account.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error updating account:', err);
+        process.exit(1);
+    }
+}));
+accountCommand
+    .command('delete <idOrName>')
+    .description('Delete an account')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .action((idOrName, options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const bookId = options.book;
+        const account = yield deleteAccount(bookId, idOrName);
+        renderItem(account.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error deleting account:', err);
+        process.exit(1);
+    }
+}));
+// 'group' command group
+const groupCommand = program.command('group').description('Manage Groups');
+groupCommand
+    .command('list')
+    .description('List all groups in a book')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .action((options) => __awaiter(void 0, void 0, void 0, function* () {
     try {
         setupBkper();
-        const app = yield updateApp();
-        console.log(`Updated ${app.getId()} successfully.`);
+        const bookId = options.book;
+        const groups = yield listGroups(bookId);
+        if (isJson()) {
+            console.log(JSON.stringify(groups.map(g => g.json()), null, 2));
+        }
+        else {
+            const matrix = new GroupsDataTableBuilder(groups).ids(true).tree(true).build();
+            renderTable(matrix, false);
+        }
+    }
+    catch (err) {
+        console.error('Error listing groups:', err);
+        process.exit(1);
+    }
+}));
+groupCommand
+    .command('get <idOrName>')
+    .description('Get a group by ID or name')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .action((idOrName, options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const bookId = options.book;
+        const group = yield getGroup(bookId, idOrName);
+        renderItem(group.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error getting group:', err);
+        process.exit(1);
+    }
+}));
+groupCommand
+    .command('create')
+    .description('Create a new group')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .requiredOption('--name <name>', 'Group name')
+    .option('--parent <parent>', 'Parent group name or ID')
+    .option('--hidden', 'Hide the group')
+    .option('-p, --property <key=value>', 'Set a property (repeatable)', collectProperty)
+    .action((options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const bookId = options.book;
+        const group = yield createGroup(bookId, {
+            name: options.name,
+            parent: options.parent,
+            hidden: options.hidden,
+            property: options.property,
+        });
+        renderItem(group.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error creating group:', err);
+        process.exit(1);
+    }
+}));
+groupCommand
+    .command('update <idOrName>')
+    .description('Update a group')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .option('--name <name>', 'Group name')
+    .option('--hidden <hidden>', 'Hide status (true/false)')
+    .option('-p, --property <key=value>', 'Set a property (repeatable)', collectProperty)
+    .action((idOrName, options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const bookId = options.book;
+        const group = yield updateGroup(bookId, idOrName, {
+            name: options.name,
+            hidden: options.hidden !== undefined ? options.hidden === 'true' : undefined,
+            property: options.property,
+        });
+        renderItem(group.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error updating group:', err);
+        process.exit(1);
+    }
+}));
+groupCommand
+    .command('delete <idOrName>')
+    .description('Delete a group')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .action((idOrName, options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const bookId = options.book;
+        const group = yield deleteGroup(bookId, idOrName);
+        renderItem(group.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error deleting group:', err);
+        process.exit(1);
+    }
+}));
+// 'transaction' command group
+const transactionCommand = program.command('transaction').description('Manage Transactions');
+transactionCommand
+    .command('list')
+    .description('List transactions in a book')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .requiredOption('-q, --query <query>', 'Search query')
+    .option('-l, --limit <limit>', 'Maximum number of results (1-1000)', parseInt)
+    .option('-c, --cursor <cursor>', 'Pagination cursor')
+    .option('-p, --properties', 'Include custom properties')
+    .action((options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const bookId = options.book;
+        const result = yield listTransactions(bookId, {
+            query: options.query,
+            limit: options.limit,
+            cursor: options.cursor,
+        });
+        if (isJson()) {
+            console.log(JSON.stringify({
+                items: result.items.map(tx => tx.json()),
+                cursor: result.cursor,
+            }, null, 2));
+        }
+        else {
+            const builder = result.book
+                .createTransactionsDataTable(result.items, result.account)
+                .ids(true)
+                .formatDates(true)
+                .formatValues(true)
+                .recordedAt(false);
+            if (options.properties) {
+                builder.properties(true);
+            }
+            const matrix = yield builder.build();
+            renderTable(matrix, false);
+            if (result.cursor) {
+                console.log(`\nNext cursor: ${result.cursor}`);
+            }
+        }
+    }
+    catch (err) {
+        console.error('Error listing transactions:', err);
+        process.exit(1);
+    }
+}));
+transactionCommand
+    .command('create')
+    .description('Create a transaction')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .requiredOption('--date <date>', 'Transaction date')
+    .requiredOption('--amount <amount>', 'Transaction amount')
+    .option('--description <description>', 'Transaction description')
+    .option('--from <from>', 'Credit account (source)')
+    .option('--to <to>', 'Debit account (destination)')
+    .option('--url <url>', 'URL (repeatable)', collectProperty)
+    .option('--remote-id <remoteId>', 'Remote ID (repeatable)', collectProperty)
+    .option('-p, --property <key=value>', 'Set a property (repeatable, empty value deletes)', collectProperty)
+    .action((options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const bookId = options.book;
+        const transaction = yield createTransaction(bookId, {
+            date: options.date,
+            amount: options.amount,
+            description: options.description,
+            from: options.from,
+            to: options.to,
+            url: options.url,
+            remoteId: options.remoteId,
+            property: options.property,
+        });
+        renderItem(transaction.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error creating transaction:', err);
+        process.exit(1);
+    }
+}));
+transactionCommand
+    .command('post <transactionId>')
+    .description('Post a transaction')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .action((transactionId, options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const bookId = options.book;
+        const transaction = yield postTransaction(bookId, transactionId);
+        renderItem(transaction.json(), isJson());
     }
     catch (err) {
-        console.error("Error updating app:", err);
+        console.error('Error posting transaction:', err);
         process.exit(1);
     }
 }));
-const mcpCommand = program.command("mcp").description("Bkper MCP server commands");
-mcpCommand
-    .command("start")
-    .description("Start Bkper MCP server")
+transactionCommand
+    .command('update <transactionId>')
+    .description('Update a transaction')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .option('--date <date>', 'Transaction date')
+    .option('--amount <amount>', 'Transaction amount')
+    .option('--description <description>', 'Transaction description')
+    .option('--from <from>', 'Credit account (source)')
+    .option('--to <to>', 'Debit account (destination)')
+    .option('--url <url>', 'URL (repeatable, replaces all)', collectProperty)
+    .option('-p, --property <key=value>', 'Set a property (repeatable, empty value deletes)', collectProperty)
+    .action((transactionId, options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const bookId = options.book;
+        const transaction = yield updateTransaction(bookId, transactionId, {
+            date: options.date,
+            amount: options.amount,
+            description: options.description,
+            from: options.from,
+            to: options.to,
+            url: options.url,
+            property: options.property,
+        });
+        renderItem(transaction.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error updating transaction:', err);
+        process.exit(1);
+    }
+}));
+transactionCommand
+    .command('check <transactionId>')
+    .description('Check a transaction')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .action((transactionId, options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const bookId = options.book;
+        const transaction = yield checkTransaction(bookId, transactionId);
+        renderItem(transaction.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error checking transaction:', err);
+        process.exit(1);
+    }
+}));
+transactionCommand
+    .command('trash <transactionId>')
+    .description('Trash a transaction')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .action((transactionId, options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const bookId = options.book;
+        const transaction = yield trashTransaction(bookId, transactionId);
+        renderItem(transaction.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error trashing transaction:', err);
+        process.exit(1);
+    }
+}));
+transactionCommand
+    .command('merge <transactionId1> <transactionId2>')
+    .description('Merge two transactions')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .action((transactionId1, transactionId2, options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const bookId = options.book;
+        const result = yield mergeTransactions(bookId, transactionId1, transactionId2);
+        if (isJson()) {
+            console.log(JSON.stringify({
+                mergedTransaction: result.mergedTransaction.json(),
+                revertedTransactionId: result.revertedTransactionId,
+                auditRecord: result.auditRecord,
+            }, null, 2));
+        }
+        else {
+            renderItem(result.mergedTransaction.json(), false);
+        }
+    }
+    catch (err) {
+        console.error('Error merging transactions:', err);
+        process.exit(1);
+    }
+}));
+// 'balance' command group
+const balanceCommand = program.command('balance').description('Manage Balances');
+balanceCommand
+    .command('get')
+    .description('Get balances report')
+    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .requiredOption('-q, --query <query>', 'Balances query')
+    .option('--expanded <level>', 'Expand groups to specified depth (0+)', parseInt)
+    .action((options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const bookId = options.book;
+        const matrix = yield getBalancesMatrix(bookId, {
+            query: options.query,
+            expanded: options.expanded,
+        });
+        renderTable(matrix, isJson());
+    }
+    catch (err) {
+        console.error('Error getting balances:', err);
+        process.exit(1);
+    }
+}));
+// 'collection' command group
+const collectionCommand = program.command('collection').description('Manage Collections');
+collectionCommand
+    .command('list')
+    .description('List all collections')
     .action(() => __awaiter(void 0, void 0, void 0, function* () {
     try {
-        // Import and start the MCP server directly
-        const { BkperMcpServer } = yield import("./mcp/server.js");
-        const server = new BkperMcpServer();
-        yield server.run();
+        setupBkper();
+        const collections = yield listCollections();
+        if (isJson()) {
+            console.log(JSON.stringify(collections.map(c => c.json()), null, 2));
+        }
+        else {
+            if (collections.length === 0) {
+                console.log('No collections found.');
+                return;
+            }
+            const matrix = [['ID', 'Name', 'Books']];
+            for (const col of collections) {
+                const books = col.getBooks();
+                matrix.push([col.getId() || '', col.getName() || '', books.length.toString()]);
+            }
+            renderTable(matrix, false);
+        }
+    }
+    catch (err) {
+        console.error('Error listing collections:', err);
+        process.exit(1);
+    }
+}));
+collectionCommand
+    .command('get <collectionId>')
+    .description('Get a collection by ID')
+    .action((collectionId) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const collection = yield getCollection(collectionId);
+        renderItem(collection.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error getting collection:', err);
+        process.exit(1);
+    }
+}));
+collectionCommand
+    .command('create')
+    .description('Create a new collection')
+    .requiredOption('--name <name>', 'Collection name')
+    .action((options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const collection = yield createCollection({ name: options.name });
+        renderItem(collection.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error creating collection:', err);
+        process.exit(1);
+    }
+}));
+collectionCommand
+    .command('update <collectionId>')
+    .description('Update a collection')
+    .option('--name <name>', 'Collection name')
+    .action((collectionId, options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const collection = yield updateCollection(collectionId, {
+            name: options.name,
+        });
+        renderItem(collection.json(), isJson());
+    }
+    catch (err) {
+        console.error('Error updating collection:', err);
+        process.exit(1);
+    }
+}));
+collectionCommand
+    .command('delete <collectionId>')
+    .description('Delete a collection')
+    .action((collectionId) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        yield deleteCollection(collectionId);
+        console.log(`Collection ${collectionId} deleted.`);
+    }
+    catch (err) {
+        console.error('Error deleting collection:', err);
+        process.exit(1);
+    }
+}));
+function collectBook(value, previous) {
+    return previous ? [...previous, value] : [value];
+}
+collectionCommand
+    .command('add-book <collectionId>')
+    .description('Add books to a collection')
+    .requiredOption('-b, --book <bookId>', 'Book ID (repeatable)', collectBook)
+    .action((collectionId, options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const books = yield addBookToCollection(collectionId, options.book);
+        if (isJson()) {
+            console.log(JSON.stringify(books.map(b => b.json()), null, 2));
+        }
+        else {
+            console.log(`Added ${options.book.length} book(s) to collection ${collectionId}.`);
+        }
+    }
+    catch (err) {
+        console.error('Error adding books to collection:', err);
+        process.exit(1);
+    }
+}));
+collectionCommand
+    .command('remove-book <collectionId>')
+    .description('Remove books from a collection')
+    .requiredOption('-b, --book <bookId>', 'Book ID (repeatable)', collectBook)
+    .action((collectionId, options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        setupBkper();
+        const books = yield removeBookFromCollection(collectionId, options.book);
+        if (isJson()) {
+            console.log(JSON.stringify(books.map(b => b.json()), null, 2));
+        }
+        else {
+            console.log(`Removed ${options.book.length} book(s) from collection ${collectionId}.`);
+        }
     }
     catch (err) {
-        console.error("Error starting MCP server:", err);
+        console.error('Error removing books from collection:', err);
         process.exit(1);
     }
 }));