@microsoft/connected-workbooks 3.2.2-beta → 3.3.1-beta

package/dist/src/utils/constants.js

@@ -2,8 +2,8 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.maxQueryLength = exports.divider = exports.section1PathPrefix = exports.emptyValue = exports.falseValue = exports.trueValue = exports.pivotCachesPathPrefix = exports.xmlTextResultType = exports.textResultType = exports.application = exports.uint8ArrayType = exports.blobFileType = exports.columnIndexOutOfRangeErr = exports.relsNotFoundErr = exports.arrayIsntMxNErr = exports.unexpectedErr = exports.promotedHeadersCannotBeUsedWithoutAdjustingColumnNamesErr = exports.InvalidColumnNameErr = exports.stylesNotFoundErr = exports.EmptyQueryNameErr = exports.QueryNameInvalidCharsErr = exports.QueryNameMaxLengthErr = exports.invalidDataTypeErr = exports.headerNotFoundErr = exports.invalidValueInColumnErr = exports.tableNotFoundErr = exports.queryTableNotFoundErr = exports.templateWithInitialDataErr = exports.formulaSectionNotFoundErr = exports.queryConnectionNotFoundErr = exports.queryAndPivotTableNotFoundErr = exports.queryNameNotFoundErr = exports.emptyQueryMashupErr = exports.base64NotFoundErr = exports.sheetsNotFoundErr = exports.connectionsNotFoundErr = exports.sharedStringsNotFoundErr = exports.docPropsRootElement = exports.docMetadataXmlPath = exports.relsXmlPath = exports.docPropsCoreXmlPath = exports.section1mPath = exports.pivotCachesPath = exports.queryTablesPath = exports.workbookXmlPath = exports.queryTableXmlPath = exports.tableXmlPath = exports.sheetsXmlPath = exports.sharedStringsXmlPath = exports.connectionsXmlPath = void 0;
-exports.OFU = exports.headers = exports.URLS = exports.defaults = exports.elementAttributesValues = exports.dataTypeKind = exports.elementAttributes = exports.element = exports.BOM = exports.falseStr = exports.trueStr = void 0;
+exports.trueValue = exports.pivotCachesPathPrefix = exports.xmlTextResultType = exports.textResultType = exports.application = exports.uint8ArrayType = exports.blobFileType = exports.columnIndexOutOfRangeErr = exports.xlRelsNotFoundErr = exports.relsNotFoundErr = exports.arrayIsntMxNErr = exports.unexpectedErr = exports.promotedHeadersCannotBeUsedWithoutAdjustingColumnNamesErr = exports.InvalidColumnNameErr = exports.stylesNotFoundErr = exports.EmptyQueryNameErr = exports.QueryNameInvalidCharsErr = exports.QueryNameMaxLengthErr = exports.invalidDataTypeErr = exports.headerNotFoundErr = exports.invalidValueInColumnErr = exports.tableReferenceNotFoundErr = exports.tableNotFoundErr = exports.queryTableNotFoundErr = exports.templateWithInitialDataErr = exports.formulaSectionNotFoundErr = exports.queryConnectionNotFoundErr = exports.queryAndPivotTableNotFoundErr = exports.queryNameNotFoundErr = exports.emptyQueryMashupErr = exports.base64NotFoundErr = exports.sheetsNotFoundErr = exports.WorkbookNotFoundERR = exports.connectionsNotFoundErr = exports.sharedStringsNotFoundErr = exports.workbookRelsXmlPath = exports.docPropsRootElement = exports.docMetadataXmlPath = exports.relsXmlPath = exports.docPropsCoreXmlPath = exports.section1mPath = exports.pivotCachesPath = exports.tablesFolderPath = exports.queryTablesPath = exports.workbookXmlPath = exports.queryTableXmlPath = exports.tableXmlPath = exports.sheetsXmlPath = exports.sharedStringsXmlPath = exports.connectionsXmlPath = void 0;
+exports.OFU = exports.headers = exports.URLS = exports.defaults = exports.elementAttributesValues = exports.dataTypeKind = exports.elementAttributes = exports.element = exports.BOM = exports.falseStr = exports.trueStr = exports.maxQueryLength = exports.divider = exports.section1PathPrefix = exports.emptyValue = exports.falseValue = void 0;
 exports.connectionsXmlPath = "xl/connections.xml";
 exports.sharedStringsXmlPath = "xl/sharedStrings.xml";
 exports.sheetsXmlPath = "xl/worksheets/sheet1.xml";
