@ptkl/sdk 0.9.8 → 0.9.10

package/dist/index.iife.js

@@ -35,24 +35,23 @@ var ProtokolSDK09 = (function (exports, axios) {
      */
     class PlatformBaseClient extends BaseClient {
         constructor(options) {
-            var _a, _b;
+            var _a, _b, _c;
             let { env = null, token = null, host = null, } = options !== null && options !== void 0 ? options : {};
             let headers = {};
             var project_uuid = null;
             if (isBrowser) {
-                console.log("DEBUG", sessionStorage.getItem('protokol_context'));
+                console.log("PlatformBaseClient: running in browser context");
                 if (sessionStorage.getItem('protokol_context') == "forge") {
                     headers['X-Project-Env'] = (_a = sessionStorage.getItem('forge_app_env')) !== null && _a !== void 0 ? _a : "dev";
                 }
                 else {
-                    // this potentially means that it is running as dev server in local
-                    headers['X-Project-Env'] = "dev";
+                    headers['X-Project-Env'] = (_b = localStorage.getItem('current_env')) !== null && _b !== void 0 ? _b : "dev";
                 }
             }
             if (typeof window !== "undefined") {
                 // @ts-ignore
                 const __global_env__ = window === null || window === void 0 ? void 0 : window.__ENV_VARIABLES__;
-                host = (_b = __global_env__ === null || __global_env__ === void 0 ? void 0 : __global_env__.API_HOST) !== null && _b !== void 0 ? _b : host;
+                host = (_c = __global_env__ === null || __global_env__ === void 0 ? void 0 : __global_env__.API_HOST) !== null && _c !== void 0 ? _c : 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;
@@ -213,11 +212,7 @@ var ProtokolSDK09 = (function (exports, axios) {
         }
         async upload(formData) {
             return await this.client.post(`/v3/system/gateway/app-service/${this.appType}/upload`, formData, {
-                timeout: 60000,
-                headers: {
-                    // set form data headers
-                    'Content-Type': 'multipart/form-data'
-                }
+                timeout: 60000
             });
         }
     }
@@ -518,6 +513,9 @@ var ProtokolSDK09 = (function (exports, axios) {
         async trigger(id, event, data) {
             return await this.client.post(`/v1/project/workflow/workflow/${id}/event/${event}`, data);
         }
+        async publish(event, data) {
+            return await this.client.post(`/v1/project/workflow/workflow/event/${event}`, data);
+        }
     }
 
     class Forge extends PlatformBaseClient {
@@ -617,7 +615,7 @@ var ProtokolSDK09 = (function (exports, axios) {
 
     class IntegrationsBaseClient extends BaseClient {
         constructor(options) {
-            var _a, _b;
+            var _a, _b, _c;
             let { env = null, token, host, } = options !== null && options !== void 0 ? options : {};
             let headers = {};
             var project_uuid = null;
@@ -626,14 +624,13 @@ var ProtokolSDK09 = (function (exports, axios) {
                     headers['X-Project-Env'] = (_a = sessionStorage.getItem('forge_app_env')) !== null && _a !== void 0 ? _a : "dev";
                 }
                 else {
-                    // this potentially means that it is running as dev server in local
-                    headers['X-Project-Env'] = "dev";
+                    headers['X-Project-Env'] = (_b = localStorage.getItem('current_env')) !== null && _b !== void 0 ? _b : "dev";
                 }
             }
             if (typeof window !== "undefined") {
                 // @ts-ignore
                 const __global_env__ = window === null || window === void 0 ? void 0 : window.__ENV_VARIABLES__;
-                host = (_b = __global_env__.INTEGRATION_API) !== null && _b !== void 0 ? _b : host;
+                host = (_c = __global_env__.INTEGRATION_API) !== null && _c !== void 0 ? _c : host;
                 // @ts-ignore
                 token = token !== null && token !== void 0 ? token : __global_env__ === null || __global_env__ === void 0 ? void 0 : __global_env__.PROJECT_API_TOKEN;
                 // @ts-ignore
@@ -661,6 +658,85 @@ var ProtokolSDK09 = (function (exports, axios) {
         }
     }
 
+    /**
+     * Document Management System (DMS) API client
+     *
+     * Provides comprehensive document and media management capabilities including:
+     * - File upload, download, and management
+     * - PDF generation and form filling
+     * - Data conversion between JSON, CSV, and Excel formats
+     * - Media processing and EXIF data extraction
+     *
+     * ## Data Conversion Features
+     *
+     * The DMS class includes powerful data conversion capabilities that allow you to:
+     * - Convert between JSON, CSV, and Excel (.xlsx) formats
+     * - Handle structured data with header, items, and footer sections
+     * - Auto-detect structured patterns in JSON arrays
+     * - Validate data format integrity
+     * - Analyze data structure and metadata
+     * - Handle large datasets with memory-efficient processing
+     *
+     * ### Supported Formats
+     * - **JSON**: Array of objects (recommended for tabular data) or structured objects
+     * - **CSV**: Comma-separated values with headers and optional comments
+     * - **Excel**: .xlsx format with optional sheet specification
+     *
+     * ### Structured Data Support
+     * When converting from JSON, the API supports:
+     *
+     * **Explicit Structure**: JSON with dedicated sections
+     * ```json
+     * {
+     *   "header": { "content": { "title": "Report" } },
+     *   "items": [{ "name": "Data" }],
+     *   "footer": { "content": { "total": 100 } }
+     * }
+     * ```
+     *
+     * **Auto-Detection**: Mixed arrays with metadata and summary objects
+     * ```json
+     * [
+     *   { "metadata": "Header info" },
+     *   { "name": "John", "age": 30 },
+     *   { "summary": "Footer info" }
+     * ]
+     * ```
+     *
+     * ### Error Handling
+     * All conversion methods may throw errors with code 3003 for conversion failures.
+     * Always wrap calls in try-catch blocks for production use.
+     *
+     * @example
+     * ```typescript
+     * import { DMS } from 'protokol-sdk';
+     *
+     * const dms = new DMS({
+     *   token: 'your-bearer-token',
+     *   host: 'http://localhost:8086'
+     * });
+     *
+     * const libraryRef = 'your-library-uuid';
+     *
+     * // Convert structured JSON to CSV with comments
+     * const structuredData = {
+     *   header: { content: { title: "Sales Report" } },
+     *   items: [{ product: "Widget", sales: 100 }],
+     *   footer: { content: { total: 100 } }
+     * };
+     *
+     * try {
+     *   const csvResult = await dms.convertData(libraryRef, structuredData, {
+     *     from: 'json',
+     *     to: 'csv',
+     *     header_as_comment: true
+     *   });
+     *   console.log(csvResult.data); // CSV with header as comments
+     * } catch (error) {
+     *   console.error('Conversion failed:', error.message);
+     * }
+     * ```
+     */
     class DMS extends IntegrationsBaseClient {
         async list(data) {
             return this.request('POST', 'media/list', { data });
@@ -757,18 +833,16 @@ var ProtokolSDK09 = (function (exports, axios) {
             return await this.request("POST", `media/library/${lib}/dirs`, { data });
         }
         async fillPdf(lib, data) {
-            const { input_html, input_path, output_path, output_pdf = false, output_type, output_file_name, data: templateData, form_data, forms } = data;
+            const { input_path, output_path, output_pdf = false, output_type, output_file_name, form_data, forms } = data;
             const responseType = output_pdf ? 'arraybuffer' : 'json';
             const contentType = output_pdf ? 'application/pdf' : 'application/json';
             return this.request('POST', `media/library/${lib}/pdf/fill`, {
                 data: {
-                    input_html,
                     input_path,
                     output_path,
                     output_pdf,
                     output_type,
                     output_file_name,
-                    data: templateData,
                     form_data,
                     forms
                 },
@@ -778,10 +852,456 @@ var ProtokolSDK09 = (function (exports, axios) {
                 responseType
             });
         }
+        // ===================================================================
+        // Data Converter Methods
+        // ===================================================================
+        // 
+        // The following methods provide comprehensive data conversion capabilities
+        // between JSON, CSV, and Excel formats, along with validation and analysis tools.
+        // All methods require a valid library reference UUID and return AxiosResponse objects.
+        //
+        /**
+         * Convert data between different formats (JSON, CSV, Excel)
+         *
+         * Supports structured data when converting from JSON format with:
+         * - 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
+         *
+         * @example
+         * ```typescript
+         * // Convert JSON to CSV
+         * const jsonData = [
+         *   { name: "John Doe", age: 30, email: "john@example.com" },
+         *   { name: "Jane Smith", age: 25, email: "jane@example.com" }
+         * ];
+         *
+         * const csvResult = await dms.convertData(libraryRef, jsonData, {
+         *   from: 'json',
+         *   to: 'csv'
+         * });
+         * console.log(csvResult.data); // CSV string
+         *
+         * // Convert structured JSON with header as comments
+         * const structuredData = {
+         *   header: {
+         *     content: {
+         *       report_title: "Monthly Sales Report",
+         *       generated_by: "Sales System"
+         *     }
+         *   },
+         *   items: [
+         *     { product: "Widget A", sales: 100 },
+         *     { product: "Widget B", sales: 150 }
+         *   ],
+         *   footer: {
+         *     content: {
+         *       total_sales: 250
+         *     }
+         *   }
+         * };
+         *
+         * const csvWithComments = await dms.convertData(libraryRef, structuredData, {
+         *   from: 'json',
+         *   to: 'csv',
+         *   header_as_comment: true,
+         *   separator_rows: 2
+         * });
+         *
+         * // Convert JSON to Excel with custom sheet name
+         * const excelResult = await dms.convertData(libraryRef, jsonData, {
+         *   from: 'json',
+         *   to: 'excel',
+         *   sheet_name: 'Customer Data'
+         * });
+         * // excelResult.data is a Blob
+         * ```
+         */
+        async convertData(lib, data, params) {
+            const { from, to, sheet_name, include_header, include_footer, header_as_comment, footer_as_comment, separator_rows } = params;
+            const queryParams = { from, to };
+            // Add optional parameters if provided
+            if (sheet_name)
+                queryParams.sheet_name = sheet_name;
+            if (include_header !== undefined)
+                queryParams.include_header = include_header;
+            if (include_footer !== undefined)
+                queryParams.include_footer = include_footer;
+            if (header_as_comment !== undefined)
+                queryParams.header_as_comment = header_as_comment;
+            if (footer_as_comment !== undefined)
+                queryParams.footer_as_comment = footer_as_comment;
+            if (separator_rows !== undefined)
+                queryParams.separator_rows = separator_rows;
+            // Determine content type based on target format
+            let responseType = 'text';
+            if (to === 'json') {
+                responseType = 'json';
+            }
+            else if (to === 'excel' || to === 'xlsx') {
+                responseType = 'blob';
+            }
+            return this.request('POST', `media/library/${lib}/convert/data`, {
+                data,
+                params: queryParams,
+                responseType,
+                headers: {
+                    'Content-Type': 'application/json'
+                }
+            });
+        }
+        /**
+         * 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
+         *
+         * @example
+         * ```typescript
+         * const jsonData = [
+         *   { name: "John", age: 30, email: "john@example.com" },
+         *   { name: "Jane", age: 25, email: "jane@example.com" }
+         * ];
+         *
+         * const dataInfo = await dms.getDataInfo(libraryRef, jsonData, {
+         *   format: 'json'
+         * });
+         *
+         * console.log(dataInfo.data);
+         * // Output:
+         * // {
+         * //   format: "json",
+         * //   size_bytes: 245,
+         * //   record_count: 2,
+         * //   field_count: 3,
+         * //   fields: ["name", "age", "email"],
+         * //   library_ref: "98bee1cb-0f21-4582-a832-7c32b4b61831"
+         * // }
+         * ```
+         */
+        async getDataInfo(lib, data, params) {
+            const { format } = params;
+            return this.request('POST', `media/library/${lib}/convert/info`, {
+                data,
+                params: { format },
+                headers: {
+                    'Content-Type': 'application/json'
+                }
+            });
+        }
+        /**
+         * 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
+         *
+         * @example
+         * ```typescript
+         * const jsonData = [{ name: "John", age: 30 }];
+         *
+         * const validation = await dms.validateData(libraryRef, jsonData, {
+         *   format: 'json'
+         * });
+         *
+         * console.log(validation.data);
+         * // Output:
+         * // {
+         * //   valid: true,
+         * //   message: "Data is valid JSON format",
+         * //   library_ref: "98bee1cb-0f21-4582-a832-7c32b4b61831"
+         * // }
+         *
+         * // Handle invalid data
+         * try {
+         *   const invalidValidation = await dms.validateData(libraryRef, "invalid json", {
+         *     format: 'json'
+         *   });
+         * } catch (error) {
+         *   console.error('Validation failed:', error.response?.data?.message);
+         * }
+         * ```
+         */
+        async validateData(lib, data, params) {
+            const { format } = params;
+            return this.request('POST', `media/library/${lib}/convert/validate`, {
+                data,
+                params: { format },
+                headers: {
+                    'Content-Type': 'application/json'
+                }
+            });
+        }
+        /**
+         * Convert JSON data to CSV format
+         *
+         * This method supports both regular JSON arrays and structured data with auto-detection:
+         * - 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
+         *
+         * @example
+         * ```typescript
+         * // Regular JSON to CSV
+         * const jsonData = [
+         *   { name: "John Doe", age: 30, email: "john@example.com" },
+         *   { name: "Jane Smith", age: 25, email: "jane@example.com" }
+         * ];
+         *
+         * const csvResponse = await dms.jsonToCsv(libraryRef, jsonData);
+         * console.log(csvResponse.data);
+         * // Output:
+         * // name,age,email
+         * // John Doe,30,john@example.com
+         * // Jane Smith,25,jane@example.com
+         *
+         * // Structured JSON with auto-detection
+         * const structuredData = [
+         *   { metadata: "EMPLOYEE REPORT\nGenerated: 2025-10-08" },
+         *   { name: "John Doe", age: 30, position: "Developer" },
+         *   { name: "Jane Smith", age: 25, position: "Designer" },
+         *   { name: "Total Employees:", age: null, position: "2 people" }
+         * ];
+         *
+         * const structuredCsv = await dms.jsonToCsv(libraryRef, structuredData);
+         * // Auto-detects header, items, and footer sections
+         * ```
+         */
+        async jsonToCsv(lib, jsonData) {
+            return this.request('POST', `media/library/${lib}/convert/json-to-csv`, {
+                data: jsonData,
+                responseType: 'text',
+                headers: {
+                    'Content-Type': 'application/json'
+                }
+            });
+        }
+        /**
+         * Convert JSON data to Excel (.xlsx) format
+         *
+         * 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
+         *
+         * @example
+         * ```typescript
+         * // Regular JSON to Excel
+         * const jsonData = [
+         *   { name: "John Doe", age: 30, email: "john@example.com" },
+         *   { name: "Jane Smith", age: 25, email: "jane@example.com" }
+         * ];
+         *
+         * // Basic conversion
+         * const excelResponse = await dms.jsonToExcel(libraryRef, jsonData);
+         * const blob = excelResponse.data; // Blob for download
+         *
+         * // With custom sheet name
+         * const excelWithOptions = await dms.jsonToExcel(libraryRef, jsonData, {
+         *   sheet_name: 'Customer Data'
+         * });
+         *
+         * // Structured data with explicit sections
+         * const structuredData = {
+         *   header: { content: { title: "Monthly Report" } },
+         *   items: [{ product: "Widget A", sales: 100 }],
+         *   footer: { content: { total_sales: 100 } }
+         * };
+         *
+         * const structuredExcel = await dms.jsonToExcel(libraryRef, structuredData);
+         *
+         * // Create download link
+         * const url = URL.createObjectURL(structuredExcel.data);
+         * const link = document.createElement('a');
+         * link.href = url;
+         * link.download = 'report.xlsx'; // Always .xlsx extension
+         * link.click();
+         * ```
+         */
+        async jsonToExcel(lib, jsonData, options) {
+            const params = {};
+            if (options === null || options === void 0 ? void 0 : options.sheet_name) {
+                params.sheet_name = options.sheet_name;
+            }
+            return this.request('POST', `media/library/${lib}/convert/json-to-excel`, {
+                data: jsonData,
+                params,
+                responseType: 'blob',
+                headers: {
+                    'Content-Type': 'application/json'
+                }
+            });
+        }
+        /**
+         * 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
+         *
+         * @example
+         * ```typescript
+         * const csvString = `name,age,email
+         * John Doe,30,john@example.com
+         * Jane Smith,25,jane@example.com`;
+         *
+         * const jsonResponse = await dms.csvToJson(libraryRef, csvString);
+         * console.log(jsonResponse.data);
+         * // Output:
+         * // [
+         * //   { name: "John Doe", age: "30", email: "john@example.com" },
+         * //   { name: "Jane Smith", age: "25", email: "jane@example.com" }
+         * // ]
+         * ```
+         */
+        async csvToJson(lib, csvData) {
+            return this.request('POST', `media/library/${lib}/convert/csv-to-json`, {
+                data: csvData,
+                responseType: 'json',
+                headers: {
+                    'Content-Type': 'text/csv'
+                }
+            });
+        }
+        /**
+         * 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
+         *
+         * @example
+         * ```typescript
+         * const csvString = `name,age,email
+         * John Doe,30,john@example.com
+         * Jane Smith,25,jane@example.com`;
+         *
+         * const excelResponse = await dms.csvToExcel(libraryRef, csvString, {
+         *   sheet_name: 'Imported Data'
+         * });
+         *
+         * // Handle the Excel blob
+         * const blob = excelResponse.data;
+         * const url = URL.createObjectURL(blob);
+         * // Use url for download or further processing
+         * ```
+         */
+        async csvToExcel(lib, csvData, options) {
+            const params = {};
+            if (options === null || options === void 0 ? void 0 : options.sheet_name) {
+                params.sheet_name = options.sheet_name;
+            }
+            return this.request('POST', `media/library/${lib}/convert/csv-to-excel`, {
+                data: csvData,
+                params,
+                responseType: 'blob',
+                headers: {
+                    'Content-Type': 'text/csv'
+                }
+            });
+        }
+        /**
+         * 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
+         *
+         * @example
+         * ```typescript
+         * // From file input
+         * const fileInput = document.querySelector('input[type="file"]');
+         * const file = fileInput.files[0]; // Excel file
+         *
+         * const jsonResponse = await dms.excelToJson(libraryRef, file, {
+         *   sheet_name: 'Sheet1' // optional, defaults to first sheet
+         * });
+         *
+         * console.log(jsonResponse.data);
+         * // Output: JSON array with data from Excel sheet
+         *
+         * // From ArrayBuffer
+         * const arrayBuffer = await file.arrayBuffer();
+         * const jsonFromBuffer = await dms.excelToJson(libraryRef, arrayBuffer);
+         * ```
+         */
+        async excelToJson(lib, excelData, options) {
+            const params = {};
+            if (options === null || options === void 0 ? void 0 : options.sheet_name) {
+                params.sheet_name = options.sheet_name;
+            }
+            return this.request('POST', `media/library/${lib}/convert/excel-to-json`, {
+                data: excelData,
+                params,
+                responseType: 'json',
+                headers: {
+                    'Content-Type': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+                }
+            });
+        }
+        /**
+         * 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
+         *
+         * @example
+         * ```typescript
+         * // From file input
+         * const fileInput = document.querySelector('input[type="file"]');
+         * const file = fileInput.files[0]; // Excel file
+         *
+         * const csvResponse = await dms.excelToCsv(libraryRef, file, {
+         *   sheet_name: 'Data' // optional, defaults to first sheet
+         * });
+         *
+         * console.log(csvResponse.data);
+         * // Output: CSV string with data from Excel sheet
+         *
+         * // Save as CSV file
+         * const csvBlob = new Blob([csvResponse.data], { type: 'text/csv' });
+         * const url = URL.createObjectURL(csvBlob);
+         * const link = document.createElement('a');
+         * link.href = url;
+         * link.download = 'converted.csv';
+         * link.click();
+         * ```
+         */
+        async excelToCsv(lib, excelData, options) {
+            const params = {};
+            if (options === null || options === void 0 ? void 0 : options.sheet_name) {
+                params.sheet_name = options.sheet_name;
+            }
+            return this.request('POST', `media/library/${lib}/convert/excel-to-csv`, {
+                data: excelData,
+                params,
+                responseType: 'text',
+                headers: {
+                    'Content-Type': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+                }
+            });
+        }
         async request(method, endpoint, params) {
             return await this.client.request({
                 method: method,
-                url: `/v2/dms/${endpoint}`,
+                url: `/v2/${endpoint}`,
                 ...params
             });
         }
@@ -855,7 +1375,7 @@ var ProtokolSDK09 = (function (exports, axios) {
             this.integrations = {
                 'protokol-invoicing': new Invoicing().setClient(this.client),
                 'protokol-vpfr': new VPFR().setClient(this.client),
-                'protokol-media': new DMS().setClient(this.client),
+                'protokol-dms': new DMS().setClient(this.client),
                 'serbia-utilities': new SerbiaUtil().setClient(this.client),
                 'protokol-payments': new Payments().setClient(this.client),
             };
@@ -864,7 +1384,7 @@ var ProtokolSDK09 = (function (exports, axios) {
             return this.getInterfaceOf('serbia-utilities');
         }
         getDMS() {
-            return this.getInterfaceOf('protokol-media');
+            return this.getInterfaceOf('protokol-dms');
         }
         getVPFR() {
             return this.getInterfaceOf('protokol-vpfr');
@@ -893,12 +1413,12 @@ var ProtokolSDK09 = (function (exports, axios) {
     exports.Apps = Apps;
     exports.Component = Component;
     exports.ComponentUtils = ComponentUtils;
+    exports.DMS = DMS;
     exports.Forge = Forge;
     exports.Functions = Functions;
     exports.Integration = Integrations;
     exports.Integrations = Integrations;
     exports.Invoicing = Invoicing;
-    exports.Media = DMS;
     exports.Payments = Payments;
     exports.Ratchet = Ratchet;
     exports.Roles = Roles;