@ptkl/sdk 1.0.3 → 1.3.0

package/dist/index.0.10.js

@@ -25,7 +25,6 @@ var ProtokolSDK010 = (function (exports, axios) {
      *
      * @class PlatformBaseClient
      * @extends BaseClient
-     * @constructor
      * @param {AxiosInstance} [client] - The axios instance to use for the client
      *
      * @example
@@ -36,7 +35,7 @@ var ProtokolSDK010 = (function (exports, axios) {
      */
     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;
@@ -45,23 +44,23 @@ var ProtokolSDK010 = (function (exports, axios) {
                 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}`;
@@ -89,21 +88,9 @@ var ProtokolSDK010 = (function (exports, axios) {
     }
 
     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
@@ -127,7 +114,6 @@ var ProtokolSDK010 = (function (exports, axios) {
          * )
          **/
         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,
@@ -153,32 +139,18 @@ var ProtokolSDK010 = (function (exports, axios) {
                 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",
                 }
             });
         }
@@ -212,17 +184,34 @@ var ProtokolSDK010 = (function (exports, axios) {
          * @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,
             });
@@ -235,7 +224,7 @@ var ProtokolSDK010 = (function (exports, axios) {
          * @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
             });
@@ -248,7 +237,7 @@ var ProtokolSDK010 = (function (exports, axios) {
          * @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
             });
@@ -256,37 +245,59 @@ var ProtokolSDK010 = (function (exports, axios) {
         /**
          * 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
@@ -339,14 +350,14 @@ var ProtokolSDK010 = (function (exports, axios) {
                                 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) => {
@@ -358,8 +369,18 @@ var ProtokolSDK010 = (function (exports, axios) {
         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}`, {
@@ -371,18 +392,127 @@ var ProtokolSDK010 = (function (exports, axios) {
             });
         }
         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
@@ -475,8 +605,7 @@ var ProtokolSDK010 = (function (exports, axios) {
          * 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
@@ -931,7 +1060,7 @@ var ProtokolSDK010 = (function (exports, axios) {
          * 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);
         }
     }
 
@@ -1002,7 +1131,7 @@ var ProtokolSDK010 = (function (exports, axios) {
         }
         /**
          * 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) {
@@ -1028,6 +1157,13 @@ var ProtokolSDK010 = (function (exports, axios) {
         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
@@ -1191,8 +1327,8 @@ var ProtokolSDK010 = (function (exports, axios) {
         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);
@@ -1220,31 +1356,6 @@ var ProtokolSDK010 = (function (exports, axios) {
         }
     }
 
-    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;
@@ -1267,7 +1378,7 @@ var ProtokolSDK010 = (function (exports, axios) {
                     }
                 }
             }
-            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;
@@ -1600,7 +1711,6 @@ var ProtokolSDK010 = (function (exports, axios) {
          * - 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
@@ -1693,7 +1803,6 @@ var ProtokolSDK010 = (function (exports, axios) {
         /**
          * 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
@@ -1734,7 +1843,6 @@ var ProtokolSDK010 = (function (exports, axios) {
         /**
          * 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
@@ -1782,7 +1890,6 @@ var ProtokolSDK010 = (function (exports, axios) {
          * - 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
          *
@@ -1833,7 +1940,6 @@ var ProtokolSDK010 = (function (exports, axios) {
          * 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
@@ -1892,7 +1998,6 @@ var ProtokolSDK010 = (function (exports, axios) {
         /**
          * 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
          *
@@ -1923,7 +2028,6 @@ var ProtokolSDK010 = (function (exports, axios) {
         /**
          * 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
@@ -1961,7 +2065,6 @@ var ProtokolSDK010 = (function (exports, axios) {
         /**
          * 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
@@ -2001,7 +2104,6 @@ var ProtokolSDK010 = (function (exports, axios) {
         /**
          * 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
@@ -2065,18 +2167,175 @@ var ProtokolSDK010 = (function (exports, axios) {
         }
     }
 
-    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");
         }
@@ -2090,15 +2349,8 @@ var ProtokolSDK010 = (function (exports, axios) {
                 ...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);
         }
     }
 
@@ -2881,28 +3133,58 @@ var ProtokolSDK010 = (function (exports, axios) {
         }
     }
 
-    // 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');
         }
@@ -2912,6 +3194,15 @@ var ProtokolSDK010 = (function (exports, axios) {
         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;
@@ -2926,6 +3217,31 @@ var ProtokolSDK010 = (function (exports, axios) {
         }
     }
 
+    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
+            });
+        }
+    }
+
     exports.APIUser = APIUser;
     exports.Apps = Apps;
     exports.Component = Component;
@@ -2937,12 +3253,14 @@ var ProtokolSDK010 = (function (exports, axios) {
     exports.Integration = Integrations;
     exports.Integrations = Integrations;
     exports.Invoicing = Invoicing;
+    exports.Mail = Mail;
+    exports.NBS = NBS;
     exports.Payments = Payments;
     exports.Platform = Platform;
     exports.Project = Project;
     exports.Ratchet = Ratchet;
     exports.Sandbox = Sandbox;
-    exports.SerbiaUtil = SerbiaUtil;
+    exports.SerbiaMinFin = MinFin;
     exports.System = System;
     exports.Thunder = Thunder;
     exports.Users = Users;