@@ -11,14 +11,17 @@ exports.tableXmlPath = "xl/tables/table1.xml";
 exports.queryTableXmlPath = "xl/queryTables/queryTable1.xml";
 exports.workbookXmlPath = "xl/workbook.xml";
 exports.queryTablesPath = "xl/queryTables/";
+exports.tablesFolderPath = "xl/tables/";
 exports.pivotCachesPath = "xl/pivotCache/";
 exports.section1mPath = "Formulas/Section1.m";
 exports.docPropsCoreXmlPath = "docProps/core.xml";
 exports.relsXmlPath = "_rels/.rels";
 exports.docMetadataXmlPath = "docMetadata";
 exports.docPropsRootElement = "cp:coreProperties";
+exports.workbookRelsXmlPath = "xl/_rels/workbook.xml.rels";
 exports.sharedStringsNotFoundErr = "SharedStrings were not found in template";
 exports.connectionsNotFoundErr = "Connections were not found in template";
+exports.WorkbookNotFoundERR = "workbook was not found in template";
 exports.sheetsNotFoundErr = "Sheets were not found in template";
 exports.base64NotFoundErr = "Base64 was not found in template";
 exports.emptyQueryMashupErr = "Query mashup is empty";
@@ -29,6 +32,7 @@ exports.formulaSectionNotFoundErr = "Formula section wasn't found in template";
 exports.templateWithInitialDataErr = "Cannot use a template file with initial data";
 exports.queryTableNotFoundErr = "Query table wasn't found in template";
 exports.tableNotFoundErr = "Table wasn't found in template";
+exports.tableReferenceNotFoundErr = "Reference not found in the table XML.";
 exports.invalidValueInColumnErr = "Invalid cell value in column";
 exports.headerNotFoundErr = "Invalid JSON file, header is missing";
 exports.invalidDataTypeErr = "Invalid JSON file, invalid data type";
@@ -41,6 +45,7 @@ exports.promotedHeadersCannotBeUsedWithoutAdjustingColumnNamesErr = "Headers can
 exports.unexpectedErr = "Unexpected error";
 exports.arrayIsntMxNErr = "Array isn't MxN";
 exports.relsNotFoundErr = ".rels were not found in template";
+exports.xlRelsNotFoundErr = "workbook.xml.rels were not found xl";
 exports.columnIndexOutOfRangeErr = "Column index out of range";
 exports.blobFileType = "blob";
 exports.uint8ArrayType = "uint8array";
