tally-xml-tdl 1.16.1 → 1.21.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tally-xml-tdl",
-  "version": "1.16.1",
+  "version": "1.21.2",
   "description": "Simple, clean TDL and XML extraction and manipulation tools for Tally",
   "type": "module",
   "main": "src/index.js",
@@ -15,7 +15,7 @@
     }
   },
   "files": [
-    "src/v16",
+    "src/v21",
     "src/index.js",
     "index.js",
     "index.d.ts",

package/src/index.js

@@ -1,3 +1,43 @@
-export * from "./v16/main.js";
-export * as masters from "./v16/masters/index.js";
-export * as vouchers from "./v16/vouchers/index.js";
+import { readdirSync, existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+// 1. Discover all version directories (v1, v2, ... vN) sorted highest first
+const versionFolders = readdirSync(__dirname, { withFileTypes: true })
+    .filter(entry => entry.isDirectory() && /^v\d+$/.test(entry.name))
+    .map(entry => ({ name: entry.name, n: Number(entry.name.slice(1)) }))
+    .sort((a, b) => b.n - a.n);
+
+const latestVersion = versionFolders[0]?.name || "v17";
+
+let company;
+let masters;
+let vouchers;
+
+const versionIndexPath = resolve(__dirname, latestVersion, "index.js");
+
+if (existsSync(versionIndexPath)) {
+    const versionModule = await import(pathToFileURL(versionIndexPath).href);
+    company = versionModule.company ?? versionModule.default;
+    masters = versionModule.masters;
+    vouchers = versionModule.vouchers;
+} else {
+    const mainUrl = pathToFileURL(resolve(__dirname, latestVersion, "main.js")).href;
+    const mastersUrl = pathToFileURL(resolve(__dirname, latestVersion, "masters", "index.js")).href;
+    const vouchersUrl = pathToFileURL(resolve(__dirname, latestVersion, "vouchers", "index.js")).href;
+
+    const [mainModule, mastersModule, vouchersModule] = await Promise.all([
+        import(mainUrl),
+        import(mastersUrl),
+        import(vouchersUrl)
+    ]);
+
+    company = mainModule.company ?? mainModule.default;
+    masters = mastersModule;
+    vouchers = vouchersModule;
+}
+
+export { company, masters, vouchers, latestVersion as version };
+export default company;

package/src/v21/company/index.js

@@ -0,0 +1,7 @@
+import tdlMessage from "../tdlMessage.json" with { type: "json" };
+import { createCompanyApi } from "../createApi.js";
+
+const { all } = createCompanyApi(tdlMessage.company);
+
+export { all };
+export default { all };

package/src/{v16 → v21}/core/execute/executeXml.js

@@ -9,7 +9,7 @@ const startFunc = async (
     const rawXml = await sendXml({ xml, url });
 
     const json = xmlToJson(rawXml);
-
+// console.log("json :", json);
     return json;
 };
 

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

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

package/src/{v16 → v21}/core/index.js

@@ -14,7 +14,9 @@ export {
 } from "./response/index.js";
 
 export {
-    executeXml,
-    executeXmlAndClean
+    executeXml
 } from "./execute/index.js";
 
+export {
+    buildXml
+} from "./buildXml.js";

package/src/v21/createApi.js

@@ -0,0 +1,74 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import { executeXml } from "./core/index.js";
+import { buildXml } from "./core/buildXml.js";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const body = fs.readFileSync(path.join(__dirname, "body.xml"), "utf8");
+
+const createVoucherApi = (tdlMessageString) => {
+    const period = async (company, fromDate, toDate) => {
+        const staticVariables = `<SVCURRENTCOMPANY>${company}</SVCURRENTCOMPANY>
+    <SVFROMDATE TYPE="Date">${fromDate}</SVFROMDATE><SVTODATE TYPE="Date">${toDate}</SVTODATE>`;
+
+        const xml = buildXml(body, {
+            staticVariables,
+            tdlMessage: tdlMessageString
+        });
+
+        return await executeXml(xml);
+    };
+
+    const all = async (company) => {
+        const staticVariables = `<SVCURRENTCOMPANY>${company}</SVCURRENTCOMPANY>`;
+
+        const xml = buildXml(body, {
+            staticVariables,
+            tdlMessage: tdlMessageString
+        });
+
+        return await executeXml(xml);
+    };
+
+    return { period, all };
+};
+
+const createMasterApi = (tdlMessageString) => {
+    const all = async (company, jsonId) => {
+        const staticVariables = `<SVCURRENTCOMPANY>${company}</SVCURRENTCOMPANY>`;
+
+        const xml = buildXml(body, {
+            staticVariables,
+            tdlMessage: tdlMessageString[jsonId]
+        });
+
+        return await executeXml(xml);
+    };
+
+    const api = { all };
+
+    if (tdlMessageString && typeof tdlMessageString === "object") {
+        for (const [key, msg] of Object.entries(tdlMessageString)) {
+            const fn = async (company) => all(company, key);
+            fn.all = fn;
+            api[key] = fn;
+        }
+    }
+
+    return api;
+};
+
+const createCompanyApi = (tdlMessageString) => {
+    const all = async () => {
+        const xml = buildXml(body, {
+            tdlMessage: tdlMessageString
+        });
+
+        return await executeXml(xml);
+    };
+
+    return { all };
+};
+
+export { createVoucherApi, createMasterApi, createCompanyApi };

package/src/v21/index.js

@@ -0,0 +1,6 @@
+import company from "./company/index.js";
+import masters from "./masters/index.js";
+import vouchers from "./vouchers/index.js";
+
+export { company, masters, vouchers };
+export default company;

package/src/v21/masters/index.js

@@ -0,0 +1,30 @@
+import tdlMessage from "../tdlMessage.json" with { type: "json" };
+import { createMasterApi } from "../createApi.js";
+
+const masterApi = createMasterApi(tdlMessage.masters);
+
+const {
+    all,
+    uom,
+    stockItems,
+    stockItemsWithBaseUnits,
+    ledgerNames,
+    ledgerNamesWithDetails,
+    ledgerNamesMoreDetails,
+    stockGroups,
+    stockGroupsAndParent
+} = masterApi;
+
+export {
+    all,
+    uom,
+    stockItems,
+    stockItemsWithBaseUnits,
+    ledgerNames,
+    ledgerNamesWithDetails,
+    ledgerNamesMoreDetails,
+    stockGroups,
+    stockGroupsAndParent
+};
+
+export default masterApi;

package/src/v21/tdlMessage.json

@@ -0,0 +1,17 @@
+{
+  "company": "<TYPE>Company</TYPE><FETCH>$$Alias:Name</FETCH>",
+  "vouchers": {
+    "purchases": "<TYPE>Vouchers:VoucherType</TYPE><CHILDOF>$$$$VchTypePurchase</CHILDOF><BELONGSTO>Yes</BELONGSTO><FETCH>AllInventoryEntries</FETCH><FETCH>Date</FETCH>",
+    "sales": "<TYPE>Vouchers:VoucherType</TYPE><CHILDOF>$$$$VchTypeSales</CHILDOF><BELONGSTO>Yes</BELONGSTO><FETCH>AllInventoryEntries</FETCH><FETCH>Date</FETCH>"
+  },
+  "masters": {
+    "uom": "<TYPE>Unit</TYPE><FETCH>$$Alias:Name</FETCH>",
+    "stockItems": "<TYPE>StockItem</TYPE><FETCH>$$Alias:Name</FETCH>",
+    "stockItemsWithBaseUnits": "<TYPE>StockItem</TYPE><FETCH>$$Alias:Name</FETCH><FETCH>BaseUnits</FETCH>",
+    "ledgerNames": "<TYPE>Ledger</TYPE><FETCH>$$Alias:Name</FETCH>",
+    "ledgerNamesWithDetails": "<TYPE>Ledger</TYPE><FETCH>$$Alias:Name</FETCH><FETCH>GSTRegistrationType</FETCH><FETCH>GSTIN</FETCH>",
+    "ledgerNamesMoreDetails": "<TYPE>Ledger</TYPE><FETCH>$$Alias:Name</FETCH><FETCH>LEDGSTREGDETAILS.LIST</FETCH>",
+    "stockGroups": "<TYPE>StockGroup</TYPE><FETCH>$$Alias:Name</FETCH>",
+    "stockGroupsAndParent": "<TYPE>StockGroup</TYPE><FETCH>$$Alias:Name</FETCH><FETCH>Parent</FETCH>"
+  }
+}

package/src/v21/vouchers/index.js

@@ -0,0 +1,5 @@
+import * as purchases from "./purchases/index.js";
+import * as sales from "./sales/index.js";
+
+export { purchases, sales };
+export default { purchases, sales };

package/src/v21/vouchers/purchases/index.js

@@ -0,0 +1,7 @@
+import tdlMessage from "../../tdlMessage.json" with { type: "json" };
+import { createVoucherApi } from "../../createApi.js";
+
+const { period, all } = createVoucherApi(tdlMessage.vouchers.purchases);
+
+export { period, all };
+export default { period, all };

package/src/v21/vouchers/sales/index.js

@@ -0,0 +1,7 @@
+import tdlMessage from "../../tdlMessage.json" with { type: "json" };
+import { createVoucherApi } from "../../createApi.js";
+
+const { period, all } = createVoucherApi(tdlMessage.vouchers.sales);
+
+export { period, all };
+export default { period, all };

package/src/v16/body copy.xml

@@ -1,25 +0,0 @@
-<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/v16/body.json

@@ -1,78 +0,0 @@
-{
-  "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/v16/company.js

@@ -1,32 +0,0 @@
-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";
-    // console.log("------------ : ", jsonId);
-
-    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);
-
-    return jsonToReturn;
-};
-
-export default startFunc;

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

@@ -1,111 +0,0 @@
-/**
- * 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/v16/core/changeType/v2/changeTypeString.js

@@ -1,111 +0,0 @@
-/**
- * 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/v16/core/changeType/v3/alterLeaf.js

@@ -1,45 +0,0 @@
-/**
- * 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;