totalum-api-sdk 2.0.42 → 3.0.0

package/dist/services/CrudService.js

@@ -8,108 +8,140 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CrudService = void 0;
-const axios_1 = __importDefault(require("axios"));
 const utils_1 = require("../utils");
 const endpoints_1 = require("../common/endpoints");
 class CrudService {
-    constructor(baseUrl, headers) {
-        this.headers = headers;
-        this.baseUrl = baseUrl;
+    constructor(client) {
+        this.client = client;
     }
     /**
-     * Fetches an item by its ID.
-     * @param {string} itemType - The type of the item. (table name)
-     * @param {string} id - The ID of the item.
-     * @returns {Promise<any>} - A promise that resolves to the item data.
+     * Fetches a record by its ID.
+     * @param {string} tableName - The type of the record. (table name)
+     * @param {string} id - The ID of the record.
+     * @returns {Promise<TotalumApiResponse<T>>} - A promise that resolves to the record data.
      */
-    getItemById(itemType, id) {
+    getRecordById(tableName, id) {
         return __awaiter(this, void 0, void 0, function* () {
-            const url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.crud.getObjectById, { typeId: itemType, id });
-            return axios_1.default.get(url, { headers: this.headers });
+            const url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.crud.getObjectById, { typeId: tableName, id });
+            return this.client.get(url);
         });
     }
     /**
      * Fetches the historic updates of a record by its ID.
      * @param {string} recordId - The ID of the record to fetch the historic updates.
-     * @returns {Promise<any>} - A promise that resolves to the historic updates data.
+     * @returns {Promise<TotalumApiResponse<UpdatesRecordResponse>>} - A promise that resolves to the historic updates data.
      */
     getHistoricRecordUpdatesById(recordId) {
         return __awaiter(this, void 0, void 0, function* () {
-            const url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.updatesRecord.getUpdateRecordByObjectId, { objectId: recordId });
-            return axios_1.default.get(url, { headers: this.headers });
+            const url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.updatesRecord.getUpdateRecordByObjectId, { objectId: recordId });
+            return this.client.get(url);
         });
     }
-    getItems(itemType, query) {
-        const url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.crud.getObjects, { typeId: itemType });
-        return axios_1.default.post(url, query, { headers: this.headers });
+    /**
+     * Fetches records with optional filtering, sorting, and pagination.
+     * The response data is an array of records. If returnCount is true, a metadata object with count is also returned.
+     * @param {string} tableName - The type of the record. (table name)
+     * @param {FilterSearchQueryI} query - Optional query parameters for filtering.
+     * @returns {Promise<TotalumApiResponse<T[]>>} - A promise that resolves to an array of records.
+     */
+    getRecords(tableName, query) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.crud.getObjects, { typeId: tableName });
+            return this.client.post(url, query);
+        });
     }
+    /**
+     * Fetches nested data across related tables.
+     * @param {NestedQuery} nestedQuery - The nested query structure.
+     * @param {any} options - Optional configuration.
+     * @returns {Promise<TotalumApiResponse<T[]>>} - A promise that resolves to nested data array.
+     */
     getNestedData(nestedQuery, options) {
         return __awaiter(this, void 0, void 0, function* () {
-            const url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.crud.getNestedData);
-            return axios_1.default.post(url, { nestedQuery: nestedQuery, options: options }, { headers: this.headers });
+            const url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.crud.getNestedData);
+            return this.client.post(url, { nestedQuery: nestedQuery, options: options });
         });
     }
-    deleteItemById(itemType, id) {
+    /**
+     * Deletes a record by its ID.
+     * @param {string} tableName - The type of the record. (table name)
+     * @param {string} id - The ID of the record.
+     * @returns {Promise<TotalumApiResponse<DeleteObjectResponse>>} - A promise that resolves when deletion is complete.
+     */
+    deleteRecordById(tableName, id) {
         return __awaiter(this, void 0, void 0, function* () {
-            const url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.crud.deleteObject, { typeId: itemType, id });
-            return axios_1.default.delete(url, { headers: this.headers });
+            const url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.crud.deleteObject, { typeId: tableName, id });
+            return this.client.delete(url);
         });
     }
