bkper-js 2.32.2 → 2.33.1

package/lib/index.d.ts

@@ -1354,31 +1354,6 @@ export declare class Billing extends Resource<bkper.Billing> {
 /**
  * This is the main entry point of the [bkper-js](https://www.npmjs.com/package/bkper-js) library.
  *
- * You can configure the library in two ways:
- *
- * 1. Using static configuration (traditional approach):
- *
- * ```typescript
- * Bkper.setConfig({
- *   apiKeyProvider: () => process.env.BKPER_API_KEY,
- *   oauthTokenProvider: () => process.env.BKPER_OAUTH_TOKEN
- * });
- *
- * const bkper = new Bkper();
- * const book = await bkper.getBook('bookId');
- * ```
- *
- * 2. Using per-instance configuration (recommended for Cloudflare Workers):
- *
- * ```typescript
- * const bkper = new Bkper({
- *   apiKeyProvider: () => process.env.BKPER_API_KEY,
- *   oauthTokenProvider: () => process.env.BKPER_OAUTH_TOKEN
- * });
- *
- * const book = await bkper.getBook('bookId');
- * ```
- *
  * @public
  */
 export declare class Bkper {
@@ -1821,6 +1796,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.
      *

package/lib/model/Bkper.js

@@ -7,44 +7,19 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { Book } from "./Book.js";
-import { App } from "./App.js";
-import * as AppService from "../service/app-service.js";
-import * as BookService from "../service/book-service.js";
-import * as CollectionService from "../service/collection-service.js";
-import * as UserService from "../service/user-service.js";
-import * as TemplateService from "../service/template-service.js";
-import { User } from "./User.js";
-import { Template } from "./Template.js";
-import { Collection } from "./Collection.js";
+import { Book } from './Book.js';
+import { App } from './App.js';
+import * as AppService from '../service/app-service.js';
+import * as BookService from '../service/book-service.js';
+import * as CollectionService from '../service/collection-service.js';
+import * as UserService from '../service/user-service.js';
+import * as TemplateService from '../service/template-service.js';
+import { User } from './User.js';
+import { Template } from './Template.js';
+import { Collection } from './Collection.js';
 /**
  * This is the main entry point of the [bkper-js](https://www.npmjs.com/package/bkper-js) library.
  *
- * You can configure the library in two ways:
- *
- * 1. Using static configuration (traditional approach):
- *
- * ```typescript
- * Bkper.setConfig({
- *   apiKeyProvider: () => process.env.BKPER_API_KEY,
- *   oauthTokenProvider: () => process.env.BKPER_OAUTH_TOKEN
- * });
- *
- * const bkper = new Bkper();
- * const book = await bkper.getBook('bookId');
- * ```
- *
- * 2. Using per-instance configuration (recommended for Cloudflare Workers):
- *
- * ```typescript
- * const bkper = new Bkper({
- *   apiKeyProvider: () => process.env.BKPER_API_KEY,
- *   oauthTokenProvider: () => process.env.BKPER_OAUTH_TOKEN
- * });
- *
- * const book = await bkper.getBook('bookId');
- * ```
- *
  * @public
  */
 export class Bkper {
@@ -105,7 +80,7 @@ export class Bkper {
     getBooks(query) {
         return __awaiter(this, void 0, void 0, function* () {
             let books = yield BookService.loadBooks(query, this.config);
-            return books.map((book) => new Book(book, this.config));
+            return books.map(book => new Book(book, this.config));
         });
     }
     /**
@@ -116,7 +91,7 @@ export class Bkper {
     getCollections() {
         return __awaiter(this, void 0, void 0, function* () {
             let collections = yield CollectionService.loadCollections(this.config);
-            return collections.map((collection) => new Collection(collection, this.config));
+            return collections.map(collection => new Collection(collection, this.config));
         });
     }
     /**
@@ -127,7 +102,7 @@ export class Bkper {
     getApps() {
         return __awaiter(this, void 0, void 0, function* () {
             let apps = yield AppService.getApps(this.config);
-            return apps.map((app) => new App(app, this.config));
+            return apps.map(app => new App(app, this.config));
         });
     }
     /**
@@ -151,7 +126,7 @@ export class Bkper {
     getTemplates() {
         return __awaiter(this, void 0, void 0, function* () {
             let templates = yield TemplateService.getTemplates(this.config);
-            return templates.map((template) => new Template(template, this.config));
+            return templates.map(template => new Template(template, this.config));
         });
     }
     /**

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.
      *

package/lib/service/http-api-request.js

@@ -103,7 +103,10 @@ export class HttpApiRequest extends HttpRequest {
         });
     }
     shouldRetry(status) {
-        return status == 408 || status == 429 || (status != null && status >= 500);
+        // 401/403 are included so consumers can refresh the OAuth token via
+        // requestRetryHandler and have the request re-issued. The retry cap
+        // (this.retry < 3) prevents loops on permanent auth failures.
+        return status == 401 || status == 403 || status == 408 || status == 429 || (status != null && status >= 500);
     }
     isNetworkError(error) {
         return error instanceof TypeError && error.message.toLowerCase().includes("fetch");

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.2",
+    "version": "2.33.1",
     "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",