tally-xml-tdl 1.13.1 → 1.13.2

package/index.d.ts

@@ -1,3 +1,6 @@
+export function company(showLog?: boolean): Promise<any>;
+export default company;
+
 export interface V6Options {
     company: string;
     jsonId: string;
@@ -8,3 +11,5 @@ export function get<T = any>(options?: V6Options): Promise<T>;
 export function clean<T = any>(options?: V6Options): Promise<T>;
 
 export * as v6 from "./src/v6/index.js";
+export * as v13 from "./src/v13/main.js";
+

package/package.json

@@ -1,19 +1,31 @@
 {
   "name": "tally-xml-tdl",
-  "version": "1.13.1",
+  "version": "1.13.2",
   "description": "Simple, clean TDL and XML extraction and manipulation tools for Tally",
   "type": "module",
   "main": "src/v13/main.js",
   "module": "./src/v13/main.js",
+  "types": "index.d.ts",
   "sideEffects": false,
   "exports": {
     ".": {
-      "types": "./src/v13/main.js",
+      "types": "./index.d.ts",
       "import": "./src/v13/main.js",
       "default": "./src/v13/main.js"
+    },
+    "./v13": {
+      "types": "./src/v13/main.d.ts",
+      "import": "./src/v13/main.js",
+      "default": "./src/v13/main.js"
+    },
+    "./v6": {
+      "types": "./src/v6/index.d.ts",
+      "import": "./src/v6/index.js",
+      "default": "./src/v6/index.js"
     }
   },
   "files": [
+    "src/v13",
     "src/v6",
     "src/index.js",
     "index.js",

package/src/index.js

@@ -1 +1,2 @@
-export * from "./v13/main.js";
+export * from "./v13/main.js";
+export * as v13 from "./v13/main.js";

package/src/v13/body.json

@@ -0,0 +1,78 @@
+{
+  "company": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT>",
+    "tdlMessage": "<TYPE>Company</TYPE><FETCH>$$Alias:Name</FETCH>"
+  },
+  "uom": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT>",
+    "tdlMessage": "<TYPE>Unit</TYPE><FETCH>$$Alias:Name</FETCH>"
+  },
+  "stockItems": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT>",
+    "tdlMessage": "<TYPE>StockItem</TYPE><FETCH>$$Alias:Name</FETCH>"
+  },
+  "stockItemsWithBaseUnits": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT>",
+    "tdlMessage": "<TYPE>StockItem</TYPE><FETCH>$$Alias:Name</FETCH><FETCH>BaseUnits</FETCH>"
+  },
+  "ledgerNames": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT>",
+    "tdlMessage": "<TYPE>Ledger</TYPE><FETCH>$$Alias:Name</FETCH>"
+  },
+  "ledgerNamesWithDetails": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT>",
+    "tdlMessage": "<TYPE>Ledger</TYPE><FETCH>$$Alias:Name</FETCH><FETCH>GSTRegistrationType</FETCH><FETCH>GSTIN</FETCH>"
+  },
+  "ledgerNamesMoreDetails": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT>",
+    "tdlMessage": "<TYPE>Ledger</TYPE><FETCH>$$Alias:Name</FETCH><FETCH>LEDGSTREGDETAILS.LIST</FETCH>"
+  },
+  "stockGroups": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT>",
+    "tdlMessage": "<TYPE>StockGroup</TYPE><FETCH>$$Alias:Name</FETCH>"
+  },
+  "stockGroupsAndParent": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT>",
+    "tdlMessage": "<TYPE>StockGroup</TYPE><FETCH>$$Alias:Name</FETCH><FETCH>Parent</FETCH>"
+  },
+  "purchases1": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT><SVFROMDATE>1-Apr-2026</SVFROMDATE><SVTODATE>30-Apr-2026</SVTODATE>",
+    "tdlMessage": "<TYPE>Voucher</TYPE><FILTER>$$IsPurchase:$VoucherTypeName</FILTER><FETCH>Date</FETCH><FETCH>VoucherNumber</FETCH><FETCH>VoucherTypeName</FETCH><FETCH>PartyLedgerName</FETCH><FETCH>Amount</FETCH>"
+  },
+  "purchases2": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT><SVFROMDATE>1-Apr-2026</SVFROMDATE><SVTODATE>30-Apr-2026</SVTODATE>",
+    "tdlMessage": "<TYPE>Vouchers:VoucherType</TYPE><CHILDOF>$$VchTypePurchase</CHILDOF><BELONGSTO>Yes</BELONGSTO><FETCH>Date, VoucherNumber, VoucherTypeName, PartyLedgerName, AllInventoryEntries</FETCH>"
+  },
+  "purchases3": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT><SVFROMDATE>1-Apr-2026</SVFROMDATE><SVTODATE>1-Apr-2026</SVTODATE>",
+    "tdlMessage": "<TYPE>Voucher</TYPE><SYSTEM TYPE=\"Formulae\" NAME=\"DateFilter\">$Date &gt;= ##SVFROMDATE AND $Date &lt;= ##SVTODATE</SYSTEM><FILTER>DateFilter</FILTER><FETCH>Date</FETCH><FETCH>VoucherNumber</FETCH><FETCH>VoucherTypeName</FETCH><FETCH>PartyLedgerName</FETCH><FETCH>AllInventoryEntries</FETCH>"
+  },
+  "purchases4": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT><SVFROMDATE>1-Apr-2026</SVFROMDATE><SVTODATE>1-Apr-2026</SVTODATE>",
+    "tdlMessage": "<SYSTEM TYPE=\"Formula\" NAME=\"DateFilter\">$Date &gt;= ##SVFROMDATE AND $Date &lt;= ##SVTODATE</SYSTEM><COLLECTION NAME=\"KeshavPurchases\"><TYPE>Voucher</TYPE><FILTER>DateFilter</FILTER><FETCH>Date</FETCH><FETCH>VoucherNumber</FETCH><FETCH>VoucherTypeName</FETCH><FETCH>PartyLedgerName</FETCH><FETCH>AllInventoryEntries</FETCH></COLLECTION>"
+  },
+  "purchases5": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT><SVFROMDATE>1-Apr-2026</SVFROMDATE><SVTODATE>1-Apr-2026</SVTODATE>",
+    "tdlMessage": "<SYSTEM TYPE=\"Formulae\" NAME=\"DateFilter\">$Date &gt;= ##SVFROMDATE AND $Date &lt;= ##SVTODATE</SYSTEM><COLLECTION NAME=\"KeshavPurchases\"><TYPE>Voucher</TYPE><FILTER>DateFilter</FILTER><FETCH>Date</FETCH><FETCH>VoucherNumber</FETCH><FETCH>VoucherTypeName</FETCH><FETCH>PartyLedgerName</FETCH><FETCH>AllInventoryEntries</FETCH></COLLECTION>"
+  },
+  "purchases6": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT><SVFROMDATE>1-Apr-2026</SVFROMDATE><SVTODATE>1-Apr-2026</SVTODATE>",
+    "tdlMessage": "<COLLECTION NAME=\"KeshavPurchases\"><TYPE>Voucher</TYPE><FILTERS>DateFilter</FILTERS><FETCH>Date</FETCH><FETCH>VoucherNumber</FETCH><FETCH>VoucherTypeName</FETCH><FETCH>PartyLedgerName</FETCH><FETCH>AllInventoryEntries</FETCH></COLLECTION><SYSTEM TYPE=\"Formulae\" NAME=\"DateFilter\">$Date &gt;= ##SVFROMDATE AND $Date &lt;= ##SVTODATE</SYSTEM>"
+  },
+  "purchases7": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT><SVFROMDATE>1-Apr-2026</SVFROMDATE><SVTODATE>1-Apr-2026</SVTODATE>",
+    "tdlMessage": "<COLLECTION NAME=\"KeshavPurchases\"><TYPE>Voucher</TYPE><FILTERS>DateFilter</FILTERS><FETCH>Date</FETCH><FETCH>VoucherNumber</FETCH><FETCH>VoucherTypeName</FETCH><FETCH>PartyLedgerName</FETCH><FETCH>AllInventoryEntries</FETCH></COLLECTION><SYSTEM TYPE=\"Formulae\" NAME=\"DateFilter\">$Date &gt;= ##SVFROMDATE AND $Date &lt;= ##SVTODATE</SYSTEM>"
+  },
+  "purchases8": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT>",
+    "tdlMessage": "<COLLECTION NAME=\"KeshavPurchases\"><TYPE>Voucher</TYPE><FETCH>Date</FETCH><FETCH>VoucherNumber</FETCH><FETCH>VoucherTypeName</FETCH></COLLECTION>"
+  },
+  "purchases9": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT>",
+    "tdlMessage": "<COLLECTION NAME=\"KeshavPurchaseInventory\"><TYPE>Vouchers:VoucherType</TYPE><CHILDOF>$$VchTypePurchase</CHILDOF><BELONGSTO>Yes</BELONGSTO><FETCH>Date, VoucherNumber, VoucherTypeName, PartyLedgerName, AllInventoryEntries</FETCH></COLLECTION>"
+  },
+  "purchases": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT><SVFROMDATE TYPE=\"Date\">4-Sep-2026</SVFROMDATE><SVTODATE TYPE=\"Date\">4-Sep-2026</SVTODATE>",
+    "tdlMessage": "<TYPE>Vouchers:VoucherType</TYPE><CHILDOF>$$VchTypePurchase</CHILDOF><BELONGSTO>Yes</BELONGSTO><FETCH>AllInventoryEntries</FETCH><FETCH>Date</FETCH>"
+  }
+}