-    editItemById(itemType, id, properties) {
+    /**
+     * Edits a record by its ID.
+     * @param {string} tableName - The type of the record. (table name)
+     * @param {string} id - The ID of the record.
+     * @param {T} properties - The properties to update.
+     * @returns {Promise<TotalumApiResponse<UpdatedRecordResponse>>} - A promise that resolves to the updated record.
+     */
+    editRecordById(tableName, id, properties) {
         return __awaiter(this, void 0, void 0, function* () {
-            const url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.crud.editObjectProperties, { typeId: itemType, id });
-            return axios_1.default.patch(url, properties, { headers: this.headers });
+            const url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.crud.editObjectProperties, { typeId: tableName, id });
+            return this.client.patch(url, properties);
         });
     }
-    createItem(itemType, item) {
+    /**
+     * Creates a new record.
+     * @param {string} tableName - The type of the record. (table name)
+     * @param {T} record - The record data to create.
+     * @returns {Promise<TotalumApiResponse<T>>} - A promise that resolves to the created record.
+     */
+    createRecord(tableName, record) {
         return __awaiter(this, void 0, void 0, function* () {
-            const url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.crud.createObject, { typeId: itemType });
-            return axios_1.default.post(url, item, { headers: this.headers });
+            const url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.crud.createObject, { typeId: tableName });
+            return this.client.post(url, record);
         });
     }
-    // many to many functions 
+    // many to many functions
     /**
-     *
-     * @param typeId the type id of the item (table name)
-     * @param id the id of the item that we want to add a many to many reference
-     * @param propertyId the property that we want to add a many to many reference
-     * @param referenceId the id of the item that we want to add as a many to many reference
+     * Adds a many-to-many reference between records.
+     * @param {string} type - The type id of the record (table name)
+     * @param {string} id - The id of the record that we want to add a many to many reference
+     * @param {string} propertyName - The property that we want to add a many to many reference
+     * @param {string} referenceId - The id of the record that we want to add as a many to many reference
+     * @returns {Promise<TotalumApiResponse<CreateRecordResponse>>}
      */
-    addManyToManyReferenceItem(type, id, propertyName, referenceId) {
+    addManyToManyReferenceRecord(type, id, propertyName, referenceId) {
         return __awaiter(this, void 0, void 0, function* () {
-            const url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.crud.addManyToManyReference, { typeId: type, id });
-            return axios_1.default.patch(url, { propertyId: propertyName, referenceId }, { headers: this.headers });
+            const url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.crud.addManyToManyReference, { typeId: type, id });
+            return this.client.patch(url, { propertyId: propertyName, referenceId });
         });
     }
     /**
-     *
-     * @param typeId the type id of the item (table name)
-     * @param id the id of the item that we want to drop a many to many reference
-     * @param propertyId the property that we want to drop a many to many reference
-     * @param referenceId the id of the item that we want to drop as a many to many reference
+     * Drops a many-to-many reference between records.
+     * @param {string} type - The type id of the record (table name)
+     * @param {string} id - The id of the record that we want to drop a many to many reference
+     * @param {string} propertyName - The property that we want to drop a many to many reference
+     * @param {string} referenceId - The id of the record that we want to drop as a many to many reference
+     * @returns {Promise<TotalumApiResponse<DeleteObjectResponse>>}
      */
-    dropManyToManyReferenceItem(type, id, propertyName, referenceId) {
+    dropManyToManyReferenceRecord(type, id, propertyName, referenceId) {
         return __awaiter(this, void 0, void 0, function* () {
-            const url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.crud.dropManyToManyReference, { typeId: type, id });
-            return axios_1.default.patch(url, { propertyId: propertyName, referenceId }, { headers: this.headers });
+            const url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.crud.dropManyToManyReference, { typeId: type, id });
+            return this.client.patch(url, { propertyId: propertyName, referenceId });
         });
     }
     /**
-     *
-     * @param typeId the type id of the item (table name)
-     * @param id the id of the item that we want to get many to many references
-     * @param propertyName the property that we want to get many to many references
-     * @param query the query to filter and sort the results
+     * Gets many-to-many reference records with optional filtering.
+     * @param {string} type - The type id of the record (table name)
+     * @param {string} id - The id of the record that we want to get many to many references
+     * @param {string} propertyName - The property that we want to get many to many references
+     * @param {FilterSearchQueryI} query - The query to filter and sort the results
+     * @returns {Promise<TotalumApiResponse<T[]>>}
      */
-    getManyToManyReferencesItems(type, id, propertyName, query) {
+    getManyToManyReferencesRecords(type, id, propertyName, query) {
         return __awaiter(this, void 0, void 0, function* () {
-            const url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.crud.getManyToManyReferencesItems, { typeId: type, id, propertyName });
-            return axios_1.default.get(url, { params: query, headers: this.headers });
+            const url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.crud.getManyToManyReferencesItems, { typeId: type, id, propertyName });
+            return this.client.get(url, query);
         });
     }
 }

