tally-xml-tdl 1.21.3 → 1.22.4

package/package.json

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

package/src/index.js

@@ -1,43 +1,2 @@
-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;
+export * from "./v22/index.js";
+export { default } from "./v22/index.js";

package/src/v20/company/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/v20/company/index.js

@@ -0,0 +1,29 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+import { executeXml } from "../core/index.js";
+import { buildXml } from "../core/buildXml.js";
+import tdlJson from "./tdl.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 { tdlMessage } = tdlJson;
+    if (showLog) console.log("tdlMessage : ", tdlMessage);
+
+    const xml = buildXml(body, {
+        tdlMessage
+    });
+
+    if (showLog) console.log("xml : ", xml);
+
+    const jsonToReturn = await executeXml(xml);
+
+    if (showLog) console.log("jsonToReturn : ", jsonToReturn);
+
+    return jsonToReturn;
+};
+
+export default startFunc;

package/src/v20/company/tdl.json

@@ -0,0 +1,4 @@
+{
+  "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT>",
+  "tdlMessage": "<TYPE>Company</TYPE><FETCH>$$Alias:Name</FETCH>"
+}

package/src/v20/core/buildXml.js

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

package/src/v20/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);
+// console.log("json :", json);
+    return json;
+};
+
+export default startFunc;

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

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

package/src/v20/core/index.js

@@ -0,0 +1,22 @@
+// 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
+} from "./execute/index.js";
+
+export {
+    buildXml
+} from "./buildXml.js";

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

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

package/src/v20/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/v20/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/v20/core/transport/index.js

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

package/src/v20/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/v20/masters/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/v20/masters/index.js

@@ -0,0 +1,39 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+import { executeXml } from "../core/index.js";
+import { buildXml } from "../core/buildXml.js";
+import bodyJson from "./masters.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, staticVariables } = bodyJson[jsonId];
+
+    const companyFilter = `<SVCURRENTCOMPANY>${company}</SVCURRENTCOMPANY>${staticVariables || ""}`;
+
+    const xml = buildXml(body, {
+        staticVariables: companyFilter,
+        tdlMessage
+    });
+
+    return executeXml(xml);
+};
+
+export { get, clean };
+export default { get, clean };

package/src/v20/masters/masters.json

@@ -0,0 +1,86 @@
+{
+  "company": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT>",
+    "tdlMessage": "<TYPE>Company</TYPE><FETCH>$$Alias:Name</FETCH>"
+  },
+  "allPurchases": {
+    "staticVariables": "<SVEXPORTFORMAT>$$SysName:XML</SVEXPORTFORMAT>",
+    "tdlMessage": "<TYPE>Vouchers</TYPE><FETCH>Date</FETCH>"
+  },
+  "purchasesPeriod": {
+    "staticVariables": "<SVFROMDATE TYPE=\"Date\">1-Apr-2026</SVFROMDATE><SVTODATE TYPE=\"Date\">30-Apr-2026</SVTODATE>",
+    "tdlMessage": "<TYPE>Vouchers</TYPE><FETCH>Date</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>"
+  },
+  "purchases10": {
+    "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/v20/vouchers/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/v20/vouchers/createVoucherApi.js

@@ -0,0 +1,38 @@
+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 };
+};
+
+export { createVoucherApi };
+export default createVoucherApi;

package/src/v20/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/v20/vouchers/purchases/index.js

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

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

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

package/src/v20/vouchers/tdlMessage.json

@@ -0,0 +1,4 @@
+{
+  "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>"
+}

package/src/v21/tdlMessage.json

@@ -12,6 +12,7 @@
     "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>"
+    "stockGroupsAndParent": "<TYPE>StockGroup</TYPE><FETCH>$$Alias:Name</FETCH><FETCH>Parent</FETCH>",
+    "stockItemsWithBatches": "<TYPE>StockItem</TYPE><FETCH>$$Alias:Name</FETCH><FETCH>BaseUnits</FETCH><FETCH>BatchAllocations.*</FETCH>"
   }
 }

package/src/v22/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/v22/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/v22/core/buildXml.js

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

package/src/v22/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);
+// console.log("json :", json);
+    return json;
+};
+
+export default startFunc;

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

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

package/src/v22/core/index.js

@@ -0,0 +1,22 @@
+// 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
+} from "./execute/index.js";
+
+export {
+    buildXml
+} from "./buildXml.js";

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

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