package/src/v13/body.xml

@@ -0,0 +1,25 @@
+<ENVELOPE>
+    <HEADER>
+        <VERSION>1</VERSION>
+        <TALLYREQUEST>Export</TALLYREQUEST>
+        <TYPE>Collection</TYPE>
+        <ID>TDLID</ID>
+    </HEADER>
+
+    <BODY>
+        <DESC>
+            <STATICVARIABLES>
+            <SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT>
+                {{STATICVARIABLES}}
+            </STATICVARIABLES>
+
+            <TDL>
+                <TDLMESSAGE>
+                    <COLLECTION NAME="TDLID">
+                        {{TDLMESSAGE}}
+                    </COLLECTION>
+                </TDLMESSAGE>
+            </TDL>
+        </DESC>
+    </BODY>
+</ENVELOPE>

package/src/v13/company.js

@@ -0,0 +1,30 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+import { executeXmlAndClean } from "./core/index.js";
+import { buildXml } from "./core/buildXml.js";
+import bodyJson from "./body.json" with {type: "json"};
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const body = fs.readFileSync(path.join(__dirname, "body.xml"), "utf8");
+
+const startFunc = async (showLog = false) => {
+    const jsonId = "company";
+
+    const { tdlMessage } = bodyJson[jsonId];
+    if (showLog) console.log("tdlMessage : ", tdlMessage);
+
+    const xml = buildXml(body, {
+        tdlMessage
+    });
+    if (showLog) console.log("xml : ", xml);
+    const jsonToReturn = await executeXmlAndClean(xml);
+    if (showLog) console.log("jsonToReturn : ", jsonToReturn);
+    // const firstRow = jsonToReturn[0];
+    // const { "@_NAME": name, "@_RESERVEDNAME": reservedName } = firstRow;
+
+    return jsonToReturn;
+};
+
+export default startFunc;

package/src/v13/core/buildXml.js

@@ -0,0 +1,9 @@
+export const buildXml = (body, {
+    staticVariables = "",
+    tdlMessage
+}) => {
+
+    return body
+        .replace("{{STATICVARIABLES}}", staticVariables)
+        .replace("{{TDLMESSAGE}}", tdlMessage);
+};