package/dist/services/EmailService.d.ts

@@ -1,3 +1,6 @@
+import { TotalumApiResponse } from "../common/interfaces";
+import { EmailSendResponse } from "../common/response-types";
+import { FetchClient } from "../common/fetch-client";
 export interface EmailPayloadI {
     to: string[];
     subject: string;
@@ -13,21 +16,20 @@ export interface EmailPayloadI {
     }[];
 }
 export declare class EmailService {
-    private headers;
-    private baseUrl;
-    constructor(baseUrl: string, headers: any);
+    private client;
+    constructor(client: FetchClient);
     /**
      * Sends an email with custom validation and attachment processing.
      * All attachments must be provided as URLs.
      * Maximum 10 attachments, each up to 15MB.
      * @param {EmailPayloadI} emailPayload - The email configuration.
-     * @returns {Promise<any>} - A promise that resolves to the email send response.
+     * @returns {Promise<TotalumApiResponse<EmailSendResponse>>} - A promise that resolves to the email send response.
      */
-    sendEmail(emailPayload: EmailPayloadI): Promise<any>;
+    sendEmail(emailPayload: EmailPayloadI): Promise<TotalumApiResponse<EmailSendResponse>>;
     /**
- * Sends an email using the Resend service with the default domain.
- * @param {EmailPayloadI} emailPayload - The email configuration including recipients, subject, content, etc.
- * @returns {Promise<any>} - A promise that resolves to the email send response.
- */
+     * Sends an email using the Resend service with the default domain.
+     * @param {EmailPayloadI} emailPayload - The email configuration including recipients, subject, content, etc.
+     * @returns {Promise<TotalumApiResponse<EmailSendResponse>>} - A promise that resolves to the email send response.
+     */
     private sendEmailWithDefaultDomain;
 }

package/dist/services/EmailService.js

@@ -8,40 +8,50 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EmailService = void 0;
-const axios_1 = __importDefault(require("axios"));
 const endpoints_1 = require("../common/endpoints");
 const utils_1 = require("../utils");
 class EmailService {
-    constructor(baseUrl, headers) {
-        this.headers = headers;
-        this.baseUrl = baseUrl;
+    constructor(client) {
+        this.client = client;
     }
     /**
      * Sends an email with custom validation and attachment processing.
      * All attachments must be provided as URLs.
      * Maximum 10 attachments, each up to 15MB.
      * @param {EmailPayloadI} emailPayload - The email configuration.
-     * @returns {Promise<any>} - A promise that resolves to the email send response.
+     * @returns {Promise<TotalumApiResponse<EmailSendResponse>>} - A promise that resolves to the email send response.
      */
     sendEmail(emailPayload) {
         return __awaiter(this, void 0, void 0, function* () {
             // Validate attachments count
             if (emailPayload.attachments && emailPayload.attachments.length > 10) {
-                throw new Error(`Maximum number of attachments is 10. Received ${emailPayload.attachments.length}.`);
+                return {
+                    errors: {
+                        errorCode: 'TOO_MANY_ATTACHMENTS',
+                        errorMessage: `Maximum number of attachments is 10. Received ${emailPayload.attachments.length}.`
+                    }
+                };
             }
             // Validate attachment URLs
             if (emailPayload.attachments) {
                 for (const attachment of emailPayload.attachments) {
                     if (!attachment.url || typeof attachment.url !== 'string') {
-                        throw new Error(`Attachment ${attachment.filename} must have a valid URL`);
+                        return {
+                            errors: {
+                                errorCode: 'INVALID_ATTACHMENT_URL',
+                                errorMessage: `Attachment ${attachment.filename} must have a valid URL`
+                            }
+                        };
                     }
                     if (!attachment.url.startsWith('http://') && !attachment.url.startsWith('https://')) {
-                        throw new Error(`Attachment ${attachment.filename} must have a valid HTTP/HTTPS URL`);
+                        return {
+                            errors: {
+                                errorCode: 'INVALID_ATTACHMENT_URL',
+                                errorMessage: `Attachment ${attachment.filename} must have a valid HTTP/HTTPS URL`
+                            }
+                        };
                     }
                 }
             }
@@ -49,14 +59,14 @@ class EmailService {
         });
     }
     /**
- * Sends an email using the Resend service with the default domain.
- * @param {EmailPayloadI} emailPayload - The email configuration including recipients, subject, content, etc.
- * @returns {Promise<any>} - A promise that resolves to the email send response.
- */
+     * Sends an email using the Resend service with the default domain.
+     * @param {EmailPayloadI} emailPayload - The email configuration including recipients, subject, content, etc.
+     * @returns {Promise<TotalumApiResponse<EmailSendResponse>>} - A promise that resolves to the email send response.
+     */
     sendEmailWithDefaultDomain(emailPayload) {
         return __awaiter(this, void 0, void 0, function* () {
-            const url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.email.sendEmail, {});
-            return axios_1.default.post(url, emailPayload, { headers: this.headers });
+            const url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.email.sendEmail, {});
+            return this.client.post(url, emailPayload);
         });
     }
 }

