BODtoJSON 1.5.0__tar.gz → 2.0.0__tar.gz

{bodtojson-1.5.0/src/BODtoJSON.egg-info → bodtojson-2.0.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: BODtoJSON
-Version: 1.5.0
-Summary: Production-grade Infor OAGIS BOD to Flattened JSON converter.
+Version: 2.0.0
+Summary: Zero-dependency OAGIS BOD to Flattened JSON and NDJSON converter
 Author: Niraj Kakodkar
 Project-URL: Homepage, https://github.com/thekakodkar/BODtoJSON
 Classifier: Development Status :: 5 - Production/Stable
@@ -14,24 +14,23 @@ License-File: LICENSE
 Requires-Dist: xmltodict
 Dynamic: license-file
 
-# BODtoJSON v1.5.0
+# BODtoJSON v2.0.0
+
+**BODtoJSON** is a zero-dependency, enterprise-grade Python data liquidity engine designed to transform complex Infor OAGIS (XML) Business Object Documents into modern, AI-ready flattened JSON and NDJSON structures.
 
-**BODtoJSON** is an enterprise-grade Python library designed to transform complex Infor OAGIS (XML) Business Object Documents into modern, AI-ready flattened JSON structures. 
 <center><img width="769" height="336" alt="BOD2JSon" src="https://github.com/user-attachments/assets/0b089179-f137-4d56-b717-85cffb20d622" /></center>
 
-v1.5.0 establishes a dual-pipeline standard, introducing strict single-line **Newline Delimited JSON (NDJSON)** generation alongside standard JSON, optimized directly for massive stream ingestions into Data Lakehouses and Vector Databases.
+v2.0.0 marks a major architectural milestone: eliminating all external core dependencies, introducing native single-pass ElementTree traversal, and establishing a dual-pipeline streaming standard for Data Lakehouses and Vector Databases.
 
 ---
 
-## 🚀 What’s New in v1.5.0 (vs. v1.0.0)
-
-The transition to v1.5.0 introduces explicit processing pipelines and an enterprise API tier while safeguarding legacy system investments:
+## 🚀 What’s New in v2.0.0 (vs. v1.0.0)
 
-* **Explicit Format Architecture:** Replaced parameter-driven routing with dedicated top-level API methods—`to_json` and `to_ndjson`—improving interface predictability and self-documentation.
-* **Strict NDJSON Linearization:** The native engine now features compact serialization via `separators=(',', ':')` and forced line termination (`\n`). Repeating record blocks (arrays) are unpacked and emitted as individual, single-line text records.
-* **100% Backward Compatibility:** The original `convert()` function remains functional at the package root. It automatically routes to `to_json` while issuing non-breaking `DeprecationWarning` logs to guide future code modernization.
-* **Enterprise REST API Tier (`api.py`):** Added a lightweight, high-performance FastAPI implementation featuring zero-overhead streaming using raw `Response` classes, eliminating middleware double-serialization bottlenecks.
-* **Pytest Migration:** The automated quality assurance framework has been upgraded to **`pytest`**, featuring regression test parameters that actively validate deprecation warning assertions.
+* **Zero-Dependency Core Engine:** Removed `xmltodict` in favor of a single-pass recursive traversal built purely on Python’s native `xml.etree.ElementTree`. This eliminates external supply-chain risks, shrinks deployment footprints for air-gapped or serverless environments, and halves intermediate memory allocations.
+* **Explicit Dual-Pipeline Architecture:** Replaced parameter-driven routing with dedicated top-level API methods—`to_json` and `to_ndjson`—improving interface predictability and self-documentation.
+* **Strict NDJSON Linearization:** Features compact serialization via `separators=(',', ':')` and forced line termination (`\n`). Multi-noun batch payloads inside `DataArea` are automatically unpacked and emitted as individual, single-line text records.
+* **Enterprise REST API Tier (`api.py`):** Added an optional, high-performance FastAPI microservice layer featuring zero-overhead streaming using raw `Response` classes, eliminating middleware double-serialization bottlenecks.
+* **Pytest Suite:** Standardized automated quality assurance on **`pytest`**, including regression assertions for deprecation warnings.
 
 ---
 

{bodtojson-1.5.0 → bodtojson-2.0.0}/README.md

@@ -1,21 +1,20 @@
-# BODtoJSON v1.5.0
+# BODtoJSON v2.0.0
+
+**BODtoJSON** is a zero-dependency, enterprise-grade Python data liquidity engine designed to transform complex Infor OAGIS (XML) Business Object Documents into modern, AI-ready flattened JSON and NDJSON structures.
 
-**BODtoJSON** is an enterprise-grade Python library designed to transform complex Infor OAGIS (XML) Business Object Documents into modern, AI-ready flattened JSON structures. 
 <center><img width="769" height="336" alt="BOD2JSon" src="https://github.com/user-attachments/assets/0b089179-f137-4d56-b717-85cffb20d622" /></center>
 
-v1.5.0 establishes a dual-pipeline standard, introducing strict single-line **Newline Delimited JSON (NDJSON)** generation alongside standard JSON, optimized directly for massive stream ingestions into Data Lakehouses and Vector Databases.
+v2.0.0 marks a major architectural milestone: eliminating all external core dependencies, introducing native single-pass ElementTree traversal, and establishing a dual-pipeline streaming standard for Data Lakehouses and Vector Databases.
 
 ---
 
-## 🚀 What’s New in v1.5.0 (vs. v1.0.0)
-
-The transition to v1.5.0 introduces explicit processing pipelines and an enterprise API tier while safeguarding legacy system investments:
+## 🚀 What’s New in v2.0.0 (vs. v1.0.0)
 
-* **Explicit Format Architecture:** Replaced parameter-driven routing with dedicated top-level API methods—`to_json` and `to_ndjson`—improving interface predictability and self-documentation.
-* **Strict NDJSON Linearization:** The native engine now features compact serialization via `separators=(',', ':')` and forced line termination (`\n`). Repeating record blocks (arrays) are unpacked and emitted as individual, single-line text records.
-* **100% Backward Compatibility:** The original `convert()` function remains functional at the package root. It automatically routes to `to_json` while issuing non-breaking `DeprecationWarning` logs to guide future code modernization.
-* **Enterprise REST API Tier (`api.py`):** Added a lightweight, high-performance FastAPI implementation featuring zero-overhead streaming using raw `Response` classes, eliminating middleware double-serialization bottlenecks.
-* **Pytest Migration:** The automated quality assurance framework has been upgraded to **`pytest`**, featuring regression test parameters that actively validate deprecation warning assertions.
+* **Zero-Dependency Core Engine:** Removed `xmltodict` in favor of a single-pass recursive traversal built purely on Python’s native `xml.etree.ElementTree`. This eliminates external supply-chain risks, shrinks deployment footprints for air-gapped or serverless environments, and halves intermediate memory allocations.
+* **Explicit Dual-Pipeline Architecture:** Replaced parameter-driven routing with dedicated top-level API methods—`to_json` and `to_ndjson`—improving interface predictability and self-documentation.
+* **Strict NDJSON Linearization:** Features compact serialization via `separators=(',', ':')` and forced line termination (`\n`). Multi-noun batch payloads inside `DataArea` are automatically unpacked and emitted as individual, single-line text records.
+* **Enterprise REST API Tier (`api.py`):** Added an optional, high-performance FastAPI microservice layer featuring zero-overhead streaming using raw `Response` classes, eliminating middleware double-serialization bottlenecks.
+* **Pytest Suite:** Standardized automated quality assurance on **`pytest`**, including regression assertions for deprecation warnings.
 
 ---
 

{bodtojson-1.5.0 → bodtojson-2.0.0}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "BODtoJSON"
-version = "1.5.0"
+version = "2.0.0"
 authors = [
   { name="Niraj Kakodkar" },
 ]
-description = "Production-grade Infor OAGIS BOD to Flattened JSON converter."
+description = "Zero-dependency OAGIS BOD to Flattened JSON and NDJSON converter"
 readme = "README.md"
 requires-python = ">=3.8"
 dependencies = [

bodtojson-2.0.0/src/BODtoJSON/__init__.py

@@ -0,0 +1,9 @@
+"""
+BODtoJSON: A zero-dependency OAGIS BOD to Flattened JSON/NDJSON converter.
+"""
+
+__version__ = "2.0.0"
+
+from .mapper import to_json, to_ndjson, convert, BODConverter
+
+__all__ = ["to_json", "to_ndjson", "convert", "BODConverter"]

{bodtojson-1.5.0 → bodtojson-2.0.0}/src/BODtoJSON/api.py

@@ -4,8 +4,8 @@ from BODtoJSON import to_json, to_ndjson, convert
 
 app = FastAPI(
     title="BODtoJSON API",
-    version="1.1.0",
-    description="Enterprise OAGIS Integration Data Fabric Engine"
+    version="2.0.0",
+    description="Zero-Dependency Enterprise OAGIS Integration Data Fabric Engine"
 )
 
 # -------------------------------------------------------------------
@@ -24,7 +24,7 @@ async def root():
     return {
         "service": "BODtoJSON",
         "status": "running",
-        "version": "1.1.0"
+        "version": "2.0.0"
     }
 
 

bodtojson-2.0.0/src/BODtoJSON/mapper.py

@@ -0,0 +1,204 @@
+import xml.etree.ElementTree as ET
+import json
+import re
+import warnings
+from typing import Dict, Any, List, Tuple
+
+
+class BODConverter:
+    def __init__(self, pnode: str = 'DataArea', separator: str = '_'):
+        self.pnode = pnode
+        self.separator = separator
+
+    def _prepare_noun_element(self, bod_xml: str, verb: str) -> ET.Element:
+        """Cleans XML, strips the administrative Verb, and extracts the primary Noun element."""
+        clean_xml = bod_xml.strip().encode('utf-8').decode('utf-8-sig')
+        sanitized_xml = re.sub(r'\sxmlns(?::\w+)?="[^"]+"', '', clean_xml, count=1)
+
+        root = ET.fromstring(sanitized_xml)
+        data_area = root.find(f".//{self.pnode}")
+
+        if data_area is None:
+            raise ValueError(f"Target node '{self.pnode}' not found.")
+
+        verb_node = data_area.find(verb)
+        if verb_node is not None:
+            data_area.remove(verb_node)
+
+        children = list(data_area)
+        if not children:
+            raise ValueError(f"No Noun element found inside '{self.pnode}'.")
+
+        return children[0]
+
+    def _strip_ns(self, tag: str) -> str:
+        """Strips any residual {namespace} URI prefixes from ElementTree tags."""
+        return tag.split('}', 1)[-1] if '}' in tag else tag
+
+    def _flatten_element(self, elem: ET.Element, prefix: str = "") -> Dict[str, Any]:
+        """
+        Recursively traverses an ElementTree node directly into a flattened dictionary,
+        preserving exact xmltodict attribute (@) and text (#text) key parity.
+        """
+        flat_dict: Dict[str, Any] = {}
+        tag_name = self._strip_ns(elem.tag)
+        current_prefix = f"{prefix}{self.separator}{tag_name}" if prefix else tag_name
+
+        # 1. Extract XML Attributes (e.g., _@accountingEntity)
+        for attr_k, attr_v in elem.attrib.items():
+            clean_attr = self._strip_ns(attr_k)
+            flat_dict[f"{current_prefix}{self.separator}@{clean_attr}"] = attr_v
+
+        children = list(elem)
+        text_val = elem.text.strip() if elem.text and elem.text.strip() else None
+
+        # 2. Leaf Node Handling
+        if not children:
+            if elem.attrib:
+                # If node has both attributes and text, assign text to _#text
+                if text_val is not None:
+                    flat_dict[f"{current_prefix}{self.separator}#text"] = text_val
+            else:
+                # Pure text leaf node (maps to None if empty, matching xmltodict parity)
+                flat_dict[current_prefix] = text_val
+            return flat_dict
+
+        # 3. Mixed Content Handling (Parent node has children AND direct text)
+        if text_val is not None:
+            flat_dict[f"{current_prefix}{self.separator}#text"] = text_val
+
+        # 4. Group Child Elements by Tag Name to Detect Repeating Arrays
+        grouped_children: Dict[str, List[ET.Element]] = {}
+        for child in children:
+            c_tag = self._strip_ns(child.tag)
+            grouped_children.setdefault(c_tag, []).append(child)
+
+        for c_tag, c_list in grouped_children.items():
+            if len(c_list) == 1:
+                flat_dict.update(self._flatten_element(c_list[0], current_prefix))
+            else:
+                # Repeating sibling tags get indexed (e.g., _PurchaseOrderLine_0_...)
+                for idx, child_elem in enumerate(c_list):
+                    indexed_prefix = f"{current_prefix}{self.separator}{c_tag}{self.separator}{idx}"
+                    # Process attributes and children of the indexed element directly
+                    flat_dict.update(self._flatten_indexed_child(child_elem, indexed_prefix))
+
+        return flat_dict
+
+    def _flatten_indexed_child(self, elem: ET.Element, indexed_prefix: str) -> Dict[str, Any]:
+        """Helper to flatten elements inside a repeating sibling list without duplicating the tag name."""
+        flat_dict: Dict[str, Any] = {}
+
+        for attr_k, attr_v in elem.attrib.items():
+            clean_attr = self._strip_ns(attr_k)
+            flat_dict[f"{indexed_prefix}{self.separator}@{clean_attr}"] = attr_v
+
+        children = list(elem)
+        text_val = elem.text.strip() if elem.text and elem.text.strip() else None
+
+        if not children:
+            if elem.attrib:
+                if text_val is not None:
+                    flat_dict[f"{indexed_prefix}{self.separator}#text"] = text_val
+            else:
+                flat_dict[indexed_prefix] = text_val
+            return flat_dict
+
+        if text_val is not None:
+            flat_dict[f"{indexed_prefix}{self.separator}#text"] = text_val
+
+        grouped_children: Dict[str, List[ET.Element]] = {}
+        for child in children:
+            c_tag = self._strip_ns(child.tag)
+            grouped_children.setdefault(c_tag, []).append(child)
+
+        for c_tag, c_list in grouped_children.items():
+            if len(c_list) == 1:
+                flat_dict.update(self._flatten_element(c_list[0], indexed_prefix))
+            else:
+                for idx, child_elem in enumerate(c_list):
+                    sub_prefix = f"{indexed_prefix}{self.separator}{c_tag}{self.separator}{idx}"
+                    flat_dict.update(self._flatten_indexed_child(child_elem, sub_prefix))
+
+        return flat_dict
+
+    def to_json(self, bod_xml: str, verb: str) -> str:
+        """Converts OAGIS XML to a single, standard flat JSON string."""
+        try:
+            noun_elem = self._prepare_noun_element(bod_xml, verb)
+            flattened = self._flatten_element(noun_elem)
+            return json.dumps(flattened)
+        except Exception as e:
+            return json.dumps({"status": "error", "message": str(e)})
+
+    def to_ndjson(self, bod_xml: str, verb: str) -> str:
+        """
+        Converts OAGIS XML into strict NDJSON format.
+        Unpacks repeating sibling elements under DataArea into single-line records.
+        """
+        try:
+            clean_xml = bod_xml.strip().encode('utf-8').decode('utf-8-sig')
+            sanitized_xml = re.sub(r'\sxmlns(?::\w+)?="[^"]+"', '', clean_xml, count=1)
+
+            root = ET.fromstring(sanitized_xml)
+            data_area = root.find(f".//{self.pnode}")
+
+            if data_area is None:
+                raise ValueError(f"Target node '{self.pnode}' not found.")
+
+            verb_node = data_area.find(verb)
+            if verb_node is not None:
+                data_area.remove(verb_node)
+
+            noun_nodes = list(data_area)
+            if not noun_nodes:
+                raise ValueError(f"No Noun element found inside '{self.pnode}'.")
+
+            lines = []
+            for noun_elem in noun_nodes:
+                flat_record = self._flatten_element(noun_elem)
+                compact_line = json.dumps(flat_record, separators=(',', ':')).strip()
+                lines.append(compact_line)
+
+            return "\n".join(lines) + "\n"
+
+        except Exception as e:
+            return json.dumps({"status": "error", "message": str(e)}) + "\n"
+
+    def convert(bod_xml: str, verb: str) -> str:
+        """
+            LEGACY FUNCTION: Maintained to prevent breaking production changes.
+            Maps directly to to_json() behind the scenes.
+        """
+        warnings.warn(
+            "The 'convert' function is deprecated and will be removed in v3.0.0. Use 'to_json' or 'to_ndjson' instead.",
+            DeprecationWarning,
+            stacklevel=2
+        )
+        return to_json(bod_xml, verb)
+
+
+# -------------------------------------------------------------------
+# Top-Level Facade Functions (Global Access Shorthand)
+# -------------------------------------------------------------------
+def to_json(bod_xml: str, verb: str) -> str:
+    """Primary API for Standard JSON conversion"""
+    return BODConverter().to_json(bod_xml, verb)
+
+
+def to_ndjson(bod_xml: str, verb: str) -> str:
+    """Primary API for Newline Delimited JSON (NDJSON) conversion"""
+    return BODConverter().to_ndjson(bod_xml, verb)
+
+
+def convert(bod_xml: str, verb: str) -> str:
+    """
+    LEGACY FUNCTION: Maintained to prevent breaking production changes.
+    Maps directly to to_json() behind the scenes.
+    """
+    warnings.warn(
+        "The 'convert' function is deprecated and will be removed in v2.0.0. Use 'to_json' or 'to_ndjson' instead.",
+        DeprecationWarning,
+        stacklevel=2
+    )
+    return to_json(bod_xml, verb)

{bodtojson-1.5.0 → bodtojson-2.0.0/src/BODtoJSON.egg-info}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: BODtoJSON
-Version: 1.5.0
-Summary: Production-grade Infor OAGIS BOD to Flattened JSON converter.
+Version: 2.0.0
+Summary: Zero-dependency OAGIS BOD to Flattened JSON and NDJSON converter
 Author: Niraj Kakodkar
 Project-URL: Homepage, https://github.com/thekakodkar/BODtoJSON
 Classifier: Development Status :: 5 - Production/Stable
@@ -14,24 +14,23 @@ License-File: LICENSE
 Requires-Dist: xmltodict
 Dynamic: license-file
 
-# BODtoJSON v1.5.0
+# BODtoJSON v2.0.0
+
+**BODtoJSON** is a zero-dependency, enterprise-grade Python data liquidity engine designed to transform complex Infor OAGIS (XML) Business Object Documents into modern, AI-ready flattened JSON and NDJSON structures.
 
-**BODtoJSON** is an enterprise-grade Python library designed to transform complex Infor OAGIS (XML) Business Object Documents into modern, AI-ready flattened JSON structures. 
 <center><img width="769" height="336" alt="BOD2JSon" src="https://github.com/user-attachments/assets/0b089179-f137-4d56-b717-85cffb20d622" /></center>
 
-v1.5.0 establishes a dual-pipeline standard, introducing strict single-line **Newline Delimited JSON (NDJSON)** generation alongside standard JSON, optimized directly for massive stream ingestions into Data Lakehouses and Vector Databases.
+v2.0.0 marks a major architectural milestone: eliminating all external core dependencies, introducing native single-pass ElementTree traversal, and establishing a dual-pipeline streaming standard for Data Lakehouses and Vector Databases.
 
 ---
 
-## 🚀 What’s New in v1.5.0 (vs. v1.0.0)
-
-The transition to v1.5.0 introduces explicit processing pipelines and an enterprise API tier while safeguarding legacy system investments:
+## 🚀 What’s New in v2.0.0 (vs. v1.0.0)
 
-* **Explicit Format Architecture:** Replaced parameter-driven routing with dedicated top-level API methods—`to_json` and `to_ndjson`—improving interface predictability and self-documentation.
-* **Strict NDJSON Linearization:** The native engine now features compact serialization via `separators=(',', ':')` and forced line termination (`\n`). Repeating record blocks (arrays) are unpacked and emitted as individual, single-line text records.
-* **100% Backward Compatibility:** The original `convert()` function remains functional at the package root. It automatically routes to `to_json` while issuing non-breaking `DeprecationWarning` logs to guide future code modernization.
-* **Enterprise REST API Tier (`api.py`):** Added a lightweight, high-performance FastAPI implementation featuring zero-overhead streaming using raw `Response` classes, eliminating middleware double-serialization bottlenecks.
-* **Pytest Migration:** The automated quality assurance framework has been upgraded to **`pytest`**, featuring regression test parameters that actively validate deprecation warning assertions.
+* **Zero-Dependency Core Engine:** Removed `xmltodict` in favor of a single-pass recursive traversal built purely on Python’s native `xml.etree.ElementTree`. This eliminates external supply-chain risks, shrinks deployment footprints for air-gapped or serverless environments, and halves intermediate memory allocations.
+* **Explicit Dual-Pipeline Architecture:** Replaced parameter-driven routing with dedicated top-level API methods—`to_json` and `to_ndjson`—improving interface predictability and self-documentation.
+* **Strict NDJSON Linearization:** Features compact serialization via `separators=(',', ':')` and forced line termination (`\n`). Multi-noun batch payloads inside `DataArea` are automatically unpacked and emitted as individual, single-line text records.
+* **Enterprise REST API Tier (`api.py`):** Added an optional, high-performance FastAPI microservice layer featuring zero-overhead streaming using raw `Response` classes, eliminating middleware double-serialization bottlenecks.
+* **Pytest Suite:** Standardized automated quality assurance on **`pytest`**, including regression assertions for deprecation warnings.
 
 ---
 

bodtojson-1.5.0/src/BODtoJSON/__init__.py

@@ -1,10 +0,0 @@
-"""
-BODtoJSON: A high-performance OAGIS BOD to Flattened JSON/NDJSON converter.
-"""
-
-__version__ = "1.1.0"
-
-# Expose both legacy and modern functionality at the top level
-from .mapper import to_json, to_ndjson, convert, BODConverter
-
-__all__ = ["to_json", "to_ndjson", "convert", "BODConverter"]

bodtojson-1.5.0/src/BODtoJSON/mapper.py

@@ -1,108 +0,0 @@
-import xml.etree.ElementTree as ET
-import xmltodict
-import json
-import re
-import warnings
-from typing import Dict, Any
-
-class BODConverter:
-    def __init__(self, pnode: str = 'DataArea', separator: str = '_'):
-        self.pnode = pnode
-        self.separator = separator
-
-    def _prepare_raw_dict(self, bod_xml: str, verb: str) -> Dict[str, Any]:
-        """Internal helper to clean XML, strip verbs, and extract the raw dictionary."""
-        clean_xml = bod_xml.strip().encode('utf-8').decode('utf-8-sig')
-        sanitized_xml = re.sub(r'\sxmlns(?::\w+)?="[^"]+"', '', clean_xml, count=1)
-        
-        root = ET.fromstring(sanitized_xml)
-        data_area = root.find(f".//{self.pnode}")
-        
-        if data_area is None:
-            raise ValueError(f"Target node '{self.pnode}' not found.")
-
-        verb_node = data_area.find(verb)
-        if verb_node is not None:
-            data_area.remove(verb_node)
-
-        noun_node = list(data_area)[0]
-        xml_fragment = ET.tostring(noun_node, encoding='utf-8').decode('utf-8')
-        
-        return xmltodict.parse(xml_fragment)
-
-    def _flatify(self, obj: Any, prefix: str = "") -> Dict[str, Any]:
-        """Recursively flattens deeply nested structures into single-level key-values."""
-        flat_dict = {}
-        if isinstance(obj, dict):
-            for k, v in obj.items():
-                new_key = f"{prefix}{self.separator}{k}" if prefix else k
-                flat_dict.update(self._flatify(v, new_key))
-        elif isinstance(obj, (list, tuple)):
-            for i, v in enumerate(obj):
-                new_key = f"{prefix}{self.separator}{i}"
-                flat_dict.update(self._flatify(v, new_key))
-        else:
-            flat_dict[prefix] = obj
-        return flat_dict
-
-    def to_json(self, bod_xml: str, verb: str) -> str:
-        """Converts OAGIS XML to a single, standard flat JSON string."""
-        try:
-            raw_dict = self._prepare_raw_dict(bod_xml, verb)
-            flattened = self._flatify(raw_dict)
-            return json.dumps(flattened)
-        except Exception as e:
-            return json.dumps({"status": "error", "message": str(e)})
-
-    def to_ndjson(self, bod_xml: str, verb: str) -> str:
-        """
-        Converts OAGIS XML into strict NDJSON format.
-        Flattens and compresses individual objects onto single lines terminated by a newline.
-        """
-        try:
-            raw_dict = self._prepare_raw_dict(bod_xml, verb)
-            noun_key = list(raw_dict.keys())[0]
-            noun_content = raw_dict[noun_key]
-
-            if isinstance(noun_content, list):
-                lines = []
-                for record in noun_content:
-                    flat_record = self._flatify({noun_key: record})
-                    compact_line = json.dumps(flat_record, separators=(',', ':')).strip()
-                    lines.append(compact_line)
-                return "\n".join(lines) + "\n"
-            
-            flat_record = self._flatify(raw_dict)
-            compact_line = json.dumps(flat_record, separators=(',', ':')).strip()
-            return compact_line + "\n"
-
-        except Exception as e:
-            return json.dumps({"status": "error", "message": str(e)}) + "\n"
-
-    def convert(self, bod_xml: str, verb: str) -> str:
-        """Legacy class method kept for 100% backward compatibility."""
-        return self.to_json(bod_xml, verb)
-
-
-# -------------------------------------------------------------------
-# Top-Level Facade Functions (Global Access Shorthand)
-# -------------------------------------------------------------------
-def to_json(bod_xml: str, verb: str) -> str:
-    """Primary API for Standard JSON conversion"""
-    return BODConverter().to_json(bod_xml, verb)
-
-def to_ndjson(bod_xml: str, verb: str) -> str:
-    """Primary API for Newline Delimited JSON (NDJSON) conversion"""
-    return BODConverter().to_ndjson(bod_xml, verb)
-
-def convert(bod_xml: str, verb: str) -> str:
-    """
-    LEGACY FUNCTION: Maintained to prevent breaking production changes.
-    Maps directly to to_json() behind the scenes.
-    """
-    warnings.warn(
-        "The 'convert' function is deprecated and will be removed in v2.0.0. Use 'to_json' or 'to_ndjson' instead.",
-        DeprecationWarning,
-        stacklevel=2
-    )
-    return to_json(bod_xml, verb)