Merge pull request #74 from FacturAPI/chore/base_url

javorosas · web-flow · commit 50f8cb85dae1 · 2025-08-29T15:05:06.000+02:00
chore(baseUrl): add set and getter for choosing base url
diff --git a/src/index.ts b/src/index.ts
@@ -8,7 +8,7 @@ import Retentions from './resources/retentions';
 import Webhooks from './tools/webhooks';
 import Tools from './tools/tools';
 import * as enums from './enums';
-import { createWrapper } from './wrapper';
+import { createWrapper, WrapperClient } from './wrapper';
 import { DEFAULT_API_VERSION } from './constants';
 
 export * from './enums';
@@ -30,6 +30,7 @@ export interface FacturapiOptions {
  */
 export default class Facturapi {
   apiVersion: ApiVersion;
+  private _wrapper: WrapperClient;
   customers: Customers;
   products: Products;
   invoices: Invoices;
@@ -40,6 +41,18 @@ export default class Facturapi {
   tools: Tools;
   webhooks: Webhooks;
 
+  /**
+   * Get or set the base URL used for API requests.
+   * Allows overriding the default API host, e.g. for testing.
+   * Usage: facturapi.BASE_URL = 'http://localhost:3000/v2'
+   */
+  get BASE_URL(): string {
+    return this._wrapper.baseURL;
+  }
+  set BASE_URL(url: string) {
+    this._wrapper.baseURL = url;
+  }
+
   static get TaxType() {
     return enums.TaxType;
   }
@@ -96,15 +109,15 @@ export default class Facturapi {
     } else {
       this.apiVersion = DEFAULT_API_VERSION;
     }
-    const wrapper = createWrapper(apiKey, this.apiVersion);
-    this.customers = new Customers(wrapper);
-    this.products = new Products(wrapper);
-    this.invoices = new Invoices(wrapper);
-    this.organizations = new Organizations(wrapper);
-    this.catalogs = new Catalogs(wrapper);
-    this.receipts = new Receipts(wrapper);
-    this.retentions = new Retentions(wrapper);
-    this.tools = new Tools(wrapper);
-    this.webhooks = new Webhooks(wrapper);
+    this._wrapper = createWrapper(apiKey, this.apiVersion);
+    this.customers = new Customers(this._wrapper);
+    this.products = new Products(this._wrapper);
+    this.invoices = new Invoices(this._wrapper);
+    this.organizations = new Organizations(this._wrapper);
+    this.catalogs = new Catalogs(this._wrapper);
+    this.receipts = new Receipts(this._wrapper);
+    this.retentions = new Retentions(this._wrapper);
+    this.tools = new Tools(this._wrapper);
+    this.webhooks = new Webhooks(this._wrapper);
   }
 }
diff --git a/src/wrapper.ts b/src/wrapper.ts
@@ -75,12 +75,18 @@ export const createWrapper = (
   apiKey: string,
   apiVersion: 'v1' | 'v2' = DEFAULT_API_VERSION,
 ) => {
-  const baseURL = apiVersion === 'v1' ? BASE_URL_V1 : BASE_URL;
+  let baseURL = apiVersion === 'v1' ? BASE_URL_V1 : BASE_URL;
   const defaultHeaders = {
     Authorization: `Basic ${encodeStringToBase64(apiKey + ':')}`,
   };
 
   const client = {
+    get baseURL(): string {
+      return baseURL;
+    },
+    set baseURL(url: string) {
+      baseURL = url;
+    },
     async request(
       url: string,
       options?: {
