@ptkl/sdk 0.9.9 → 0.9.10

package/dist/index.cjs.js

@@ -19180,11 +19180,7 @@ class Apps extends PlatformBaseClient {
     }
     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
         });
     }
 }
@@ -19643,15 +19639,38 @@ class IntegrationsBaseClient extends BaseClient {
  *
  * 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)
- * - **CSV**: Comma-separated values with headers
+ * - **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.
@@ -19667,15 +19686,20 @@ class IntegrationsBaseClient extends BaseClient {
  *
  * const libraryRef = 'your-library-uuid';
  *
- * // Convert JSON to CSV
- * const jsonData = [
- *   { name: "John", age: 30 },
- *   { name: "Jane", age: 25 }
- * ];
+ * // 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.jsonToCsv(libraryRef, jsonData);
- *   console.log(csvResult.data); // CSV string
+ *   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);
  * }
@@ -19777,18 +19801,16 @@ class DMS extends IntegrationsBaseClient {
         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
             },
@@ -19809,9 +19831,13 @@ class DMS extends IntegrationsBaseClient {
     /**
      * 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
+     * @param params - Conversion parameters including structured data options
      * @returns Promise resolving to converted data
      *
      * @example
@@ -19828,6 +19854,32 @@ class DMS extends IntegrationsBaseClient {
      * });
      * 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',
@@ -19838,11 +19890,21 @@ class DMS extends IntegrationsBaseClient {
      * ```
      */
     async convertData(lib, data, params) {
-        const { from, to, sheet_name } = params;
+        const { from, to, sheet_name, include_header, include_footer, header_as_comment, footer_as_comment, separator_rows } = params;
         const queryParams = { from, to };
-        if (sheet_name) {
+        // 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') {
@@ -19948,12 +20010,17 @@ class DMS extends IntegrationsBaseClient {
     /**
      * 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 recommended for tabular data)
+     * @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" }
@@ -19965,6 +20032,17 @@ class DMS extends IntegrationsBaseClient {
      * // 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) {
@@ -19979,13 +20057,17 @@ class DMS extends IntegrationsBaseClient {
     /**
      * 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 recommended for tabular data)
+     * @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" }
@@ -20000,11 +20082,20 @@ class DMS extends IntegrationsBaseClient {
      *   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(excelWithOptions.data);
+     * const url = URL.createObjectURL(structuredExcel.data);
      * const link = document.createElement('a');
      * link.href = url;
-     * link.download = 'data.xlsx';
+     * link.download = 'report.xlsx'; // Always .xlsx extension
      * link.click();
      * ```
      */
@@ -20178,7 +20269,7 @@ class DMS extends IntegrationsBaseClient {
     async request(method, endpoint, params) {
         return await this.client.request({
             method: method,
-            url: `/v2/dms/${endpoint}`,
+            url: `/v2/${endpoint}`,
             ...params
         });
     }
@@ -20252,7 +20343,7 @@ class Integrations extends IntegrationsBaseClient {
         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),
         };
@@ -20261,7 +20352,7 @@ class Integrations extends IntegrationsBaseClient {
         return this.getInterfaceOf('serbia-utilities');
     }
     getDMS() {
-        return this.getInterfaceOf('protokol-media');
+        return this.getInterfaceOf('protokol-dms');
     }
     getVPFR() {
         return this.getInterfaceOf('protokol-vpfr');
@@ -20290,12 +20381,12 @@ exports.APIUser = APIUser;
 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;

package/dist/index.esm.js

@@ -211,11 +211,7 @@ class Apps extends PlatformBaseClient {
     }
     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
         });
     }
 }
@@ -674,15 +670,38 @@ class IntegrationsBaseClient extends BaseClient {
  *
  * 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)
- * - **CSV**: Comma-separated values with headers
+ * - **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.
@@ -698,15 +717,20 @@ class IntegrationsBaseClient extends BaseClient {
  *
  * const libraryRef = 'your-library-uuid';
  *
- * // Convert JSON to CSV
- * const jsonData = [
- *   { name: "John", age: 30 },
- *   { name: "Jane", age: 25 }
- * ];
+ * // 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.jsonToCsv(libraryRef, jsonData);
- *   console.log(csvResult.data); // CSV string
+ *   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);
  * }
@@ -808,18 +832,16 @@ class DMS extends IntegrationsBaseClient {
         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
             },
