bkper 4.0.0 → 4.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/CHANGELOG.md +48 -28
  2. package/README.md +394 -217
  3. package/lib/bkper-factory.d.ts.map +1 -1
  4. package/lib/bkper-factory.js +5 -0
  5. package/lib/bkper-factory.js.map +1 -1
  6. package/lib/cli.js +105 -37
  7. package/lib/cli.js.map +1 -1
  8. package/lib/commands/accounts/create.d.ts.map +1 -1
  9. package/lib/commands/accounts/create.js +16 -5
  10. package/lib/commands/accounts/create.js.map +1 -1
  11. package/lib/commands/accounts/update.d.ts.map +1 -1
  12. package/lib/commands/accounts/update.js +13 -5
  13. package/lib/commands/accounts/update.js.map +1 -1
  14. package/lib/commands/balances/index.d.ts +1 -1
  15. package/lib/commands/balances/index.d.ts.map +1 -1
  16. package/lib/commands/balances/index.js +1 -1
  17. package/lib/commands/balances/index.js.map +1 -1
  18. package/lib/commands/balances/{get.d.ts → list.d.ts} +3 -3
  19. package/lib/commands/balances/list.d.ts.map +1 -0
  20. package/lib/commands/balances/{get.js → list.js} +2 -2
  21. package/lib/commands/balances/list.js.map +1 -0
  22. package/lib/commands/books/create.d.ts.map +1 -1
  23. package/lib/commands/books/create.js +10 -2
  24. package/lib/commands/books/create.js.map +1 -1
  25. package/lib/commands/books/update.d.ts.map +1 -1
  26. package/lib/commands/books/update.js +13 -5
  27. package/lib/commands/books/update.js.map +1 -1
  28. package/lib/commands/groups/create.d.ts.map +1 -1
  29. package/lib/commands/groups/create.js +16 -5
  30. package/lib/commands/groups/create.js.map +1 -1
  31. package/lib/commands/groups/update.d.ts.map +1 -1
  32. package/lib/commands/groups/update.js +13 -5
  33. package/lib/commands/groups/update.js.map +1 -1
  34. package/lib/commands/transactions/create.d.ts.map +1 -1
  35. package/lib/commands/transactions/create.js +23 -7
  36. package/lib/commands/transactions/create.js.map +1 -1
  37. package/lib/commands/transactions/merge.d.ts.map +1 -1
  38. package/lib/commands/transactions/merge.js +6 -2
  39. package/lib/commands/transactions/merge.js.map +1 -1
  40. package/lib/commands/transactions/update.d.ts.map +1 -1
  41. package/lib/commands/transactions/update.js +23 -7
  42. package/lib/commands/transactions/update.js.map +1 -1
  43. package/lib/render/table-formatter.d.ts.map +1 -1
  44. package/lib/render/table-formatter.js +22 -4
  45. package/lib/render/table-formatter.js.map +1 -1
  46. package/lib/utils/validation.d.ts +38 -0
  47. package/lib/utils/validation.d.ts.map +1 -0
  48. package/lib/utils/validation.js +46 -0
  49. package/lib/utils/validation.js.map +1 -0
  50. package/package.json +2 -2
  51. package/lib/commands/balances/get.d.ts.map +0 -1
  52. package/lib/commands/balances/get.js.map +0 -1
package/CHANGELOG.md CHANGED
@@ -4,45 +4,65 @@
4
4
 
5
5
  ### **February 2026**
6
6
 
