bkper-js 2.42.0 → 2.43.1

package/lib/index.d.ts

@@ -2077,6 +2077,16 @@ export declare class Book extends ResourceProperty<bkper.Book> {
      * @returns The [[Transaction]] object
      */
     getTransaction(id: string): Promise<Transaction | undefined>;
+    /**
+     * Retrieve complete transactions by id.
+     *
+     * Requests are sent sequentially in batches of up to 200 IDs.
+     *
+     * @param ids - The transaction IDs
+     *
+     * @returns The matching Transactions in input order
+     */
+    getTransactionsByIds(ids: string[]): Promise<Transaction[]>;
     /**
      * Retrieve a file by id.
      *

package/lib/model/Book.js

@@ -1224,6 +1224,41 @@ export class Book extends ResourceProperty {
             return transaction;
         });
     }
+    /**
+     * Retrieve complete transactions by id.
+     *
+     * Requests are sent sequentially in batches of up to 200 IDs.
+     *
+     * @param ids - The transaction IDs
+     *
+     * @returns The matching Transactions in input order
+     */
+    getTransactionsByIds(ids) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (ids == null) {
+                throw new Error('Transaction IDs are required.');
+            }
+            const distinctIds = new Set();
+            const normalizedIds = [];
+            for (const id of ids) {
+                if (id == null || typeof id !== 'string' || id.trim() === '') {
+                    throw new Error('Transaction IDs must be non-blank strings.');
+                }
+                const normalizedId = id.trim();
+                if (distinctIds.has(normalizedId)) {
+                    throw new Error(`Duplicate transaction ID: ${normalizedId}`);
+                }
+                distinctIds.add(normalizedId);
+                normalizedIds.push(normalizedId);
+            }
+            const transactions = [];
+            for (let index = 0; index < normalizedIds.length; index += 200) {
+                const payloads = yield TransactionService.getTransactionsByIds(this.getId(), normalizedIds.slice(index, index + 200), this.getConfig());
+                transactions.push(...payloads.map(payload => new Transaction(this, payload)));
+            }
+            return transactions;
+        });
+    }
     /**
      * Retrieve a file by id.
      *

package/lib/service/transaction-service.js

@@ -108,6 +108,19 @@ export function getTransaction(bookId, id, config) {
         return response.data;
     });
 }
+export function getTransactionsByIds(bookId, ids, config) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const payload = {
+            items: ids.map(id => ({ id: id })),
+        };
+        const response = yield new HttpBooksApiV5Request(`${bookId}/transactions/load`, config)
+            .setMethod('POST')
+            .setPayload(payload)
+            .fetch();
+        const transactionList = response.data;
+        return transactionList != null && transactionList.items != null ? transactionList.items : [];
+    });
+}
 export function listTransactions(bookId, query, limit, cursor, config) {
     return __awaiter(this, void 0, void 0, function* () {
         if (!query) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "bkper-js",
-    "version": "2.42.0",
+    "version": "2.43.1",
     "description": "Javascript client for Bkper REST API",
     "main": "./lib/index.js",
     "module": "./lib/index.js",