package/src/v13/core/changeType/v1/changeTypeString.js

@@ -0,0 +1,111 @@
+/**
+ * The Story of Tally Type Conversion:
+ *
+ * Act 1 - The XML Artifacts:
+ *   Tally XML represents typed primitive fields with attributes such as `@_TYPE="String"`,
+ *   `@_TYPE="Date"`, or `@_TYPE="Logical"`. The XML parser converts these tags into
+ *   objects where `#text` holds the actual content and `@_TYPE` holds the data type.
+ *   Tags with empty content (e.g. <SERIALMASTER TYPE="String"/>) result in objects
+ *   containing only `@_TYPE` without a `#text` key.
+ *
+ * Act 2 - The String Story:
+ *   When `@_TYPE === "String"`, we extract `#text` as a clean string.
+ *   If `#text` is missing (empty element), we normalize it to an empty string `""`
+ *   rather than keeping the unparsed metadata object.
+ *
+ * Act 3 - The Date Story:
+ *   When `@_TYPE === "Date"`, Tally returns dates in YYYYMMDD format (e.g., 20260904).
+ *   XML parsers often parse this as a numeric literal (20260904). We safely normalize
+ *   this into a clean string representation `'20260904'` for consistent date formatting.
+ *
+ * Act 4 - Logical & Other Primitives:
+ *   When `@_TYPE === "Logical"` (values like 'Yes' / 'No') or other typed fields,
+ *   we unwrap `#text` to its plain scalar value while leaving nested child arrays
+ *   (e.g., inventory lines, ledger entries) intact.
+ */
+
+/**
+ * Normalizes a single field value based on its Tally XML type.
+ *
+ * @param {object} params
+ * @param {*} params.inValue - The field value to inspect and transform.
+ * @returns {*} The cleaned scalar or original complex structure.
+ */
+const handleValue = ({ inValue }) => {
+    const localValue = inValue;
+
+    // Preserve null, undefined, primitives, and nested arrays (e.g. ALLINVENTORYENTRIES.LIST)
+    if (!localValue || typeof localValue !== "object" || Array.isArray(localValue)) {
+        return localValue;
+    }
+
+    // Process Tally typed objects with @_TYPE
+    if ("@_TYPE" in localValue) {
+        const type = localValue["@_TYPE"];
+        const hasText = "#text" in localValue;
+        const rawText = localValue["#text"];
+
+        // Act 2 fallback: Empty tags (<FIELD TYPE="..."/>) have no #text
+        if (!hasText) {
+            return "";
+        }
+
+        switch (type) {
+            // Act 2: String types
+            case "String":
+                return String(rawText);
+
+            // Act 3: Date types (normalize numbers like 20260904 to string '20260904')
+            case "Date":
+                return String(rawText);
+
+            // Act 4: Logical types ('Yes' / 'No')
+            case "Logical":
+                return String(rawText);
+
+            // Other types (Number, Amount, Rate, etc.)
+            default:
+                return rawText;
+        }
+    }
+
+    return localValue;
+};
+
+/**
+ * Transforms an array of rows by converting Tally typed objects into clean values.
+ *
+ * @param {object|Array} input - Either { inArray: Array } or positional Array.
+ * @returns {Array} Array of cleaned rows.
+ */
+const changeTypeString = (input) => {
+    // Supports both { inArray } parameter convention and direct array argument
+    let localArray = Array.isArray(input) ? input : input?.inArray;
+
+    if (!localArray) {
+        return [];
+    }
+
+    if (!Array.isArray(localArray)) {
+        localArray = [localArray];
+    }
+
+    const newArray = localArray.map(row => {
+        if (!row || typeof row !== "object") {
+            return row;
+        }
+
+        const result = {};
+
+        for (const [key, value] of Object.entries(row)) {
+            result[key] = handleValue({ inValue: value });
+        }
+
+        return result;
+    });
+
+    return newArray;
+};
+
+export default changeTypeString;
+export { changeTypeString };

package/src/v13/core/changeType/v2/changeTypeString.js

@@ -0,0 +1,111 @@
+/**
+ * The Story of Tally Type Conversion:
+ *
+ * Act 1 - The XML Artifacts:
+ *   Tally XML represents typed primitive fields with attributes such as `@_TYPE="String"`,
+ *   `@_TYPE="Date"`, or `@_TYPE="Logical"`. The XML parser converts these tags into
+ *   objects where `#text` holds the actual content and `@_TYPE` holds the data type.
+ *   Tags with empty content (e.g. <SERIALMASTER TYPE="String"/>) result in objects
+ *   containing only `@_TYPE` without a `#text` key.
+ *
+ * Act 2 - The String Story:
+ *   When `@_TYPE === "String"`, we extract `#text` as a clean string.
+ *   If `#text` is missing (empty element), we normalize it to an empty string `""`
+ *   rather than keeping the unparsed metadata object.
+ *
+ * Act 3 - The Date Story:
+ *   When `@_TYPE === "Date"`, Tally returns dates in YYYYMMDD format (e.g., 20260904).
+ *   XML parsers often parse this as a numeric literal (20260904). We safely normalize
+ *   this into a clean string representation `'20260904'` for consistent date formatting.
+ *
+ * Act 4 - Logical & Other Primitives:
+ *   When `@_TYPE === "Logical"` (values like 'Yes' / 'No') or other typed fields,
+ *   we unwrap `#text` to its plain scalar value while leaving nested child arrays
+ *   (e.g., inventory lines, ledger entries) intact.
+ */
+
+/**
+ * Normalizes a single field value based on its Tally XML type.
+ *
+ * @param {object} params
+ * @param {*} params.inValue - The field value to inspect and transform.
+ * @returns {*} The cleaned scalar or original complex structure.
+ */
+const handleValue = ({ inValue }) => {
+    const localValue = inValue;
+
+    // Preserve null, undefined, primitives, and nested arrays (e.g. ALLINVENTORYENTRIES.LIST)
+    if (!localValue || typeof localValue !== "object" || Array.isArray(localValue)) {
+        return localValue;
+    }
+
+    // Process Tally typed objects with @_TYPE
+    if ("@_TYPE" in localValue) {
+        const type = localValue["@_TYPE"];
+        const hasText = "#text" in localValue;
+        const rawText = localValue["#text"];
+
+        // Act 2 fallback: Empty tags (<FIELD TYPE="..."/>) have no #text
+        if (!hasText) {
+            return "";
+        }
+
+        switch (type) {
+            // Act 2: String types
+            case "String":
+                return String(rawText);
+
+            // Act 3: Date types (normalize numbers like 20260904 to string '20260904')
+            case "Date":
+                return String(rawText);
+
+            // Act 4: Logical types ('Yes' / 'No')
+            case "Logical":
+                return String(rawText);
+
+            // Other types (Number, Amount, Rate, etc.)
+            default:
+                return rawText;
+        }
+    }
+
+    return localValue;
+};
+
+/**
+ * Transforms an array of rows by converting Tally typed objects into clean values.
+ *
+ * @param {object|Array} input - Either { inArray: Array } or positional Array.
+ * @returns {Array} Array of cleaned rows.
+ */
+const changeTypeString = (input) => {
+    // Supports both { inArray } parameter convention and direct array argument
+    let localArray = Array.isArray(input) ? input : input?.inArray;
+
+    if (!localArray) {
+        return [];
+    }
+
+    if (!Array.isArray(localArray)) {
+        localArray = [localArray];
+    }
+
+    const newArray = localArray.map(row => {
+        if (!row || typeof row !== "object") {
+            return row;
+        }
+
+        const result = {};
+
+        for (const [key, value] of Object.entries(row)) {
+            result[key] = handleValue({ inValue: value });
+        }
+
+        return result;
+    });
+
+    return newArray;
+};
+
+export default changeTypeString;
+export { changeTypeString };