package/src/v22/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/v22/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/v22/core/transport/index.js

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

package/src/v22/createApi.js

@@ -0,0 +1,87 @@
+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 = (arg) => {
+    const inTdlMessage = (arg && typeof arg === "object" && "inTdlMessage" in arg) ? arg.inTdlMessage : arg;
+    const localTdlMessage = inTdlMessage;
+
+    const all = async (company, jsonId = "all") => {
+        const localCompany = company;
+        const localJsonId = jsonId;
+        const staticVariables = `<SVCURRENTCOMPANY>${localCompany}</SVCURRENTCOMPANY>`;
+
+        let messageTemplate;
+        if (typeof localTdlMessage === "string") {
+            messageTemplate = localTdlMessage;
+        } else if (localTdlMessage && typeof localTdlMessage === "object") {
+            messageTemplate = localTdlMessage[localJsonId] || localTdlMessage.all || localTdlMessage.names || Object.values(localTdlMessage)[0];
+        }
+
+        const xml = buildXml(body, {
+            staticVariables,
+            tdlMessage: messageTemplate
+        });
+
+        return await executeXml(xml);
+    };
+
+    const mainFn = async (company) => all(company, "all");
+    mainFn.all = (company, jsonId) => (jsonId ? all(company, jsonId) : all(company, "all"));
+
+    if (localTdlMessage && typeof localTdlMessage === "object") {
+        for (const [key, msg] of Object.entries(localTdlMessage)) {
+            const fn = async (company) => all(company, key);
+            fn.all = fn;
+            mainFn[key] = fn;
+        }
+    }
+
+    return mainFn;
+};
+
+const createCompanyApi = (tdlMessageString) => {
+    const all = async () => {
+        const xml = buildXml(body, {
+            tdlMessage: tdlMessageString
+        });
+
+        return await executeXml(xml);
+    };
+
+    return { all };
+};
+
+export { createVoucherApi, createMasterApi, createCompanyApi };

package/src/v22/index.js

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

package/src/v22/masters/Ledger/index.js

@@ -0,0 +1,22 @@
+import tdlMessage from "../../tdlMessage.json" with { type: "json" };
+import { createMasterApi } from "../../createApi.js";
+
+const ledgerApi = createMasterApi({ inTdlMessage: tdlMessage.masters.Ledger });
+
+const {
+    all,
+    names,
+    withDetails,
+    moreDetails,
+    withGstDetails
+} = ledgerApi;
+
+export {
+    all,
+    names,
+    withDetails,
+    moreDetails,
+    withGstDetails
+};
+
+export default ledgerApi;

package/src/v22/masters/StockGroup/index.js

@@ -0,0 +1,18 @@
+import tdlMessage from "../../tdlMessage.json" with { type: "json" };
+import { createMasterApi } from "../../createApi.js";
+
+const stockGroupApi = createMasterApi({ inTdlMessage: tdlMessage.masters.StockGroup });
+
+const {
+    all,
+    names,
+    withParent
+} = stockGroupApi;
+
+export {
+    all,
+    names,
+    withParent
+};
+
+export default stockGroupApi;

package/src/v22/masters/StockItem/index.js

@@ -0,0 +1,20 @@
+import tdlMessage from "../../tdlMessage.json" with { type: "json" };
+import { createMasterApi } from "../../createApi.js";
+
+const stockItemApi = createMasterApi({ inTdlMessage: tdlMessage.masters.StockItem });
+
+const {
+    all,
+    names,
+    withBaseUnits,
+    withBatches
+} = stockItemApi;
+
+export {
+    all,
+    names,
+    withBaseUnits,
+    withBatches
+};
+
+export default stockItemApi;

package/src/v22/masters/Unit/index.js

@@ -0,0 +1,16 @@
+import tdlMessage from "../../tdlMessage.json" with { type: "json" };
+import { createMasterApi } from "../../createApi.js";
+
+const unitApi = createMasterApi({ inTdlMessage: tdlMessage.masters.Unit });
+
+const {
+    all,
+    names
+} = unitApi;
+
+export {
+    all,
+    names
+};
+
+export default unitApi;

package/src/v22/masters/index.js