@@ -85,6 +90,7 @@ exports.element = {
     dimension: "dimension",
     selection: "selection",
     kindCell: "c",
+    sheet: "sheet",
 };
 exports.elementAttributes = {
     connection: "connection",
@@ -98,6 +104,7 @@ exports.elementAttributes = {
     name: "name",
     description: "description",
     id: "id",
+    relationId: "r:id",
     type: "Type",
     value: "Value",
     relationshipInfo: "RelationshipInfoContainer",
@@ -117,6 +124,7 @@ exports.elementAttributes = {
     x14acDyDescent: "x14ac:dyDescent",
     xr3uid: "xr3:uid",
     space: "xml:space",
+    target: "Target",
 };
 exports.dataTypeKind = {
     string: "str",
@@ -134,6 +142,7 @@ exports.defaults = {
     queryName: "Query1",
     sheetName: "Sheet1",
     columnName: "Column",
+    tableName: "Table1",
 };
 exports.URLS = {
     PQ: [

package/dist/src/utils/documentUtils.js

@@ -93,13 +93,27 @@ var convertToExcelColumn = function (index) {
     var base = 26; // number of letters in the alphabet
     while (index >= 0) {
         var remainder = index % base;
-        columnStr = String.fromCharCode(remainder + 65) + columnStr; // ASCII 'A' is 65
+        columnStr = String.fromCharCode(remainder + 'A'.charCodeAt(0)) + columnStr;
         index = Math.floor(index / base) - 1;
     }
     return columnStr;
 };
-var getTableReference = function (numberOfCols, numberOfRows) {
-    return "A1:".concat(getCellReferenceRelative(numberOfCols, numberOfRows));
+/**
+ * Parse an Excel range (e.g. "B2:D10") and return its starting row and column indices.
+ * @param cellRangeRef - Range reference string.
+ * @returns Object with numeric row and column.
+ */
+var GetStartPosition = function (cellRangeRef) {
+    var match = cellRangeRef.toUpperCase().match(/^([A-Z]+)(\d+):/);
+    if (!match) {
+        return { row: 0, column: 0 };
+    }
+    var colLetters = match[1], rowStr = match[2];
+    var row = parseInt(rowStr, 10);
+    var column = colLetters
+        .split("")
+        .reduce(function (acc, char) { return acc * 26 + (char.charCodeAt(0) - "A".charCodeAt(0) + 1); }, 0);
+    return { row: row, column: column };
 };
 var createCellElement = function (doc, colIndex, rowIndex, data) {
     var cell = doc.createElementNS(doc.documentElement.namespaceURI, constants_1.element.kindCell);
@@ -146,8 +160,8 @@ exports.default = {
     getCellReferenceRelative: getCellReferenceRelative,
     getCellReferenceAbsolute: getCellReferenceAbsolute,
     createCell: createCellElement,
-    getTableReference: getTableReference,
     updateCellData: updateCellData,
     resolveType: resolveType,
     convertToExcelColumn: convertToExcelColumn,
+    GetStartPosition: GetStartPosition,
 };

package/dist/src/utils/tableUtils.js

@@ -45,7 +45,17 @@ var constants_1 = require("./constants");
 var documentUtils_1 = __importDefault(require("./documentUtils"));
 var uuid_1 = require("uuid");
 var xmldom_qsa_1 = require("xmldom-qsa");
-var updateTableInitialDataIfNeeded = function (zip, tableData, updateQueryTable) { return __awaiter(void 0, void 0, void 0, function () {
+/**
+ * Update initial data for a table, its sheet, query table, and defined name if provided.
+ * @param zip - The JSZip instance containing workbook parts.
+ * @param cellRangeRef - Cell range reference (e.g. "A1:C5").
+ * @param sheetPath - Path to the sheet XML within the zip.
+ * @param tablePath - Path to the table XML within the zip.
+ * @param tableName - Name of the table.
+ * @param tableData - Optional TableData containing headers and rows.
+ * @param updateQueryTable - Whether to update the associated queryTable part.
+ */
+var updateTableInitialDataIfNeeded = function (zip, cellRangeRef, sheetPath, tablePath, sheetName, tableData, updateQueryTable) { return __awaiter(void 0, void 0, void 0, function () {
     var sheetsXmlString, newSheet, queryTableXmlString, newQueryTable, workbookXmlString, newWorkbook, tableXmlString, newTable;
     var _a, _b, _c, _d;
     return __generator(this, function (_e) {
@@ -54,14 +64,14 @@ var updateTableInitialDataIfNeeded = function (zip, tableData, updateQueryTable)
                 if (!tableData) {
                     return [2 /*return*/];
                 }
-                return [4 /*yield*/, ((_a = zip.file(constants_1.sheetsXmlPath)) === null || _a === void 0 ? void 0 : _a.async(constants_1.textResultType))];
+                return [4 /*yield*/, ((_a = zip.file(sheetPath)) === null || _a === void 0 ? void 0 : _a.async(constants_1.textResultType))];
             case 1:
                 sheetsXmlString = _e.sent();
                 if (sheetsXmlString === undefined) {
                     throw new Error(constants_1.sheetsNotFoundErr);
                 }
-                newSheet = updateSheetsInitialData(sheetsXmlString, tableData);
-                zip.file(constants_1.sheetsXmlPath, newSheet);
+                newSheet = updateSheetsInitialData(sheetsXmlString, tableData, cellRangeRef);
+                zip.file(sheetPath, newSheet);
                 if (!updateQueryTable) return [3 /*break*/, 5];
                 return [4 /*yield*/, ((_b = zip.file(constants_1.queryTableXmlPath)) === null || _b === void 0 ? void 0 : _b.async(constants_1.textResultType))];
             case 2:
@@ -79,22 +89,30 @@ var updateTableInitialDataIfNeeded = function (zip, tableData, updateQueryTable)
                 if (workbookXmlString === undefined) {
                     throw new Error(constants_1.sheetsNotFoundErr);
                 }
-                newWorkbook = updateWorkbookInitialData(workbookXmlString, tableData);
+                newWorkbook = updateWorkbookInitialData(workbookXmlString, sheetName + GenerateReferenceFromString(cellRangeRef));
                 zip.file(constants_1.workbookXmlPath, newWorkbook);
                 _e.label = 5;
-            case 5: return [4 /*yield*/, ((_d = zip.file(constants_1.tableXmlPath)) === null || _d === void 0 ? void 0 : _d.async(constants_1.textResultType))];
+            case 5: return [4 /*yield*/, ((_d = zip.file(tablePath)) === null || _d === void 0 ? void 0 : _d.async(constants_1.textResultType))];
             case 6:
                 tableXmlString = _e.sent();
                 if (tableXmlString === undefined) {
                     throw new Error(constants_1.tableNotFoundErr);
                 }
-                newTable = updateTablesInitialData(tableXmlString, tableData, updateQueryTable);
-                zip.file(constants_1.tableXmlPath, newTable);
+                newTable = updateTablesInitialData(tableXmlString, tableData, cellRangeRef, updateQueryTable);
+                zip.file(tablePath, newTable);
                 return [2 /*return*/];
         }
     });
 }); };
-var updateTablesInitialData = function (tableXmlString, tableData, updateQueryTable) {
+/**
+ * Generate updated table XML string with new columns, reference, and filter range.
+ * @param tableXmlString - Original table XML.
+ * @param tableData - TableData containing column names.
+ * @param cellRangeRef - Cell range reference.
+ * @param updateQueryTable - Whether to include queryTable attributes.
+ * @returns Serialized XML string of the updated table.
+ */
+var updateTablesInitialData = function (tableXmlString, tableData, cellRangeRef, updateQueryTable) {
     if (updateQueryTable === void 0) { updateQueryTable = false; }
     var parser = new xmldom_qsa_1.DOMParser();
     var serializer = new xmldom_qsa_1.XMLSerializer();
@@ -115,19 +133,24 @@ var updateTablesInitialData = function (tableXmlString, tableData, updateQueryTa
     tableColumns.setAttribute(constants_1.elementAttributes.count, tableData.columnNames.length.toString());
     tableDoc
         .getElementsByTagName(constants_1.element.table)[0]
-        .setAttribute(constants_1.elementAttributes.reference, "A1:".concat(documentUtils_1.default.getCellReferenceRelative(tableData.columnNames.length - 1, tableData.rows.length + 1)));
+        .setAttribute(constants_1.elementAttributes.reference, cellRangeRef);
     tableDoc
         .getElementsByTagName(constants_1.element.autoFilter)[0]
-        .setAttribute(constants_1.elementAttributes.reference, "A1:".concat(documentUtils_1.default.getCellReferenceRelative(tableData.columnNames.length - 1, tableData.rows.length + 1)));
+        .setAttribute(constants_1.elementAttributes.reference, cellRangeRef);
     return serializer.serializeToString(tableDoc);
 };
-var updateWorkbookInitialData = function (workbookXmlString, tableData) {
+/**
+ * Update the definedName element in workbook XML to a custom name.
+ * @param workbookXmlString - Original workbook XML string.
+ * @param customDefinedName - New defined name text content (e.g. "!$A$1:$C$5").
+ * @returns Serialized XML string of the updated workbook.
+ */
+var updateWorkbookInitialData = function (workbookXmlString, customDefinedName) {
     var newParser = new xmldom_qsa_1.DOMParser();
     var newSerializer = new xmldom_qsa_1.XMLSerializer();
     var workbookDoc = newParser.parseFromString(workbookXmlString, constants_1.xmlTextResultType);
     var definedName = workbookDoc.getElementsByTagName(constants_1.element.definedName)[0];
-    definedName.textContent =
-        constants_1.defaults.sheetName + "!$A$1:".concat(documentUtils_1.default.getCellReferenceAbsolute(tableData.columnNames.length - 1, tableData.rows.length + 1));
+    definedName.textContent = customDefinedName;
     return newSerializer.serializeToString(workbookDoc);
 };
 var updateQueryTablesInitialData = function (queryTableXmlString, tableData) {
@@ -147,42 +170,64 @@ var updateQueryTablesInitialData = function (queryTableXmlString, tableData) {
     queryTableDoc.getElementsByTagName(constants_1.element.queryTableRefresh)[0].setAttribute(constants_1.elementAttributes.nextId, (tableData.columnNames.length + 1).toString());
     return serializer.serializeToString(queryTableDoc);
 };
-var updateSheetsInitialData = function (sheetsXmlString, tableData) {
+/**
+ * Update sheet XML with header row and data rows based on TableData.
+ * @param sheetsXmlString - Original sheet XML string.
+ * @param tableData - TableData containing headers and rows.
+ * @param cellRangeRef - Cell range reference.
+ * @returns Serialized XML string of the updated sheet.
+ */
+var updateSheetsInitialData = function (sheetsXmlString, tableData, cellRangeRef) {
+    var _a = documentUtils_1.default.GetStartPosition(cellRangeRef), row = _a.row, column = _a.column;
     var parser = new xmldom_qsa_1.DOMParser();
     var serializer = new xmldom_qsa_1.XMLSerializer();
     var sheetsDoc = parser.parseFromString(sheetsXmlString, constants_1.xmlTextResultType);
     var sheetData = sheetsDoc.getElementsByTagName(constants_1.element.sheetData)[0];
     sheetData.textContent = "";
-    var rowIndex = 0;
     var columnRow = sheetsDoc.createElementNS(sheetsDoc.documentElement.namespaceURI, constants_1.element.row);
-    columnRow.setAttribute(constants_1.elementAttributes.row, (rowIndex + 1).toString());
-    columnRow.setAttribute(constants_1.elementAttributes.spans, "1:" + tableData.columnNames.length);
+    columnRow.setAttribute(constants_1.elementAttributes.row, row.toString());
+    columnRow.setAttribute(constants_1.elementAttributes.spans, column + ":" + (column + tableData.columnNames.length - 1));
     columnRow.setAttribute(constants_1.elementAttributes.x14acDyDescent, "0.3");
     tableData.columnNames.forEach(function (col, colIndex) {
-        columnRow.appendChild(documentUtils_1.default.createCell(sheetsDoc, colIndex, rowIndex, col));
+        columnRow.appendChild(documentUtils_1.default.createCell(sheetsDoc, colIndex + column - 1, row - 1, col));
     });
     sheetData.appendChild(columnRow);
-    rowIndex++;
-    tableData.rows.forEach(function (row) {
+    row++;
+    tableData.rows.forEach(function (_row) {
         var newRow = sheetsDoc.createElementNS(sheetsDoc.documentElement.namespaceURI, constants_1.element.row);
-        newRow.setAttribute(constants_1.elementAttributes.row, (rowIndex + 1).toString());
-        newRow.setAttribute(constants_1.elementAttributes.spans, "1:" + row.length);
+        newRow.setAttribute(constants_1.elementAttributes.row, row.toString());
+        newRow.setAttribute(constants_1.elementAttributes.spans, column + ":" + (column + tableData.columnNames.length - 1));
         newRow.setAttribute(constants_1.elementAttributes.x14acDyDescent, "0.3");
-        row.forEach(function (cellContent, colIndex) {
-            newRow.appendChild(documentUtils_1.default.createCell(sheetsDoc, colIndex, rowIndex, cellContent));
+        _row.forEach(function (cellContent, colIndex) {
+            newRow.appendChild(documentUtils_1.default.createCell(sheetsDoc, colIndex + column - 1, row - 1, cellContent));
         });
         sheetData.appendChild(newRow);
-        rowIndex++;
+        row++;
     });
-    var reference = documentUtils_1.default.getTableReference(tableData.rows[0].length - 1, tableData.rows.length + 1);
-    sheetsDoc.getElementsByTagName(constants_1.element.dimension)[0].setAttribute(constants_1.elementAttributes.reference, reference);
-    sheetsDoc.getElementsByTagName(constants_1.element.selection)[0].setAttribute(constants_1.elementAttributes.sqref, reference);
+    sheetsDoc.getElementsByTagName(constants_1.element.dimension)[0].setAttribute(constants_1.elementAttributes.reference, cellRangeRef);
+    sheetsDoc.getElementsByTagName(constants_1.element.selection)[0].setAttribute(constants_1.elementAttributes.sqref, cellRangeRef);
     return serializer.serializeToString(sheetsDoc);
 };
+/**
+ * Add Excel-style dollar signs and a '!' prefix to a cell range.
+ * Converts "A1:B2" into "!$A$1:$B$2".
+ * @param cellRangeRef - Range reference string without dollar signs.
+ * @returns Range with dollar signs and prefix.
+ */
+var GenerateReferenceFromString = function (cellRangeRef) {
+    return "!" + cellRangeRef.split(":").map(function (part) {
+        var match = part.match(/^([A-Za-z]+)(\d+)$/);
+        if (match) {
+            var col = match[1], row = match[2];
+            return "$".concat(col.toUpperCase(), "$").concat(row);
+        }
+    }).join(":");
+};
 exports.default = {
     updateTableInitialDataIfNeeded: updateTableInitialDataIfNeeded,
     updateSheetsInitialData: updateSheetsInitialData,
     updateWorkbookInitialData: updateWorkbookInitialData,
     updateTablesInitialData: updateTablesInitialData,
     updateQueryTablesInitialData: updateQueryTablesInitialData,
+    GenerateReferenceFromString: GenerateReferenceFromString,
 };

package/dist/src/utils/xmlInnerPartsUtils.js

@@ -277,6 +277,114 @@ var updatePivotTable = function (tableXmlString, connectionId, refreshOnOpen) {
     }
     return { isPivotTableUpdated: isPivotTableUpdated, newPivotTable: newPivotTable };
 };
+/**
+ * Retrieves the target path of a sheet from workbook relationships by its relationship ID.
+ */
+function getSheetPathFromXlRelId(zip, rId) {
+    return __awaiter(this, void 0, void 0, function () {
+        var relsFile, relsString, relsDoc, relationship, target;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    relsFile = zip.file(constants_1.workbookRelsXmlPath);
+                    if (!relsFile) {
+                        throw new Error(constants_1.xlRelsNotFoundErr);
+                    }
+                    return [4 /*yield*/, relsFile.async(constants_1.textResultType)];
+                case 1:
+                    relsString = _a.sent();
+                    relsDoc = new xmldom_qsa_1.DOMParser().parseFromString(relsString, constants_1.xmlTextResultType);
+                    relationship = relsDoc.querySelector("Relationship[Id=\"".concat(rId, "\"]"));
+                    if (!relationship) {
+                        throw new Error("Relationship not found for Id: ".concat(rId));
+                    }
+                    target = relationship.getAttribute(constants_1.elementAttributes.target);
+                    if (!target) {
+                        throw new Error("Target not found for Relationship Id: ".concat(rId));
+                    }
+                    return [2 /*return*/, target];
+            }
+        });
+    });
+}
+// get sheet name from workbook
+var getSheetPathByNameFromZip = function (zip, sheetName) { return __awaiter(void 0, void 0, void 0, function () {
+    var workbookXmlString, parser, doc, sheetElements, i, rId;
+    var _a;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0: return [4 /*yield*/, ((_a = zip.file(constants_1.workbookXmlPath)) === null || _a === void 0 ? void 0 : _a.async("text"))];
+            case 1:
+                workbookXmlString = _b.sent();
+                if (!workbookXmlString) {
+                    throw new Error(constants_1.WorkbookNotFoundERR);
+                }
+                parser = new xmldom_qsa_1.DOMParser();
+                doc = parser.parseFromString(workbookXmlString, constants_1.xmlTextResultType);
+                sheetElements = doc.getElementsByTagName(constants_1.element.sheet);
+                for (i = 0; i < sheetElements.length; i++) {
+                    if (sheetElements[i].getAttribute(constants_1.elementAttributes.name) === sheetName) {
+                        rId = sheetElements[i].getAttribute(constants_1.elementAttributes.relationId);
+                        if (rId) {
+                            return [2 /*return*/, getSheetPathFromXlRelId(zip, rId)];
+                        }
+                    }
+                }
+                throw new Error("Sheet with name ".concat(sheetName, " not found"));
+        }
+    });
+}); };
+// get definedName
+var getReferenceFromTable = function (zip, tablePath) { return __awaiter(void 0, void 0, void 0, function () {
+    var tableXmlString, parser, doc, tableElements, reference;
+    var _a, _b;
+    return __generator(this, function (_c) {
+        switch (_c.label) {
+            case 0: return [4 /*yield*/, ((_a = zip.file(tablePath)) === null || _a === void 0 ? void 0 : _a.async("text"))];
+            case 1:
+                tableXmlString = _c.sent();
+                if (!tableXmlString) {
+                    throw new Error(constants_1.WorkbookNotFoundERR);
+                }
+                parser = new xmldom_qsa_1.DOMParser();
+                doc = parser.parseFromString(tableXmlString, constants_1.xmlTextResultType);
+                tableElements = doc.getElementsByTagName(constants_1.element.table);
+                reference = (_b = tableElements[0]) === null || _b === void 0 ? void 0 : _b.getAttribute(constants_1.elementAttributes.reference);
+                if (!reference) {
+                    throw new Error(constants_1.tableReferenceNotFoundErr);
+                }
+                return [2 /*return*/, reference.split(":")[0]]; // Return the start cell reference (e.g., "A1" from "A1:B10")
+        }
+    });
+}); };
+var findTablePathFromZip = function (zip, targetTableName) { return __awaiter(void 0, void 0, void 0, function () {
+    var tablesFolder, tableFilePromises, tableFiles, parser, _i, tableFiles_1, _a, path, content, doc, tableElem;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                tablesFolder = zip.folder("xl/tables");
+                if (!tablesFolder)
+                    return [2 /*return*/, ""];
+                tableFilePromises = [];
+                tablesFolder.forEach(function (relativePath, file) {
+                    tableFilePromises.push(file.async(constants_1.textResultType).then(function (content) { return ({ path: relativePath, content: content }); }));
+                });
+                return [4 /*yield*/, Promise.all(tableFilePromises)];
+            case 1:
+                tableFiles = _b.sent();
+                parser = new xmldom_qsa_1.DOMParser();
+                for (_i = 0, tableFiles_1 = tableFiles; _i < tableFiles_1.length; _i++) {
+                    _a = tableFiles_1[_i], path = _a.path, content = _a.content;
+                    doc = parser.parseFromString(content, constants_1.xmlTextResultType);
+                    tableElem = doc.getElementsByTagName(constants_1.element.table)[0];
+                    if (tableElem && tableElem.getAttribute(constants_1.elementAttributes.name) === targetTableName) {
+                        return [2 /*return*/, path];
+                    }
+                }
+                throw new Error(constants_1.tableNotFoundErr);
+        }
+    });
+}); };
 exports.default = {
     updateDocProps: updateDocProps,
     clearLabelInfo: clearLabelInfo,
@@ -286,4 +394,7 @@ exports.default = {
     updatePivotTablesandQueryTables: updatePivotTablesandQueryTables,
     updateQueryTable: updateQueryTable,
     updatePivotTable: updatePivotTable,
+    getSheetPathByNameFromZip: getSheetPathByNameFromZip,
+    getReferenceFromTable: getReferenceFromTable,
+    findTablePathFromZip: findTablePathFromZip,
 };

package/dist/src/utils/xmlPartsUtils.js

@@ -44,26 +44,59 @@ Object.defineProperty(exports, "__esModule", { value: true });
 var constants_1 = require("./constants");
 var mashupDocumentParser_1 = require("./mashupDocumentParser");
 var pqUtils_1 = __importDefault(require("./pqUtils"));
-var xmlInnerPartsUtils_1 = __importDefault(require("./xmlInnerPartsUtils"));
 var tableUtils_1 = __importDefault(require("./tableUtils"));
+var xmlInnerPartsUtils_1 = __importDefault(require("./xmlInnerPartsUtils"));
+var documentUtils_1 = __importDefault(require("./documentUtils"));
 var updateWorkbookDataAndConfigurations = function (zip, fileConfigs, tableData, updateQueryTable) {
     if (updateQueryTable === void 0) { updateQueryTable = false; }
     return __awaiter(void 0, void 0, void 0, function () {
-        return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0: return [4 /*yield*/, xmlInnerPartsUtils_1.default.updateDocProps(zip, fileConfigs === null || fileConfigs === void 0 ? void 0 : fileConfigs.docProps)];
+        var sheetName, tablePath, sheetPath, templateSettings, sheetLocation, _a, cellRangeRef;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    sheetName = constants_1.defaults.sheetName;
+                    tablePath = constants_1.tableXmlPath;
+                    sheetPath = constants_1.sheetsXmlPath;
+                    if (!((fileConfigs === null || fileConfigs === void 0 ? void 0 : fileConfigs.templateFile) !== undefined)) return [3 /*break*/, 4];
+                    templateSettings = fileConfigs === null || fileConfigs === void 0 ? void 0 : fileConfigs.templateSettings;
+                    if (!((templateSettings === null || templateSettings === void 0 ? void 0 : templateSettings.sheetName) !== undefined)) return [3 /*break*/, 2];
+                    return [4 /*yield*/, xmlInnerPartsUtils_1.default.getSheetPathByNameFromZip(zip, templateSettings.sheetName)];
                 case 1:
-                    _a.sent();
-                    if (!((fileConfigs === null || fileConfigs === void 0 ? void 0 : fileConfigs.templateFile) === undefined)) return [3 /*break*/, 3];
+                    sheetLocation = _b.sent();
+                    sheetName = templateSettings.sheetName;
+                    sheetPath = "xl/" + sheetLocation;
+                    _b.label = 2;
+                case 2:
+                    if (!((templateSettings === null || templateSettings === void 0 ? void 0 : templateSettings.tableName) !== undefined)) return [3 /*break*/, 4];
+                    _a = constants_1.tablesFolderPath;
+                    return [4 /*yield*/, xmlInnerPartsUtils_1.default.findTablePathFromZip(zip, templateSettings === null || templateSettings === void 0 ? void 0 : templateSettings.tableName)];
+                case 3:
+                    tablePath = _a + (_b.sent());
+                    _b.label = 4;
+                case 4:
+                    cellRangeRef = "A1";
+                    if (!((fileConfigs === null || fileConfigs === void 0 ? void 0 : fileConfigs.templateFile) != null)) return [3 /*break*/, 6];
+                    return [4 /*yield*/, xmlInnerPartsUtils_1.default.getReferenceFromTable(zip, tablePath)];
+                case 5:
+                    cellRangeRef = _b.sent();
+                    _b.label = 6;
+                case 6:
+                    if (tableData) {
+                        cellRangeRef += ":".concat(documentUtils_1.default.getCellReferenceRelative(tableData.columnNames.length - 1, tableData.rows.length + 1));
+                    }
+                    return [4 /*yield*/, xmlInnerPartsUtils_1.default.updateDocProps(zip, fileConfigs === null || fileConfigs === void 0 ? void 0 : fileConfigs.docProps)];
+                case 7:
+                    _b.sent();
+                    if (!((fileConfigs === null || fileConfigs === void 0 ? void 0 : fileConfigs.templateFile) === undefined)) return [3 /*break*/, 9];
                     // If we are using our base template, we need to clear label info
                     return [4 /*yield*/, xmlInnerPartsUtils_1.default.clearLabelInfo(zip)];
-                case 2:
+                case 8:
                     // If we are using our base template, we need to clear label info
-                    _a.sent();
-                    _a.label = 3;
-                case 3: return [4 /*yield*/, tableUtils_1.default.updateTableInitialDataIfNeeded(zip, tableData, updateQueryTable)];
-                case 4:
-                    _a.sent();
+                    _b.sent();
+                    _b.label = 9;
+                case 9: return [4 /*yield*/, tableUtils_1.default.updateTableInitialDataIfNeeded(zip, cellRangeRef, sheetPath, tablePath, sheetPath, tableData, updateQueryTable)];
+                case 10:
+                    _b.sent();
                     return [2 /*return*/];
             }
         });
@@ -89,8 +122,8 @@ var updateWorkbookPowerQueryDocument = function (zip, queryName, queryMashupDoc)
         }
     });
 }); };
-var updateWorkbookSingleQueryAttributes = function (zip, queryName, refreshOnOpen) { return __awaiter(void 0, void 0, void 0, function () {
-    var connectionsXmlString, _a, connectionId, connectionXmlFileString, sharedStringsXmlString, _b, sharedStringIndex, newSharedStrings, sheetsXmlString, worksheetString;
+var updateWorkbookSingleQueryAttributes = function (zip, queryName, refreshOnOpen, sheetName) { return __awaiter(void 0, void 0, void 0, function () {
+    var connectionsXmlString, _a, connectionId, connectionXmlFileString, sharedStringsXmlString, _b, sharedStringIndex, newSharedStrings, sheetPath, sheetLocation, sheetsXmlString, worksheetString;
     var _c, _d, _e;
     return __generator(this, function (_f) {
         switch (_f.label) {
@@ -110,17 +143,24 @@ var updateWorkbookSingleQueryAttributes = function (zip, queryName, refreshOnOpe
                 }
                 _b = xmlInnerPartsUtils_1.default.updateSharedStrings(sharedStringsXmlString, queryName), sharedStringIndex = _b.sharedStringIndex, newSharedStrings = _b.newSharedStrings;
                 zip.file(constants_1.sharedStringsXmlPath, newSharedStrings);
-                return [4 /*yield*/, ((_e = zip.file(constants_1.sheetsXmlPath)) === null || _e === void 0 ? void 0 : _e.async(constants_1.textResultType))];
+                sheetPath = constants_1.sheetsXmlPath;
+                if (!(sheetName !== undefined)) return [3 /*break*/, 4];
+                return [4 /*yield*/, xmlInnerPartsUtils_1.default.getSheetPathByNameFromZip(zip, sheetName)];
             case 3:
+                sheetLocation = _f.sent();
+                sheetPath = "xl/" + sheetLocation;
+                _f.label = 4;
+            case 4: return [4 /*yield*/, ((_e = zip.file(sheetPath)) === null || _e === void 0 ? void 0 : _e.async(constants_1.textResultType))];
+            case 5:
                 sheetsXmlString = _f.sent();
                 if (sheetsXmlString === undefined) {
                     throw new Error(constants_1.sheetsNotFoundErr);
                 }
                 worksheetString = xmlInnerPartsUtils_1.default.updateWorksheet(sheetsXmlString, sharedStringIndex.toString());
-                zip.file(constants_1.sheetsXmlPath, worksheetString);
+                zip.file(sheetPath, worksheetString);
                 // Update tables
                 return [4 /*yield*/, xmlInnerPartsUtils_1.default.updatePivotTablesandQueryTables(zip, queryName, refreshOnOpen, connectionId)];
-            case 4:
+            case 6:
                 // Update tables
                 _f.sent();
                 return [2 /*return*/];