package/dist/services/FilesService.d.ts

@@ -1,37 +1,83 @@
+import { TotalumApiResponse } from "../common/interfaces";
+import { FileDeleteResponse, OcrImageResponse, OcrPdfResponse, ScanInvoiceResponse, ScanDocumentResponse } from "../common/response-types";
+import { FetchClient } from "../common/fetch-client";
 export declare class FilesService {
-    private headers;
-    private baseUrl;
-    constructor(baseUrl: string, headers: any);
+    private client;
+    constructor(client: FetchClient);
     /**
-     *
-     * @param fileFormData the form data of the file to upload
+     * Uploads a file to Totalum.
+     * @param {FormData} fileFormData - The form data containing the file to upload
+     * @param {object} options - Optional upload options
+     * @param {boolean} options.compressFile - Whether to compress the file
+     * @returns {Promise<TotalumApiResponse<string>>} - File name ID
      */
-    uploadFile(fileFormData: any, options?: {
+    uploadFile(fileFormData: FormData, options?: {
         compressFile?: boolean;
-    }): Promise<import("axios").AxiosResponse<any, any>>;
+    }): Promise<TotalumApiResponse<string>>;
     /**
-     *
-     * @param fileName the name of the file to delete
+     * Deletes a file from Totalum.
+     * @param {string} fileName - The name of the file to delete
+     * @returns {Promise<TotalumApiResponse<FileDeleteResponse>>}
      */
-    deleteFile(fileName: string): Promise<import("axios").AxiosResponse<any, any>>;
+    deleteFile(fileName: string): Promise<TotalumApiResponse<FileDeleteResponse>>;
     /**
-     *
-     * @param fileName
-     * @param options options.expirationTime - is the time in milliseconds that the signed URL should be valid for. The default is 128 hours
-     * @returns
+     * Gets a signed download URL for a file.
+     * @param {string} fileName - The name of the file
+     * @param {object} options - Optional configuration
+     * @param {number} options.expirationTime - Expiration time in milliseconds (default: 128 hours)
+     * @returns {Promise<TotalumApiResponse<string>>} - The download URL
      */
     getDownloadUrl(fileName: string, options?: {
         expirationTime?: number;
-    }): Promise<import("axios").AxiosResponse<any, any>>;
+    }): Promise<TotalumApiResponse<string>>;
+    /**
+     * Generates a PDF from a template.
+     * @param {string} id - Template ID
+     * @param {Record<string, any>} variables - Variables to replace in template
+     * @param {string} name - Name for the generated PDF
+     * @returns {Promise<TotalumApiResponse<string>>} - The generated PDF filename
+     */
     generatePdfByTemplate(id: string, variables: {
         [variableName: string]: any;
-    }, name: string): Promise<import("axios").AxiosResponse<any, any>>;
+    }, name: string): Promise<TotalumApiResponse<string>>;
+    /**
+     * Creates a PDF from HTML content.
+     * @param {object} data - PDF creation data
+     * @param {string} data.html - HTML content to convert
+     * @param {string} data.name - Name for the generated PDF
+     * @returns {Promise<TotalumApiResponse<string>>} - The generated PDF filename
+     */
     createPdfFromHtml(data: {
         html: string;
         name: string;
-    }): Promise<import("axios").AxiosResponse<any, any>>;
-    ocrOfImage(fileName: string): Promise<import("axios").AxiosResponse<any, any>>;
-    ocrOfPdf(fileName: string): Promise<import("axios").AxiosResponse<any, any>>;
-    scanInvoice(fileName: string, options?: any): Promise<import("axios").AxiosResponse<any, any>>;
-    scanDocument(fileName: string, properties: any, options?: any): Promise<import("axios").AxiosResponse<any, any>>;
+    }): Promise<TotalumApiResponse<string>>;
+    /**
+     * Performs OCR on an image file.
+     * @param {string} fileName - The file name of the uploaded image
+     * @returns {Promise<TotalumApiResponse<OcrImageResponse>>}
+     */
+    ocrOfImage(fileName: string): Promise<TotalumApiResponse<OcrImageResponse>>;
+    /**
+     * Performs OCR on a PDF file.
+     * @param {string} fileName - The file name of the uploaded PDF
+     * @returns {Promise<TotalumApiResponse<OcrPdfResponse>>}
+     */
+    ocrOfPdf(fileName: string): Promise<TotalumApiResponse<OcrPdfResponse>>;
+    /**
+     * Scans an invoice and extracts information.
+     * The response includes both data and metadata with OCR details and usage tracking.
+     * @param {string} fileName - The file name of the uploaded invoice
+     * @param {any} options - Optional scanning options
+     * @returns {Promise<TotalumApiResponse<ScanInvoiceResponse>>}
+     */
+    scanInvoice(fileName: string, options?: any): Promise<TotalumApiResponse<ScanInvoiceResponse>>;
+    /**
+     * Scans a document and extracts specified properties.
+     * The response includes both data (based on provided schema) and metadata with OCR details.
+     * @param {string} fileName - The file name of the uploaded document
+     * @param {any} properties - Properties schema to extract from the document (JSON Schema format)
+     * @param {any} options - Optional scanning options
+     * @returns {Promise<TotalumApiResponse<ScanDocumentResponse>>}
+     */
+    scanDocument(fileName: string, properties: any, options?: any): Promise<TotalumApiResponse<ScanDocumentResponse>>;
 }

