microsoft-graph 2.3.1 → 2.4.0

package/dist/operations/workbookTable/getWorkbookTableBodyRange.test.js

@@ -4,13 +4,13 @@ import { getDefaultDriveRef } from "../../services/drive.js";
 import { driveItemPath } from "../../services/driveItem.js";
 import { generateTempFileName } from "../../services/temporaryFiles.js";
 import { createWorkbookRangeRef } from "../../services/workbookRange.js";
-import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import { createDefaultWorkbookWorksheetRef } from "../../services/workbookWorksheet.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
 import calculateWorkbook from "../workbook/calculateWorkbook.js";
 import createWorkbook from "../workbook/createWorkbook.js";
 import updateWorkbookRange from "../workbookRange/updateWorkbookRange.js";
 import createWorkbookTable from "./createWorkbookTable.js";
 import getWorkbookTableBodyRange from "./getWorkbookTableBodyRange.js";
-import { createDefaultWorkbookWorksheetRef } from "../../services/workbookWorksheet.js";
 describe("getWorkbookTableBodyRange", () => {
     it("can retrieve the data body range of a table", async () => {
         const workbookName = generateTempFileName("xlsx");
@@ -39,7 +39,7 @@ describe("getWorkbookTableBodyRange", () => {
             ]);
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
 });

package/dist/operations/workbookTable/getWorkbookTableBodyVisibleRange.d.ts

@@ -0,0 +1,13 @@
+import type { WorkbookRange } from "@microsoft/microsoft-graph-types";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+import type { WorkbookRangeRef } from "../../models/WorkbookRangeRef.ts";
+import type { WorkbookTableRef } from "../../models/WorkbookTableRef.ts";
+/**
+ * Retrieve the visible data body range of a table.
+ *
+ * @param tableRef - A reference to the table, optionally including session information.
+ * @returns The data body range of the specified table, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/table-databodyrange
+ */
+export default function getWorkbookTableBodyVisibleRange(tableRef: WorkbookTableRef): GraphOperation<WorkbookRange & WorkbookRangeRef>;
+//# sourceMappingURL=getWorkbookTableBodyVisibleRange.d.ts.map

package/dist/operations/workbookTable/getWorkbookTableBodyVisibleRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWorkbookTableBodyVisibleRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookTable/getWorkbookTableBodyVisibleRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAIzE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,gCAAgC,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAmBrI"}

package/dist/operations/workbookTable/getWorkbookTableBodyVisibleRange.js

@@ -0,0 +1,29 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+import { createWorkbookRangeRef } from "../../services/workbookRange.js";
+/**
+ * Retrieve the visible data body range of a table.
+ *
+ * @param tableRef - A reference to the table, optionally including session information.
+ * @returns The data body range of the specified table, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/table-databodyrange
+ */
+export default function getWorkbookTableBodyVisibleRange(tableRef) {
+    return operation({
+        contextId: tableRef.contextId,
+        method: "GET",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables/{table-id}/dataBodyRange/visibleView", tableRef),
+        headers: {
+            "workbook-session-id": tableRef.sessionId,
+        },
+        body: null,
+        responseTransform: (response) => {
+            const range = response;
+            const rangeRef = createWorkbookRangeRef(tableRef, range.address);
+            return {
+                ...range,
+                ...rangeRef,
+            };
+        },
+    });
+}

package/dist/operations/workbookTable/getWorkbookTableBodyVisibleRange.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getWorkbookTableBodyVisibleRange.test.d.ts.map

package/dist/operations/workbookTable/getWorkbookTableBodyVisibleRange.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWorkbookTableBodyVisibleRange.test.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookTable/getWorkbookTableBodyVisibleRange.test.ts"],"names":[],"mappings":""}

package/dist/operations/workbookTable/getWorkbookTableBodyVisibleRange.test.js

@@ -0,0 +1,45 @@
+import { describe, expect, it } from "vitest";
+import { getDefaultDriveRef } from "../../services/drive.js";
+import { driveItemPath } from "../../services/driveItem.js";
+import { generateTempFileName } from "../../services/temporaryFiles.js";
+import { createWorkbookRangeRef } from "../../services/workbookRange.js";
+import { createWorkbookTableColumnRef } from "../../services/workbookTableColumn.js";
+import { createDefaultWorkbookWorksheetRef } from "../../services/workbookWorksheet.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
+import calculateWorkbook from "../workbook/calculateWorkbook.js";
+import createWorkbook from "../workbook/createWorkbook.js";
+import updateWorkbookRange from "../workbookRange/updateWorkbookRange.js";
+import applyWorkbookTableColumnFilter from "./applyWorkbookTableColumnFilter.js";
+import createWorkbookTable from "./createWorkbookTable.js";
+import getWorkbookTableBodyVisibleRange from "./getWorkbookTableBodyVisibleRange.js";
+describe("getWorkbookTableBodyVisibleRange", () => {
+    it("can retrieve the visible body range of a table from an existing workbook", async () => {
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const driveRef = getDefaultDriveRef();
+        const workbook = await createWorkbook(driveRef, workbookPath);
+        try {
+            const worksheetRef = createDefaultWorkbookWorksheetRef(workbook);
+            const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:D4");
+            const table = await createWorkbookTable(rangeRef, true);
+            await updateWorkbookRange(rangeRef, {
+                values: [
+                    ["A", "B", "C", "D"],
+                    [1, 2, 3, 4],
+                    [5, 6, 7, 8],
+                    [9, 10, 11, 12],
+                ],
+            });
+            await applyWorkbookTableColumnFilter(createWorkbookTableColumnRef(table, "A"), {
+                filterOn: "custom",
+                criterion1: ">5",
+            });
+            await calculateWorkbook(workbook);
+            const visible = await getWorkbookTableBodyVisibleRange(table);
+            expect(visible.values).toEqual([[9, 10, 11, 12]]);
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+});

package/dist/operations/workbookTable/getWorkbookTableHeaderRange.test.js

@@ -5,7 +5,7 @@ import { driveItemPath } from "../../services/driveItem.js";
 import { generateTempFileName } from "../../services/temporaryFiles.js";
 import { createWorkbookRangeRef } from "../../services/workbookRange.js";
 import { createDefaultWorkbookWorksheetRef } from "../../services/workbookWorksheet.js";
-import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
 import calculateWorkbook from "../workbook/calculateWorkbook.js";
 import createWorkbook from "../workbook/createWorkbook.js";
 import updateWorkbookRange from "../workbookRange/updateWorkbookRange.js";
@@ -35,7 +35,7 @@ describe("getWorkbookTableHeaderRange", () => {
             expect(headerRange.values).toEqual([["Header1", "Header2", "Header3", "Header4"]]);
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
 });

package/dist/operations/workbookTable/listWorkbookTableColumns.test.js

@@ -4,7 +4,7 @@ import { driveItemPath } from "../../services/driveItem.js";
 import { generateTempFileName } from "../../services/temporaryFiles.js";
 import { createWorkbookRangeRef } from "../../services/workbookRange.js";
 import { createDefaultWorkbookWorksheetRef } from "../../services/workbookWorksheet.js";
-import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
 import calculateWorkbook from "../workbook/calculateWorkbook.js";
 import createWorkbook from "../workbook/createWorkbook.js";
 import createWorkbookTable from "./createWorkbookTable.js";
@@ -23,7 +23,7 @@ describe("listWorkbookTableColumns", () => {
             expect(columns.length).toBeGreaterThan(0);
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
 });

package/dist/operations/workbookTable/listWorkbookTableRows.test.js

@@ -4,7 +4,7 @@ import { driveItemPath } from "../../services/driveItem.js";
 import { generateTempFileName } from "../../services/temporaryFiles.js";
 import { createWorkbookRangeRef } from "../../services/workbookRange.js";
 import { createDefaultWorkbookWorksheetRef } from "../../services/workbookWorksheet.js";
-import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
 import calculateWorkbook from "../workbook/calculateWorkbook.js";
 import createWorkbook from "../workbook/createWorkbook.js";
 import createWorkbookTable from "./createWorkbookTable.js";
@@ -23,7 +23,7 @@ describe("listWorkbookTableRows", () => {
             expect(rows.length).toBeGreaterThan(0);
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
 });

package/dist/operations/workbookTable/listWorkbookTables.test.js

@@ -4,7 +4,7 @@ import { driveItemPath } from "../../services/driveItem.js";
 import { generateTempFileName } from "../../services/temporaryFiles.js";
 import { createWorkbookRangeRef } from "../../services/workbookRange.js";
 import { createDefaultWorkbookWorksheetRef } from "../../services/workbookWorksheet.js";
-import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
 import calculateWorkbook from "../workbook/calculateWorkbook.js";
 import createWorkbook from "../workbook/createWorkbook.js";
 import createWorkbookTable from "./createWorkbookTable.js";
@@ -24,7 +24,7 @@ describe("listWorkbookTables", () => {
             expect(tables.length).toBeGreaterThan(0);
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
 });

package/dist/operations/workbookWorksheet/createWorkbookWorksheet.test.js

@@ -2,7 +2,7 @@ import { describe, expect, it } from "vitest";
 import { getDefaultDriveRef } from "../../services/drive.js";
 import { driveItemPath } from "../../services/driveItem.js";
 import { generateTempFileName } from "../../services/temporaryFiles.js";
-import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
 import createWorkbook from "../workbook/createWorkbook.js";
 import createWorkbookWorksheet from "./createWorkbookWorksheet.js";
 describe("createWorkbookWorksheet", () => {
@@ -17,7 +17,7 @@ describe("createWorkbookWorksheet", () => {
             expect(worksheet.name).toBe(worksheetName);
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
     it("can create a new worksheet without a name", async () => {
@@ -30,7 +30,7 @@ describe("createWorkbookWorksheet", () => {
             expect(worksheet.name).toBeDefined();
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
 });

package/dist/operations/workbookWorksheet/deleteWorkbookWorksheet.test.js

@@ -2,7 +2,7 @@ import { describe, expect, it } from "vitest";
 import { getDefaultDriveRef } from "../../services/drive.js";
 import { driveItemPath } from "../../services/driveItem.js";
 import { generateTempFileName } from "../../services/temporaryFiles.js";
-import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
 import calculateWorkbook from "../workbook/calculateWorkbook.js";
 import createWorkbook from "../workbook/createWorkbook.js";
 import createWorkbookWorksheet from "./createWorkbookWorksheet.js";
@@ -22,7 +22,7 @@ describe("deleteWorkbookWorksheet", () => {
             expect(worksheets.some((ws) => ws.id === worksheet.worksheetId)).toBe(false);
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
 });

package/dist/operations/workbookWorksheet/getWorkbookWorksheetUsedRange.d.ts

@@ -0,0 +1,13 @@
+import type { WorkbookRange } from "@microsoft/microsoft-graph-types";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+import type { WorkbookRangeRef } from "../../models/WorkbookRangeRef.ts";
+import type { WorkbookWorksheetRef } from "../../models/WorkbookWorksheetRef.ts";
+/**
+ * Retrieve the used range in a worksheet, ignoring trailing rows and columns that are blank.
+ *
+ * @param worksheetRef - A reference to the worksheet, optionally including session information.
+ * @returns The used range of the worksheet, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-usedrange
+ */
+export default function getWorkbookWorksheetUsedRange(worksheetRef: WorkbookWorksheetRef): GraphOperation<WorkbookRange & WorkbookRangeRef>;
+//# sourceMappingURL=getWorkbookWorksheetUsedRange.d.ts.map

package/dist/operations/workbookWorksheet/getWorkbookWorksheetUsedRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWorkbookWorksheetUsedRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookWorksheet/getWorkbookWorksheetUsedRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAItE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAIjF;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,6BAA6B,CAAC,YAAY,EAAE,oBAAoB,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAsB1I"}

package/dist/operations/workbookWorksheet/getWorkbookWorksheetUsedRange.js

@@ -0,0 +1,33 @@
+import ProtocolError from "../../errors/ProtocolError.js";
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+import { createWorkbookRangeRef } from "../../services/workbookRange.js";
+/**
+ * Retrieve the used range in a worksheet, ignoring trailing rows and columns that are blank.
+ *
+ * @param worksheetRef - A reference to the worksheet, optionally including session information.
+ * @returns The used range of the worksheet, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-usedrange
+ */
+export default function getWorkbookWorksheetUsedRange(worksheetRef) {
+    return operation({
+        contextId: worksheetRef.contextId,
+        method: "GET",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range/usedRange", worksheetRef),
+        headers: {
+            "workbook-session-id": worksheetRef.sessionId,
+        },
+        body: null,
+        responseTransform: (response) => {
+            const range = response;
+            if (!range.address) {
+                throw new ProtocolError("Invalid response: address is missing");
+            }
+            const rangeRef = createWorkbookRangeRef(worksheetRef, range.address);
+            return {
+                ...range,
+                ...rangeRef,
+            };
+        },
+    });
+}

package/dist/operations/workbookWorksheet/getWorkbookWorksheetUsedRange.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getWorkbookWorksheetUsedRange.test.d.ts.map

package/dist/operations/workbookWorksheet/getWorkbookWorksheetUsedRange.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWorkbookWorksheetUsedRange.test.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookWorksheet/getWorkbookWorksheetUsedRange.test.ts"],"names":[],"mappings":""}

package/dist/operations/workbookWorksheet/getWorkbookWorksheetUsedRange.test.js

@@ -0,0 +1,54 @@
+import { describe, expect, it } from "vitest";
+import { sequential } from "../../graphApi.js";
+import { getDefaultDriveRef } from "../../services/drive.js";
+import { driveItemPath } from "../../services/driveItem.js";
+import { generateTempFileName } from "../../services/temporaryFiles.js";
+import { createWorkbookRangeRef } from "../../services/workbookRange.js";
+import { createWorkbookWorksheetRef, defaultWorkbookWorksheetId } from "../../services/workbookWorksheet.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
+import calculateWorkbook from "../workbook/calculateWorkbook.js";
+import createWorkbook from "../workbook/createWorkbook.js";
+import updateWorkbookRange from "../workbookRange/updateWorkbookRange.js";
+import getWorkbookUsedRange from "./getWorkbookWorksheetUsedRange.js";
+const values = [
+    [1, 2],
+    [3, 4],
+];
+describe("getWorkbookUsedRange", () => {
+    it("can retrieve the used range from an existing workbook", async () => {
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const driveRef = getDefaultDriveRef();
+        const workbook = await createWorkbook(driveRef, workbookPath);
+        const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+        const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:B2");
+        try {
+            await updateWorkbookRange(rangeRef, {
+                values: values,
+            });
+            await calculateWorkbook(workbook);
+            const usedRange = await getWorkbookUsedRange(worksheetRef);
+            expect(usedRange.values).toEqual(values);
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+    it("can retrieve the used range from an existing workbook sequential", async () => {
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const driveRef = getDefaultDriveRef();
+        const workbook = await createWorkbook(driveRef, workbookPath);
+        const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+        const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:B2");
+        try {
+            const [_, __, usedRange] = await sequential(updateWorkbookRange(rangeRef, {
+                values: values,
+            }), calculateWorkbook(workbook), getWorkbookUsedRange(worksheetRef));
+            expect(usedRange.values).toEqual(values);
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+});

package/dist/operations/workbookWorksheet/getWorkbookWorksheetUsedVisibleRange.d.ts

@@ -0,0 +1,13 @@
+import type { WorkbookRange } from "@microsoft/microsoft-graph-types";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+import type { WorkbookRangeRef } from "../../models/WorkbookRangeRef.ts";
+import type { WorkbookWorksheetRef } from "../../models/WorkbookWorksheetRef.ts";
+/**
+ * Retrieve the visible (not hidden) range in a worksheet.
+ *
+ * @param worksheetRef - A reference to the worksheet, optionally including session information.
+ * @returns The visible range of the worksheet, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-usedrange
+ */
+export default function getWorkbookWorksheetUsedVisibleRange(worksheetRef: WorkbookWorksheetRef): GraphOperation<WorkbookRange & WorkbookRangeRef>;
+//# sourceMappingURL=getWorkbookWorksheetUsedVisibleRange.d.ts.map

package/dist/operations/workbookWorksheet/getWorkbookWorksheetUsedVisibleRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWorkbookWorksheetUsedVisibleRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookWorksheet/getWorkbookWorksheetUsedVisibleRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAIjF;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,oCAAoC,CAAC,YAAY,EAAE,oBAAoB,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAmBjJ"}

package/dist/operations/workbookWorksheet/getWorkbookWorksheetUsedVisibleRange.js

@@ -0,0 +1,29 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+import { createWorkbookRangeRef } from "../../services/workbookRange.js";
+/**
+ * Retrieve the visible (not hidden) range in a worksheet.
+ *
+ * @param worksheetRef - A reference to the worksheet, optionally including session information.
+ * @returns The visible range of the worksheet, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-usedrange
+ */
+export default function getWorkbookWorksheetUsedVisibleRange(worksheetRef) {
+    return operation({
+        contextId: worksheetRef.contextId,
+        method: "GET",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range/usedRange/visibleView", worksheetRef),
+        headers: {
+            "workbook-session-id": worksheetRef.sessionId,
+        },
+        body: null,
+        responseTransform: (response) => {
+            const range = response;
+            const rangeRef = createWorkbookRangeRef(worksheetRef, range.address);
+            return {
+                ...range,
+                ...rangeRef,
+            };
+        },
+    });
+}

package/dist/operations/workbookWorksheet/getWorkbookWorksheetUsedVisibleRange.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getWorkbookWorksheetUsedVisibleRange.test.d.ts.map

package/dist/operations/workbookWorksheet/getWorkbookWorksheetUsedVisibleRange.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWorkbookWorksheetUsedVisibleRange.test.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookWorksheet/getWorkbookWorksheetUsedVisibleRange.test.ts"],"names":[],"mappings":""}

package/dist/operations/workbookWorksheet/getWorkbookWorksheetUsedVisibleRange.test.js

@@ -0,0 +1,37 @@
+import { describe, expect, it } from "vitest";
+import { getDefaultDriveRef } from "../../services/drive.js";
+import { driveItemPath } from "../../services/driveItem.js";
+import { generateTempFileName } from "../../services/temporaryFiles.js";
+import { createWorkbookRangeRef } from "../../services/workbookRange.js";
+import { createWorkbookWorksheetRef, defaultWorkbookWorksheetId } from "../../services/workbookWorksheet.js";
+import setRowHidden from "../../tasks/setRowHidden.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
+import calculateWorkbook from "../workbook/calculateWorkbook.js";
+import createWorkbook from "../workbook/createWorkbook.js";
+import updateWorkbookRange from "../workbookRange/updateWorkbookRange.js";
+import getWorkbookWorksheetUsedVisibleRange from "./getWorkbookWorksheetUsedVisibleRange.js";
+describe("getWorkbookWorksheetUsedVisibleRange", () => {
+    it("can retrieve the used visible range from an existing workbook", async () => {
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const driveRef = getDefaultDriveRef();
+        const workbook = await createWorkbook(driveRef, workbookPath);
+        const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+        const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:B2");
+        try {
+            await updateWorkbookRange(rangeRef, {
+                values: [
+                    [1, 2],
+                    [3, 4],
+                ],
+            });
+            await setRowHidden(createWorkbookRangeRef(worksheetRef, "1:1"), true);
+            await calculateWorkbook(workbook);
+            const usedRange = await getWorkbookWorksheetUsedVisibleRange(worksheetRef);
+            expect(usedRange.values).toEqual([[3, 4]]);
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+});

package/dist/operations/workbookWorksheet/listWorkbookWorksheets.test.js

@@ -3,7 +3,7 @@ import { sequential } from "../../graphApi.js";
 import { getDefaultDriveRef } from "../../services/drive.js";
 import { driveItemPath } from "../../services/driveItem.js";
 import { generateTempFileName } from "../../services/temporaryFiles.js";
-import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
 import calculateWorkbook from "../workbook/calculateWorkbook.js";
 import createWorkbook from "../workbook/createWorkbook.js";
 import createWorkbookWorksheet from "./createWorkbookWorksheet.js";
@@ -24,7 +24,7 @@ describe("listWorkbookWorksheets", () => {
             expect(worksheetIds).toContain(worksheet2.worksheetId);
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
     it("can list worksheets in an existing workbook parallel", async () => {
@@ -39,7 +39,7 @@ describe("listWorkbookWorksheets", () => {
             expect(worksheetIds).toContain(worksheet2.worksheetId);
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
 });

package/dist/operations/workbookWorksheet/updateWorkbookWorksheet.test.js

@@ -3,8 +3,8 @@ import { getDefaultDriveRef } from "../../services/drive.js";
 import { driveItemPath } from "../../services/driveItem.js";
 import { generateTempFileName } from "../../services/temporaryFiles.js";
 import { createDefaultWorkbookWorksheetRef } from "../../services/workbookWorksheet.js";
-import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
 import getWorkbookWorksheetByName from "../../tasks/getWorkbookWorksheetByName.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
 import calculateWorkbook from "../workbook/calculateWorkbook.js";
 import createWorkbook from "../workbook/createWorkbook.js";
 import createWorkbookWorksheet from "./createWorkbookWorksheet.js";
@@ -23,7 +23,7 @@ describe("updateWorkbookWorksheet", () => {
             expect(updatedWorksheet.name).toBe(newName);
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
     it("can update the visibility of an existing worksheet", async () => {
@@ -38,7 +38,7 @@ describe("updateWorkbookWorksheet", () => {
             expect(updatedWorksheet.visibility).toBe("Hidden");
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
 });

package/dist/services/workbookTableColumn.d.ts

@@ -0,0 +1,12 @@
+import type { ColumnAddress } from "../models/Address.ts";
+import type { WorkbookTableColumnRef } from "../models/WorkbookTableColumnRef.ts";
+import type { WorkbookTableRef } from "../models/WorkbookTableRef.ts";
+/**
+ * Creates a reference to a workbook table column.
+ * @param tableRef - The reference to the worksheet containing the table.
+ * @param column  - The ID of the table.
+ * @returns A reference to the workbook table.
+ * @throws Error if the table ID is missing.
+ */
+export declare function createWorkbookTableColumnRef(tableRef: WorkbookTableRef, column: ColumnAddress | undefined): WorkbookTableColumnRef;
+//# sourceMappingURL=workbookTableColumn.d.ts.map

package/dist/services/workbookTableColumn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbookTableColumn.d.ts","sourceRoot":"","sources":["../../src/services/workbookTableColumn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,sBAAsB,CAelI"}

package/dist/services/workbookTableColumn.js

@@ -0,0 +1,22 @@
+/**
+ * Creates a reference to a workbook table column.
+ * @param tableRef - The reference to the worksheet containing the table.
+ * @param column  - The ID of the table.
+ * @returns A reference to the workbook table.
+ * @throws Error if the table ID is missing.
+ */
+export function createWorkbookTableColumnRef(tableRef, column) {
+    if (!column) {
+        throw new Error("TableId is missing");
+    }
+    return {
+        contextId: tableRef.contextId,
+        siteId: tableRef.siteId,
+        driveId: tableRef.driveId,
+        itemId: tableRef.itemId,
+        worksheetId: tableRef.worksheetId,
+        sessionId: tableRef.sessionId,
+        tableId: tableRef.tableId,
+        column: column,
+    };
+}

package/dist/tasks/getRangeLastUsedCell.test.js

@@ -8,8 +8,8 @@ import { driveItemPath } from "../services/driveItem.js";
 import { generateTempFileName } from "../services/temporaryFiles.js";
 import { createWorkbookRangeRef } from "../services/workbookRange.js";
 import { createWorkbookWorksheetRef, defaultWorkbookWorksheetId } from "../services/workbookWorksheet.js";
-import deleteDriveItemWithRetry from "./deleteDriveItemWithRetry.js";
 import getRangeLastUsedCell from "./getRangeLastUsedCell.js";
+import tryDeleteDriveItem from "./tryDeleteDriveItem.js";
 describe("getRangeLastUsedCell", () => {
     it("should return the last used cell value", async () => {
         const workbookName = generateTempFileName("xlsx");
@@ -33,7 +33,7 @@ describe("getRangeLastUsedCell", () => {
             expect(result.address).toBe("B2");
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
     it("should return the last non-empty cell value when the last cell is empty", async () => {
@@ -58,7 +58,7 @@ describe("getRangeLastUsedCell", () => {
             expect(result.address).toBe("A2");
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
     it("should return null when no cells are used", async () => {
@@ -79,7 +79,7 @@ describe("getRangeLastUsedCell", () => {
             expect(result).toBeNull();
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
 });

package/dist/tasks/getWorkbookTableVisibleBody.d.ts

@@ -1,10 +1,5 @@
 import type { WorkbookRangeView } from "@microsoft/microsoft-graph-types";
 import type { WorkbookTableRef } from "../models/WorkbookTableRef.ts";
-/**
- * Get the visible cells of a workbook table. Hidden cells are omitted.
- *
- * @param tableRef - A reference to the workbook table.
- * @returns The visible range of the table.
- */
+/** @deprecated Use `getWorkbookTableBodyVisibleRange` instead. */
 export declare function getWorkbookTableVisibleBody(tableRef: WorkbookTableRef): Promise<WorkbookRangeView>;
 //# sourceMappingURL=getWorkbookTableVisibleBody.d.ts.map

package/dist/tasks/getWorkbookTableVisibleBody.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getWorkbookTableVisibleBody.d.ts","sourceRoot":"","sources":["../../src/tasks/getWorkbookTableVisibleBody.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAKxG"}
+{"version":3,"file":"getWorkbookTableVisibleBody.d.ts","sourceRoot":"","sources":["../../src/tasks/getWorkbookTableVisibleBody.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE,kEAAkE;AAClE,wBAAsB,2BAA2B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAKxG"}

package/dist/tasks/getWorkbookTableVisibleBody.js

@@ -1,11 +1,6 @@
 import getWorkbookVisibleRange from "../operations/workbookRange/getWorkbookVisibleRange.js";
 import getWorkbookTableBodyRange from "../operations/workbookTable/getWorkbookTableBodyRange.js";
-/**
- * Get the visible cells of a workbook table. Hidden cells are omitted.
- *
- * @param tableRef - A reference to the workbook table.
- * @returns The visible range of the table.
- */
+/** @deprecated Use `getWorkbookTableBodyVisibleRange` instead. */
 export async function getWorkbookTableVisibleBody(tableRef) {
     const range = await getWorkbookTableBodyRange(tableRef);
     const visibleRange = await getWorkbookVisibleRange(range);