bkper-js 2.22.0 → 2.23.1

package/CHANGELOG.md

@@ -10,13 +10,24 @@ See what's new and what has changed in bkper-js
 - Added `App.setDevelopers`
 - Added `App.getDevelopers`
 - Added `Config.agentIdProvider`
-- Added `User.getBillingAdminEmail`
-- Added `User.getTotalTransactionsThisMonth`
-- Added `User.getTotalTransactionsThisYear`
+- Added `Billing`
+- Added `Billing.getAdminEmail`
+- Added `Billing.getDaysLeftInTrial`
+- Added `Billing.getPlan`
+- Added `Billing.getTotalTransactionsThisMonth`
+- Added `Billing.getTotalTransactionsThisYear`
+- Added `Billing.hasStartedTrial`
+- Added `Billing.isEnabled`
+- Added `Billing.isPlanOverdue`
+- Added `User.getBilling`
 - Added `User.getUsername`
-- Added `User.isPlanOverdue`
 - Removed `App.setUserEmails` from `App`. Use `App.setUsers` instead
 - Removed `App.setDeveloperEmail` from `App`. Use `App.setDevelopers` instead
+- Removed `User.getDaysLeftInTrial` from `User`. Use `Billing.getDaysLeftInTrial` instead
+- Removed `User.getPlan` from `User`. Use `Billing.getPlan` instead
+- Removed `User.hasBillingEnabled` from `User`. Use `Billing.isEnabled` instead
+- Removed `User.hasStartedTrial` from `User`. Use `Billing.hasStartedTrial` instead
+- Removed `User.isFree` from `User`. Use `Billing.getPlan` instead
 
 ## 2025
 

package/lib/index.d.ts

@@ -1224,6 +1224,20 @@ export declare class Billing extends Resource<bkper.Billing> {
      * @returns The number of total transactions this year
      */
     getTotalTransactionsThisYear(): number | undefined;
+    /**
+     * Gets the transaction counts associated to the User's billing account.
+     *
+     * @returns The transaction counts associated to the User's billing account
+     */
+    getCounts(): Promise<bkper.Counts>;
+    /**
+     * Gets the URL to redirect the User to the billing portal.
+     *
+     * @param returnUrl - The URL to return to after the User has been redirected to the billing portal
+     *
+     * @returns The URL to redirect the User to the billing portal
+     */
+    getPortalUrl(returnUrl: string): Promise<string | undefined>;
 }
 
 /**
@@ -1327,14 +1341,6 @@ export declare class Bkper {
      * @returns The retrieved User
      */
     getUser(): Promise<User>;
-    /**
-     * Gets the URL to redirect the User to the billing portal.
-     *
-     * @param returnUrl - The URL to return to after the User has been redirected to the billing portal
-     *
-     * @returns The URL to redirect the User to the billing portal
-     */
-    getBillingPortalUrl(returnUrl: string): Promise<string | undefined>;
 }
 
 /**
@@ -2237,10 +2243,7 @@ export declare interface Config {
      * @param attempt - The number of retry attempts made so far.
      */
     requestRetryHandler?: (status?: number, error?: any, attempt?: number) => Promise<void>;
-    /**
-     * Sets the base api url. Default to https://app.bkper.com/_ah/api/bkper
-     */
-    apiBaseUrl?: string;
+
 }
 
 /**

package/lib/model/Billing.js

@@ -1,5 +1,15 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 import { Resource } from "./Resource.js";
 import { Bkper } from "./Bkper.js";
+import * as UserService from "../service/user-service.js";
 /**
  * This class defines the Billing information for a [[User]].
  *
@@ -80,5 +90,29 @@ export class Billing extends Resource {
     getTotalTransactionsThisYear() {
         return this.payload.totalTransactionsThisYear;
     }
+    /**
+     * Gets the transaction counts associated to the User's billing account.
+     *
+     * @returns The transaction counts associated to the User's billing account
+     */
+    getCounts() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const countsPayload = yield UserService.getBillingCounts(this.getConfig());
+            return countsPayload;
+        });
+    }
+    /**
+     * Gets the URL to redirect the User to the billing portal.
+     *
+     * @param returnUrl - The URL to return to after the User has been redirected to the billing portal
+     *
+     * @returns The URL to redirect the User to the billing portal
+     */
+    getPortalUrl(returnUrl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const urlPayload = yield UserService.getBillingPortalUrl(returnUrl, this.getConfig());
+            return urlPayload.url;
+        });
+    }
 }
 //# sourceMappingURL=Billing.js.map

