@ptkl/sdk 1.0.3 → 1.3.0

package/dist/v0.10/index.esm.js

@@ -24,7 +24,6 @@ const isSandbox = typeof window !== "undefined";
  *
  * @class PlatformBaseClient
  * @extends BaseClient
- * @constructor
  * @param {AxiosInstance} [client] - The axios instance to use for the client
  *
  * @example
@@ -35,7 +34,7 @@ const isSandbox = typeof window !== "undefined";
  */
 class PlatformBaseClient extends BaseClient {
     constructor(options) {
-        var _a, _b, _c, _d, _e, _f, _g;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
         let { env = null, token = null, host = null, } = options !== null && options !== void 0 ? options : {};
         let headers = {};
         var project_uuid = null;
@@ -44,23 +43,23 @@ class PlatformBaseClient extends BaseClient {
             const __global_env__ = window === null || window === void 0 ? void 0 : window.__ENV_VARIABLES__;
             host = (_a = __global_env__ === null || __global_env__ === void 0 ? void 0 : __global_env__.API_HOST) !== null && _a !== void 0 ? _a : host;
             // @ts-ignore
-            env = env !== null && env !== void 0 ? env : __global_env__ === null || __global_env__ === void 0 ? void 0 : __global_env__.PROJECT_ENV;
-            token = token !== null && token !== void 0 ? token : __global_env__ === null || __global_env__ === void 0 ? void 0 : __global_env__.PROJECT_API_TOKEN;
+            env = (_b = __global_env__ === null || __global_env__ === void 0 ? void 0 : __global_env__.PROJECT_ENV) !== null && _b !== void 0 ? _b : env;
+            token = (_c = __global_env__ === null || __global_env__ === void 0 ? void 0 : __global_env__.PROJECT_API_TOKEN) !== null && _c !== void 0 ? _c : token;
             project_uuid = __global_env__ === null || __global_env__ === void 0 ? void 0 : __global_env__.PROJECT_UUID;
             if (isBrowser) {
                 if (sessionStorage.getItem('protokol_context') == "forge") {
-                    headers['X-Project-Env'] = (_b = sessionStorage.getItem('forge_app_env')) !== null && _b !== void 0 ? _b : "dev";
+                    headers['X-Project-Env'] = (_d = sessionStorage.getItem('forge_app_env')) !== null && _d !== void 0 ? _d : "dev";
                 }
                 else {
-                    headers['X-Project-Env'] = (_c = localStorage.getItem('current_env')) !== null && _c !== void 0 ? _c : "dev";
+                    headers['X-Project-Env'] = (_e = localStorage.getItem('current_env')) !== null && _e !== void 0 ? _e : "dev";
                 }
             }
         }
-        else if (isNode) {
-            host = (_d = host !== null && host !== void 0 ? host : process.env.API_HOST) !== null && _d !== void 0 ? _d : null;
-            env = (_e = env !== null && env !== void 0 ? env : process.env.PROJECT_ENV) !== null && _e !== void 0 ? _e : null;
-            token = (_f = token !== null && token !== void 0 ? token : process.env.PROJECT_API_TOKEN) !== null && _f !== void 0 ? _f : null;
-            project_uuid = (_g = process.env.PROJECT_UUID) !== null && _g !== void 0 ? _g : null;
+        if (isNode) {
+            host = (_f = host !== null && host !== void 0 ? host : process.env.API_HOST) !== null && _f !== void 0 ? _f : null;
+            env = (_g = env !== null && env !== void 0 ? env : process.env.PROJECT_ENV) !== null && _g !== void 0 ? _g : null;
+            token = (_h = token !== null && token !== void 0 ? token : process.env.PROJECT_API_TOKEN) !== null && _h !== void 0 ? _h : null;
+            project_uuid = (_j = process.env.PROJECT_UUID) !== null && _j !== void 0 ? _j : null;
         }
         if (token) {
             headers['Authorization'] = `Bearer ${token}`;
@@ -88,21 +87,9 @@ class PlatformBaseClient extends BaseClient {
 }
 
 class Component extends PlatformBaseClient {
-    constructor(ref = null, options) {
-        var _a;
+    constructor(ref = null) {
         super();
         this.ref = ref;
-        this.version = (_a = options === null || options === void 0 ? void 0 : options.version) !== null && _a !== void 0 ? _a : null;
-    }
-    /**
-     * Get the base path for component API calls
-     * @private
-     */
-    getComponentPath() {
-        if (this.version) {
-            return `/v3/system/component/${this.ref}/v/${this.version}`;
-        }
-        return `/v3/system/component/${this.ref}`;
     }
     /**
      * Find method to search for models
@@ -126,7 +113,6 @@ class Component extends PlatformBaseClient {
      * )
      **/
     async find(filters, opts) {
-        const { cache = false, buildttl = -1, locale = "en_US", } = opts !== null && opts !== void 0 ? opts : {};
         let payload = {
             context: filters,
             ref: this.ref,
@@ -152,32 +138,18 @@ class Component extends PlatformBaseClient {
             sortBy: ctx.sortBy,
             sortDesc: sortDesc,
             filter: ctx.filter,
-            filterOn: ctx.filterOn.join(","),
+            filterOn: ctx.filterOn,
             limit: limit,
             dateFrom: ctx.dateFrom,
             dateTo: ctx.dateTo,
             dateField: ctx.dateField,
         };
-        if (Object.keys(ctx.$adv || []).length > 0) {
-            params.$adv = JSON.stringify([ctx.$adv]);
-        }
-        if (ctx.$aggregate && ctx.$aggregate.length > 0) {
-            params.$aggregate = JSON.stringify(ctx.$aggregate);
-        }
-        if (opts) {
-            Object.keys(opts).forEach(k => {
-                if (['cache', 'buildttl', 'locale'].includes(k)) {
-                    return;
-                }
-                params[`_opt_${k}`] = opts ? opts[k] : null;
-            });
-        }
-        return await this.client.get(`${this.getComponentPath()}/models`, {
-            params: params,
+        return await this.client.post(`/v4/system/component/${this.ref}/models`, {
+            ...params,
+            options: opts
+        }, {
             headers: {
-                'X-Cache': cache,
-                'X-Build-Ttl': buildttl,
-                'Accept-Language': locale
+                "Accept-Language": (opts === null || opts === void 0 ? void 0 : opts.locale) || "en_US",
             }
         });
     }
@@ -211,17 +183,34 @@ class Component extends PlatformBaseClient {
      * @returns (Promise<Model>)
      */
     async get(uuid) {
-        return await this.client.get(`${this.getComponentPath()}/model/${uuid}`);
+        return await this.client.get(`/v4/system/component/${this.ref}/model/${uuid}`);
     }
     /**
      * Update model by uuid
      *
-     * @param uuid string - The uuid of the model
-     * @param data
-     * @returns
+     * Regular fields in `data` are applied via `$set`. You can include MongoDB
+     * update operators (prefixed with `$`) directly in the data object for
+     * granular updates like incrementing, pushing to arrays, etc.
+     *
+     * @param uuid - The uuid of the model to update
+     * @param data - Fields to update, optionally including update operators
+     * @param options - Update options
+     * @returns The updated model
+     *
+     * @example
+     * // Simple update (backwards compatible)
+     * await component.update(uuid, { name: "John" }, opts)
+     *
+     * // With update operators
+     * await component.update(uuid, {
+     *   name: "John",
+     *   $inc: { login_count: 1 },
+     *   $push: { tags: "verified" },
+     *   $addToSet: { roles: "admin" }
+     * }, opts)
      */
     async update(uuid, data, options) {
-        return await this.client.post(`${this.getComponentPath()}/model/${uuid}`, {
+        return await this.client.post(`/v4/system/component/${this.ref}/model/${uuid}`, {
             data,
             options,
         });
@@ -234,7 +223,7 @@ class Component extends PlatformBaseClient {
      * @returns
      */
     async updateMany(data, options) {
-        return await this.client.patch(`${this.getComponentPath()}/models/bulk`, {
+        return await this.client.patch(`/v4/system/component/${this.ref}/models/bulk`, {
             data,
             options
         });
@@ -247,7 +236,7 @@ class Component extends PlatformBaseClient {
      * @returns
      */
     async createMany(data, options) {
-        return await this.client.post(`${this.getComponentPath()}/models/bulk`, {
+        return await this.client.post(`/v4/system/component/${this.ref}/models/bulk`, {
             data,
             options
         });
@@ -255,37 +244,59 @@ class Component extends PlatformBaseClient {
     /**
      * Modify models by filters
      *
-     * @param data
-     * @param options
-     * @returns
+     * Updates all models matching the given filters. Supports inline update
+     * operators in the data payload for granular operations.
+     *
+     * @param filters - Query filters to match models
+     * @param data - Fields to update, optionally including update operators
+     * @param options - Modify options (e.g. upsert)
+     * @returns The modified models
+     *
+     * @example
+     * await component.modify(
+     *   { status: "active" },
+     *   { $inc: { impression_count: 1 }, $addToSet: { viewers: "user-1" } },
+     *   { upsert: false }
+     * )
      */
     async modify(filters, data, options) {
-        return await this.client.patch(`${this.getComponentPath()}/modify/model`, {
+        return await this.client.patch(`/v4/system/component/${this.ref}/modify/model`, {
             filters,
             data,
             options,
         });
     }
     /**
-     * Concurrent update model by uuid
+     * Concurrent update model by uuid with optimistic locking
      *
-     * @param uuid string - The uuid of the model
-     * @param version number - The version of the model
-     * @param data
-     * @returns
+     * Uses version-based concurrency control — the update will fail with a
+     * conflict error if the document has been modified since the provided version.
+     * Supports inline update operators in the data payload.
+     *
+     * @param uuid - The uuid of the model
+     * @param version - The expected __version__ of the model
+     * @param data - Fields to update, optionally including update operators
+     * @param options - Update options
+     * @returns The updated model
+     *
+     * @example
+     * await component.concurrentUpdate(uuid, model.__version__, {
+     *   status: "processed",
+     *   $inc: { retry_count: 1 }
+     * }, opts)
      */
     async concurrentUpdate(uuid, version, data, options) {
-        return await this.client.post(`${this.getComponentPath()}/model/${uuid}`, {
+        return await this.client.post(`/v4/system/component/${this.ref}/model/${uuid}`, {
             version: version,
             data,
             options,
         });
     }
     async create(model) {
-        return await this.client.post(`${this.getComponentPath()}/model`, model);
+        return await this.client.post(`/v4/system/component/${this.ref}/model`, model);
     }
     async delete(uuid) {
-        return await this.client.delete(`${this.getComponentPath()}/model/${uuid}`);
+        return await this.client.delete(`/v4/system/component/${this.ref}/model/${uuid}`);
     }
     /**
      * Execute aggregate pipeline with optional streaming support
@@ -338,14 +349,14 @@ class Component extends PlatformBaseClient {
                             onError: onErrorCallback,
                             onEnd: onEndCallback
                         };
-                        streamPromise = this._streamNDJSON(`${this.getComponentPath()}/aggregate`, {
+                        streamPromise = this._streamNDJSON(`/v4/system/component/${this.ref}/aggregate`, {
                             'Accept': 'application/x-ndjson',
                             'Content-Type': 'application/json'
                         }, handler, pipeline);
                     }
                     return streamPromise.then(resolve, reject);
                 }
-                return this.client.post(`${this.getComponentPath()}/aggregate`, pipeline)
+                return this.client.post(`/v4/system/component/${this.ref}/aggregate`, pipeline)
                     .then(resolve, reject);
             },
             catch: (reject) => {
@@ -357,8 +368,18 @@ class Component extends PlatformBaseClient {
     async settings() {
         return await this.client.get(`/v3/system/component/settings/${this.ref}`);
     }
+    async settingsForVersion(version) {
+        return await this.client.get(`/v3/system/component/settings/${this.ref}/${version}`);
+    }
+    async publish(version, env) {
+        return await this.client.post(`/v3/system/component/version/publish`, {
+            ref: this.ref,
+            version,
+            env,
+        });
+    }
     async saveSettings(settings, version) {
-        return await this.client.post(`/v3/system/component/settings/${this.ref}/${version}`, settings);
+        return await this.client.post(`/v4/system/component/settings/${this.ref}/${version}`, settings);
     }
     async saveTemplatesDist(version, sdkVersion, engine, dist) {
         return await this.client.post(`/v3/system/component/templates/${this.ref}/${version}`, {
@@ -370,18 +391,127 @@ class Component extends PlatformBaseClient {
         });
     }
     async workflow(event, input) {
-        return await this.client.post(`${this.getComponentPath()}/workflow/event`, {
+        return await this.client.post(`/v3/system/component/${this.ref}/workflow/event`, {
             event,
             input
         });
     }
     async function(name, input) {
-        return await this.client.post(`${this.getComponentPath()}/function/${name}`, {
+        return await this.client.post(`/v3/system/component/${this.ref}/function/${name}`, {
             data: input
         });
     }
     async revisions(uuid) {
-        return await this.client.get(`${this.getComponentPath()}/model/${uuid}/revisions`);
+        return await this.client.get(`/v3/system/component/${this.ref}/model/${uuid}/revisions`);
+    }
+    /**
+     * Install a new extension on the component
+     *
+     * @param extension - The extension definition to install
+     * @param version - The component version to install the extension on
+     * @returns Updated component settings
+     *
+     * @example
+     * ```typescript
+     * await component.installExtension({
+     *     name: 'shipping_tracker',
+     *     is_active: true,
+     *     fields: [...],
+     *     config: { api_key: 'key' }
+     * }, '0.1.0')
+     * ```
+     */
+    async installExtension(extension, version) {
+        return await this.client.post(`/v4/system/component/${this.ref}/${version}/extensions`, extension);
+    }
+    /**
+     * Update an existing extension on the component
+     *
+     * @param name - The name of the extension to update
+     * @param version - The component version
+     * @param data - Partial extension data to update
+     * @returns Updated component settings
+     *
+     * @example
+     * ```typescript
+     * await component.updateExtension('shipping_tracker', '0.1.0', {
+     *     is_active: false,
+     *     config: { api_key: 'new-key' }
+     * })
+     * ```
+     */
+    async updateExtension(name, version, data) {
+        return await this.client.patch(`/v4/system/component/${this.ref}/${version}/extensions/${name}`, data);
+    }
+    /**
+     * Delete an extension from the component
+     *
+     * @param name - The name of the extension to delete
+     * @param version - The component version
+     * @returns Updated component settings
+     *
+     * @example
+     * ```typescript
+     * await component.deleteExtension('shipping_tracker', '0.1.0')
+     * ```
+     */
+    async deleteExtension(name, version) {
+        return await this.client.delete(`/v4/system/component/${this.ref}/${version}/extensions/${name}`);
+    }
+    /**
+     * Install a new policy on the component
+     *
+     * @param policy - The policy definition to install
+     * @param version - The component version to install the policy on
+     * @returns Updated component settings
+     *
+     * @example
+     * ```typescript
+     * await component.installPolicy({
+     *     type: 'field_access',
+     *     name: 'restrict_email',
+     *     enabled: true,
+     *     priority: 1,
+     *     config: { fields: ['email'], actions: ['see'], roles: ['role-uuid'] }
+     * }, '0.1.0')
+     * ```
+     */
+    async installPolicy(policy, version) {
+        return await this.client.post(`/v4/system/component/${this.ref}/${version}/policies`, policy);
+    }
+    /**
+     * Update an existing policy on the component
+     *
+     * @param name - The name of the policy to update
+     * @param version - The component version
+     * @param data - Partial policy data to update
+     * @returns Updated component settings
+     *
+     * @example
+     * ```typescript
+     * await component.updatePolicy('restrict_email', '0.1.0', {
+     *     enabled: false,
+     *     priority: 2
+     * })
+     * ```
+     */
+    async updatePolicy(name, version, data) {
+        return await this.client.patch(`/v4/system/component/${this.ref}/${version}/policies/${name}`, data);
+    }
+    /**
+     * Delete a policy from the component
+     *
+     * @param name - The name of the policy to delete
+     * @param version - The component version
+     * @returns Updated component settings
+     *
+     * @example
+     * ```typescript
+     * await component.deletePolicy('restrict_email', '0.1.0')
+     * ```
+     */
+    async deletePolicy(name, version) {
+        return await this.client.delete(`/v4/system/component/${this.ref}/${version}/policies/${name}`);
     }
     /**
      * Internal method to handle NDJSON streaming responses
@@ -474,8 +604,7 @@ class Functions extends PlatformBaseClient {
      * Run platform function
      *
      * @param id - Function ID
-     * @param input - Input data
-     * @param query - Query parameters
+     * @param d - Object containing input data, query parameters, and headers
      * @returns - Function result
      *
      * @example
@@ -930,7 +1059,7 @@ class Sandbox extends PlatformBaseClient {
      * const result = await platform.sandbox().spark("myFunction", { foo: "bar" })
      */
     async spark(name, data) {
-        return await this.client.post(`/v1/project/sandbox/spark/exec/${name}`, data);
+        return await this.client.post(`/luma/sandbox/v1/spark/exec/${name}`, data);
     }
 }
 
@@ -1001,7 +1130,7 @@ class Project extends PlatformBaseClient {
     }
     /**
      * Invite a user to the project
-     * @param email Array of emails
+     * @param emails Array of emails
      * @param roles Array of role UUIDs
      */
     async invite(emails, roles) {
@@ -1027,6 +1156,13 @@ class Project extends PlatformBaseClient {
     async acceptInvite(uuid) {
         return await this.client.get(`/v1/project/invite/accept/${uuid}`);
     }
+    /**
+     * Revoke an invite
+     * @param uuid Invite UUID
+     */
+    async revokeInvite(uuid) {
+        return await this.client.delete(`/v1/project/invite/${uuid}`);
+    }
     /**
      * Register through an invite
      * @param uuid Invite UUID
@@ -1190,8 +1326,8 @@ class Platform extends PlatformBaseClient {
     forge() {
         return (new Forge()).setClient(this.client);
     }
-    component(ref, options) {
-        return (new Component(ref, options)).setClient(this.client);
+    component(ref) {
+        return (new Component(ref)).setClient(this.client);
     }
     componentUtils() {
         return (new ComponentUtils()).setClient(this.client);
@@ -1219,31 +1355,6 @@ class Platform extends PlatformBaseClient {
     }
 }
 
-class Invoicing extends PlatformBaseClient {
-    async getSalesInvoices(provider, page) {
-        return await this.request("GET", `invoices/${provider}/sales`, {
-            params: {
-                page: page || 1
-            }
-        });
-    }
-    async acceptPurchaseInvoice(provider, id, comment) {
-        return await this.request('POST', `invoices/${provider}/purchase/acceptReject/${id}`, {
-            data: {
-                accepted: true,
-                comment: comment
-            }
-        });
-    }
-    async request(method, endpoint, params) {
-        return await this.client.request({
-            method: method,
-            url: `/karadjordje/v1/${endpoint}`,
-            ...params
-        });
-    }
-}
-
 class IntegrationsBaseClient extends BaseClient {
     constructor(options) {
         var _a, _b, _c, _d, _e, _f, _g;
@@ -1266,7 +1377,7 @@ class IntegrationsBaseClient extends BaseClient {
                 }
             }
         }
-        else if (isNode) {
+        if (isNode) {
             host = (_d = host !== null && host !== void 0 ? host : process.env.INTEGRATION_API) !== null && _d !== void 0 ? _d : null;
             env = (_e = env !== null && env !== void 0 ? env : process.env.PROJECT_ENV) !== null && _e !== void 0 ? _e : null;
             token = (_f = token !== null && token !== void 0 ? token : process.env.PROJECT_API_TOKEN) !== null && _f !== void 0 ? _f : null;
@@ -1599,7 +1710,6 @@ class DMS extends IntegrationsBaseClient {
      * - Explicit structure: JSON with `header`, `items`, and `footer` properties
      * - Auto-detection: Mixed JSON arrays with metadata objects and summary rows
      *
-     * @param lib - Library reference UUID
      * @param data - Raw data to convert
      * @param params - Conversion parameters including structured data options
      * @returns Promise resolving to converted data
@@ -1692,7 +1802,6 @@ class DMS extends IntegrationsBaseClient {
     /**
      * Get information about data format and structure
      *
-     * @param lib - Library reference UUID
      * @param data - Raw data to analyze
      * @param params - Analysis parameters
      * @returns Promise resolving to data information
@@ -1733,7 +1842,6 @@ class DMS extends IntegrationsBaseClient {
     /**
      * Validate data format without performing conversion
      *
-     * @param lib - Library reference UUID
      * @param data - Raw data to validate
      * @param params - Validation parameters
      * @returns Promise resolving to validation result
@@ -1781,7 +1889,6 @@ class DMS extends IntegrationsBaseClient {
      * - Regular arrays are converted directly to CSV
      * - Structured data (with metadata objects) is automatically detected and formatted
      *
-     * @param lib - Library reference UUID
      * @param jsonData - JSON data (array of objects or structured data)
      * @returns Promise resolving to CSV string
      *
@@ -1832,7 +1939,6 @@ class DMS extends IntegrationsBaseClient {
      * Supports both regular JSON arrays and structured data patterns.
      * Excel files are always generated with .xlsx extension.
      *
-     * @param lib - Library reference UUID
      * @param jsonData - JSON data (array of objects or structured data)
      * @param options - Optional conversion options
      * @returns Promise resolving to Excel file as Blob
@@ -1891,7 +1997,6 @@ class DMS extends IntegrationsBaseClient {
     /**
      * Convert CSV data to JSON format
      *
-     * @param lib - Library reference UUID
      * @param csvData - CSV data string (with headers in first row)
      * @returns Promise resolving to JSON array
      *
@@ -1922,7 +2027,6 @@ class DMS extends IntegrationsBaseClient {
     /**
      * Convert CSV data to Excel (.xlsx) format
      *
-     * @param lib - Library reference UUID
      * @param csvData - CSV data string (with headers in first row)
      * @param options - Optional conversion options
      * @returns Promise resolving to Excel file as Blob
@@ -1960,7 +2064,6 @@ class DMS extends IntegrationsBaseClient {
     /**
      * Convert Excel (.xlsx) data to JSON format
      *
-     * @param lib - Library reference UUID
      * @param excelData - Excel file data as Blob or ArrayBuffer
      * @param options - Optional conversion options
      * @returns Promise resolving to JSON array
@@ -2000,7 +2103,6 @@ class DMS extends IntegrationsBaseClient {
     /**
      * Convert Excel (.xlsx) data to CSV format
      *
-     * @param lib - Library reference UUID
      * @param excelData - Excel file data as Blob or ArrayBuffer
      * @param options - Optional conversion options
      * @returns Promise resolving to CSV string
@@ -2064,18 +2166,175 @@ class DMS extends IntegrationsBaseClient {
     }
 }
 
-class SerbiaUtil extends IntegrationsBaseClient {
-    async nbsSearch(params) {
-        return await this.services("GET", "nbs/search", { params });
+/**
+ * SDK client for the Protokol Mail integration.
+ *
+ * Provides methods to send emails, list email logs, resend failed emails,
+ * and manage attachments through the Protokol Mail API.
+ *
+ * @example
+ * ```typescript
+ * import { Mail } from "@ptkl/sdk/beta"
+ *
+ * const mail = new Mail()
+ *
+ * // Send an email
+ * const result = await mail.send({
+ *   to: ["user@example.com"],
+ *   subject: "Hello",
+ *   body: "<h1>Welcome!</h1>"
+ * })
+ *
+ * console.log(result.message_id)
+ * ```
+ */
+class Mail extends IntegrationsBaseClient {
+    /**
+     * Send an email. The email is queued for async delivery.
+     *
+     * Supports both JSON body (with base64-encoded attachments) and
+     * multipart/form-data (with file uploads).
+     *
+     * @param input - The email content and recipients
+     * @returns The queued email's message ID and status
+     *
+     * @example
+     * ```typescript
+     * const result = await mail.send({
+     *   to: ["recipient@example.com"],
+     *   cc: ["cc@example.com"],
+     *   subject: "Invoice #123",
+     *   body: "<p>Please find your invoice attached.</p>",
+     *   reply_to: "billing@company.com",
+     *   sender_name: "Billing Department",
+     *   attachments: [{
+     *     file_name: "invoice.pdf",
+     *     mime_type: "application/pdf",
+     *     content: "base64encodedcontent...",
+     *     size: 12345
+     *   }]
+     * })
+     * ```
+     */
+    async send(input) {
+        const { data } = await this.client.post("/protokol-mail/v1/emails", input);
+        return data;
+    }
+    /**
+     * List emails for the current project with optional filtering and pagination.
+     *
+     * @param params - Optional query parameters for filtering and pagination
+     * @returns Paginated list of email log entries
+     *
+     * @example
+     * ```typescript
+     * // List all emails
+     * const emails = await mail.list()
+     *
+     * // List failed emails, page 2
+     * const failed = await mail.list({ status: "failed", page: 2, limit: 10 })
+     * ```
+     */
+    async list(params) {
+        const { data } = await this.client.get("/protokol-mail/v1/emails", { params });
+        return data;
     }
+    /**
+     * Get a single email by its message ID.
+     *
+     * @param messageId - The UUID of the email message
+     * @returns The full email log entry
+     *
+     * @example
+     * ```typescript
+     * const email = await mail.get("550e8400-e29b-41d4-a716-446655440000")
+     * console.log(email.status, email.subject)
+     * ```
+     */
+    async get(messageId) {
+        const { data } = await this.client.get(`/protokol-mail/v1/emails/${messageId}`);
+        return data;
+    }
+    /**
+     * Resend a previously failed email. Resets the retry counter and
+     * re-queues the email for delivery.
+     *
+     * @param messageId - The UUID of the email to resend
+     * @returns Confirmation with the message ID
+     *
+     * @example
+     * ```typescript
+     * await mail.resend("550e8400-e29b-41d4-a716-446655440000")
+     * ```
+     */
+    async resend(messageId) {
+        const { data } = await this.client.post(`/protokol-mail/v1/emails/${messageId}/resend`);
+        return data;
+    }
+    /**
+     * List attachment metadata for a specific email.
+     *
+     * @param messageId - The UUID of the email message
+     * @returns Array of attachment metadata entries
+     *
+     * @example
+     * ```typescript
+     * const attachments = await mail.listAttachments("550e8400-e29b-41d4-a716-446655440000")
+     * attachments.forEach(att => console.log(att.file_name, att.file_size))
+     * ```
+     */
+    async listAttachments(messageId) {
+        const { data } = await this.client.get(`/protokol-mail/v1/emails/${messageId}/attachments`);
+        return data;
+    }
+    /**
+     * Download an attachment's binary content.
+     *
+     * @param messageId - The UUID of the email message
+     * @param attachmentId - The UUID of the attachment
+     * @returns The raw binary data as an ArrayBuffer
+     *
+     * @example
+     * ```typescript
+     * const content = await mail.downloadAttachment(
+     *   "550e8400-e29b-41d4-a716-446655440000",
+     *   "660e8400-e29b-41d4-a716-446655440000"
+     * )
+     * ```
+     */
+    async downloadAttachment(messageId, attachmentId) {
+        const { data } = await this.client.get(`/protokol-mail/v1/emails/${messageId}/attachments/${attachmentId}`, { responseType: "arraybuffer" });
+        return data;
+    }
+}
+
+class VPFR extends IntegrationsBaseClient {
+    async request(method, endpoint, params) {
+        return await this.client.request({
+            method: method,
+            url: `/v1/karadjordje/vpfr/${endpoint}`,
+            ...params
+        });
+    }
+}
+
+class MinFin extends IntegrationsBaseClient {
     async getReceiptFromUrl(url, source) {
-        return await this.services("POST", "receipt/crawl", {
+        return await this.services("POST", "receipt/extract", {
             data: {
                 url,
                 source
             }
         });
     }
+    async getReceiptFromQrCode(qrCodeImage, source) {
+        return await this.services("POST", "receipt/extract", {
+            data: {
+                qrCodeImage,
+                source
+            }
+        });
+    }
     async getContoList() {
         return await this.services("GET", "conto");
     }
@@ -2089,15 +2348,8 @@ class SerbiaUtil extends IntegrationsBaseClient {
             ...params
         });
     }
-}
-
-class VPFR extends IntegrationsBaseClient {
-    async request(method, endpoint, params) {
-        return await this.client.request({
-            method: method,
-            url: `/v1/karadjordje/vpfr/${endpoint}`,
-            ...params
-        });
+    vpfr() {
+        return new VPFR().setClient(this.client);
     }
 }
 
@@ -2880,28 +3132,58 @@ class Minimax extends IntegrationsBaseClient {
     }
 }
 
-// import integrations
+class NBS extends IntegrationsBaseClient {
+    async nbsSearch(params) {
+        return await this.services("GET", "nbs/search", { params });
+    }
+    async getNbsIpsQrCode(code, size, lang) {
+        return await this.request("GET", `ipsQr/generate`, {
+            params: {
+                size,
+                lang
+            },
+            data: {
+                ...code
+            }
+        });
+    }
+    async validateNbsIpsQrCode(qrCodeString, lang) {
+        return await this.request("GET", `ipsQr/validate`, {
+            params: {
+                lang
+            },
+            data: {
+                QRCodeString: qrCodeString
+            }
+        });
+    }
+    async services(method, endpoint, params) {
+        return this.request(method, `services/${endpoint}`, params);
+    }
+    async request(method, endpoint, params) {
+        return await this.client.request({
+            method: method,
+            url: `/v1/karadjordje/${endpoint}`,
+            ...params
+        });
+    }
+}
+
 class Integrations extends IntegrationsBaseClient {
     constructor(options) {
         super(options);
         this.integrations = {
-            'protokol-invoicing': new Invoicing().setClient(this.client),
-            'protokol-vpfr': new VPFR().setClient(this.client),
+            'serbia-minfin': new MinFin().setClient(this.client),
             'protokol-dms': new DMS().setClient(this.client),
-            'serbia-utilities': new SerbiaUtil().setClient(this.client),
+            'protokol-mail': new Mail().setClient(this.client),
+            'nbs': new NBS().setClient(this.client),
             'protokol-payments': new Payments().setClient(this.client),
             'protokol-minimax': new Minimax().setClient(this.client),
         };
     }
-    getSerbiaUtilities() {
-        return this.getInterfaceOf('serbia-utilities');
-    }
     getDMS() {
         return this.getInterfaceOf('protokol-dms');
     }
-    getVPFR() {
-        return this.getInterfaceOf('protokol-vpfr');
-    }
     getInvoicing() {
         return this.getInterfaceOf('protokol-invoicing');
     }
@@ -2911,6 +3193,15 @@ class Integrations extends IntegrationsBaseClient {
     getMinimax() {
         return this.getInterfaceOf('protokol-minimax');
     }
+    getMail() {
+        return this.getInterfaceOf('protokol-mail');
+    }
+    getNBS() {
+        return this.getInterfaceOf('nbs');
+    }
+    getSerbiaMinFin() {
+        return this.getInterfaceOf('serbia-minfin');
+    }
     async isInstalled(id) {
         const { data } = await this.client.get("/v1/integrations");
         return data.find((i) => i.id == id) !== undefined;
@@ -2925,4 +3216,29 @@ class Integrations extends IntegrationsBaseClient {
     }
 }
 
-export { APIUser, Apps, Component, ComponentUtils, Config, DMS, Forge, Functions, Integrations as Integration, Integrations, Invoicing, Payments, Platform, Project, Ratchet, Sandbox, SerbiaUtil, System, Thunder, Users, VPFR, Workflow };
+class Invoicing extends PlatformBaseClient {
+    async getSalesInvoices(provider, page) {
+        return await this.request("GET", `invoices/${provider}/sales`, {
+            params: {
+                page: page || 1
+            }
+        });
+    }
+    async acceptPurchaseInvoice(provider, id, comment) {
+        return await this.request('POST', `invoices/${provider}/purchase/acceptReject/${id}`, {
+            data: {
+                accepted: true,
+                comment: comment
+            }
+        });
+    }
+    async request(method, endpoint, params) {
+        return await this.client.request({
+            method: method,
+            url: `/karadjordje/v1/${endpoint}`,
+            ...params
+        });
+    }
+}
+
+export { APIUser, Apps, Component, ComponentUtils, Config, DMS, Forge, Functions, Integrations as Integration, Integrations, Invoicing, Mail, NBS, Payments, Platform, Project, Ratchet, Sandbox, MinFin as SerbiaMinFin, System, Thunder, Users, VPFR, Workflow };