package/dist/services/FilesService.js

@@ -8,89 +8,136 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FilesService = void 0;
-const axios_1 = __importDefault(require("axios"));
 const utils_1 = require("../utils");
 const endpoints_1 = require("../common/endpoints");
 class FilesService {
-    constructor(baseUrl, headers) {
-        this.headers = headers;
-        this.baseUrl = baseUrl;
+    constructor(client) {
+        this.client = client;
     }
     /**
-     *
-     * @param fileFormData the form data of the file to upload
+     * Uploads a file to Totalum.
+     * @param {FormData} fileFormData - The form data containing the file to upload
+     * @param {object} options - Optional upload options
+     * @param {boolean} options.compressFile - Whether to compress the file
+     * @returns {Promise<TotalumApiResponse<string>>} - File name ID
      */
     uploadFile(fileFormData, options) {
         return __awaiter(this, void 0, void 0, function* () {
-            let url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.files.uploadFile);
+            let url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.files.uploadFile);
             if (options === null || options === void 0 ? void 0 : options.compressFile)
                 url += '?compressFile=true';
-            return axios_1.default.post(url, fileFormData, { headers: this.headers });
+            return this.client.post(url, fileFormData);
         });
     }
     /**
-     *
-     * @param fileName the name of the file to delete
+     * Deletes a file from Totalum.
+     * @param {string} fileName - The name of the file to delete
+     * @returns {Promise<TotalumApiResponse<FileDeleteResponse>>}
      */
     deleteFile(fileName) {
         return __awaiter(this, void 0, void 0, function* () {
-            const url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.files.deleteFile, { fileName });
-            return axios_1.default.delete(url, { headers: this.headers });
+            const url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.files.deleteFile, { fileName });
+            return this.client.delete(url);
         });
     }
     /**
-     *
-     * @param fileName
-     * @param options options.expirationTime - is the time in milliseconds that the signed URL should be valid for. The default is 128 hours
-     * @returns
+     * Gets a signed download URL for a file.
+     * @param {string} fileName - The name of the file
+     * @param {object} options - Optional configuration
+     * @param {number} options.expirationTime - Expiration time in milliseconds (default: 128 hours)
+     * @returns {Promise<TotalumApiResponse<string>>} - The download URL
      */
     getDownloadUrl(fileName, options) {
         return __awaiter(this, void 0, void 0, function* () {
-            const url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.files.getDownloadUrl, { fileName });
-            return axios_1.default.get(url, { headers: this.headers, params: options });
+            const url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.files.getDownloadUrl, { fileName });
+            return this.client.get(url, options);
         });
     }
