bkper 4.0.1 → 4.0.2

package/CHANGELOG.md

@@ -4,45 +4,65 @@
 
 ### **February 2026**
 
-**CLI**
-
-- Table-formatted output is now the default for all commands
-- Added `--json` global flag to output raw JSON instead of formatted tables
-- Added `-b, --book` required option for scoping commands to a book
-- Added `-p, --properties` flag to `transaction list` to include custom properties
-- Transaction tables show formatted dates and values with IDs
-- Group tables render as indented trees showing hierarchy
-- Single-item commands display as indented key-value pairs
-- Removed MCP server (`mcp start` command)
+-   **CLI**
+    -   Table-formatted output is now the default for all commands
+    -   Added `--json` global flag to output raw JSON instead of formatted tables
+    -   Added `-b, --book` option for scoping commands to a specific [Book](https://bkper.com/docs)
+    -   Added `-p, --properties` repeatable flag for setting custom properties as `key=value` pairs
+    -   [Transaction](https://bkper.com/docs) tables show formatted dates and values with IDs
+    -   [Group](https://bkper.com/docs) tables render as indented trees showing hierarchy
+    -   Single-item commands display as indented key-value pairs
+    -   Removed MCP server — now maintained as a separate project
+-   **Data Management**
+    -   Added [Book](https://bkper.com/docs) create command
+    -   Added [Collection](https://bkper.com/docs) commands: create, list, get, update, delete, add-book, remove-book
+    -   Added [Transaction](https://bkper.com/docs) update command
+    -   Renamed `balance get` to `balance list` for consistency
+-   **Authentication**
+    -   Switched to PKCE-based OAuth flow — no client secret required
+    -   Branded OAuth callback pages for a polished sign-in experience
+-   **App Development**
+    -   Local development now uses Cloudflare Tunnel for event handling — no cloud deployment needed during development
+    -   Renamed `dev` environment to `preview` for clarity
+    -   Added `--no-open` flag to suppress automatic browser launch during dev
+
+### **January 2026**
+
+-   **App Platform**
+    -   Added [`app init`](https://bkper.com/docs) command to scaffold new apps from template
+    -   Added [`app deploy`](https://bkper.com/docs) and [`app undeploy`](https://bkper.com/docs) commands for managing deployments
+    -   Added [`app status`](https://bkper.com/docs) to view current deployment information
+    -   Added [`app dev`](https://bkper.com/docs) and [`app build`](https://bkper.com/docs) commands for local development and build workflows
+    -   Added [`app secrets`](https://bkper.com/docs) management — put, list, and delete secrets for your apps
+    -   Added [`app sync`](https://bkper.com/docs) command to push `bkper.yaml` configuration to the platform
+    -   Support for shared packages in monorepo setups with hot reload
+    -   Asset file uploads included in deployments
+    -   Migrated app configuration from `bkperapp.yaml` to `bkper.yaml`
 
 ## 2025
 
 ### **October 2025**
 
-**MCP Server**
-
-- Added smart transaction merging - combine multiple transactions intelligently based on date and account matching
-- Simplified transaction creation - accounts are now optional, making it easier to record simple income and expenses
-- Improved transaction data responses for better AI assistant integration
+-   **MCP Server**
+    -   Added smart [Transaction](https://bkper.com/docs) merging — combine multiple transactions based on date and account matching
+    -   Simplified [Transaction](https://bkper.com/docs) creation — accounts are now optional for recording simple income and expenses
+    -   Improved transaction data responses for better AI assistant integration
 
 ### **September 2025**
 
-**MCP Server**
-
-- Streamlined transaction data for cleaner AI assistant responses
-- Fixed credential storage to follow standard configuration directories
+-   **MCP Server**
+    -   Streamlined transaction data for cleaner AI assistant responses
+    -   Fixed credential storage to follow standard configuration directories
 
 ### **July 2025**
 
-**MCP Server**
-
-- Added support for AI assistants to analyze your books with monthly and year-to-date balances
-- Improved date filtering with more intuitive `before:` operator
-- Added setup instructions for Claude Desktop and other AI tools
+-   **MCP Server**
+    -   Added monthly and year-to-date [Balance](https://bkper.com/docs) analysis for AI assistants
+    -   Improved date filtering with `before:` operator
+    -   Added setup instructions for Claude Desktop and other AI tools
 
 ### **June 2025**
 
-**bkper-node CLI**
-
-- Introduced MCP server - connect AI assistants to your Bkper books with `bkper mcp start`
-- Added book name filtering to quickly find specific books
+-   **CLI**
+    -   Introduced MCP server — connect AI assistants to your Bkper [Books](https://bkper.com/docs) with `bkper mcp start`
+    -   Added [Book](https://bkper.com/docs) name filtering to quickly find specific books

package/lib/bkper-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bkper-factory.d.ts","sourceRoot":"","sources":["../src/bkper-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAKjC;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,KAAK,CAiBxC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,SAUzB"}
+{"version":3,"file":"bkper-factory.d.ts","sourceRoot":"","sources":["../src/bkper-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAKjC;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,KAAK,CAiBxC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,SAezB"}

package/lib/bkper-factory.js

@@ -43,6 +43,11 @@ export function setupBkper() {
     Bkper.setConfig({
         apiKeyProvider: apiKey ? () => __awaiter(this, void 0, void 0, function* () { return apiKey; }) : undefined,
         oauthTokenProvider: () => getOAuthToken(),
+        requestHeadersProvider: () => __awaiter(this, void 0, void 0, function* () {
+            return {
+                'bkper-agent-id': 'bkper-cli',
+            };
+        }),
         //@ts-ignore
         apiBaseUrl,
     });

package/lib/bkper-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"bkper-factory.js","sourceRoot":"","sources":["../src/bkper-factory.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,IAAI,uBAAuB,GAAsB,SAAS,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB;IAC5B,8CAA8C;IAC9C,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,IAAK,UAAkB,CAAC,WAAW,EAAE,CAAC;QACrE,OAAQ,UAAkB,CAAC,WAAW,IAAI,KAAK,CAAC;IACpD,CAAC;IAED,+CAA+C;IAC/C,IAAI,uBAAuB,EAAE,CAAC;QAC1B,OAAO,uBAAuB,CAAC;IACnC,CAAC;IAED,sCAAsC;IACtC,UAAU,EAAE,CAAC;IACb,gCAAgC;IAChC,uBAAuB,GAAG,IAAI,KAAK,EAAE,CAAC;IAEtC,OAAO,uBAAuB,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU;IACtB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACzC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAE7C,KAAK,CAAC,SAAS,CAAC;QACZ,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,GAAS,EAAE,gDAAC,OAAA,MAAM,CAAA,GAAA,CAAC,CAAC,CAAC,SAAS;QACvD,kBAAkB,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE;QACzC,YAAY;QACZ,UAAU;KACb,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"bkper-factory.js","sourceRoot":"","sources":["../src/bkper-factory.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,IAAI,uBAAuB,GAAsB,SAAS,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB;IAC5B,8CAA8C;IAC9C,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,IAAK,UAAkB,CAAC,WAAW,EAAE,CAAC;QACrE,OAAQ,UAAkB,CAAC,WAAW,IAAI,KAAK,CAAC;IACpD,CAAC;IAED,+CAA+C;IAC/C,IAAI,uBAAuB,EAAE,CAAC;QAC1B,OAAO,uBAAuB,CAAC;IACnC,CAAC;IAED,sCAAsC;IACtC,UAAU,EAAE,CAAC;IACb,gCAAgC;IAChC,uBAAuB,GAAG,IAAI,KAAK,EAAE,CAAC;IAEtC,OAAO,uBAAuB,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU;IACtB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACzC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAE7C,KAAK,CAAC,SAAS,CAAC;QACZ,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,GAAS,EAAE,gDAAC,OAAA,MAAM,CAAA,GAAA,CAAC,CAAC,CAAC,SAAS;QACvD,kBAAkB,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE;QACzC,sBAAsB,EAAE,GAAS,EAAE;YAC/B,OAAO;gBACH,gBAAgB,EAAE,WAAW;aAChC,CAAC;QACN,CAAC,CAAA;QACD,YAAY;QACZ,UAAU;KACb,CAAC,CAAC;AACP,CAAC"}

package/lib/cli.js

@@ -10,7 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 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 { 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';
@@ -21,6 +21,7 @@ import { listTransactions, createTransaction, updateTransaction, postTransaction
 import { listBalancesMatrix } 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';
+import { validateRequiredOptions, throwIfErrors } from './utils/validation.js';
 function collectProperty(value, previous) {
     return previous ? [...previous, value] : [value];
 }
@@ -221,9 +222,10 @@ secretsCommand
 appCommand
     .command('install <appId>')
     .description('Install an app into a book')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .option('-b, --book <bookId>', 'Book ID')
     .action((appId, options) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'book', flag: '--book' }]));
         setupBkper();
         const integration = yield installApp(options.book, appId);
         renderItem(integration.json(), isJson());
@@ -236,9 +238,10 @@ appCommand
 appCommand
     .command('uninstall <appId>')
     .description('Uninstall an app from a book')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .option('-b, --book <bookId>', 'Book ID')
     .action((appId, options) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'book', flag: '--book' }]));
         setupBkper();
         const integration = yield uninstallApp(options.book, appId);
         renderItem(integration.json(), isJson());
@@ -255,6 +258,7 @@ bookCommand
     .description('List all books')
     .option('-q, --query <query>', 'Search query')
     .action((options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
     try {
         setupBkper();
         const books = yield listBooks(options.query);
@@ -262,7 +266,33 @@ bookCommand
             console.log(JSON.stringify(books.map(b => b.json()), null, 2));
         }
         else {
-            const matrix = new BooksDataTableBuilder(books).ids(true).build();
+            if (books.length === 0) {
+                console.log('No results found.');
+                return;
+            }
+            books.sort((a, b) => {
+                var _a, _b;
+                const collA = (_a = a.getCollection()) === null || _a === void 0 ? void 0 : _a.getName();
+                const collB = (_b = b.getCollection()) === null || _b === void 0 ? void 0 : _b.getName();
+                if (collA && !collB)
+                    return -1;
+                if (!collA && collB)
+                    return 1;
+                let ret = (collA || '').localeCompare(collB || '');
+                if (ret === 0) {
+                    ret = (a.getName() || '').localeCompare(b.getName() || '');
+                }
+                return ret;
+            });
+            const matrix = [['Book Id', 'Name', 'Owner', 'Collection']];
+            for (const book of books) {
+                matrix.push([
+                    book.getId() || '',
+                    book.getName() || '',
+                    book.getOwnerName() || '',
+                    ((_a = book.getCollection()) === null || _a === void 0 ? void 0 : _a.getName()) || '',
+                ]);
+            }
             renderTable(matrix, false);
         }
     }
@@ -288,7 +318,7 @@ bookCommand
 bookCommand
     .command('create')
     .description('Create a new book')
-    .requiredOption('--name <name>', 'Book name')
+    .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)')
@@ -297,6 +327,7 @@ bookCommand
     .option('-p, --property <key=value>', 'Set a property (repeatable)', collectProperty)
     .action((options) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'name', flag: '--name' }]));
         setupBkper();
         const book = yield createBook({
             name: options.name,
@@ -352,9 +383,10 @@ const accountCommand = program.command('account').description('Manage Accounts')
 accountCommand
     .command('list')
     .description('List all accounts in a book')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .option('-b, --book <bookId>', 'Book ID')
     .action((options) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'book', flag: '--book' }]));
         setupBkper();
         const bookId = options.book;
         const accounts = yield listAccounts(bookId);
@@ -377,9 +409,10 @@ accountCommand
 accountCommand
     .command('get <idOrName>')
     .description('Get an account by ID or name')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .option('-b, --book <bookId>', 'Book ID')
     .action((idOrName, options) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'book', flag: '--book' }]));
         setupBkper();
         const bookId = options.book;
         const account = yield getAccount(bookId, idOrName);
@@ -393,14 +426,18 @@ accountCommand
 accountCommand
     .command('create')
     .description('Create a new account')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
-    .requiredOption('--name <name>', 'Account name')
+    .option('-b, --book <bookId>', 'Book ID')
+    .option('--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 {
+        throwIfErrors(validateRequiredOptions(options, [
+            { name: 'book', flag: '--book' },
+            { name: 'name', flag: '--name' },
+        ]));
         setupBkper();
         const bookId = options.book;
         const account = yield createAccount(bookId, {
@@ -422,13 +459,14 @@ accountCommand
 accountCommand
     .command('update <idOrName>')
     .description('Update an account')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .option('-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 {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'book', flag: '--book' }]));
         setupBkper();
         const bookId = options.book;
         const account = yield updateAccount(bookId, idOrName, {
@@ -447,9 +485,10 @@ accountCommand
 accountCommand
     .command('delete <idOrName>')
     .description('Delete an account')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .option('-b, --book <bookId>', 'Book ID')
     .action((idOrName, options) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'book', flag: '--book' }]));
         setupBkper();
         const bookId = options.book;
         const account = yield deleteAccount(bookId, idOrName);
@@ -465,9 +504,10 @@ const groupCommand = program.command('group').description('Manage Groups');
 groupCommand
     .command('list')
     .description('List all groups in a book')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .option('-b, --book <bookId>', 'Book ID')
     .action((options) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'book', flag: '--book' }]));
         setupBkper();
         const bookId = options.book;
         const groups = yield listGroups(bookId);
@@ -487,9 +527,10 @@ groupCommand
 groupCommand
     .command('get <idOrName>')
     .description('Get a group by ID or name')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .option('-b, --book <bookId>', 'Book ID')
     .action((idOrName, options) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'book', flag: '--book' }]));
         setupBkper();
         const bookId = options.book;
         const group = yield getGroup(bookId, idOrName);
@@ -503,13 +544,17 @@ groupCommand
 groupCommand
     .command('create')
     .description('Create a new group')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
-    .requiredOption('--name <name>', 'Group name')
+    .option('-b, --book <bookId>', 'Book ID')
+    .option('--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 {
+        throwIfErrors(validateRequiredOptions(options, [
+            { name: 'book', flag: '--book' },
+            { name: 'name', flag: '--name' },
+        ]));
         setupBkper();
         const bookId = options.book;
         const group = yield createGroup(bookId, {
@@ -528,12 +573,13 @@ groupCommand
 groupCommand
     .command('update <idOrName>')
     .description('Update a group')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .option('-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 {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'book', flag: '--book' }]));
         setupBkper();
         const bookId = options.book;
         const group = yield updateGroup(bookId, idOrName, {
@@ -551,9 +597,10 @@ groupCommand
 groupCommand
     .command('delete <idOrName>')
     .description('Delete a group')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .option('-b, --book <bookId>', 'Book ID')
     .action((idOrName, options) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'book', flag: '--book' }]));
         setupBkper();
         const bookId = options.book;
         const group = yield deleteGroup(bookId, idOrName);
@@ -569,13 +616,17 @@ const transactionCommand = program.command('transaction').description('Manage Tr
 transactionCommand
     .command('list')
     .description('List transactions in a book')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
-    .requiredOption('-q, --query <query>', 'Search query')
+    .option('-b, --book <bookId>', 'Book ID')
+    .option('-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 {
+        throwIfErrors(validateRequiredOptions(options, [
+            { name: 'book', flag: '--book' },
+            { name: 'query', flag: '--query' },
+        ]));
         setupBkper();
         const bookId = options.book;
         const result = yield listTransactions(bookId, {
@@ -614,9 +665,9 @@ transactionCommand
 transactionCommand
     .command('create')
     .description('Create a transaction')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
-    .requiredOption('--date <date>', 'Transaction date')
-    .requiredOption('--amount <amount>', 'Transaction amount')
+    .option('-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)')
@@ -625,6 +676,11 @@ transactionCommand
     .option('-p, --property <key=value>', 'Set a property (repeatable, empty value deletes)', collectProperty)
     .action((options) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        throwIfErrors(validateRequiredOptions(options, [
+            { name: 'book', flag: '--book' },
+            { name: 'date', flag: '--date' },
+            { name: 'amount', flag: '--amount' },
+        ]));
         setupBkper();
         const bookId = options.book;
         const transaction = yield createTransaction(bookId, {
@@ -647,9 +703,10 @@ transactionCommand
 transactionCommand
     .command('post <transactionId>')
     .description('Post a transaction')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .option('-b, --book <bookId>', 'Book ID')
     .action((transactionId, options) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'book', flag: '--book' }]));
         setupBkper();
         const bookId = options.book;
         const transaction = yield postTransaction(bookId, transactionId);
@@ -663,7 +720,7 @@ transactionCommand
 transactionCommand
     .command('update <transactionId>')
     .description('Update a transaction')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .option('-b, --book <bookId>', 'Book ID')
     .option('--date <date>', 'Transaction date')
     .option('--amount <amount>', 'Transaction amount')
     .option('--description <description>', 'Transaction description')
@@ -673,6 +730,7 @@ transactionCommand
     .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 {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'book', flag: '--book' }]));
         setupBkper();
         const bookId = options.book;
         const transaction = yield updateTransaction(bookId, transactionId, {
@@ -694,9 +752,10 @@ transactionCommand
 transactionCommand
     .command('check <transactionId>')
     .description('Check a transaction')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .option('-b, --book <bookId>', 'Book ID')
     .action((transactionId, options) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'book', flag: '--book' }]));
         setupBkper();
         const bookId = options.book;
         const transaction = yield checkTransaction(bookId, transactionId);
@@ -710,9 +769,10 @@ transactionCommand
 transactionCommand
     .command('trash <transactionId>')
     .description('Trash a transaction')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .option('-b, --book <bookId>', 'Book ID')
     .action((transactionId, options) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'book', flag: '--book' }]));
         setupBkper();
         const bookId = options.book;
         const transaction = yield trashTransaction(bookId, transactionId);
@@ -726,9 +786,10 @@ transactionCommand
 transactionCommand
     .command('merge <transactionId1> <transactionId2>')
     .description('Merge two transactions')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
+    .option('-b, --book <bookId>', 'Book ID')
     .action((transactionId1, transactionId2, options) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'book', flag: '--book' }]));
         setupBkper();
         const bookId = options.book;
         const result = yield mergeTransactions(bookId, transactionId1, transactionId2);
@@ -753,11 +814,15 @@ const balanceCommand = program.command('balance').description('Manage Balances')
 balanceCommand
     .command('list')
     .description('List balances')
-    .requiredOption('-b, --book <bookId>', 'Book ID')
-    .requiredOption('-q, --query <query>', 'Balances query')
+    .option('-b, --book <bookId>', 'Book ID')
+    .option('-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 {
+        throwIfErrors(validateRequiredOptions(options, [
+            { name: 'book', flag: '--book' },
+            { name: 'query', flag: '--query' },
+        ]));
         setupBkper();
         const bookId = options.book;
         const matrix = yield listBalancesMatrix(bookId, {
@@ -818,9 +883,10 @@ collectionCommand
 collectionCommand
     .command('create')
     .description('Create a new collection')
-    .requiredOption('--name <name>', 'Collection name')
+    .option('--name <name>', 'Collection name')
     .action((options) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'name', flag: '--name' }]));
         setupBkper();
         const collection = yield createCollection({ name: options.name });
         renderItem(collection.json(), isJson());
@@ -867,9 +933,10 @@ function collectBook(value, previous) {
 collectionCommand
     .command('add-book <collectionId>')
     .description('Add books to a collection')
-    .requiredOption('-b, --book <bookId>', 'Book ID (repeatable)', collectBook)
+    .option('-b, --book <bookId>', 'Book ID (repeatable)', collectBook)
     .action((collectionId, options) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'book', flag: '--book' }]));
         setupBkper();
         const books = yield addBookToCollection(collectionId, options.book);
         if (isJson()) {
@@ -887,9 +954,10 @@ collectionCommand
 collectionCommand
     .command('remove-book <collectionId>')
     .description('Remove books from a collection')
-    .requiredOption('-b, --book <bookId>', 'Book ID (repeatable)', collectBook)
+    .option('-b, --book <bookId>', 'Book ID (repeatable)', collectBook)
     .action((collectionId, options) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'book', flag: '--book' }]));
         setupBkper();
         const books = yield removeBookFromCollection(collectionId, options.book);
         if (isJson()) {