tally-xml-tdl 1.6.3 → 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,16 +1,22 @@
 {
   "name": "tally-xml-tdl",
-  "version": "1.6.3",
+  "version": "1.13.2",
   "description": "Simple, clean TDL and XML extraction and manipulation tools for Tally",
   "type": "module",
-  "main": "index.js",
+  "main": "src/v13/main.js",
+  "module": "./src/v13/main.js",
   "types": "index.d.ts",
   "sideEffects": false,
   "exports": {
     ".": {
       "types": "./index.d.ts",
-      "import": "./index.js",
-      "default": "./index.js"
+      "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",
@@ -19,6 +25,7 @@
     }
   },
   "files": [
+    "src/v13",
     "src/v6",
     "src/index.js",
     "index.js",

package/src/index.js

@@ -1,2 +1,2 @@
-export * from "./v6/index.js";
-export * as v6 from "./v6/index.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 };