package/src/v13/core/changeType/v3/alterLeaf.js

@@ -0,0 +1,45 @@
+/**
+ * Unwraps Tally XML typed objects and normalizes them into clean scalars.
+ *
+ * Removes @_TYPE (String, Date, Number, Logical, Rate, etc.) and extracts #text.
+ * Empty tags (<TAG TYPE="..."/>) without #text normalize to empty string "".
+ *
+ * @param {object} params
+ * @param {object} params.inValue - Typed object containing @_TYPE.
+ * @returns {*} Clean scalar value.
+ */
+const alterLeaf = ({ inValue }) => {
+    const localValue = inValue;
+
+    if (!localValue || typeof localValue !== "object") {
+        return localValue;
+    }
+
+    if ("@_TYPE" in localValue) {
+        const type = String(localValue["@_TYPE"] || "").toLowerCase();
+        const hasText = "#text" in localValue;
+        const rawText = localValue["#text"];
+
+        if (!hasText || rawText === undefined || rawText === null) {
+            return "";
+        }
+
+        switch (type) {
+            case "string":
+            case "date":
+            case "logical":
+            case "rate":
+                return String(rawText);
+            case "number":
+            case "amount":
+            case "quantity":
+                return rawText;
+            default:
+                return rawText;
+        }
+    }
+
+    return localValue;
+};
+
+export default alterLeaf;

package/src/v13/core/changeType/v3/changeTypeString.js

@@ -0,0 +1,21 @@
+import traverse from "./traverse.js";
+
+/**
+ * Traverses an array of Tally collection rows recursively to remove all @_TYPE
+ * objects (Date, String, Number, Logical, Rate, etc.) throughout the entire tree.
+ *
+ * @param {object|Array} input - Either { inArray: Array } or Array directly.
+ * @returns {Array} Fully cleaned array of rows.
+ */
+const changeTypeString = (input) => {
+    const localArray = Array.isArray(input) ? input : (input?.inArray ?? input);
+
+    if (!localArray) {
+        return [];
+    }
+
+    return traverse({ inData: localArray });
+};
+
+export default changeTypeString;
+export { changeTypeString };

package/src/v13/core/changeType/v3/forArray/v1/index.js

@@ -0,0 +1,17 @@
+import traverse from "../../traverse.js";
+
+const startFunc = ({ inDataAsArray }) => {
+    const localDataAsArray = inDataAsArray;
+
+    if (!Array.isArray(localDataAsArray)) {
+        return [];
+    }
+
+    const childrenArray = localDataAsArray.map(element => {
+        return traverse({ inData: element });
+    });
+
+    return childrenArray;
+};
+
+export default startFunc;

package/src/v13/core/changeType/v3/forObject/v1/index.js

@@ -0,0 +1,19 @@
+import traverse from "../../traverse.js";
+
+const startFunc = ({ inDataAsObject }) => {
+    const localDataAsObject = inDataAsObject;
+
+    if (localDataAsObject === null || typeof localDataAsObject !== "object") {
+        return localDataAsObject;
+    }
+
+    const result = {};
+
+    for (const [key, value] of Object.entries(localDataAsObject)) {
+        result[key] = traverse({ inData: value });
+    }
+
+    return result;
+};
+
+export default startFunc;

package/src/v13/core/changeType/v3/guards.js

@@ -0,0 +1,26 @@
+export const isNullOrUndefined = ({ inData }) => {
+    const localData = inData;
+    return localData === null || localData === undefined;
+};
+
+export const isArray = ({ inData }) => {
+    const localData = inData;
+    return Array.isArray(localData);
+};
+
+export const isObject = ({ inData }) => {
+    const localData = inData;
+    return localData !== null && typeof localData === "object" && !Array.isArray(localData);
+};
+
+export const isTallyType = ({ inData }) => {
+    const localData = inData;
+    return isObject({ inData: localData }) && "@_TYPE" in localData;
+};
+
+export default {
+    isNullOrUndefined,
+    isArray,
+    isObject,
+    isTallyType
+};

package/src/v13/core/changeType/v3/traverse.js