@@ -840,9 +862,13 @@ class DMS extends IntegrationsBaseClient {
     /**
      * 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
+     * @param params - Conversion parameters including structured data options
      * @returns Promise resolving to converted data
      *
      * @example
@@ -859,6 +885,32 @@ class DMS extends IntegrationsBaseClient {
      * });
      * 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',
@@ -869,11 +921,21 @@ class DMS extends IntegrationsBaseClient {
      * ```
      */
     async convertData(lib, data, params) {
-        const { from, to, sheet_name } = params;
+        const { from, to, sheet_name, include_header, include_footer, header_as_comment, footer_as_comment, separator_rows } = params;
         const queryParams = { from, to };
-        if (sheet_name) {
+        // 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') {
@@ -979,12 +1041,17 @@ class DMS extends IntegrationsBaseClient {
     /**
      * 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 recommended for tabular data)
+     * @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" }
@@ -996,6 +1063,17 @@ class DMS extends IntegrationsBaseClient {
      * // 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) {
@@ -1010,13 +1088,17 @@ class DMS extends IntegrationsBaseClient {
     /**
      * 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 recommended for tabular data)
+     * @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" }
@@ -1031,11 +1113,20 @@ class DMS extends IntegrationsBaseClient {
      *   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(excelWithOptions.data);
+     * const url = URL.createObjectURL(structuredExcel.data);
      * const link = document.createElement('a');
      * link.href = url;
-     * link.download = 'data.xlsx';
+     * link.download = 'report.xlsx'; // Always .xlsx extension
      * link.click();
      * ```
      */
@@ -1209,7 +1300,7 @@ class DMS extends IntegrationsBaseClient {
     async request(method, endpoint, params) {
         return await this.client.request({
             method: method,
-            url: `/v2/dms/${endpoint}`,
+            url: `/v2/${endpoint}`,
             ...params
         });
     }
@@ -1283,7 +1374,7 @@ class Integrations extends IntegrationsBaseClient {
         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),
         };
@@ -1292,7 +1383,7 @@ class Integrations extends IntegrationsBaseClient {
         return this.getInterfaceOf('serbia-utilities');
     }
     getDMS() {
-        return this.getInterfaceOf('protokol-media');
+        return this.getInterfaceOf('protokol-dms');
     }
     getVPFR() {
         return this.getInterfaceOf('protokol-vpfr');
@@ -1317,4 +1408,4 @@ class Integrations extends IntegrationsBaseClient {
     }
 }
 
-export { APIUser, Apps, Component, ComponentUtils, Forge, Functions, Integrations as Integration, Integrations, Invoicing, DMS as Media, Payments, Ratchet, Roles, Sandbox, SerbiaUtil, System, Thunder, Users as User, VPFR, Workflow, Platform as default };
+export { APIUser, Apps, Component, ComponentUtils, DMS, Forge, Functions, Integrations as Integration, Integrations, Invoicing, Payments, Ratchet, Roles, Sandbox, SerbiaUtil, System, Thunder, Users as User, VPFR, Workflow, Platform as default };

package/dist/index.iife.js

@@ -212,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
             });
         }
     }
@@ -675,15 +671,38 @@ var ProtokolSDK09 = (function (exports, axios) {
      *
      * 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)
-     * - **CSV**: Comma-separated values with headers
+     * - **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.
@@ -699,15 +718,20 @@ var ProtokolSDK09 = (function (exports, axios) {
      *
      * const libraryRef = 'your-library-uuid';
      *
-     * // Convert JSON to CSV
-     * const jsonData = [
-     *   { name: "John", age: 30 },
-     *   { name: "Jane", age: 25 }
-     * ];
+     * // 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.jsonToCsv(libraryRef, jsonData);
-     *   console.log(csvResult.data); // CSV string
+     *   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);
      * }
@@ -809,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
                 },
