bkper 3.5.4 → 3.5.6

package/README.md

@@ -1,6 +1,6 @@
 [Bkper REST API]: https://bkper.com/docs/#rest-api-enabling
 
-A **command line** utility for managing [Bkper Apps and Bots](https://bkper.com/docs/) and running the [Model Context Protocol (MCP) server](https://modelcontextprotocol.io). 
+A **command line** utility for managing [Bkper Apps and Bots](https://bkper.com/docs/) and running the [Model Context Protocol (MCP) server](https://modelcontextprotocol.io).
 
 The MCP server enables AI assistants and agents to interact with your Bkper books through a standardized protocol.
 
@@ -13,37 +13,45 @@ The MCP server enables AI assistants and agents to interact with your Bkper book
 ```
 npm i bkper
 ```
+
 or
+
 ```
 yarn add bkper
 ```
+
 or
+
 ```
 bun add bkper
 ```
 
-Optionally, you can install it globally to be able to use the ```bkper``` command line utility:
+Optionally, you can install it globally to be able to use the `bkper` command line utility:
 
 ```
 npm i -g bkper
 ```
+
 or
+
 ```
 yarn global add bkper
 ```
 
 ## Commands
 
-- ```login```   - Logs the user in. Saves the client credentials to a ```~/.config/bkper/.bkper-credentials.json``` file.
-- ```logout```  - Logs out the user by deleting client credentials.
-- ```mcp start``` - Start the Bkper MCP (Model Context Protocol) server.
-- ```app -c```  - Create a new App based on ```./bkperapp.yaml``` file.
-- ```app -u```  - Update an existing App based on ```./bkperapp.yaml``` file.
+- `login` - Logs the user in. Saves the client credentials to a `~/.config/bkper/.bkper-credentials.json` file.
+- `logout` - Logs out the user by deleting client credentials.
+- `mcp start` - Start the Bkper MCP (Model Context Protocol) server.
+- `app -c` - Create a new App based on `./bkperapp.yaml` file.
+- `app -u` - Update an existing App based on `./bkperapp.yaml` file.
 
 ### Examples
+
 ```
 npm bkper login
 ```
+
 ```
 yarn bkper login
 ```
@@ -68,6 +76,7 @@ The server runs on stdio and provides the following tools:
 #### Prerequisites
 
 Before using the MCP server:
+
 1. Login using `bkper login` to set up authentication
 2. Enable the [Bkper REST API]
 3. Ensure the `BKPER_API_KEY` environment variable is set.
@@ -79,6 +88,7 @@ The MCP server uses the same authentication as the CLI, reading credentials from
 ##### Claude Desktop
 
 Add to your configuration file:
+
 - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
 - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
 
@@ -99,6 +109,7 @@ Add to your configuration file:
 ##### Other MCP Clients
 
 For other MCP-compatible clients, configure them to run:
+
 ```bash
 BKPER_API_KEY=your-api-key npx bkper mcp start
 ```
@@ -108,6 +119,7 @@ The server communicates via stdio, so any MCP client that supports stdio transpo
 #### Available MCP Tools
 
 Once connected, the MCP client can:
+
 - List your Bkper books
 - Get account balances for any date or period
 - Search and filter transactions
@@ -115,18 +127,17 @@ Once connected, the MCP client can:
 
 For more information about the Model Context Protocol, visit [modelcontextprotocol.io](https://modelcontextprotocol.io).
 
-
-
 ## Apps and Bots
 
 ### Environment Variables
+
 The following environment variable is necessary in order to communicate with the [Bkper REST API]:
 
 ```
 BKPER_API_KEY=XXXX
 ```
 
-The ```app``` command also uses the following variables in order to perform App create/update operations:
+The `app` command also uses the following variables in order to perform App create/update operations:
 
 ```
 BKPER_CLIENT_SECRET=YYYY
@@ -134,16 +145,14 @@ BKPER_USER_EMAILS="someone@gmail.com anotherone@altrostat.com"
 BKPER_DEVELOPER_EMAIL=somedeveloer@mycompany.com
 ```
 
-You can add a ```.env``` file at the root of your project with those variables and bkper will automatically load from it. 
+You can add a `.env` file at the root of your project with those variables and bkper will automatically load from it.
 Follow [these](https://bkper.com/docs/#rest-api-enabling) steps in order to configure a valid Bkper API key.
 
 > WARNING: Never upload variables to the source code repository.
 
-
-### ```./bkperapp.yaml``` Reference
+### `./bkperapp.yaml` Reference
 
 ```yaml
-
 # BASIC APP CONFIGURATION
 
 # The agent id of the App or Bot. It can NOT be changed after the App or Bot is created.
@@ -158,8 +167,6 @@ logoUrl: https://static.thenounproject.com/png/2318500-200.png
 # The logo url to be used when in dark mode
 logoUrlDark: https://static.thenounproject.com/png/2318500-200.png
 
-
-
 # CONTEXT MENU CONFIGURATION
 
 # The menu production url to open in the popup window. See accepted expressions bellow.
@@ -174,20 +181,12 @@ menuText: Open My Custom App
 menuPopupWidth: 500 # width in pixels. Default to 80% of screen width.
 menuPopupHeight: 300 # height in pixels. Default to 90% of screen height.
 
-
-#ASSISTANT CONFIGURATION
-
-# The conversation url to be called by Bkper when a new conversation message is added
-conversationUrl: https://us-central1-bkper-tax-trigger.cloudfunctions.net/chat
-
-
-
 # BOT EVENTS CONFIGURATION
 
 # The webhook url to be called by Bkper when an event occurs.
 webhookUrl: https://us-central1-bkper-tax-trigger.cloudfunctions.net/events
 
-# The events the Bot is capable of processing by the webhook. 
+# The events the Bot is capable of processing by the webhook.
 # This is optional and, if not specified, no events will be processed.
 events:
   - "TRANSACTION_POSTED"
@@ -211,7 +210,6 @@ filePatterns:
   - "-*.qif"
   - "*.csv"
 
-
 # Schema to provide autocompletion on properties editor.
 propertiesSchema:
   book:
@@ -242,19 +240,18 @@ propertiesSchema:
     values:
       - "value2"
       - "value2"
-
 ```
 
 #### Accepted expressions in menuUrl property:
 
-  - ```${book.id}``` - the current book id
-  - ```${book.properties.xxxxx}``` - any property value from the current book
-  - ```${transactions.query}``` - the current query being executed on transactions list
-  - ```${transactions.ids}``` - the ids of selected transactions, splitted by comma
-  - ```${account.id}``` - the current account being filterd
-  - ```${account.properties.xxxxx}``` - any property value from the current account being filtered
-  - ```${group.id}``` - the current group being filterd
-  - ```${group.properties.xxxxx}``` - any property value from the current group being filtered
+- `${book.id}` - the current book id
+- `${book.properties.xxxxx}` - any property value from the current book
+- `${transactions.query}` - the current query being executed on transactions list
+- `${transactions.ids}` - the ids of selected transactions, splitted by comma
+- `${account.id}` - the current account being filterd
+- `${account.properties.xxxxx}` - any property value from the current account being filtered
+- `${group.id}` - the current group being filterd
+- `${group.properties.xxxxx}` - any property value from the current group being filtered
 
 #### Example:
 
@@ -264,20 +261,19 @@ propertiesSchema:
 
 #### Library
 
-The ```getOAuthToken``` returns a Promise that resolves to a valid OAuth token, to be used by the [```bkper-js```](https://github.com/bkper/bkper-js) library
+The `getOAuthToken` returns a Promise that resolves to a valid OAuth token, to be used by the [`bkper-js`](https://github.com/bkper/bkper-js) library
 
 Example:
 
 ```javascript
-import { Bkper } from 'bkper-js';
-import { getOAuthToken } from 'bkper';
+import { Bkper } from "bkper-js";
+import { getOAuthToken } from "bkper";
 
 Bkper.setConfig({
   oauthTokenProvider: async () => getOAuthToken(),
-})
+});
 ```
 
 ## Documentation
 
 - [Developer Docs](https://bkper.com/docs)
-

package/lib/mcp/tools/list_transactions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list_transactions.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/list_transactions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAuB,MAAM,oCAAoC,CAAC;AAGzF,UAAU,sBAAsB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAUD,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,cAAc,CAAC,CA0EpG;AAED,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2B1C,CAAC"}
+{"version":3,"file":"list_transactions.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/list_transactions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAuB,MAAM,oCAAoC,CAAC;AAGzF,UAAU,sBAAsB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAUD,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,cAAc,CAAC,CAuFpG;AAED,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2B1C,CAAC"}

package/lib/mcp/tools/list_transactions.js

@@ -7,6 +7,17 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
 import { getBkperInstance } from '../bkper-factory.js';
 export function handleListTransactions(params) {
@@ -32,7 +43,10 @@ export function handleListTransactions(params) {
             const transactionList = yield book.listTransactions(params.query, limit, params.cursor);
             // Get transactions from list
             const transactionItems = transactionList.getItems();
-            const transactions = transactionItems.map((transaction) => transaction.json());
+            const transactions = transactionItems.map((transaction) => {
+                const _a = transaction.json(), { agentId, agentName, agentLogo, agentLogoDark, createdAt, createdBy, updatedAt, dateValue } = _a, cleanTransaction = __rest(_a, ["agentId", "agentName", "agentLogo", "agentLogoDark", "createdAt", "createdBy", "updatedAt", "dateValue"]);
+                return cleanTransaction;
+            });
             // Get pagination info from list
             const hasMore = transactionItems.length > 0;
             const nextCursor = transactionList.getCursor() || null;

package/lib/mcp/tools/list_transactions.js.map

@@ -1 +1 @@
-{"version":3,"file":"list_transactions.js","sourceRoot":"","sources":["../../../src/mcp/tools/list_transactions.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAkB,SAAS,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAiBvD,MAAM,UAAgB,sBAAsB,CAAC,MAA8B;;QACzE,IAAI,CAAC;YACH,+BAA+B;YAC/B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACnB,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,aAAa,EACvB,oCAAoC,CACrC,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAClB,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,aAAa,EACvB,mCAAmC,CACpC,CAAC;YACJ,CAAC;YAED,gCAAgC;YAChC,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;YAEzC,qBAAqB;YACrB,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACxD,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,aAAa,EACvB,mBAAmB,MAAM,CAAC,MAAM,EAAE,CACnC,CAAC;YACJ,CAAC;YAED,+BAA+B;YAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,sBAAsB;YAEvE,+CAA+C;YAC/C,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAExF,6BAA6B;YAC7B,MAAM,gBAAgB,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAC;YACpD,MAAM,YAAY,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,WAAgB,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;YAEpF,gCAAgC;YAChC,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC;YAC5C,MAAM,UAAU,GAAG,eAAe,CAAC,SAAS,EAAE,IAAI,IAAI,CAAC;YAEvD,iBAAiB;YACjB,MAAM,QAAQ,GAAyB;gBACrC,YAAY;gBACZ,OAAO;gBACP,MAAM,EAAE,UAAU;gBAClB,KAAK;aACN,CAAC;YAEF,kDAAkD;YAClD,QAAQ,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YAE9B,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;qBACxC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,4BAA4B;YAC5B,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,sBAAsB;YACtB,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,aAAa,EACvB,gCAAgC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACzF,CAAC;QACJ,CAAC;IACH,CAAC;CAAA;AAED,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,+IAA+I;IAC5J,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mCAAmC;aACjD;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iEAAiE;aAC/E;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6KAA6K;aAC3L;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6DAA6D;gBAC1E,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,GAAG;aACb;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;KAC9B;CACF,CAAC"}
+{"version":3,"file":"list_transactions.js","sourceRoot":"","sources":["../../../src/mcp/tools/list_transactions.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bkper",
-  "version": "3.5.4",
+  "version": "3.5.6",
   "description": "Node.js command line client for Bkper",
   "bin": {
     "bkper": "./lib/cli.js"