@@ -0,0 +1,47 @@
+import {
+    isNullOrUndefined,
+    isArray,
+    isObject,
+    isTallyType
+} from "./guards.js";
+import forArray from "./forArray/v1/index.js";
+import forObject from "./forObject/v1/index.js";
+import alterLeaf from "./alterLeaf.js";
+
+/**
+ * Central recursive dispatcher adapted from jsonToSpec traversal architecture.
+ *
+ * Recursively walks JSON trees of arbitrary depth.
+ * Leaf nodes containing Tally type wrappers (@_TYPE) are unwrapped and normalized.
+ *
+ * @param {object} params
+ * @param {*} params.inData - Node or subtree to traverse.
+ * @returns {*} Cleaned node or subtree.
+ */
+const traverse = ({ inData }) => {
+    const localData = inData;
+
+    if (isNullOrUndefined({ inData: localData })) {
+        return localData;
+    }
+
+    // Leaf node: Tally typed object with @_TYPE
+    if (isTallyType({ inData: localData })) {
+        return alterLeaf({ inValue: localData });
+    }
+
+    // Branch node: Array
+    if (isArray({ inData: localData })) {
+        return forArray({ inDataAsArray: localData });
+    }
+
+    // Branch node: Object
+    if (isObject({ inData: localData })) {
+        return forObject({ inDataAsObject: localData });
+    }
+
+    // Primitive values (string, number, boolean)
+    return localData;
+};
+
+export default traverse;

package/src/v13/core/cleanTallyResponse.js

@@ -0,0 +1,58 @@
+import changeTypeString from "./changeType/v3/changeTypeString.js";
+
+const showLog = true;
+
+const pullKey = (inCollection) => {
+    let collection = inCollection;
+    // console.log("collection : ", collection);
+
+    if (!collection || typeof collection !== "object") {
+        return { key: undefined, rows: undefined };
+    }
+
+    const [key, rows] = Object.entries(collection).find(
+        ([key, value]) =>
+            !key.startsWith("@") &&
+            Array.isArray(value)
+    ) ?? [];
+
+    return { key, rows };
+};
+
+const cleanTallyResponse = (json) => {
+    // console.log("json : ", json);
+
+    const data = json?.ENVELOPE?.BODY?.DATA;
+    if (showLog) console.log("data : ", data);
+
+    let collection = data?.COLLECTION;
+    if (showLog) console.log("collection1 : ", collection);
+
+    const originalKeys = Object.keys(collection);
+
+    if (originalKeys.length === 1) {
+        collection[originalKeys[0]] = [collection[originalKeys[0]]];
+    };
+
+    if (showLog) console.log("originalKeys : ", originalKeys);
+
+    const { key, rows } = pullKey(collection);
+    if (showLog) console.log("collection1 : ", key, rows);
+    const neededArray = rows;
+    // console.log("neededArray : ", neededArray[1]);
+
+    if (!Array.isArray(neededArray)) {
+        return neededArray;
+    };
+
+    const changedArray = changeTypeString(neededArray);
+
+    if (changedArray?.[1]?.["ALLINVENTORYENTRIES.LIST"]?.[0]?.["BATCHALLOCATIONS.LIST"]) {
+        console.log("changedArray=-------- : ", changedArray[1]["ALLINVENTORYENTRIES.LIST"][0]["BATCHALLOCATIONS.LIST"]);
+    };
+
+    return changedArray;
+};
+
+export default cleanTallyResponse;
+export { cleanTallyResponse };

package/src/v13/core/execute/executeBody.js

@@ -0,0 +1,23 @@
+import { jsonToXml } from "../request/jsonToXml.js";
+import { sendXml } from "../transport/http.js";
+
+const executeBody = async (body, {
+    full = false,
+    url = "http://localhost:9000"
+} = {}) => {
+    // Act 1: Request (Formulating what to send)
+    let xml;
+    if (body.ENVELOPE) {
+        xml = jsonToXml(body);
+    };
+
+    // console.log("--------- : ", xml);
+    // Act 2: Transport (Sending over the wire)
+    const rawXml = await sendXml({ xml, url });
+
+
+    return rawXml;
+};
+
+export default executeBody;
+

package/src/v13/core/execute/executeXml.js

@@ -0,0 +1,16 @@
+// src/v4/core/execute/executeXml.js
+import { sendXml } from "../transport/http.js";
+import { xmlToJson } from "../response/xmlToJson.js";
+
+const startFunc = async (
+    xml,
+    { url = "http://localhost:9000" } = {}
+) => {
+    const rawXml = await sendXml({ xml, url });
+
+    const json = xmlToJson(rawXml);
+
+    return json;
+};
+
+export default startFunc;

package/src/v13/core/execute/executeXmlAndClean.js

@@ -0,0 +1,15 @@
+// src/v13/core/execute/executeXml.js
+import cleanTallyResponse from "../../core/cleanTallyResponse.js";
+import { sendXml } from "../transport/http.js";
+import { xmlToJson } from "../response/xmlToJson.js";
+
+export const executeXmlAndClean = async (
+    xml,
+    { url = "http://localhost:9000" } = {}
+) => {
+    const rawXml = await sendXml({ xml, url });
+
+    const json = xmlToJson(rawXml);
+
+    return cleanTallyResponse(json);
+};

package/src/v13/core/execute/index.js

@@ -0,0 +1,3 @@
+export { default as executeXml } from "./executeXml.js";
+export { executeXmlAndClean } from "./executeXmlAndClean.js";
+

package/src/v13/core/index.js

@@ -0,0 +1,20 @@
+// Sub-modules
+export * as transport from "./transport/index.js";
+export * as response from "./response/index.js";
+export * as execute from "./execute/index.js";
+
+// Direct Core Exports
+export {
+    sendXml,
+    sendToTally
+} from "./transport/index.js";
+
+export {
+    xmlToJson
+} from "./response/index.js";
+
+export {
+    executeXml,
+    executeXmlAndClean
+} from "./execute/index.js";
+

