@truto/truto-jsonata 1.0.44 → 1.0.46

package/README.md

@@ -829,6 +829,81 @@ expression.evaluate({}).then(result => { console.log(result); });
 
 </details>
 
+<details>
+<summary> jsonToCsv(json, options)</summary>
+
+Converts an array of JSON objects to CSV format. Uses the [@json2csv/plainjs](https://juanjodiaz.github.io/json2csv/#/parsers/parser) library for conversion.
+
+**Parameters:**
+
+- **json**: An array of objects (or a single object) to convert to CSV. Null and undefined values are automatically filtered out.
+- **options** _(Optional)_: Configuration options for the CSV parser. Supports all options from `@json2csv/plainjs`, including:
+  - **delimiter**: Custom delimiter (default: `','`)
+  - **header**: Include/exclude header row (default: `true`)
+  - **fields**: Array of field objects with `label` and `value` properties for custom headers
+  - See [@json2csv/plainjs documentation](https://juanjodiaz.github.io/json2csv/#/parsers/parser?id=parameters) for all available options
+
+**Example:**
+
+```javascript
+import trutoJsonata from '@truto/truto-jsonata';
+
+// Example 1: Basic conversion
+const data = [
+  { name: 'John', age: 30, city: 'New York' },
+  { name: 'Jane', age: 25, city: 'Los Angeles' }
+];
+const expression = trutoJsonata("$jsonToCsv(data, {})");
+expression.evaluate({ data }).then(result => { 
+  console.log(result); 
+  // Output: "name","age","city"
+  //         "John",30,"New York"
+  //         "Jane",25,"Los Angeles"
+});
+
+// Example 2: Custom delimiter
+const expression2 = trutoJsonata("$jsonToCsv(data, { delimiter: ';' })");
+expression2.evaluate({ data }).then(result => { 
+  console.log(result); 
+  // Output: "name";"age";"city"
+  //         "John";30;"New York"
+  //         "Jane";25;"Los Angeles"
+});
+
+// Example 3: Custom headers
+const options = {
+  fields: [
+    { label: 'Full Name', value: 'name' },
+    { label: 'Years', value: 'age' }
+  ]
+};
+const expression3 = trutoJsonata("$jsonToCsv(data, options)");
+expression3.evaluate({ data, options }).then(result => { 
+  console.log(result); 
+  // Output: "Full Name","Years"
+  //         "John",30
+  //         "Jane",25
+});
+
+// Example 4: Without header
+const expression4 = trutoJsonata("$jsonToCsv(data, { header: false })");
+expression4.evaluate({ data }).then(result => { 
+  console.log(result); 
+  // Output: "John",30,"New York"
+  //         "Jane",25,"Los Angeles"
+});
+
+// Example 5: Empty array returns empty string
+const emptyData = [];
+const expression5 = trutoJsonata("$jsonToCsv(emptyData, {})");
+expression5.evaluate({ emptyData }).then(result => { 
+  console.log(result); 
+  // Output: ""
+});
+```
+
+</details>
+
 <details>
 <summary> getMimeType(fileName)</summary>
 
@@ -1532,6 +1607,44 @@ Output:
 
 </details>
 
+<details>
+<summary>convertMdToPdf(markdown, options = { title: '', pageSize: 'a4', embedImages: false, pageMargins: [40, 60, 40, 60], defaultStyle: { fontSize: 12, lineHeight: 1.4 } })</summary>
+
+Converts Markdown text to a PDF `Blob` using jsPDF.
+
+**Example:**
+
+```javascript
+import trutoJsonata from '@truto/truto-jsonata'
+
+const markdown = `# Title\n\nThis is a paragraph.`
+const expression = trutoJsonata("$convertMdToPdf(markdown)")
+expression.evaluate({ markdown }).then(blob => {
+  console.log(blob) // Blob { type: 'application/pdf' }
+})
+```
+
+**Options:**
+- `title`: Optional document title
+- `pageSize`: jsPDF page size (e.g., `'a4'`, `'LETTER'`)
+- `embedImages`: Reserved for future use
+- `pageMargins`: `[left, top, right, bottom]` in points
+- `defaultStyle`: `{ fontSize: number, lineHeight: number }`
+
+If your transport requires a JSON-serializable value, convert the PDF Blob to a data URI string and decode it later:
+
+```javascript
+import trutoJsonata from '@truto/truto-jsonata'
+
+const markdown = `# Report\nGenerated content`
+const expr = trutoJsonata("$getDataUri($convertMdToPdf(markdown), 'application/pdf')")
+expr.evaluate({ markdown }).then(dataUri => {
+  // dataUri starts with 'data:application/pdf;base64,'
+  console.log(typeof dataUri, dataUri.startsWith('data:application/pdf;base64,'))
+})
+```
+</details>
+
 ---  
 
 ### Array and Object Utilities (Lodash Enhancements)