@@ -841,9 +863,13 @@ var ProtokolSDK09 = (function (exports, axios) {
         /**
          * 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
+         * @param params - Conversion parameters including structured data options
          * @returns Promise resolving to converted data
          *
          * @example
@@ -860,6 +886,32 @@ var ProtokolSDK09 = (function (exports, axios) {
          * });
          * 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',
@@ -870,11 +922,21 @@ var ProtokolSDK09 = (function (exports, axios) {
          * ```
          */
         async convertData(lib, data, params) {
-            const { from, to, sheet_name } = params;
+            const { from, to, sheet_name, include_header, include_footer, header_as_comment, footer_as_comment, separator_rows } = params;
             const queryParams = { from, to };
-            if (sheet_name) {
+            // 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') {
@@ -980,12 +1042,17 @@ var ProtokolSDK09 = (function (exports, axios) {
         /**
          * 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 recommended for tabular data)
+         * @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" }
@@ -997,6 +1064,17 @@ var ProtokolSDK09 = (function (exports, axios) {
          * // 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) {
@@ -1011,13 +1089,17 @@ var ProtokolSDK09 = (function (exports, axios) {
         /**
          * 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 recommended for tabular data)
+         * @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" }
@@ -1032,11 +1114,20 @@ var ProtokolSDK09 = (function (exports, axios) {
          *   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(excelWithOptions.data);
+         * const url = URL.createObjectURL(structuredExcel.data);
          * const link = document.createElement('a');
          * link.href = url;
-         * link.download = 'data.xlsx';
+         * link.download = 'report.xlsx'; // Always .xlsx extension
          * link.click();
          * ```
          */
@@ -1210,7 +1301,7 @@ var ProtokolSDK09 = (function (exports, axios) {
         async request(method, endpoint, params) {
             return await this.client.request({
                 method: method,
-                url: `/v2/dms/${endpoint}`,
+                url: `/v2/${endpoint}`,
                 ...params
             });
         }
@@ -1284,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),
             };
@@ -1293,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');
@@ -1322,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;

package/dist/monaco.d.ts

@@ -1,3 +1,31 @@
+declare module "@ptkl/sdk" {
+import Platform from './api/platform';
+export { default as Component } from './api/component';
+export { default as Integration } from './api/integrations';
+export { default as Ratchet } from './api/ratchet';
+export { default as Sandbox } from './api/sandbox';
+export { default as System } from './api/system';
+export { default as User } from './api/users';
+export { default as Functions } from './api/functions';
+export { default as APIUser } from './api/apiUser';
+export { default as Roles } from './api/roles';
+export { default as Apps } from './api/apps';
+export { default as Workflow } from './api/workflow';
+export { default as ComponentUtils } from './api/componentUtils';
+export { default as Thunder } from './api/thunder';
+export { default as Forge } from './api/forge';
+export { default as Integrations } from './api/integrations';
+export { default as Payments } from './api/integrations/payments';
+export { default as Invoicing } from './api/integrations/invoicing';
+export { default as DMS } from './api/integrations/dms';
+export { default as SerbiaUtil } from './api/integrations/serbiaUtil';
+export { default as VPFR } from './api/integrations/vpfr';
+export type * from './types/component';
+export type * from './types/integrations';
+export type * from './types/users';
+export default Platform;
+
+}
 
 // Type definitions
 declare type FindParams = {
@@ -111,17 +139,106 @@ declare type PDFFormStructure = {
 declare type PDFOutputType = 'pdf' | 'base64' | 'file';
 
 declare type PDFFillOptions = {
-    input_html?: string;
     input_path?: string;
     output_path?: string;
     output_pdf?: boolean;
     output_type?: PDFOutputType;
     output_file_name?: string;
-    data?: Record<string, any>;
     form_data?: Record<string, any>;
     forms?: PDFFormStructure[] | any;
 };
 
+declare type HTML2PDFOptions = {
+    input_html?: string;
+    input_path?: string;
+    output_path?: string;
+    output_pdf?: boolean;
+    output_type?: PDFOutputType;
+    output_file_name?: string;
+    data?: Record<string, any>;
+};
+
+/**
+ * Supported data formats for conversion operations
+ */
+declare type DataFormat = 'json' | 'csv' | 'excel' | 'xlsx';
+
+/**
+ * Parameters for data conversion between formats
+ */
+declare type DataConversionParams = {
+    /** Source format */
+    from: DataFormat;
+    /** Target format */
+    to: DataFormat;
+    /** Optional Excel sheet name (defaults to "Sheet1") */
+    sheet_name?: string;
+    /** Include header section in output (default: true) */
+    include_header?: boolean;
+    /** Include footer section in output (default: true) */
+    include_footer?: boolean;
+    /** Render header as comments in CSV (default: false) */
+    header_as_comment?: boolean;
+    /** Render footer as comments in CSV (default: false) */
+    footer_as_comment?: boolean;
+    /** Empty rows between sections (default: 1) */
+    separator_rows?: number;
+};
+
+/**
+ * Parameters for data format validation
+ */
+declare type DataValidationParams = {
+    /** Format to validate against */
+    format: DataFormat;
+};
+
+/**
+ * Parameters for data analysis and information extraction
+ */
+declare type DataInfoParams = {
+    /** Format of the data to analyze */
+    format: DataFormat;
+};
+
+/**
+ * Information about analyzed data structure and content
+ */
+declare type DataInfo = {
+    /** Detected or specified format */
+    format: string;
+    /** Size of data in bytes */
+    size_bytes: number;
+    /** Number of records/rows */
+    record_count: number;
+    /** Number of fields/columns */
+    field_count: number;
+    /** Array of field/column names */
+    fields: string[];
+    /** Library reference UUID */
+    library_ref: string;
+};
+
+/**
+ * Result of data format validation
+ */
+declare type DataValidationResult = {
+    /** Whether the data is valid for the specified format */
+    valid: boolean;
+    /** Validation message (success or error details) */
+    message: string;
+    /** Library reference UUID */
+    library_ref: string;
+};
+
+/**
+ * Optional parameters for data conversion operations
+ */
+declare type ConversionOptions = {
+    /** Excel sheet name for read/write operations (defaults to "Sheet1") */
+    sheet_name?: string;
+};
+
 declare interface UserModel {
     uuid: string;
     name: string;
@@ -215,11 +332,20 @@ declare class DMSConstructor extends IntegrationsBaseClientConstructor {
   getMedia(lib: string, key: string, encoding: string): Promise<any>;
   download(lib: string, key: string): Promise<any>;
   getExifData(lib: string, key: string): Promise<any>;
-  html2pdf(lib: string, data: any): Promise<any>;
+  html2pdf(lib: string, data: HTML2PDFOptions): Promise<any>;
   createDir(lib: string, path: string): Promise<any>;
   deleteDir(lib: string, path: string): Promise<any>;
   dirs(lib: string, data: string): Promise<any>;
   fillPdf(lib: string, data: PDFFillOptions): Promise<any>;
+  convertData(lib: string, data: any, params: DataConversionParams): Promise<any>;
+  getDataInfo(lib: string, data: any, params: DataInfoParams): Promise<any>;
+  validateData(lib: string, data: any, params: DataValidationParams): Promise<any>;
+  jsonToCsv(lib: string, jsonData: any): Promise<any>;
+  jsonToExcel(lib: string, jsonData: any, options?: ConversionOptions): Promise<any>;
+  csvToJson(lib: string, csvData: string): Promise<any>;
+  csvToExcel(lib: string, csvData: string, options?: ConversionOptions): Promise<any>;
+  excelToJson(lib: string, excelData: Blob | ArrayBuffer, options?: ConversionOptions): Promise<any>;
+  excelToCsv(lib: string, excelData: Blob | ArrayBuffer, options?: ConversionOptions): Promise<any>;
   request(method: string, endpoint: string, params?: any): Promise<any>;
   requestv1(method: string, endpoint: string, params?: any): Promise<any>;
 }
@@ -393,6 +519,7 @@ declare class VPFRConstructor extends IntegrationsBaseClientConstructor {
 declare class WorkflowConstructor extends PlatformBaseClientConstructor {
   constructor();
   trigger(id: string, event: string, data: any): Promise<any>;
+  publish(event: string, data: any): Promise<any>;
 }
 
 interface ProtokolSDK {
@@ -411,7 +538,7 @@ interface ProtokolSDK {
   Integrations: typeof IntegrationsConstructor;
   Payments: typeof PaymentsConstructor;
   Invoicing: typeof InvoicingConstructor;
-  Media: typeof MediaConstructor;
+  DMS: typeof DMSConstructor;
   SerbiaUtil: typeof SerbiaUtilConstructor;
   VPFR: typeof VPFRConstructor;
 }

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ptkl/sdk",
-  "version": "0.9.8",
+  "version": "0.9.10",
   "scripts": {
     "build": "rollup -c",
     "build:monaco": "npm run build && node scripts/generate-monaco-types.cjs",

package/dist/types/api/integrations/dms.d.ts

@@ -1,6 +1,6 @@
 import IntegrationsBaseClient from "../integrationsBaseClient";
 import { AxiosResponse } from "axios";
-import { PDFFillOptions, DataConversionParams, DataValidationParams, DataInfoParams, DataInfo, DataValidationResult, ConversionOptions } from "../../types/integrations";
+import { PDFFillOptions, DataConversionParams, DataValidationParams, DataInfoParams, DataInfo, DataValidationResult, ConversionOptions, HTML2PDFOptions } from "../../types/integrations";
 /**
  * Document Management System (DMS) API client
  *
@@ -14,15 +14,38 @@ import { PDFFillOptions, DataConversionParams, DataValidationParams, DataInfoPar
  *
  * 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)
- * - **CSV**: Comma-separated values with headers
+ * - **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.
@@ -38,15 +61,20 @@ import { PDFFillOptions, DataConversionParams, DataValidationParams, DataInfoPar
  *
  * const libraryRef = 'your-library-uuid';
  *
- * // Convert JSON to CSV
- * const jsonData = [
- *   { name: "John", age: 30 },
- *   { name: "Jane", age: 25 }
- * ];
+ * // 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.jsonToCsv(libraryRef, jsonData);
- *   console.log(csvResult.data); // CSV string
+ *   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);
  * }
@@ -61,7 +89,7 @@ export default class DMS extends IntegrationsBaseClient {
     getMedia(lib: string, key: string, encoding: string): Promise<AxiosResponse<any, any>>;
     download(lib: string, key: string): Promise<AxiosResponse<any, any>>;
     getExifData(lib: string, key: string): Promise<AxiosResponse<any, any>>;
-    html2pdf(lib: string, data: any): Promise<AxiosResponse<any, any>>;
+    html2pdf(lib: string, data: HTML2PDFOptions): Promise<AxiosResponse<any, any>>;
     createDir(lib: string, path: string): Promise<AxiosResponse<any, any>>;
     deleteDir(lib: string, path: string): Promise<AxiosResponse<any, any>>;
     dirs(lib: string, data: string): Promise<AxiosResponse<any, any>>;
@@ -69,9 +97,13 @@ export default class DMS extends IntegrationsBaseClient {
     /**
      * 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
+     * @param params - Conversion parameters including structured data options
      * @returns Promise resolving to converted data
      *
      * @example
@@ -88,6 +120,32 @@ export default class DMS extends IntegrationsBaseClient {
      * });
      * 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',
@@ -168,12 +226,17 @@ export default class DMS extends IntegrationsBaseClient {
     /**
      * 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 recommended for tabular data)
+     * @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" }
@@ -185,19 +248,34 @@ export default class DMS extends IntegrationsBaseClient {
      * // 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
      * ```
      */
     jsonToCsv(lib: string, jsonData: any): Promise<AxiosResponse<string>>;
     /**
      * 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 recommended for tabular data)
+     * @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" }
@@ -212,11 +290,20 @@ export default class DMS extends IntegrationsBaseClient {
      *   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(excelWithOptions.data);
+     * const url = URL.createObjectURL(structuredExcel.data);
      * const link = document.createElement('a');
      * link.href = url;
-     * link.download = 'data.xlsx';
+     * link.download = 'report.xlsx'; // Always .xlsx extension
      * link.click();
      * ```
      */

package/dist/types/index.d.ts

@@ -16,7 +16,7 @@ export { default as Forge } from './api/forge';
 export { default as Integrations } from './api/integrations';
 export { default as Payments } from './api/integrations/payments';
 export { default as Invoicing } from './api/integrations/invoicing';
-export { default as Media } from './api/integrations/dms';
+export { default as DMS } from './api/integrations/dms';
 export { default as SerbiaUtil } from './api/integrations/serbiaUtil';
 export { default as VPFR } from './api/integrations/vpfr';
 export type * from './types/component';

package/dist/types/types/integrations.d.ts

@@ -42,16 +42,23 @@ export type PDFFormStructure = {
 };
 export type PDFOutputType = 'pdf' | 'base64' | 'file';
 export type PDFFillOptions = {
-    input_html?: string;
     input_path?: string;
     output_path?: string;
     output_pdf?: boolean;
     output_type?: PDFOutputType;
     output_file_name?: string;
-    data?: Record<string, any>;
     form_data?: Record<string, any>;
     forms?: PDFFormStructure[] | any;
 };
+export type HTML2PDFOptions = {
+    input_html?: string;
+    input_path?: string;
+    output_path?: string;
+    output_pdf?: boolean;
+    output_type?: PDFOutputType;
+    output_file_name?: string;
+    data?: Record<string, any>;
+};
 /**
  * Supported data formats for conversion operations
  */
@@ -66,6 +73,16 @@ export type DataConversionParams = {
     to: DataFormat;
     /** Optional Excel sheet name (defaults to "Sheet1") */
     sheet_name?: string;
+    /** Include header section in output (default: true) */
+    include_header?: boolean;
+    /** Include footer section in output (default: true) */
+    include_footer?: boolean;
+    /** Render header as comments in CSV (default: false) */
+    header_as_comment?: boolean;
+    /** Render footer as comments in CSV (default: false) */
+    footer_as_comment?: boolean;
+    /** Empty rows between sections (default: 1) */
+    separator_rows?: number;
 };
 /**
  * Parameters for data format validation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ptkl/sdk",
-  "version": "0.9.9",
+  "version": "0.9.10",
   "scripts": {
     "build": "rollup -c",
     "build:monaco": "npm run build && node scripts/generate-monaco-types.cjs",