package/src/v13/core/request/envelope.js

@@ -0,0 +1,86 @@
+import { jsonToXml } from "./jsonToXml.js";
+
+/**
+ * Creates a base Tally XML Envelope JavaScript Object.
+ * 
+ * @param {object} [params]
+ * @param {string} [params.id=""] - Collection or Request ID
+ * @param {string} [params.type="COLLECTION"] - Request Type (default "COLLECTION")
+ * @param {object} [params.staticVariables] - Static variables for DESC
+ * @param {object} [params.tdlMessage] - Object to place inside TDLMESSAGE
+ * @returns {object} Tally Envelope JS Object
+ */
+export const createEnvelope = ({
+    id = "",
+    type = "COLLECTION",
+    staticVariables = { SVEXPORTFORMAT: "$$SysName:XML" },
+    tdlMessage = {}
+} = {}) => {
+    return {
+        ENVELOPE: {
+            HEADER: {
+                VERSION: 1,
+                TALLYREQUEST: "EXPORT",
+                TYPE: type,
+                ID: id
+            },
+            BODY: {
+                DESC: {
+                    STATICVARIABLES: staticVariables,
+                    TDL: {
+                        TDLMESSAGE: tdlMessage
+                    }
+                }
+            }
+        }
+    };
+};
+
+/**
+ * Creates a Tally Collection Request Envelope object.
+ * 
+ * @param {object} params
+ * @param {string} params.name - Collection name (used for ID and COLLECTION NAME)
+ * @param {string} params.type - Tally Object Type (e.g. 'Group', 'Ledger', 'Company')
+ * @param {string|string[]} [params.fields] - Field names to FETCH
+ * @param {object} [params.filters] - Additional collection child nodes or filters
+ * @param {object} [params.staticVariables] - Static variables for DESC
+ * @returns {object} Tally Envelope JS Object
+ */
+export const createCollectionEnvelope = ({
+    name,
+    type,
+    fields = [],
+    filters = {},
+    staticVariables = { SVEXPORTFORMAT: "$$SysName:XML" }
+} = {}) => {
+    const fetchValue = Array.isArray(fields)
+        ? fields.join(",\n        ")
+        : (fields || "");
+
+    const collectionDef = {
+        "@_NAME": name,
+        TYPE: type,
+        ...(fetchValue ? { FETCH: fetchValue } : {}),
+        ...filters
+    };
+
+    return createEnvelope({
+        id: name,
+        type: "COLLECTION",
+        staticVariables,
+        tdlMessage: {
+            COLLECTION: collectionDef
+        }
+    });
+};
+
+/**
+ * Helper to build an XML string directly for a collection query.
+ * 
+ * @param {object} options - Options passed to createCollectionEnvelope
+ * @returns {string} XML string ready to send to Tally
+ */
+export const buildCollectionXml = (options) => {
+    return jsonToXml(createCollectionEnvelope(options));
+};

package/src/v13/core/request/index.js

@@ -0,0 +1,6 @@
+export { jsonToXml } from "./jsonToXml.js";
+export {
+    createEnvelope,
+    createCollectionEnvelope,
+    buildCollectionXml
+} from "./envelope.js";

package/src/v13/core/request/jsonToXml.js

@@ -0,0 +1,19 @@
+import { XMLBuilder } from "fast-xml-parser";
+
+/**
+ * Converts a JavaScript Object into a formatted XML string.
+ * Preserves XML attributes prefixed with `@_`.
+ * 
+ * @param {object} jsonObj - The JavaScript object to serialize.
+ * @param {object} [options] - Optional XMLBuilder configurations.
+ * @returns {string} Formatted XML string.
+ */
+export const jsonToXml = (jsonObj, options = {}) => {
+    const builder = new XMLBuilder({
+        ignoreAttributes: false,
+        format: true,
+        ...options
+    });
+
+    return builder.build(jsonObj);
+};

package/src/v13/core/response/index.js

@@ -0,0 +1,2 @@
+export { xmlToJson } from "./xmlToJson.js";
+

package/src/v13/core/response/xmlToJson.js

@@ -0,0 +1,18 @@
+import { XMLParser } from "fast-xml-parser";
+
+/**
+ * Converts XML string into a JavaScript Object.
+ * Preserves XML attributes using the `@_` prefix.
+ * 
+ * @param {string} xml - The XML string to parse.
+ * @param {object} [options] - Optional XMLParser configurations.
+ * @returns {object} The parsed JavaScript object.
+ */
+export const xmlToJson = (xml, options = {}) => {
+    const parser = new XMLParser({
+        ignoreAttributes: false,
+        ...options
+    });
+
+    return parser.parse(xml);
+};

package/src/v13/core/transport/http.js

@@ -0,0 +1,40 @@
+import { xmlToJson } from "../response/xmlToJson.js";
+
+/**
+ * Sends a raw XML string to Tally via HTTP POST and returns the raw response text.
+ * 
+ * @param {object} params
+ * @param {string} params.xml - The XML payload to send.
+ * @param {string} [params.url="http://localhost:9000"] - Tally HTTP endpoint URL.
+ * @returns {Promise<string>} Raw XML response text from Tally.
+ */
+export const sendXml = async ({
+    xml,
+    url = "http://localhost:9000"
+} = {}) => {
+    const res = await fetch(url, {
+        method: "POST",
+        headers: {
+            "Content-Type": "text/xml"
+        },
+        body: xml
+    });
+
+    return await res.text();
+};
+
+/**
+ * Sends an XML payload to Tally via HTTP POST and parses the response to JSON.
+ * 
+ * @param {object} params
+ * @param {string} params.xml - The XML string to send.
+ * @param {string} [params.url="http://localhost:9000"] - Tally HTTP endpoint URL.
+ * @returns {Promise<object>} Parsed JSON response from Tally.
+ */
+export const sendToTally = async ({
+    xml,
+    url = "http://localhost:9000"
+} = {}) => {
+    const text = await sendXml({ xml, url });
+    return xmlToJson(text);
+};