7
- **CLI**
8
-
9
- - Table-formatted output is now the default for all commands
10
- - Added `--json` global flag to output raw JSON instead of formatted tables
11
- - Added `-b, --book` required option for scoping commands to a book
12
- - Added `-p, --properties` flag to `transaction list` to include custom properties
13
- - Transaction tables show formatted dates and values with IDs
14
- - Group tables render as indented trees showing hierarchy
15
- - Single-item commands display as indented key-value pairs
16
- - Removed MCP server (`mcp start` command)
7
+ - **CLI**
8
+ - Table-formatted output is now the default for all commands
9
+ - Added `--json` global flag to output raw JSON instead of formatted tables
10
+ - Added `-b, --book` option for scoping commands to a specific [Book](https://bkper.com/docs)
11
+ - Added `-p, --properties` repeatable flag for setting custom properties as `key=value` pairs
12
+ - [Transaction](https://bkper.com/docs) tables show formatted dates and values with IDs
13
+ - [Group](https://bkper.com/docs) tables render as indented trees showing hierarchy
14
+ - Single-item commands display as indented key-value pairs
15
+ - Removed MCP server — now maintained as a separate project
16
+ - **Data Management**
17
+ - Added [Book](https://bkper.com/docs) create command
18
+ - Added [Collection](https://bkper.com/docs) commands: create, list, get, update, delete, add-book, remove-book
19
+ - Added [Transaction](https://bkper.com/docs) update command
20
+ - Renamed `balance get` to `balance list` for consistency
21
+ - **Authentication**
22
+ - Switched to PKCE-based OAuth flow — no client secret required
23
+ - Branded OAuth callback pages for a polished sign-in experience
24
+ - **App Development**
25
+ - Local development now uses Cloudflare Tunnel for event handling — no cloud deployment needed during development
26
+ - Renamed `dev` environment to `preview` for clarity
27
+ - Added `--no-open` flag to suppress automatic browser launch during dev
28
+
29
+ ### **January 2026**
30
+
31
+ - **App Platform**
32
+ - Added [`app init`](https://bkper.com/docs) command to scaffold new apps from template
33
+ - Added [`app deploy`](https://bkper.com/docs) and [`app undeploy`](https://bkper.com/docs) commands for managing deployments
34
+ - Added [`app status`](https://bkper.com/docs) to view current deployment information
35
+ - Added [`app dev`](https://bkper.com/docs) and [`app build`](https://bkper.com/docs) commands for local development and build workflows
36
+ - Added [`app secrets`](https://bkper.com/docs) management — put, list, and delete secrets for your apps
37
+ - Added [`app sync`](https://bkper.com/docs) command to push `bkper.yaml` configuration to the platform
38
+ - Support for shared packages in monorepo setups with hot reload
39
+ - Asset file uploads included in deployments
40
+ - Migrated app configuration from `bkperapp.yaml` to `bkper.yaml`
17
41
 
18
42
  ## 2025
19
43
 
20
44
  ### **October 2025**
21
45
 
22
- **MCP Server**
23
-
24
- - Added smart transaction merging - combine multiple transactions intelligently based on date and account matching
25
- - Simplified transaction creation - accounts are now optional, making it easier to record simple income and expenses
26
- - Improved transaction data responses for better AI assistant integration
46
+ - **MCP Server**
47
+ - Added smart [Transaction](https://bkper.com/docs) merging — combine multiple transactions based on date and account matching
48
+ - Simplified [Transaction](https://bkper.com/docs) creation — accounts are now optional for recording simple income and expenses
49
+ - Improved transaction data responses for better AI assistant integration
27
50
 
28
51
  ### **September 2025**
29
52
 
30
- **MCP Server**
31
-
32
- - Streamlined transaction data for cleaner AI assistant responses
33
- - Fixed credential storage to follow standard configuration directories
53
+ - **MCP Server**
54
+ - Streamlined transaction data for cleaner AI assistant responses
55
+ - Fixed credential storage to follow standard configuration directories
34
56
 
35
57
  ### **July 2025**
36
58
 
37
- **MCP Server**
38
-
39
- - Added support for AI assistants to analyze your books with monthly and year-to-date balances
40
- - Improved date filtering with more intuitive `before:` operator
41
- - Added setup instructions for Claude Desktop and other AI tools
59
+ - **MCP Server**
60
+ - Added monthly and year-to-date [Balance](https://bkper.com/docs) analysis for AI assistants
61
+ - Improved date filtering with `before:` operator
62
+ - Added setup instructions for Claude Desktop and other AI tools
42
63
 
43
64
  ### **June 2025**
44
65
 
45
- **bkper-node CLI**
46
-
47
- - Introduced MCP server - connect AI assistants to your Bkper books with `bkper mcp start`
48
- - Added book name filtering to quickly find specific books
66
+ - **CLI**
67
+ - Introduced MCP server — connect AI assistants to your Bkper [Books](https://bkper.com/docs) with `bkper mcp start`
68
+ - Added [Book](https://bkper.com/docs) name filtering to quickly find specific books