package/lib/model/Bkper.js

@@ -152,19 +152,6 @@ export class Bkper {
             return new User(user, this.config);
         });
     }
-    /**
-     * Gets the URL to redirect the User to the billing portal.
-     *
-     * @param returnUrl - The URL to return to after the User has been redirected to the billing portal
-     *
-     * @returns The URL to redirect the User to the billing portal
-     */
-    getBillingPortalUrl(returnUrl) {
-        return __awaiter(this, void 0, void 0, function* () {
-            let url = yield UserService.getBillingPortalUrl(returnUrl, this.config);
-            return url.url;
-        });
-    }
 }
 /** @internal */
 Bkper.globalConfig = {};

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

@@ -9,30 +9,17 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { HttpRequest } from "./http-request.js";
 /**
- * Proxy URL for clients without their own API key.
- * The proxy injects a managed API key server-side.
+ * The official Bkper API base URL.
  */
-export const PROXY_BASE_URL = "https://api.bkper.app";
-/**
- * Direct API URL for clients with their own API key.
- */
-export const DIRECT_BASE_URL = "https://app.bkper.com/_ah/api/bkper";
+export const API_BASE_URL = "https://api.bkper.app";
 /**
  * Resolves the base URL based on config.
- *
- * Priority:
- * 1. If apiBaseUrl is set, use it (power user / dev mode)
- * 2. If apiKeyProvider is set, use direct URL (power user with own key)
- * 3. Otherwise, use proxy URL (default for most users)
  */
 export function resolveBaseUrl(config) {
     if (config.apiBaseUrl) {
         return config.apiBaseUrl;
     }
-    if (config.apiKeyProvider) {
-        return DIRECT_BASE_URL;
-    }
-    return PROXY_BASE_URL;
+    return API_BASE_URL;
 }
 export class HttpApiRequest extends HttpRequest {
     constructor(path, config) {
@@ -49,7 +36,7 @@ export class HttpApiRequest extends HttpRequest {
             this.addCustomHeaders();
             yield this.addAgentIdHeader();
             this.setHeader("Authorization", `Bearer ${yield this.getAccessToken()}`);
-            this.addParam("key", yield this.getApiKey());
+            yield this.addApiKeyHeader();
             try {
                 let resp = yield _super.execute.call(this);
                 if (resp.status >= 200 && resp.status < 300) {
@@ -146,13 +133,15 @@ export class HttpApiRequest extends HttpRequest {
             }
         });
     }
-    getApiKey() {
+    addApiKeyHeader() {
         return __awaiter(this, void 0, void 0, function* () {
             const effectiveConfig = this.config;
             if (effectiveConfig.apiKeyProvider) {
-                return yield effectiveConfig.apiKeyProvider();
+                const apiKey = yield effectiveConfig.apiKeyProvider();
+                if (apiKey) {
+                    this.setHeader("bkper-api-key", apiKey);
+                }
             }
-            return null;
         });
     }
     getAccessToken() {

package/lib/service/user-service.js

@@ -20,6 +20,12 @@ export function getBilling(config) {
         return res.data;
     });
 }
+export function getBillingCounts(config) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const res = yield new HttpApiV5Request(`user/billing/counts`, config).setMethod('GET').fetch();
+        return res.data;
+    });
+}
 export function getBillingPortalUrl(returnUrl, config) {
     return __awaiter(this, void 0, void 0, function* () {
         const res = yield new HttpApiV5Request(`user/billing/portal`, config).addParam('returnUrl', returnUrl).fetch();

package/lib/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.53.1"
+      "packageVersion": "7.55.2"
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bkper-js",
-  "version": "2.22.0",
+  "version": "2.23.1",
   "description": "Javascript client for Bkper REST API",
   "main": "./lib/index.js",
   "module": "./lib/index.js",
@@ -34,10 +34,8 @@
     "preversion": "bun run build",
     "postversion": "git push --tags && yarn publish --new-version $npm_package_version && git push && echo \"Successfully released version $npm_package_version!\""
   },
-  "peerDependencies": {
-    "@bkper/bkper-api-types": "^5.34.0"
-  },
   "dependencies": {
+    "@bkper/bkper-api-types": "^5.34.0",
     "big.js": "^6.0.3",
     "dayjs": "^1.10.3",
     "luxon": "^1.25.0",