package/src/v13/core/transport/index.js

@@ -0,0 +1 @@
+export { sendXml, sendToTally } from "./http.js";

package/src/v13/daybook/body copy.xml

@@ -0,0 +1,16 @@
+<HEADER>
+    <VERSION>1</VERSION>
+    <TALLYREQUEST>EXPORT</TALLYREQUEST>
+    <TYPE>DATA</TYPE>
+    <ID>Day Book</ID>
+</HEADER>
+
+<BODY>
+    <DESC>
+        <STATICVARIABLES>
+            <SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT>
+            <SVFROMDATE TYPE="Date">4-Sep-2026</SVFROMDATE>
+            <SVTODATE TYPE="Date">4-Sep-2026</SVTODATE>
+        </STATICVARIABLES>
+    </DESC>
+</BODY>

package/src/v13/daybook/body.xml

@@ -0,0 +1,30 @@
+<ENVELOPE>
+  <HEADER>
+    <VERSION>1</VERSION>
+    <TALLYREQUEST>EXPORT</TALLYREQUEST>
+    <TYPE>COLLECTION</TYPE>
+    <ID>KeshavPurchaseInventory</ID>
+  </HEADER>
+  <BODY>
+    <DESC>
+      <STATICVARIABLES>
+        <SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT>
+        <SVFROMDATE TYPE="Date">4-Sep-2026</SVFROMDATE>
+        <SVTODATE TYPE="Date">4-Sep-2026</SVTODATE>
+      </STATICVARIABLES>
+      <TDL>
+        <TDLMESSAGE>
+          <COLLECTION NAME="KeshavPurchaseInventory">
+            <TYPE>Vouchers:VoucherType</TYPE>
+            <CHILDOF>$$VchTypePurchase</CHILDOF>
+            <BELONGSTO>Yes</BELONGSTO>
+            <FILTER>DateFilter</FILTER>
+            <FETCH>AllInventoryEntries</FETCH>
+            <FETCH>Date</FETCH>
+          </COLLECTION>
+          <SYSTEM TYPE="Formulae" NAME="DateFilter">$Date &gt;= ##SVFROMDATE AND $Date &lt;= ##SVTODATE</SYSTEM>
+        </TDLMESSAGE>
+      </TDL>
+    </DESC>
+  </BODY>
+</ENVELOPE>

package/src/v13/fromJson.js

@@ -0,0 +1,86 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+import { executeXml, executeXmlAndClean } from "./core/index.js";
+import { buildXml } from "./core/buildXml.js";
+import bodyJson from "./body.json" with {type: "json"};
+
+import executeBody from "./core/execute/executeBody.js";
+import executeXmlFunc from "./core/execute/executeXml.js";
+import { cleanTallyResponse } from "./core/cleanTallyResponse.js";
+import { xmlToJson } from "./core/response/xmlToJson.js";
+
+import purchaseBody from "./purc/body.json" with {type: "json"};
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const body = fs.readFileSync(path.join(__dirname, "body.xml"), "utf8");
+
+const get = (company, jsonId) => {
+    const { tdlMessage } = bodyJson[jsonId];
+
+    const staticVariables = `<SVCURRENTCOMPANY>${company}</SVCURRENTCOMPANY>`;
+
+    const xml = buildXml(body, {
+        staticVariables,
+        tdlMessage
+    });
+
+    return executeXml(xml);
+};
+
+const clean = (company, jsonId) => {
+    const { tdlMessage } = bodyJson[jsonId];
+
+    const staticVariables = `<SVCURRENTCOMPANY>${company}</SVCURRENTCOMPANY>`;
+
+    const xml = buildXml(body, {
+        staticVariables,
+        tdlMessage
+    });
+
+    return executeXmlAndClean(xml);
+};
+
+const company = async (showLog = false) => {
+    const jsonId = "company";
+
+    const { tdlMessage } = bodyJson[jsonId];
+    if (showLog) console.log("tdlMessage : ", tdlMessage);
+
+    const xml = buildXml(body, {
+        tdlMessage
+    });
+
+    return executeXmlAndClean(xml);
+};
+
+const purchase = async () => {
+    const retXml = await executeBody(purchaseBody);
+    // console.log("retXml : ", retXml);
+    const fromTally = xmlToJson(retXml);
+
+    return cleanTallyResponse(fromTally);
+};
+
+const purchaseFromXml = async () => {
+
+    const xml = fs.readFileSync(path.join(__dirname, "purc/body.xml"), "utf8");
+
+    const retXml = await executeXmlFunc(xml);
+    // console.log("retXml : ", retXml);
+
+    return retXml;
+};
+
+const daybook = async () => {
+
+    const xml = fs.readFileSync(path.join(__dirname, "daybook/body.xml"), "utf8");
+    console.log("xml : ", xml);
+    const retXml = await executeXmlFunc(xml);
+    console.log("retXml : ", retXml);
+
+    return retXml;
+};
+
+export { get, clean, company, purchase, purchaseFromXml, daybook };

package/src/v13/fromXml.js

@@ -0,0 +1,30 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import executeXmlFunc from "./core/execute/executeXml.js";
+import cleanTallyResponse from "./core/cleanTallyResponse.js";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const fromXml = async () => {
+
+    const xml = fs.readFileSync(path.join(__dirname, "daybook/body.xml"), "utf8");
+    console.log("xml : ", xml);
+    const retXml = await executeXmlFunc(xml);
+    console.log("retXml : ", retXml);
+
+    return retXml;
+};
+
+const fromXmlSimple = async () => {
+
+    const xml = fs.readFileSync(path.join(__dirname, "daybook/body.xml"), "utf8");
+    // console.log("xml : ", xml);
+    const retXml = await executeXmlFunc(xml);
+    // console.log("retXml : ", retXml);
+    const clearResponse = cleanTallyResponse(retXml);
+    // console.log("clearResponse : ", clearResponse);
+    return clearResponse;
+};
+
+export { fromXml, fromXmlSimple };

