@ptkl/sdk 1.0.3 → 1.3.0

package/dist/v0.10/types/integrations/payments.d.ts

@@ -0,0 +1,48 @@
+type PaymentProvider = "monri";
+type Transaction = {
+    id: string;
+    provider: PaymentProvider;
+    transactionId: string;
+    userId: string;
+    amount: number;
+    precision: number;
+    currency: string;
+    status: "pending" | "completed" | "failed" | "refunded" | "voided" | "deactivated" | "expired";
+    description: string;
+    paymentLink: string | null;
+    tokenizedPanEnc?: string;
+    tokenizedPan?: string;
+    formattedAmount?: string;
+    autoRefund: boolean;
+    redirectUrl: string | null;
+    metadata: {
+        lang?: "en" | "es" | "ba" | "hr";
+        items?: {
+            itemId?: string;
+            name: string;
+            pricePerUnit?: number;
+            quantity?: number;
+            price: number;
+        }[];
+    };
+    logs: {
+        timestamp: string;
+        status: string;
+        details?: any;
+    }[];
+    expiresAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+type PaymentAmount = {
+    totalAmount: string;
+} | {
+    items: {
+        itemId?: string;
+        name: string;
+        pricePerUnit?: number;
+        quantity?: number;
+        price: number;
+    }[];
+};
+export type { PaymentProvider, PaymentAmount, Transaction };

package/dist/v0.10/types/integrations/serbiaUtils.d.ts

@@ -0,0 +1,40 @@
+export interface GenerateIPSQrCodeRequest {
+    TransactionType: string;
+    Version: string;
+    CharacterSet: string;
+    RecipientAccountNumber: string;
+    RecipientName: string;
+    AmountInLocalCurrency: string;
+    PaymentPurposeCode: string;
+    PurposeOfPayment?: string;
+    PaymentOrderNumber?: string;
+    PayerInformation?: string;
+}
+export interface ValidateIPSQrCodeRequest {
+    QRCodeString: string;
+}
+export interface IPSQrCodeResponse {
+    Status: {
+        StatusCode: number;
+        StatusDescription: string;
+    };
+    OriginalQRCodeString?: string;
+    ParsedData?: GenerateIPSQrCodeRequest;
+    Base64EncodedImage?: string;
+    Errors?: string[];
+}
+export type NbsIpsQrCode = {
+    TransactionType: string;
+    Version: string;
+    CharacterSet: string;
+    RecipientAccountNumber: string;
+    RecipientName: string;
+    AmountInLocalCurrency: string;
+    PayerInformation: string;
+    PaymentPurposeCode: string;
+    PurposeOfPayment: string;
+    PaymentOrderNumber: string;
+};
+export type NBSSearchParams = {
+    vatNumber: string;
+};

package/dist/v0.10/types/integrations/serbiaUtits.d.ts

@@ -0,0 +1,37 @@
+export interface GenerateIPSQrCodeRequest {
+    TransactionType: string;
+    Version: string;
+    CharacterSet: string;
+    RecipientAccountNumber: string;
+    RecipientName: string;
+    AmountInLocalCurrency: string;
+    PaymentPurposeCode: string;
+    PurposeOfPayment?: string;
+    PaymentOrderNumber?: string;
+    PayerInformation?: string;
+}
+export interface ValidateIPSQrCodeRequest {
+    QRCodeString: string;
+}
+export interface IPSQrCodeResponse {
+    Status: {
+        StatusCode: number;
+        StatusDescription: string;
+    };
+    OriginalQRCodeString?: string;
+    ParsedData?: GenerateIPSQrCodeRequest;
+    Base64EncodedImage?: string;
+    Errors?: string[];
+}
+export type NbsIpsQrCode = {
+    TransactionType: string;
+    Version: string;
+    CharacterSet: string;
+    RecipientAccountNumber: string;
+    RecipientName: string;
+    AmountInLocalCurrency: string;
+    PayerInformation: string;
+    PaymentPurposeCode: string;
+    PurposeOfPayment: string;
+    PaymentOrderNumber: string;
+};

package/dist/v0.9/api/functions.d.ts

@@ -7,8 +7,7 @@ export default 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

package/dist/v0.9/api/index.d.ts

@@ -20,5 +20,6 @@ export { default as Invoicing } from './integrations/invoicing';
 export { default as DMS } from './integrations/dms';
 export { default as SerbiaUtil } from './integrations/serbiaUtil';
 export { default as VPFR } from './integrations/vpfr';
+export { default as Mail } from './integrations/mail';
 import Platfrom from './platform';
 export default Platfrom;

package/dist/v0.9/api/integrations/mail.d.ts

@@ -0,0 +1,69 @@
+import IntegrationsBaseClient from "../integrationsBaseClient";
+import { SendEmailRequest, SendEmailResponse, MailLog, EmailListResponse, ListEmailsParams, AttachmentMeta } from "../../types/integrations/mail";
+/**
+ * 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"
+ *
+ * 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)
+ * ```
+ */
+export default class Mail extends IntegrationsBaseClient {
+    /**
+     * Send an email. The email is queued for async delivery.
+     *
+     * @param input - The email content and recipients
+     * @returns The queued email's message ID and status
+     */
+    send(input: SendEmailRequest): Promise<SendEmailResponse>;
+    /**
+     * 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
+     */
+    list(params?: ListEmailsParams): Promise<EmailListResponse>;
+    /**
+     * Get a single email by its message ID.
+     *
+     * @param messageId - The UUID of the email message
+     * @returns The full email log entry
+     */
+    get(messageId: string): Promise<MailLog>;
+    /**
+     * Resend a previously failed email.
+     *
+     * @param messageId - The UUID of the email to resend
+     * @returns Confirmation with the message ID
+     */
+    resend(messageId: string): Promise<SendEmailResponse>;
+    /**
+     * List attachment metadata for a specific email.
+     *
+     * @param messageId - The UUID of the email message
+     * @returns Array of attachment metadata entries
+     */
+    listAttachments(messageId: string): Promise<AttachmentMeta[]>;
+    /**
+     * 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
+     */
+    downloadAttachment(messageId: string, attachmentId: string): Promise<ArrayBuffer>;
+}

package/dist/v0.9/api/integrations/serbiaUtil.d.ts

@@ -1,10 +1,13 @@
 import IntegrationsBaseClient from "../integrationsBaseClient";
-import { NbsIpsQrCode } from "../../types/integrations";
+import { NbsIpsQrCode, NBSSearchParams, IPSQrCodeResponse } from "../../types/integrations/serbiaUtits";
+import { AxiosResponse } from "axios";
 export default class SerbiaUtil extends IntegrationsBaseClient {
-    nbsSearch(params: any): Promise<import("axios").AxiosResponse<any, any>>;
-    generateNbsIpsQrCode(params: NbsIpsQrCode): any;
-    getReceiptFromUrl(url: string, source: string): Promise<import("axios").AxiosResponse<any, any>>;
-    getContoList(): Promise<import("axios").AxiosResponse<any, any>>;
-    services(method: string, endpoint: string, params?: any): Promise<import("axios").AxiosResponse<any, any>>;
-    request(method: string, endpoint: string, params: any): Promise<import("axios").AxiosResponse<any, any>>;
+    nbsSearch(params: NBSSearchParams): Promise<AxiosResponse<any, any>>;
+    getNbsIpsQrCode(code: NbsIpsQrCode, size: number, lang?: string): Promise<AxiosResponse<IPSQrCodeResponse>>;
+    validateNbsIpsQrCode(qrCodeString: string, lang?: string): Promise<AxiosResponse<IPSQrCodeResponse>>;
+    getReceiptFromUrl(url: string, source: string): Promise<AxiosResponse<any, any>>;
+    getReceiptFromQrCode(qrCodeImage: string, source: string): Promise<AxiosResponse<any, any>>;
+    getContoList(): Promise<AxiosResponse<any, any>>;
+    private services;
+    request(method: string, endpoint: string, params: any): Promise<AxiosResponse<any, any>>;
 }

package/dist/v0.9/api/integrations.d.ts

@@ -1,5 +1,6 @@
 import Invoicing from "./integrations/invoicing";
 import DMS from "./integrations/dms";
+import Mail from "./integrations/mail";
 import VPFR from "./integrations/vpfr";
 import IntegrationsBaseClient from "./integrationsBaseClient";
 import Payments from "./integrations/payments";
@@ -15,6 +16,7 @@ export default class Integrations extends IntegrationsBaseClient {
     getDMS(): DMS;
     getVPFR(): VPFR;
     getInvoicing(): Invoicing;
+    getMail(): Mail;
     getPayments(): Payments;
     getMinimax(): Minimax;
     isInstalled(id: string): Promise<boolean>;

package/dist/v0.9/api/platformBaseClient.d.ts

@@ -6,7 +6,6 @@ import BaseClient from "./baseClient";
  *
  * @class PlatformBaseClient
  * @extends BaseClient
- * @constructor
  * @param {AxiosInstance} [client] - The axios instance to use for the client
  *
  * @example

package/dist/v0.9/api/project.d.ts

@@ -24,7 +24,7 @@ export default class Project extends PlatformBaseClient {
     archive(): Promise<AxiosResponse<any>>;
     /**
      * Invite a user to the project
-     * @param email Array of emails
+     * @param emails Array of emails
      * @param roles Array of role UUIDs
      */
     invite(emails: string[], roles: string[]): Promise<AxiosResponse<any>>;
@@ -42,6 +42,11 @@ export default class Project extends PlatformBaseClient {
      * @param uuid Invite UUID
      */
     acceptInvite(uuid: string): Promise<AxiosResponse<any>>;
+    /**
+     * Revoke an invite
+     * @param uuid Invite UUID
+     */
+    revokeInvite(uuid: string): Promise<AxiosResponse<any>>;
     /**
      * Register through an invite
      * @param uuid Invite UUID

package/dist/v0.9/api/roles.d.ts

@@ -0,0 +1,12 @@
+import BaseClient from "./baseClient";
+/**
+ * Deprecation notice: The Roles API is deprecated and will be removed in future versions.
+ * Please use the Users API for role and permission management.
+ */
+export default class Roles extends BaseClient {
+    create(role: any): Promise<any>;
+    delete(uuid: string): Promise<any>;
+    list(): Promise<any>;
+    listPermissions(): Promise<any>;
+    edit(permissions: string[], workspaces: string[], level: number, uuid: string): Promise<any>;
+}

package/dist/v0.9/index.cjs.js

@@ -18993,7 +18993,6 @@ const isSandbox = typeof window !== "undefined";
  *
  * @class PlatformBaseClient
  * @extends BaseClient
- * @constructor
  * @param {AxiosInstance} [client] - The axios instance to use for the client
  *
  * @example
@@ -19025,7 +19024,7 @@ class PlatformBaseClient extends BaseClient {
                 }
             }
         }
-        else if (isNode) {
+        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;
@@ -19443,8 +19442,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
@@ -19959,7 +19957,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) {
@@ -19985,6 +19983,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
@@ -20224,7 +20229,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;
@@ -20921,18 +20926,135 @@ class DMS extends IntegrationsBaseClient {
     }
 }
 
+/**
+ * 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"
+ *
+ * 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.
+     *
+     * @param input - The email content and recipients
+     * @returns The queued email's message ID and status
+     */
+    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
+     */
+    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
+     */
+    async get(messageId) {
+        const { data } = await this.client.get(`/protokol-mail/v1/emails/${messageId}`);
+        return data;
+    }
+    /**
+     * Resend a previously failed email.
+     *
+     * @param messageId - The UUID of the email to resend
+     * @returns Confirmation with the message ID
+     */
+    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
+     */
+    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
+     */
+    async downloadAttachment(messageId, attachmentId) {
+        const { data } = await this.client.get(`/protokol-mail/v1/emails/${messageId}/attachments/${attachmentId}`, { responseType: "arraybuffer" });
+        return data;
+    }
+}
+
 class SerbiaUtil extends IntegrationsBaseClient {
     async nbsSearch(params) {
-        return await this.services("GET", "nbs/search", { 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 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");
     }
@@ -21745,6 +21867,7 @@ class Integrations extends IntegrationsBaseClient {
             'protokol-invoicing': new Invoicing().setClient(this.client),
             'protokol-vpfr': new VPFR().setClient(this.client),
             'protokol-dms': new DMS().setClient(this.client),
+            'protokol-mail': new Mail().setClient(this.client),
             'serbia-utilities': new SerbiaUtil().setClient(this.client),
             'protokol-payments': new Payments().setClient(this.client),
             'protokol-minimax': new Minimax().setClient(this.client),
@@ -21762,6 +21885,9 @@ class Integrations extends IntegrationsBaseClient {
     getInvoicing() {
         return this.getInterfaceOf('protokol-invoicing');
     }
+    getMail() {
+        return this.getInterfaceOf('protokol-mail');
+    }
     getPayments() {
         return this.getInterfaceOf('protokol-payments');
     }
@@ -21797,6 +21923,7 @@ exports.Functions = Functions;
 exports.Integration = Integrations;
 exports.Integrations = Integrations;
 exports.Invoicing = Invoicing;
+exports.Mail = Mail;
 exports.Payments = Payments;
 exports.Platform = Platform;
 exports.Project = Project;