+    /**
+     * Generates a PDF from a template.
+     * @param {string} id - Template ID
+     * @param {Record<string, any>} variables - Variables to replace in template
+     * @param {string} name - Name for the generated PDF
+     * @returns {Promise<TotalumApiResponse<string>>} - The generated PDF filename
+     */
     generatePdfByTemplate(id, variables, name) {
         return __awaiter(this, void 0, void 0, function* () {
-            const url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.pdfTemplate.generatePdfByTemplate, { id });
-            return axios_1.default.post(url, { templateId: id, variables, name }, { headers: this.headers });
+            const url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.pdfTemplate.generatePdfByTemplate, { id });
+            return this.client.post(url, { templateId: id, variables, name });
         });
     }
+    /**
+     * Creates a PDF from HTML content.
+     * @param {object} data - PDF creation data
+     * @param {string} data.html - HTML content to convert
+     * @param {string} data.name - Name for the generated PDF
+     * @returns {Promise<TotalumApiResponse<string>>} - The generated PDF filename
+     */
     createPdfFromHtml(data) {
         return __awaiter(this, void 0, void 0, function* () {
-            const url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.pdfTemplate.createPdfFromHtml);
-            // Encode HTML to base64
-            const base64HtmlString = Buffer.from(data.html, 'utf-8').toString('base64');
-            return axios_1.default.post(url, { base64HtmlString, name: data.name }, { headers: this.headers });
+            const url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.pdfTemplate.createPdfFromHtml);
+            // Cross-platform base64 encoding (works in both Node.js and browser)
+            let base64HtmlString;
+            if (typeof window === 'undefined') {
+                // Node.js environment
+                base64HtmlString = Buffer.from(data.html, 'utf-8').toString('base64');
+            }
+            else {
+                // Browser environment
+                base64HtmlString = btoa(unescape(encodeURIComponent(data.html)));
+            }
+            return this.client.post(url, { base64HtmlString, name: data.name });
         });
     }
+    /**
+     * Performs OCR on an image file.
+     * @param {string} fileName - The file name of the uploaded image
+     * @returns {Promise<TotalumApiResponse<OcrImageResponse>>}
+     */
     ocrOfImage(fileName) {
         return __awaiter(this, void 0, void 0, function* () {
-            const url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.files.ocrOfImage);
-            return axios_1.default.post(url, { fileName }, { headers: this.headers });
+            const url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.files.ocrOfImage);
+            return this.client.post(url, { fileName });
         });
     }
+    /**
+     * Performs OCR on a PDF file.
+     * @param {string} fileName - The file name of the uploaded PDF
+     * @returns {Promise<TotalumApiResponse<OcrPdfResponse>>}
+     */
     ocrOfPdf(fileName) {
         return __awaiter(this, void 0, void 0, function* () {
-            const url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.files.ocrOfPdf);
-            return axios_1.default.post(url, { fileName }, { headers: this.headers });
+            const url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.files.ocrOfPdf);
+            return this.client.post(url, { fileName });
         });
     }
+    /**
+     * Scans an invoice and extracts information.
+     * The response includes both data and metadata with OCR details and usage tracking.
+     * @param {string} fileName - The file name of the uploaded invoice
+     * @param {any} options - Optional scanning options
+     * @returns {Promise<TotalumApiResponse<ScanInvoiceResponse>>}
+     */
     scanInvoice(fileName, options) {
         return __awaiter(this, void 0, void 0, function* () {
-            const url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.files.scanInvoice);
-            return axios_1.default.post(url, { fileName, options }, { headers: this.headers });
+            const url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.files.scanInvoice);
+            return this.client.post(url, { fileName, options });
         });
     }
+    /**
+     * Scans a document and extracts specified properties.
+     * The response includes both data (based on provided schema) and metadata with OCR details.
+     * @param {string} fileName - The file name of the uploaded document
+     * @param {any} properties - Properties schema to extract from the document (JSON Schema format)
+     * @param {any} options - Optional scanning options
+     * @returns {Promise<TotalumApiResponse<ScanDocumentResponse>>}
+     */
     scanDocument(fileName, properties, options) {
         return __awaiter(this, void 0, void 0, function* () {
-            const url = utils_1.UtilsService.getUrl(this.baseUrl, endpoints_1.endpoints.files.scanDocument);
-            return axios_1.default.post(url, { fileName, properties, options }, { headers: this.headers });
+            const url = utils_1.UtilsService.getUrl('', endpoints_1.endpoints.files.scanDocument);
+            return this.client.post(url, { fileName, properties, options });
         });
     }
 }