microsoft-graph 2.3.1 → 2.5.0

package/dist/operations/workbookTable/deleteWorkbookTable.js

@@ -0,0 +1,22 @@
+// https://learn.microsoft.com/en-us/graph/api/table-delete
+// DELETE /sites/{site-id}/drives/{drive-id/items/{item-id}/workbook/tables/{table-id}
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/**
+ * Delete a workbook table. All data in the table will be cleared.
+ *
+ * @param tableRef - A reference to the table, optionally including session information.
+ * @see https://learn.microsoft.com/en-us/graph/api/table-delete
+ */
+export default function deleteWorkbookTable(tableRef) {
+    return operation({
+        contextId: tableRef.contextId,
+        method: "DELETE",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/tables/{table-id}", tableRef),
+        headers: {
+            "workbook-session-id": tableRef.sessionId,
+        },
+        body: null,
+        responseTransform: () => undefined,
+    });
+}

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

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

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

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

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

@@ -0,0 +1,48 @@
+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 { createDefaultWorkbookWorksheetRef } from "../../services/workbookWorksheet.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
+import createWorkbook from "../workbook/createWorkbook.js";
+import getWorkbookWorksheetRange from "../workbookRange/getWorkbookWorksheetRange.js";
+import updateWorkbookRange from "../workbookRange/updateWorkbookRange.js";
+import createWorkbookTable from "./createWorkbookTable.js";
+import deleteWorkbookTable from "./deleteWorkbookTable.js";
+import getWorkbookTable from "./getWorkbookTable.js";
+describe("deleteWorkbookTable", () => {
+    it("can delete a workbook table", 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 deleteWorkbookTable(table);
+            await expect(async () => {
+                await getWorkbookTable(table);
+            }).rejects.toThrow();
+            const range = await getWorkbookWorksheetRange(rangeRef);
+            expect(range.values).toEqual([
+                ["", "", "", ""],
+                ["", "", "", ""],
+                ["", "", "", ""],
+                ["", "", "", ""],
+            ]);
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+});

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

@@ -0,0 +1,10 @@
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+import type { WorkbookTableRef } from "../../models/WorkbookTableRef.ts";
+/**
+ * Converts the table into a normal range of cells. All data is preserved.
+ *
+ * @param tableRef - A reference to the table, optionally including session information.
+ * @see https://learn.microsoft.com/en-us/graph/api/table-converttorange
+ */
+export default function deleteWorkbookTablePreservingValues(tableRef: WorkbookTableRef): GraphOperation<void>;
+//# sourceMappingURL=deleteWorkbookTablePreservingValues.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deleteWorkbookTablePreservingValues.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookTable/deleteWorkbookTablePreservingValues.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,mCAAmC,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,IAAI,CAAC,CAW5G"}

package/dist/operations/workbookTable/deleteWorkbookTablePreservingValues.js

@@ -0,0 +1,20 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/**
+ * Converts the table into a normal range of cells. All data is preserved.
+ *
+ * @param tableRef - A reference to the table, optionally including session information.
+ * @see https://learn.microsoft.com/en-us/graph/api/table-converttorange
+ */
+export default function deleteWorkbookTablePreservingValues(tableRef) {
+    return operation({
+        contextId: tableRef.contextId,
+        method: "POST",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/tables/{table-id}/convertToRange", tableRef),
+        headers: {
+            "workbook-session-id": tableRef.sessionId,
+        },
+        body: null,
+        responseTransform: () => undefined,
+    });
+}

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

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

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

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

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

@@ -0,0 +1,48 @@
+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 { createDefaultWorkbookWorksheetRef } from "../../services/workbookWorksheet.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
+import createWorkbook from "../workbook/createWorkbook.js";
+import getWorkbookWorksheetRange from "../workbookRange/getWorkbookWorksheetRange.js";
+import updateWorkbookRange from "../workbookRange/updateWorkbookRange.js";
+import createWorkbookTable from "./createWorkbookTable.js";
+import deleteWorkbookTablePreservingValues from "./deleteWorkbookTablePreservingValues.js";
+import getWorkbookTable from "./getWorkbookTable.js";
+describe("deleteWorkbookTablePreservingValues", () => {
+    it("can convert a table to a normal range while preserving values", 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 deleteWorkbookTablePreservingValues(table);
+            await expect(async () => {
+                await getWorkbookTable(table);
+            }).rejects.toThrow();
+            const range = await getWorkbookWorksheetRange(rangeRef);
+            expect(range.values).toEqual([
+                ["A", "B", "C", "D"],
+                [1, 2, 3, 4],
+                [5, 6, 7, 8],
+                [9, 10, 11, 12],
+            ]);
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+});

package/dist/operations/workbookTable/getWorkbookTable.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("getWorkbookTable", () => {
             expect(retrievedTable.tableId).toBe(table.tableId);
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
 });

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":""}