nx-json-parser 1.0.0

package/README.md

@@ -0,0 +1,111 @@
+# nx-json-parser
+
+A robust Markdown-to-JSON transformer SDK built on top of `unified`, `remark`, and `remark-gfm`. 
+
+Designed for structured data extraction from LLM outputs and other Markdown-formatted strings.
+
+## Features
+
+- **AST-Based Parsing**: Uses `remark` for reliable, production-grade Markdown parsing (no regex hell).
+- **Table Support**: Automatically converts Markdown tables into arrays of JavaScript objects using `remark-gfm`.
+- **List Support**: Smartly handles lists, converting them to arrays.
+- **Bullet-Style Sections**: Includes a custom plugin to detect and transform bulleted "sections" (e.g., `- Title: Content`) into structured JSON keys.
+- **CamelCase Normalization**: Automatically transforms headings and table headers into `camelCase` keys.
+- **Extensible**: Built on the `unified` ecosystem, allowing for additional plugins (math, frontmatter, etc.).
+
+## Installation
+
+```bash
+npm install nx-json-parser
+```
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import { markdownToJson } from 'nx-json-parser';
+
+const md = `
+# Summary
+The product is a high-performance database.
+
+## Key Features
+- Scalable
+- Secure
+- Fast
+`;
+
+const result = markdownToJson(md);
+/*
+{
+  summary: "The product is a high-performance database.",
+  keyFeatures: ["Scalable", "Secure", "Fast"]
+}
+*/
+```
+
+### Table Support
+
+```typescript
+const md = `
+### Database Performance
+| Metric | Value | Status |
+|--------|-------|--------|
+| Latency| 5ms   | OK     |
+| Throughput | 10k ops/s | High |
+`;
+
+const result = markdownToJson(md);
+/*
+{
+  databasePerformance: [
+    { metric: "Latency", value: "5ms", status: "OK" },
+    { metric: "Throughput", value: "10k ops/s", status: "High" }
+  ]
+}
+*/
+```
+
+### Bullet-Style Sections
+
+LLMs often output sections using bullet points. `nx-json-parser` detects this pattern and treats them as structured keys:
+
+```typescript
+const md = `
+- Short Answer
+The sky appears blue due to Rayleigh scattering.
+
+- Technical Detail
+Short-wavelength light is scattered more strongly by atmospheric gases.
+`;
+
+const result = markdownToJson(md);
+/*
+{
+  shortAnswer: "The sky appears blue due to Rayleigh scattering.",
+  technicalDetail: "Short-wavelength light is scattered more strongly by atmospheric gases."
+}
+*/
+```
+
+## API
+
+### `markdownToJson(markdown: string): any`
+Converts a Markdown string to a JSON object.
+
+### `JSONTransformer`
+The main class for transformation. You can provide a custom `RemarkParser` if needed.
+
+```typescript
+import { JSONTransformer, RemarkParser } from 'nx-json-parser';
+
+const transformer = new JSONTransformer({
+  parser: new RemarkParser()
+});
+const result = transformer.transform(md);
+```
+
+## License
+
+ISC

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './types.js';
+export * from './parser.js';
+export * from './transformer.js';
+/**
+ * Convenience function to transform markdown string to JSON.
+ * @param markdown The markdown string to parse.
+ * @returns A JSON object.
+ */
+export declare function markdownToJson(markdown: string): any;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AAIjC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAGpD"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export * from './types.js';
+export * from './parser.js';
+export * from './transformer.js';
+import { JSONTransformer } from './transformer.js';
+/**
+ * Convenience function to transform markdown string to JSON.
+ * @param markdown The markdown string to parse.
+ * @returns A JSON object.
+ */
+export function markdownToJson(markdown) {
+    const transformer = new JSONTransformer();
+    return transformer.transform(markdown);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC3C,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;IAC1C,OAAO,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC3C,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,8 @@
+import { MarkdownSection } from './types.js';
+export declare class RemarkParser {
+    private processor;
+    parse(markdown: string): MarkdownSection[];
+    private processContent;
+    private tableToArray;
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAI7C,qBAAa,YAAY;IACrB,OAAO,CAAC,SAAS,CAGc;IAE/B,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE;IA0C1C,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,YAAY;CAcvB"}

package/dist/parser.js

@@ -0,0 +1,78 @@
+import { unified } from 'unified';
+import remarkParse from 'remark-parse';
+import remarkGfm from 'remark-gfm';
+import { toString } from 'mdast-util-to-string';
+import { remarkBulletSections } from './plugins/bullet-sections.js';
+import { toCamelCase } from 'nx-helpers';
+export class RemarkParser {
+    processor = unified()
+        .use(remarkParse)
+        .use(remarkGfm)
+        .use(remarkBulletSections);
+    parse(markdown) {
+        const tree = this.processor.runSync(this.processor.parse(markdown));
+        const sections = [];
+        let currentSection = null;
+        let currentNodes = [];
+        const rootChildren = tree.children;
+        for (const node of rootChildren) {
+            if (node.type === 'heading') {
+                if (currentSection) {
+                    currentSection.content = this.processContent(currentNodes);
+                    sections.push(currentSection);
+                }
+                currentSection = {
+                    heading: toString(node).trim(),
+                    content: null,
+                    level: node.depth,
+                    format: 'heading'
+                };
+                currentNodes = [];
+            }
+            else {
+                currentNodes.push(node);
+            }
+        }
+        if (currentSection) {
+            currentSection.content = this.processContent(currentNodes);
+            sections.push(currentSection);
+        }
+        else if (currentNodes.length > 0) {
+            sections.push({
+                heading: 'Root',
+                content: this.processContent(currentNodes),
+                level: 0,
+                format: 'text'
+            });
+        }
+        return sections;
+    }
+    processContent(nodes) {
+        if (nodes.length === 0)
+            return '';
+        if (nodes.length === 1 && nodes[0].type === 'table') {
+            return this.tableToArray(nodes[0]);
+        }
+        if (nodes.length === 1 && nodes[0].type === 'list') {
+            return nodes[0].children.map((item) => toString(item).trim());
+        }
+        return nodes.map(node => {
+            if (node.type === 'table') {
+                return JSON.stringify(this.tableToArray(node));
+            }
+            return toString(node);
+        }).join('\n\n').trim();
+    }
+    tableToArray(tableNode) {
+        const headers = tableNode.children[0].children.map((cell) => toCamelCase(toString(cell).trim()));
+        return tableNode.children.slice(1).map((row) => {
+            const obj = {};
+            row.children.forEach((cell, i) => {
+                const key = headers[i] || `column${i}`;
+                obj[key] = toString(cell).trim();
+            });
+            return obj;
+        });
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"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"}

package/dist/plugins/bullet-sections.d.ts

@@ -0,0 +1,2 @@
+export declare function remarkBulletSections(): (tree: any) => void;
+//# sourceMappingURL=bullet-sections.d.ts.map

package/dist/plugins/bullet-sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bullet-sections.d.ts","sourceRoot":"","sources":["../../src/plugins/bullet-sections.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,KACxB,MAAM,GAAG,UAkFpB"}

package/dist/plugins/bullet-sections.js

@@ -0,0 +1,79 @@
+import { toString } from 'mdast-util-to-string';
+export function remarkBulletSections() {
+    return (tree) => {
+        const children = tree.children;
+        if (!children)
+            return;
+        for (let i = 0; i < children.length; i++) {
+            const node = children[i];
+            if (node.type === 'list' && node.ordered === false) {
+                const items = node.children;
+                if (items.length === 0)
+                    continue;
+                const newRootNodes = [];
+                let currentListItems = [];
+                items.forEach((item, idx) => {
+                    const firstChild = item.children[0];
+                    const text = firstChild ? toString(firstChild) : '';
+                    const lines = text.trim().split('\n');
+                    const firstLine = lines[0]?.trim() || '';
+                    const isShort = firstLine.length > 0 && firstLine.length < 150;
+                    const hasMoreContent = lines.length > 1 || item.children.length > 1;
+                    // Section detection:
+                    // 1. It's short and has more content.
+                    // 2. OR it's short and is followed by a non-short item? (Hard to check here)
+                    // 3. OR it's one of the "known" section keywords.
+                    const keywords = ['answer', 'assumptions', 'unknowns', 'evidence', 'protection', 'control', 'management', 'design', 'logging', 'monitoring', 'backups', 'compliance', 'governance', 'modeling', 'incident', 'vendor', 'changes'];
+                    const isSectionKeyword = keywords.some(k => firstLine.toLowerCase().includes(k));
+                    if (isShort && (hasMoreContent || isSectionKeyword)) {
+                        // Flush existing list items if any
+                        if (currentListItems.length > 0) {
+                            newRootNodes.push({
+                                type: 'list',
+                                ordered: false,
+                                children: [...currentListItems]
+                            });
+                            currentListItems = [];
+                        }
+                        // Add as heading
+                        newRootNodes.push({
+                            type: 'heading',
+                            depth: 2,
+                            children: [{ type: 'text', value: firstLine }]
+                        });
+                        // Add content
+                        if (lines.length > 1) {
+                            newRootNodes.push({
+                                type: 'paragraph',
+                                children: [{ type: 'text', value: lines.slice(1).join('\n').trim() }]
+                            });
+                        }
+                        if (item.children.length > 1) {
+                            newRootNodes.push(...item.children.slice(1));
+                        }
+                    }
+                    else {
+                        currentListItems.push(item);
+                    }
+                });
+                // Flush remaining
+                if (currentListItems.length > 0) {
+                    newRootNodes.push({
+                        type: 'list',
+                        ordered: false,
+                        children: [...currentListItems]
+                    });
+                }
+                if (newRootNodes.length > 0) {
+                    // If we performed any transformation (i.e., we found at least one heading)
+                    const hasHeadings = newRootNodes.some(n => n.type === 'heading');
+                    if (hasHeadings) {
+                        children.splice(i, 1, ...newRootNodes);
+                        i += newRootNodes.length - 1;
+                    }
+                }
+            }
+        }
+    };
+}
+//# sourceMappingURL=bullet-sections.js.map

package/dist/plugins/bullet-sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bullet-sections.js","sourceRoot":"","sources":["../../src/plugins/bullet-sections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,MAAM,UAAU,oBAAoB;IAChC,OAAO,CAAC,IAAS,EAAE,EAAE;QACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;gBACjD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;gBAC5B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;oBAAE,SAAS;gBAEjC,MAAM,YAAY,GAAU,EAAE,CAAC;gBAC/B,IAAI,gBAAgB,GAAU,EAAE,CAAC;gBAEjC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAS,EAAE,GAAW,EAAE,EAAE;oBACrC,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;oBACpC,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACtC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;oBAEzC,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,GAAG,GAAG,CAAC;oBAC/D,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;oBAEpE,qBAAqB;oBACrB,sCAAsC;oBACtC,6EAA6E;oBAC7E,kDAAkD;oBAClD,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;oBACjO,MAAM,gBAAgB,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;oBAEjF,IAAI,OAAO,IAAI,CAAC,cAAc,IAAI,gBAAgB,CAAC,EAAE,CAAC;wBAClD,mCAAmC;wBACnC,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BAC9B,YAAY,CAAC,IAAI,CAAC;gCACd,IAAI,EAAE,MAAM;gCACZ,OAAO,EAAE,KAAK;gCACd,QAAQ,EAAE,CAAC,GAAG,gBAAgB,CAAC;6BAClC,CAAC,CAAC;4BACH,gBAAgB,GAAG,EAAE,CAAC;wBAC1B,CAAC;wBAED,iBAAiB;wBACjB,YAAY,CAAC,IAAI,CAAC;4BACd,IAAI,EAAE,SAAS;4BACf,KAAK,EAAE,CAAC;4BACR,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;yBACjD,CAAC,CAAC;wBAEH,cAAc;wBACd,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BACnB,YAAY,CAAC,IAAI,CAAC;gCACd,IAAI,EAAE,WAAW;gCACjB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;6BACxE,CAAC,CAAC;wBACP,CAAC;wBACD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BAC3B,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;wBACjD,CAAC;oBACL,CAAC;yBAAM,CAAC;wBACJ,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAChC,CAAC;gBACL,CAAC,CAAC,CAAC;gBAEH,kBAAkB;gBAClB,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC9B,YAAY,CAAC,IAAI,CAAC;wBACd,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE,KAAK;wBACd,QAAQ,EAAE,CAAC,GAAG,gBAAgB,CAAC;qBAClC,CAAC,CAAC;gBACP,CAAC;gBAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1B,2EAA2E;oBAC3E,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;oBACjE,IAAI,WAAW,EAAE,CAAC;wBACd,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,YAAY,CAAC,CAAC;wBACvC,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;oBACjC,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC,CAAC;AACN,CAAC"}

package/dist/transformer.d.ts

@@ -0,0 +1,13 @@
+import { RemarkParser } from './parser.js';
+import { ParseResult } from './types.js';
+export interface TransformerOptions {
+    parser?: RemarkParser;
+}
+export declare class JSONTransformer {
+    private parser;
+    constructor(options?: TransformerOptions);
+    transform(markdown: string): ParseResult;
+    private tryParseJson;
+    private parseFlexMd;
+}
+//# sourceMappingURL=transformer.d.ts.map

package/dist/transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.d.ts","sourceRoot":"","sources":["../src/transformer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAAe;gBAEjB,OAAO,GAAE,kBAAuB;IAI5C,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW;IAsCxC,OAAO,CAAC,YAAY;IAoCpB,OAAO,CAAC,WAAW;CA0BtB"}

package/dist/transformer.js

@@ -0,0 +1,99 @@
+import { RemarkParser } from './parser.js';
+import { toCamelCase } from 'nx-helpers';
+export class JSONTransformer {
+    parser;
+    constructor(options = {}) {
+        this.parser = options.parser || new RemarkParser();
+    }
+    transform(markdown) {
+        if (!markdown || typeof markdown !== 'string')
+            return {};
+        const trimmed = markdown.trim();
+        // 1. Handle "Proper JSONs" - First priority
+        const jsonResult = this.tryParseJson(trimmed);
+        if (jsonResult !== null && typeof jsonResult === 'object') {
+            return jsonResult;
+        }
+        // 2. Handle "Proper Flex MDs" (===key blocks)
+        const flexMdResult = this.parseFlexMd(trimmed);
+        if (Object.keys(flexMdResult).length > 0) {
+            return flexMdResult;
+        }
+        // 3. Fallback to Remark Parser (Unified/Remark)
+        const sections = this.parser.parse(markdown);
+        const result = {};
+        sections.forEach(section => {
+            const key = toCamelCase(section.heading);
+            if (result[key]) {
+                if (Array.isArray(result[key])) {
+                    result[key].push(section.content);
+                }
+                else {
+                    result[key] = [result[key], section.content];
+                }
+            }
+            else {
+                result[key] = section.content;
+            }
+        });
+        return result;
+    }
+    tryParseJson(str) {
+        let clean = str.trim();
+        // Handle Markdown code blocks (e.g. ```json ... ```)
+        if (clean.startsWith('```')) {
+            const lines = clean.split('\n');
+            if (lines.length > 1) {
+                // Find the matching end ```
+                let endIdx = -1;
+                for (let i = lines.length - 1; i > 0; i--) {
+                    if (lines[i].trim() === '```') {
+                        endIdx = i;
+                        break;
+                    }
+                }
+                if (endIdx > 0) {
+                    clean = lines.slice(1, endIdx).join('\n').trim();
+                }
+                else {
+                    // No closing block, just strip first line if it looks like header
+                    clean = lines.slice(1).join('\n').trim();
+                }
+            }
+        }
+        // Basic JSON object/array check
+        if ((clean.startsWith('{') && clean.endsWith('}')) || (clean.startsWith('[') && clean.endsWith(']'))) {
+            try {
+                return JSON.parse(clean);
+            }
+            catch (e) {
+                return null;
+            }
+        }
+        return null;
+    }
+    parseFlexMd(text) {
+        const result = {};
+        const regex = /^===\s*([a-zA-Z0-9_-]+)\s*$/gm;
+        const markers = [];
+        let match;
+        while ((match = regex.exec(text)) !== null) {
+            markers.push({
+                key: match[1],
+                nodeStart: match.index,
+                contentStart: match.index + match[0].length
+            });
+        }
+        if (markers.length === 0)
+            return result;
+        for (let i = 0; i < markers.length; i++) {
+            const current = markers[i];
+            const next = markers[i + 1];
+            const nextNodeStart = next ? next.nodeStart : text.length;
+            const content = text.substring(current.contentStart, nextNodeStart).trim();
+            result[toCamelCase(current.key)] = content;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=transformer.js.map

package/dist/transformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.js","sourceRoot":"","sources":["../src/transformer.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,11 @@
+export interface MarkdownSection {
+    heading: string;
+    content: any;
+    level: number;
+    format: 'heading' | 'list' | 'table' | 'text';
+}
+export type ParseResult = Record<string, any>;
+export interface OutputFormatSpec {
+    [key: string]: any;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,GAAG,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;CAC/C;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAE/B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/jest.config.js

@@ -0,0 +1,16 @@
+export default {
+    preset: 'ts-jest/presets/default-esm',
+    testEnvironment: 'node',
+    extensionsToTreatAsEsm: ['.ts'],
+    moduleNameMapper: {
+        '^(\\.{1,2}/.*)\\.js$': '$1',
+    },
+    transform: {
+        '^.+\\.tsx?$': [
+            'ts-jest',
+            {
+                useESM: true,
+            },
+        ],
+    },
+};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "nx-json-parser",
+  "version": "1.0.0",
+  "description": "Transform strings to JSON based on Markdown structure using unified/remark",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "markdown",
+    "json",
+    "parser",
+    "unified",
+    "remark"
+  ],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "mdast-util-to-string": "^4.0.0",
+    "nx-helpers": "^1.5.0",
+    "remark-gfm": "^4.0.1",
+    "remark-parse": "^11.0.0",
+    "unified": "^11.0.5",
+    "unist-util-visit": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,15 @@
+export * from './types.js';
+export * from './parser.js';
+export * from './transformer.js';
+
+import { JSONTransformer } from './transformer.js';
+
+/**
+ * Convenience function to transform markdown string to JSON.
+ * @param markdown The markdown string to parse.
+ * @returns A JSON object.
+ */
+export function markdownToJson(markdown: string): any {
+    const transformer = new JSONTransformer();
+    return transformer.transform(markdown);
+}

package/src/parser.ts

@@ -0,0 +1,90 @@
+import { unified } from 'unified';
+import remarkParse from 'remark-parse';
+import remarkGfm from 'remark-gfm';
+import { toString } from 'mdast-util-to-string';
+import { MarkdownSection } from './types.js';
+import { remarkBulletSections } from './plugins/bullet-sections.js';
+import { toCamelCase } from 'nx-helpers';
+
+export class RemarkParser {
+    private processor = unified()
+        .use(remarkParse)
+        .use(remarkGfm)
+        .use(remarkBulletSections);
+
+    parse(markdown: string): MarkdownSection[] {
+        const tree = this.processor.runSync(this.processor.parse(markdown));
+        const sections: MarkdownSection[] = [];
+        let currentSection: MarkdownSection | null = null;
+        let currentNodes: any[] = [];
+
+        const rootChildren = (tree as any).children;
+
+        for (const node of rootChildren) {
+            if (node.type === 'heading') {
+                if (currentSection) {
+                    currentSection.content = this.processContent(currentNodes);
+                    sections.push(currentSection);
+                }
+
+                currentSection = {
+                    heading: toString(node).trim(),
+                    content: null,
+                    level: node.depth,
+                    format: 'heading'
+                };
+                currentNodes = [];
+            } else {
+                currentNodes.push(node);
+            }
+        }
+
+        if (currentSection) {
+            currentSection.content = this.processContent(currentNodes);
+            sections.push(currentSection);
+        } else if (currentNodes.length > 0) {
+            sections.push({
+                heading: 'Root',
+                content: this.processContent(currentNodes),
+                level: 0,
+                format: 'text'
+            });
+        }
+
+        return sections;
+    }
+
+    private processContent(nodes: any[]): any {
+        if (nodes.length === 0) return '';
+
+        if (nodes.length === 1 && nodes[0].type === 'table') {
+            return this.tableToArray(nodes[0]);
+        }
+
+        if (nodes.length === 1 && nodes[0].type === 'list') {
+            return nodes[0].children.map((item: any) => toString(item).trim());
+        }
+
+        return nodes.map(node => {
+            if (node.type === 'table') {
+                return JSON.stringify(this.tableToArray(node));
+            }
+            return toString(node);
+        }).join('\n\n').trim();
+    }
+
+    private tableToArray(tableNode: any): any[] {
+        const headers = tableNode.children[0].children.map((cell: any) =>
+            toCamelCase(toString(cell).trim())
+        );
+
+        return tableNode.children.slice(1).map((row: any) => {
+            const obj: any = {};
+            row.children.forEach((cell: any, i: number) => {
+                const key = headers[i] || `column${i}`;
+                obj[key] = toString(cell).trim();
+            });
+            return obj;
+        });
+    }
+}

package/src/plugins/bullet-sections.ts

@@ -0,0 +1,86 @@
+import { toString } from 'mdast-util-to-string';
+
+export function remarkBulletSections() {
+    return (tree: any) => {
+        const children = tree.children;
+        if (!children) return;
+
+        for (let i = 0; i < children.length; i++) {
+            const node = children[i];
+            if (node.type === 'list' && node.ordered === false) {
+                const items = node.children;
+                if (items.length === 0) continue;
+
+                const newRootNodes: any[] = [];
+                let currentListItems: any[] = [];
+
+                items.forEach((item: any, idx: number) => {
+                    const firstChild = item.children[0];
+                    const text = firstChild ? toString(firstChild) : '';
+                    const lines = text.trim().split('\n');
+                    const firstLine = lines[0]?.trim() || '';
+
+                    const isShort = firstLine.length > 0 && firstLine.length < 150;
+                    const hasMoreContent = lines.length > 1 || item.children.length > 1;
+
+                    // Section detection:
+                    // 1. It's short and has more content.
+                    // 2. OR it's short and is followed by a non-short item? (Hard to check here)
+                    // 3. OR it's one of the "known" section keywords.
+                    const keywords = ['answer', 'assumptions', 'unknowns', 'evidence', 'protection', 'control', 'management', 'design', 'logging', 'monitoring', 'backups', 'compliance', 'governance', 'modeling', 'incident', 'vendor', 'changes'];
+                    const isSectionKeyword = keywords.some(k => firstLine.toLowerCase().includes(k));
+
+                    if (isShort && (hasMoreContent || isSectionKeyword)) {
+                        // Flush existing list items if any
+                        if (currentListItems.length > 0) {
+                            newRootNodes.push({
+                                type: 'list',
+                                ordered: false,
+                                children: [...currentListItems]
+                            });
+                            currentListItems = [];
+                        }
+
+                        // Add as heading
+                        newRootNodes.push({
+                            type: 'heading',
+                            depth: 2,
+                            children: [{ type: 'text', value: firstLine }]
+                        });
+
+                        // Add content
+                        if (lines.length > 1) {
+                            newRootNodes.push({
+                                type: 'paragraph',
+                                children: [{ type: 'text', value: lines.slice(1).join('\n').trim() }]
+                            });
+                        }
+                        if (item.children.length > 1) {
+                            newRootNodes.push(...item.children.slice(1));
+                        }
+                    } else {
+                        currentListItems.push(item);
+                    }
+                });
+
+                // Flush remaining
+                if (currentListItems.length > 0) {
+                    newRootNodes.push({
+                        type: 'list',
+                        ordered: false,
+                        children: [...currentListItems]
+                    });
+                }
+
+                if (newRootNodes.length > 0) {
+                    // If we performed any transformation (i.e., we found at least one heading)
+                    const hasHeadings = newRootNodes.some(n => n.type === 'heading');
+                    if (hasHeadings) {
+                        children.splice(i, 1, ...newRootNodes);
+                        i += newRootNodes.length - 1;
+                    }
+                }
+            }
+        }
+    };
+}

package/src/transformer.ts

@@ -0,0 +1,116 @@
+import { RemarkParser } from './parser.js';
+import { ParseResult } from './types.js';
+import { toCamelCase } from 'nx-helpers';
+
+export interface TransformerOptions {
+    parser?: RemarkParser;
+}
+
+export class JSONTransformer {
+    private parser: RemarkParser;
+
+    constructor(options: TransformerOptions = {}) {
+        this.parser = options.parser || new RemarkParser();
+    }
+
+    transform(markdown: string): ParseResult {
+        if (!markdown || typeof markdown !== 'string') return {};
+
+        const trimmed = markdown.trim();
+
+        // 1. Handle "Proper JSONs" - First priority
+        const jsonResult = this.tryParseJson(trimmed);
+        if (jsonResult !== null && typeof jsonResult === 'object') {
+            return jsonResult;
+        }
+
+        // 2. Handle "Proper Flex MDs" (===key blocks)
+        const flexMdResult = this.parseFlexMd(trimmed);
+        if (Object.keys(flexMdResult).length > 0) {
+            return flexMdResult;
+        }
+
+        // 3. Fallback to Remark Parser (Unified/Remark)
+        const sections = this.parser.parse(markdown);
+        const result: ParseResult = {};
+
+        sections.forEach(section => {
+            const key = toCamelCase(section.heading);
+
+            if (result[key]) {
+                if (Array.isArray(result[key])) {
+                    (result[key] as any[]).push(section.content);
+                } else {
+                    result[key] = [result[key], section.content];
+                }
+            } else {
+                result[key] = section.content;
+            }
+        });
+
+        return result;
+    }
+
+    private tryParseJson(str: string): any | null {
+        let clean = str.trim();
+
+        // Handle Markdown code blocks (e.g. ```json ... ```)
+        if (clean.startsWith('```')) {
+            const lines = clean.split('\n');
+            if (lines.length > 1) {
+                // Find the matching end ```
+                let endIdx = -1;
+                for (let i = lines.length - 1; i > 0; i--) {
+                    if (lines[i]!.trim() === '```') {
+                        endIdx = i;
+                        break;
+                    }
+                }
+
+                if (endIdx > 0) {
+                    clean = lines.slice(1, endIdx).join('\n').trim();
+                } else {
+                    // No closing block, just strip first line if it looks like header
+                    clean = lines.slice(1).join('\n').trim();
+                }
+            }
+        }
+
+        // Basic JSON object/array check
+        if ((clean.startsWith('{') && clean.endsWith('}')) || (clean.startsWith('[') && clean.endsWith(']'))) {
+            try {
+                return JSON.parse(clean);
+            } catch (e) {
+                return null;
+            }
+        }
+        return null;
+    }
+
+    private parseFlexMd(text: string): ParseResult {
+        const result: ParseResult = {};
+        const regex = /^===\s*([a-zA-Z0-9_-]+)\s*$/gm;
+        const markers: { key: string, contentStart: number, nodeStart: number }[] = [];
+
+        let match;
+        while ((match = regex.exec(text)) !== null) {
+            markers.push({
+                key: match[1]!,
+                nodeStart: match.index,
+                contentStart: match.index + match[0].length
+            });
+        }
+
+        if (markers.length === 0) return result;
+
+        for (let i = 0; i < markers.length; i++) {
+            const current = markers[i]!;
+            const next = markers[i + 1];
+            const nextNodeStart = next ? next.nodeStart : text.length;
+            const content = text.substring(current.contentStart, nextNodeStart).trim();
+            result[toCamelCase(current.key)] = content;
+        }
+
+        return result;
+    }
+}

package/src/types.ts

@@ -0,0 +1,13 @@
+export interface MarkdownSection {
+  heading: string;
+  content: any; // Can be string, array of objects (for tables), etc.
+  level: number;
+  format: 'heading' | 'list' | 'table' | 'text';
+}
+
+export type ParseResult = Record<string, any>;
+
+export interface OutputFormatSpec {
+  // Define if the user wants to enforce a specific schema later
+  [key: string]: any;
+}

package/test/parser.2.test.ts

@@ -0,0 +1,103 @@
+import { markdownToJson } from '../src/index.js';
+
+describe('nx-json-parser - Complex Input', () => {
+    const str = `- Short answer
+Key considerations include data protection (encryption at rest and in transit), strong access control and IAM, secure network design, configuration and patch management, monitoring and logging, backups and disaster recovery, compliance and governance, and a clear shared responsibility model with incident response planning.
+
+- Full answer
+Deploying a database in the cloud shifts part of the security burden to the cloud provider, but the customer retains substantial responsibility for protecting data and configuring services properly. The main security considerations can be grouped as follows:
+
+- Data protection
+  - Encryption at rest and in transit (use TLS for data in transit; enable encryption for data at rest; manage encryption keys securely).
+  - Key management and rotation (use a centralized Key Management Service or HSM where appropriate; implement regular key rotation and strict access controls).
+  - Data masking or tokenization for sensitive fields where full data visibility is not required.
+
+- Access control and identity management
+  - Principle of least privilege (grant only the minimum rights needed to perform tasks).
+  - Strong authentication and MFA for human access; use short-lived credentials and service accounts with scoped permissions.
+  - Role-based access control (RBAC) and/or attribute-based access control (ABAC); separate duties to reduce risk of misuse.
+  - Regular review and revocation of unused accounts; automated credential rotation where feasible.
+
+- Network design and perimeter controls
+  - Use private networks (VPC/subnets) with restricted exposure; limit public endpoints when possible.
+  - Firewalls/security groups and network ACLs with allow-by-default deny rules.
+  - Private endpoints or VPC endpoints to connect to the database without traversing the open internet.
+  - Segmentation and defense-in-depth to limit lateral movement.
+
+- Configuration, hardening, and patch management
+  - Use secure baseline configurations; disable unnecessary features and ports.
+  - Keep the database engine and underlying software up to date with vendor patches.
+  - Implement automated configuration drift detection and enforce configuration compliance.
+
+- Logging, monitoring, and alerting
+  - Enable comprehensive database auditing logs and integrate with centralized logging/SIEM.
+  - Monitor for anomalous patterns (e.g., unusual query volumes, off-hours access, failed login spikes).
+  - Maintain alerting with clear runbooks and escalation paths; ensure tamper-evident logging.
+
+- Backups, recovery, and business continuity
+  - Encrypt backups; test restore procedures regularly; verify integrity of backups.
+  - Use cross-region replication and define RPO (recovery point objective) and RTO (recovery time objective) aligned with business needs.
+  - Protect against ransomware with immutable or write-once backup settings where available.
+
+- Compliance, governance, and data residency
+  - Map data handling to applicable regulations (GDPR, HIPAA, PCI DSS, etc.) and maintain proper data classification and retention policies.
+  - Maintain data residency requirements and ensure data transfer controls are in place.
+  - Keep audit trails and documentation for compliance evidence.
+
+- Threat modeling, vulnerability management, and secure development
+  - Regular threat modeling to identify new risks in cloud deployment.
+  - Continuous vulnerability scanning of databases and associated components; timely remediation.
+  - Secure software development practices for applications interacting with the database (code reviews, secrets management, secure APIs).
+
+- Incident response and disaster recovery
+  - Define roles and responsibilities, incident playbooks, and communication plans.
+  - Regular tabletop exercises and live tests of disaster recovery procedures.
+  - Clear escalation paths and post-incident review processes.
+
+- Vendor and service model considerations
+  - Understand the shared responsibility model for your chosen cloud provider and database service (PaaS vs IaaS) and document how security responsibilities are allocated.
+  - Evaluate provider security controls, uptime commitments, and data-handling practices; consider additional controls you must implement.
+
+- Ongoing governance and changes
+  - Implement change management, version control for configuration, and approval processes for any changes affecting security.
+  - Periodic security reassessments, penetration testing (where allowed), and third-party risk assessments.
+
+- Assumptions
+- The user is deploying a database in a cloud environment (IaaS or managed service) and seeks a comprehensive security overview.
+- The database may handle sensitive or regulated data, requiring compliance considerations.
+- A shared responsibility model with the cloud provider applies, but customer controls and configurations are critical.
+
+- Unknowns
+- Which cloud provider and database service is in use (affects specific features and tooling).
+- The type of data (sensitive/regulatory) and applicable compliance requirements.
+- Whether the deployment is multi-tenant or dedicated, and its scale and regional footprint.
+- The acceptable RPO/RTO and budget for security controls and ongoing monitoring.
+
+- Evidence
+1. Shared responsibility model: Cloud providers secure the underlying infrastructure; customers are responsible for securing data, access, and configurations.  
+2. Encryption: Encrypted data at rest and in transit is foundational for protecting data confidentiality in the cloud; keys should be managed securely with rotation.  
+3. Access control: Least privilege, MFA, short-lived credentials, and robust IAM/RBAC/ABAC controls reduce the risk of unauthorized access.  
+4. Network security: Private networks, restricted exposure, and private endpoints limit attack surface and exposure to the public internet.  
+5. Configuration and patch management: Secure baselines, disable unnecessary features, and timely patching reduce vulnerability exposure.  
+6. Logging and monitoring: Centralized, tamper-evident logging and proactive monitoring enable rapid detection and response to incidents.  
+7. Backups and DR: Encrypted backups and tested restore procedures with defined RPO/RTO ensure availability and recoverability.  
+8. Compliance and governance: Aligning data handling with regulations and maintaining auditable trails supports accountability and compliance.  
+9. Threat modeling and vulnerability management: Regular assessment and remediation of threats and vulnerabilities reduce risk over time.  
+10. Incident response planning: Prepared playbooks and drills enable faster containment and recovery from security incidents.  
+11. Data residency considerations: Data localization requirements can influence data storage and transfer controls.  
+12. Vendor/service model considerations: Clear understanding of the provider’s and customer’s security responsibilities and controls is essential for effective security posture.`;
+
+    it('should parse the large security overview correctly', () => {
+        const result = markdownToJson(str);
+
+        expect(result.shortAnswer).toBeDefined();
+        expect(result.fullAnswer).toBeDefined();
+        expect(result.dataProtection).toBeDefined();
+        expect(result.accessControlAndIdentityManagement).toBeDefined();
+        expect(result.assumptions).toBeInstanceOf(Array);
+        expect(result.evidence).toBeInstanceOf(Array);
+
+        expect((result.evidence as string[]).length).toBe(12);
+        expect(result.shortAnswer).toContain('Key considerations include data protection');
+    });
+});

package/test/parser.test.ts

@@ -0,0 +1,96 @@
+import { markdownToJson } from '../src/index.js';
+
+describe('nx-json-parser - Basic & Formats', () => {
+    it('should parse simple headings', () => {
+        const md = `
+# Title
+This is some content.
+
+## Section One
+More content here.
+    `;
+        const result = markdownToJson(md);
+        expect(result.title).toBe('This is some content.');
+        expect(result.sectionOne).toBe('More content here.');
+    });
+
+    it('should parse tables into arrays of objects', () => {
+        const md = `
+### Users List
+| Name | Age | Role |
+|------|-----|------|
+| Alice| 30  | Admin|
+| Bob  | 25  | User |
+    `;
+        const result = markdownToJson(md);
+        expect(result.usersList).toEqual([
+            { name: 'Alice', age: '30', role: 'Admin' },
+            { name: 'Bob', age: '25', role: 'User' }
+        ]);
+    });
+
+    it('should parse lists into arrays', () => {
+        const md = `
+### Features
+- Feature A
+- Feature B
+- Feature C
+    `;
+        const result = markdownToJson(md);
+        expect(result.features).toEqual(['Feature A', 'Feature B', 'Feature C']);
+    });
+
+    it('should handle bullet-style sections (via plugin)', () => {
+        const md = `
+- Short Answer
+The sky is blue.
+
+- Full Answer
+Rayleigh scattering causes the blue color...
+    `;
+        const result = markdownToJson(md);
+        expect(result.shortAnswer).toBe('The sky is blue.');
+        expect(result.fullAnswer).toBe('Rayleigh scattering causes the blue color...');
+    });
+
+    it('should handle "Proper JSON" strings', () => {
+        const jsonStr = JSON.stringify({
+            status: "success",
+            data: { id: 123, name: "Test" }
+        });
+        const result = markdownToJson(jsonStr);
+        expect(result.status).toBe("success");
+        expect(result.data.id).toBe(123);
+    });
+
+    it('should handle JSON inside code blocks', () => {
+        const md = `
+\`\`\`json
+{
+  "api": "v1",
+  "status": "active"
+}
+\`\`\`
+    `;
+        const result = markdownToJson(md);
+        expect(result.api).toBe("v1");
+        expect(result.status).toBe("active");
+    });
+
+    it('should handle "Proper Flex MD" (===key) format', () => {
+        const flexMd = `
+=== TITLE
+The Great Gatsby
+
+=== AUTHOR
+F. Scott Fitzgerald
+
+=== SUMMARY
+A story about wealth and love.
+    `;
+        const result = markdownToJson(flexMd);
+        expect(result.title).toBe("The Great Gatsby");
+        expect(result.author).toBe("F. Scott Fitzgerald");
+        expect(result.summary).toBe("A story about wealth and love.");
+    });
+});

package/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "module": "nodenext",
+    "target": "esnext",
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "moduleResolution": "nodenext",
+    "isolatedModules": true
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "**/*.test.ts"
+  ]
+}