fix: remove the root xml element as a reassemble flag and dynamically…

… get it from a disassembled file in the path

README.md

@@ -98,7 +98,7 @@ An XML with the following nested and leaf elements
 </PermissionSet>
 ```
 
-will be diassembled as such:
+will be disassembled as such:
 
 - Each nested element (`<recordTypeVisibilities>`, `<applicationVisibilities>`, `pageAccesses`, etc.) will be disassembled into sub-directories by the nested element name. If a unique & required ID element (`application` is the unique ID element for `<applicationVisibilities>`) is found, the disassembled file will be named using it. Otherwise, the disassembled files for nested elements will be named using the SHA-256 of the element contents.
 - Each leaf element (`<description>`, `<label>`, `<userLicense>`) will be disassembled into the same file.
@@ -122,7 +122,6 @@ Import the `ReassembleXMLFileHandler` class from the package.
 ```typescript
 /* 
 FLAGS
-- xmlElement: XML Root Element for the final reassembled file
 - xmlPath: Path to the disassembled XML files to reassemble (must be a directory)
 - xmlNamespace: (Optional) Namespace for the final XML (default: None)
 - fileExtension: (Optional) Desired file extension for the final XML (default: `.xml`)
@@ -132,12 +131,13 @@ import { ReassembleXMLFileHandler } from "xml-disassembler";
 const handler = new ReassembleXMLFileHandler();
 await handler.reassemble({
   xmlPath: "test/baselines/general/HR_Admin",
-  xmlElement: "PermissionSet",
   xmlNamespace: "http://soap.sforce.com/2006/04/metadata",
   fileExtension: "permissionset-meta.xml",
 });
 ```
 
+_NOTE_: You should be reassembling files created by this package's `DisassembleXMLFileHandler` class for intended results. This class will assume all disassembled files in `xmlPath` have the same XML Root Element.
+
 The reassembled XML file will be created in the parent directory of `xmlPath` and will overwrite the original file used to create the original disassembled directories, if it still exists and the `fileExtension` flag matches the original file extension.
 
 ## Template

src/service/reassembleXMLFileHandler.ts

@@ -1,5 +1,7 @@
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
+import { XMLParser } from "fast-xml-parser";
+import { XmlElement, XML_PARSER_OPTION } from "@src/helpers/types";
 import { buildReassembledFile } from "@src/service/buildReassembledFiles";
 
 export class ReassembleXMLFileHandler {
@@ -30,13 +32,48 @@ export class ReassembleXMLFileHandler {
     return combinedXmlContents;
   }
 
+  async processFilesForRootElement(
+    dirPath: string,
+  ): Promise<string | undefined> {
+    const files = await fs.readdir(dirPath);
+    const xmlParser = new XMLParser(XML_PARSER_OPTION);
+
+    for (const file of files) {
+      const filePath = path.join(dirPath, file);
+      const fileStat = await fs.stat(filePath);
+
+      if (fileStat.isDirectory()) {
+        // Recursively process files in subdirectory
+        const result = await this.processFilesForRootElement(filePath);
+        if (result !== undefined) {
+          // Found root element name, return it
+          return result;
+        }
+      } else if (fileStat.isFile()) {
+        // Process files
+        const xmlContent = await fs.readFile(filePath, "utf-8");
+        const xmlParsed = xmlParser.parse(xmlContent) as Record<
+          string,
+          XmlElement
+        >;
+        const rootElementName = Object.keys(xmlParsed)[1];
+        if (rootElementName !== undefined) {
+          // Found root element name, return it
+          return rootElementName;
+        }
+      }
+    }
+
+    // No root element name found in any files
+    return undefined;
+  }
+
   async reassemble(xmlAttributes: {
-    xmlElement: string;
     xmlPath: string;
-    xmlNamespace?: string | undefined;
-    fileExtension?: string | undefined;
+    xmlNamespace?: string;
+    fileExtension?: string;
   }): Promise<void> {
-    const { xmlElement, xmlPath, xmlNamespace, fileExtension } = xmlAttributes;
+    const { xmlPath, xmlNamespace, fileExtension } = xmlAttributes;
     const combinedXmlContents: string[] = [];
 
     // Process files directly inside the `xmlPath` directory
@@ -54,18 +91,25 @@ export class ReassembleXMLFileHandler {
       }
     }
 
+    // Process at least one XML file to get the `rootElementName`
+    let rootElementName = await this.processFilesForRootElement(xmlPath);
+
     const parentDirectory = path.dirname(xmlPath); // Get the parent directory path
     const subdirectoryBasename = path.basename(xmlPath);
     const fileName = fileExtension
       ? `${subdirectoryBasename}.${fileExtension}`
       : `${subdirectoryBasename}.xml`;
     const filePath = path.join(parentDirectory, fileName);
 
-    await buildReassembledFile(
-      combinedXmlContents,
-      filePath,
-      xmlElement,
-      xmlNamespace,
-    );
+    if (rootElementName !== undefined) {
+      await buildReassembledFile(
+        combinedXmlContents,
+        filePath,
+        rootElementName,
+        xmlNamespace,
+      );
+    } else {
+      console.error("Root element name is undefined");
+    }
   }
 }

test/main.spec.ts

@@ -27,7 +27,6 @@ describe("main function", () => {
     const handler = new ReassembleXMLFileHandler();
     await handler.reassemble({
       xmlPath: "test/baselines/general/HR_Admin",
-      xmlElement: "PermissionSet",
       xmlNamespace: "http://soap.sforce.com/2006/04/metadata",
       fileExtension: "permissionset-meta.xml",
     });
@@ -49,7 +48,6 @@ describe("main function", () => {
     const handler = new ReassembleXMLFileHandler();
     await handler.reassemble({
       xmlPath: "test/baselines/cdata/VidLand_US",
-      xmlElement: "MarketingAppExtension",
     });
 
     // Ensure that the console.log spy was called with the correct message
@@ -69,7 +67,6 @@ describe("main function", () => {
     const handler = new ReassembleXMLFileHandler();
     await handler.reassemble({
       xmlPath: "test/baselines/comments/Numbers-fr",
-      xmlElement: "GlobalValueSetTranslation",
     });
 
     // Ensure that the console.log spy was called with the correct message
@@ -99,7 +96,6 @@ describe("main function", () => {
     const handler = new ReassembleXMLFileHandler();
     await handler.reassemble({
       xmlPath: "test/baselines/array-of-leafs/Dreamhouse",
-      xmlElement: "CustomApplication",
       xmlNamespace: "http://soap.sforce.com/2006/04/metadata",
       fileExtension: "app-meta.xml",
     });