@@ -0,0 +1,57 @@
+import Unit from "./Unit/index.js";
+import StockItem from "./StockItem/index.js";
+import Ledger from "./Ledger/index.js";
+import StockGroup from "./StockGroup/index.js";
+
+const all = async (company, type, variant = "all") => {
+    const localCompany = company;
+    const localType = type;
+    const localVariant = variant;
+
+    const target = masters[localType];
+    if (!target) {
+        throw new Error(`Master type '${localType}' not found.`);
+    }
+    if (typeof target[localVariant] === "function") {
+        return await target[localVariant](localCompany);
+    }
+    if (typeof target.all === "function") {
+        return await target.all(localCompany, localVariant);
+    }
+    return await target(localCompany);
+};
+
+const masters = {
+    all,
+    Unit,
+    StockItem,
+    Ledger,
+    StockGroup,
+    // Aliases for convenience
+    unit: Unit,
+    stockItem: StockItem,
+    stockItems: StockItem,
+    ledger: Ledger,
+    ledgers: Ledger,
+    stockGroup: StockGroup,
+    stockGroups: StockGroup,
+    uom: Unit
+};
+
+export {
+    all,
+    Unit,
+    StockItem,
+    Ledger,
+    StockGroup,
+    Unit as unit,
+    StockItem as stockItem,
+    StockItem as stockItems,
+    Ledger as ledger,
+    Ledger as ledgers,
+    StockGroup as stockGroup,
+    StockGroup as stockGroups,
+    Unit as uom
+};
+
+export default masters;

package/src/v22/tdlMessage.json

@@ -0,0 +1,31 @@
+{
+  "company": "<TYPE>Company</TYPE><FETCH>$$Alias:Name</FETCH>",
+  "vouchers": {
+    "purchases": "<TYPE>Vouchers:VoucherType</TYPE><CHILDOF>$$$$VchTypePurchase</CHILDOF><BELONGSTO>Yes</BELONGSTO><FETCH>Date, VoucherNumber, VoucherTypeName, PartyLedgerName, Amount, AllInventoryEntries</FETCH>",
+    "sales": "<TYPE>Vouchers:VoucherType</TYPE><CHILDOF>$$$$VchTypeSales</CHILDOF><BELONGSTO>Yes</BELONGSTO><FETCH>Date, VoucherNumber, VoucherTypeName, PartyLedgerName, Amount, AllInventoryEntries</FETCH>"
+  },
+  "masters": {
+    "Unit": {
+      "all": "<TYPE>Unit</TYPE><FETCH>$$Alias:Name</FETCH>",
+      "names": "<TYPE>Unit</TYPE><FETCH>$$Alias:Name</FETCH>"
+    },
+    "StockItem": {
+      "all": "<TYPE>StockItem</TYPE><FETCH>$$Alias:Name</FETCH>",
+      "names": "<TYPE>StockItem</TYPE><FETCH>$$Alias:Name</FETCH>",
+      "withBaseUnits": "<TYPE>StockItem</TYPE><FETCH>$$Alias:Name</FETCH><FETCH>BaseUnits</FETCH>",
+      "withBatches": "<TYPE>StockItem</TYPE><FETCH>$$Alias:Name</FETCH><FETCH>BaseUnits</FETCH><FETCH>BatchAllocations.*</FETCH>"
+    },
+    "Ledger": {
+      "all": "<TYPE>Ledger</TYPE><FETCH>$$Alias:Name</FETCH>",
+      "names": "<TYPE>Ledger</TYPE><FETCH>$$Alias:Name</FETCH>",
+      "withDetails": "<TYPE>Ledger</TYPE><FETCH>$$Alias:Name</FETCH><FETCH>GSTRegistrationType</FETCH><FETCH>GSTIN</FETCH>",
+      "moreDetails": "<TYPE>Ledger</TYPE><FETCH>$$Alias:Name</FETCH><FETCH>LEDGSTREGDETAILS.LIST</FETCH>",
+      "withGstDetails": "<TYPE>Ledger</TYPE><FETCH>$$Alias:Name</FETCH><FETCH>LEDGSTREGDETAILS.LIST</FETCH>"
+    },
+    "StockGroup": {
+      "all": "<TYPE>StockGroup</TYPE><FETCH>$$Alias:Name</FETCH>",
+      "names": "<TYPE>StockGroup</TYPE><FETCH>$$Alias:Name</FETCH>",
+      "withParent": "<TYPE>StockGroup</TYPE><FETCH>$$Alias:Name</FETCH><FETCH>Parent</FETCH>"
+    }
+  }
+}

package/src/v22/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/v22/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/v22/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 };