bkper-js 2.32.1 → 2.33.0

package/lib/index.d.ts

@@ -1821,6 +1821,18 @@ export declare class Book extends ResourceProperty<bkper.Book> {
      * @param transactions - The transactions to be untrashed
      */
     batchUntrashTransactions(transactions: Transaction[]): Promise<void>;
+    /**
+     * Merge two [[Transactions]] into a single new canonical transaction.
+     *
+     * The merged transaction is created synchronously. Cleanup of the two
+     * originals is scheduled asynchronously by the backend.
+     *
+     * @param transaction1 - The first transaction to merge
+     * @param transaction2 - The second transaction to merge
+     *
+     * @returns The merged Transaction
+     */
+    mergeTransactions(transaction1: Transaction, transaction2: Transaction): Promise<Transaction>;
     /**
      * Replay [[Events]] on the Book, in batch.
      *
@@ -1836,6 +1848,7 @@ export declare class Book extends ResourceProperty<bkper.Book> {
      * @returns The created Accounts
      */
     batchCreateAccounts(accounts: Account[]): Promise<Account[]>;
+
     /**
      * Update [[Accounts]] on the Book, in batch.
      *

package/lib/model/Book.js

@@ -542,6 +542,26 @@ export class Book extends ResourceProperty {
             yield TransactionService.untrashTransactionsBatch(this.getId(), transactionPayloads, this.getConfig());
         });
     }
+    /**
+     * Merge two [[Transactions]] into a single new canonical transaction.
+     *
+     * The merged transaction is created synchronously. Cleanup of the two
+     * originals is scheduled asynchronously by the backend.
+     *
+     * @param transaction1 - The first transaction to merge
+     * @param transaction2 - The second transaction to merge
+     *
+     * @returns The merged Transaction
+     */
+    mergeTransactions(transaction1, transaction2) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const payload = {
+                items: [transaction1.json(), transaction2.json()],
+            };
+            let operation = yield TransactionService.mergeTransactions(this.getId(), payload, this.getConfig());
+            return new Transaction(this, operation.transaction || {});
+        });
+    }
     /**
      * Replay [[Events]] on the Book, in batch.
      *
@@ -567,7 +587,7 @@ export class Book extends ResourceProperty {
         return __awaiter(this, void 0, void 0, function* () {
             if (accounts.length > 0) {
                 const accountList = {
-                    items: accounts.map(a => a.json()),
+                    items: yield Promise.all(accounts.map(account => this.normalizeAccountPayloadForBatchCreate_(account))),
                 };
                 const payloads = yield AccountService.createAccounts(this.getId(), accountList, this.getConfig());
                 const createdAccounts = [];
@@ -582,6 +602,29 @@ export class Book extends ResourceProperty {
             return [];
         });
     }
+    /** @internal */
+    normalizeAccountPayloadForBatchCreate_(account) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const payload = account.json();
+            if (!payload.groups || payload.groups.length === 0) {
+                return payload;
+            }
+            const normalizedGroups = [];
+            for (const groupPayload of payload.groups) {
+                const idOrName = groupPayload.id || groupPayload.name;
+                if (!idOrName || idOrName.trim() === '') {
+                    throw new Error('Account group reference must include id or name');
+                }
+                const group = yield this.getGroup(idOrName);
+                if (!group) {
+                    throw new Error(`Group not found: ${idOrName}`);
+                }
+                normalizedGroups.push(group.json());
+            }
+            payload.groups = normalizedGroups;
+            return payload;
+        });
+    }
     /**
      * Update [[Accounts]] on the Book, in batch.
      *

package/lib/service/transaction-service.js

@@ -126,6 +126,13 @@ export function listTransactions(bookId, query, limit, cursor, config) {
         return response.data;
     });
 }
+export function mergeTransactions(bookId, transactions, config) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const payload = Object.assign({}, transactions);
+        const response = yield new HttpBooksApiV5Request(`${bookId}/transactions/merge`, config).setMethod('PATCH').setPayload(payload).fetch();
+        return response.data;
+    });
+}
 export function countTransactions(bookId, query, config) {
     return __awaiter(this, void 0, void 0, function* () {
         const request = new HttpBooksApiV5Request(`${bookId}/transactions/count`, config).setMethod('GET').addParam('query', query);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "bkper-js",
-    "version": "2.32.1",
+    "version": "2.33.0",
     "description": "Javascript client for Bkper REST API",
     "main": "./lib/index.js",
     "module": "./lib/index.js",
@@ -35,7 +35,7 @@
         "upgrade:api": "bun update @bkper/bkper-api-types --latest"
     },
     "dependencies": {
-        "@bkper/bkper-api-types": "^5.39.1",
+        "@bkper/bkper-api-types": "^5.40.0",
         "big.js": "^6.0.3",
         "dayjs": "^1.10.3",
         "luxon": "^1.25.0",