package/src/v13/index.d.ts

@@ -1,8 +1,13 @@
-export interface V6Options {
+export interface V13Options {
     company: string;
     jsonId: string;
     url?: string;
 }
 
-export function get<T = any>(options?: V6Options): Promise<T>;
-export function clean<T = any>(options?: V6Options): Promise<T>;
+export function company(showLog?: boolean): Promise<any>;
+export function get<T = any>(options?: V13Options): Promise<T>;
+export function clean<T = any>(options?: V13Options): Promise<T>;
+export function purchase(): Promise<any>;
+export function purchaseFromXml(): Promise<any>;
+export function daybook(): Promise<any>;
+

package/src/v13/main.d.ts

@@ -0,0 +1,2 @@
+export function company(showLog?: boolean): Promise<any>;
+export default company;

package/src/v13/main.js

@@ -1,3 +1,4 @@
 import company from "./company.js";
 
-export { company };
+export { company };
+export default company;

package/src/v13/purc/body.json

@@ -0,0 +1,36 @@
+{
+  "ENVELOPE": {
+    "HEADER": {
+      "VERSION": 1,
+      "TALLYREQUEST": "EXPORT",
+      "TYPE": "COLLECTION",
+      "ID": "KeshavPurchaseInventory"
+    },
+    "BODY": {
+      "DESC": {
+        "STATICVARIABLES": {
+          "SVEXPORTFORMAT": "$$SysName:XML",
+          "SVFROMDATE": {
+            "@_TYPE": "Date",
+            "#text": "1-Apr-2026"
+          },
+          "SVTODATE": {
+            "@_TYPE": "Date",
+            "#text": "30-Apr-2026"
+          }
+        },
+        "TDL": {
+          "TDLMESSAGE": {
+            "COLLECTION": {
+              "@_NAME": "KeshavPurchaseInventory",
+              "TYPE": "Vouchers:VoucherType",
+              "CHILDOF": "$$VchTypePurchase",
+              "BELONGSTO": "Yes",
+              "FETCH": "Date"
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/src/v13/purc/body.xml

@@ -0,0 +1,28 @@
+<ENVELOPE>
+  <HEADER>
+    <VERSION>1</VERSION>
+    <TALLYREQUEST>EXPORT</TALLYREQUEST>
+    <TYPE>COLLECTION</TYPE>
+    <ID>KeshavPurchaseInventory</ID>
+  </HEADER>
+  <BODY>
+    <DESC>
+      <STATICVARIABLES>
+        <SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT>
+        <SVFROMDATE TYPE="Date">4-Sep-2026</SVFROMDATE>
+        <SVTODATE TYPE="Date">4-Sep-2026</SVTODATE>
+      </STATICVARIABLES>
+      <TDL>
+        <TDLMESSAGE>
+          <COLLECTION NAME="KeshavPurchaseInventory">
+            <TYPE>Vouchers:VoucherType</TYPE>
+            <CHILDOF>$$VchTypePurchase</CHILDOF>
+            <BELONGSTO>Yes</BELONGSTO>
+            <FETCH>AllInventoryEntries</FETCH>
+            <FETCH>Date</FETCH>
+          </COLLECTION>
+        </TDLMESSAGE>
+      </TDL>
+    </DESC>
+  </BODY>
+</ENVELOPE>

package/src/v13/purchases/v1.xml

@@ -0,0 +1,30 @@
+<ENVELOPE>
+  <HEADER>
+    <VERSION>1</VERSION>
+    <TALLYREQUEST>EXPORT</TALLYREQUEST>
+    <TYPE>COLLECTION</TYPE>
+    <ID>KeshavPurchaseInventory</ID>
+  </HEADER>
+  <BODY>
+    <DESC>
+      <STATICVARIABLES>
+        <SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT>
+        <SVFROMDATE TYPE="Date">4-Sep-2026</SVFROMDATE>
+        <SVTODATE TYPE="Date">4-Sep-2026</SVTODATE>
+      </STATICVARIABLES>
+      <TDL>
+        <TDLMESSAGE>
+          <COLLECTION NAME="KeshavPurchaseInventory">
+            <TYPE>Vouchers:VoucherType</TYPE>
+            <CHILDOF>$$VchTypePurchase</CHILDOF>
+            <BELONGSTO>Yes</BELONGSTO>
+            <FILTER>DateFilter</FILTER>
+            <FETCH>AllInventoryEntries</FETCH>
+            <FETCH>Date</FETCH>
+          </COLLECTION>
+          <SYSTEM TYPE="Formulae" NAME="DateFilter">$Date &gt;= ##SVFROMDATE AND $Date &lt;= ##SVTODATE</SYSTEM>
+        </TDLMESSAGE>
+      </TDL>
+    </DESC>
+  </BODY>
+</ENVELOPE>

package/src/v13/purchases.js

@@ -0,0 +1,30 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import executeXmlFunc from "./core/execute/executeXml.js";
+import cleanTallyResponse from "./core/cleanTallyResponse.js";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const fromXml = async () => {
+
+    const xml = fs.readFileSync(path.join(__dirname, "daybook/body.xml"), "utf8");
+    console.log("xml : ", xml);
+    const retXml = await executeXmlFunc(xml);
+    console.log("retXml : ", retXml);
+
+    return retXml;
+};
+
+const fromXmlSimple = async () => {
+
+    const xml = fs.readFileSync(path.join(__dirname, "daybook/body.xml"), "utf8");
+    // console.log("xml : ", xml);
+    const retXml = await executeXmlFunc(xml);
+    // console.log("retXml : ", retXml);
+    const clearResponse = cleanTallyResponse(retXml);
+    // console.log("clearResponse : ", clearResponse);
+    return clearResponse;
+};
+
+export { fromXml, fromXmlSimple };