microsoft-graph 2.3.0 → 2.4.0

package/dist/operations/workbookTable/getWorkbookTableBodyRange.js

@@ -2,7 +2,13 @@ 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 data body range of a table. @see https://learn.microsoft.com/en-us/graph/api/table-databodyrange */
+/**
+ * Retrieve the 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 getWorkbookTableBodyRange(tableRef) {
     return operation({
         contextId: tableRef.contextId,

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.d.ts

@@ -2,6 +2,12 @@ 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 header row range of a table. @see https://learn.microsoft.com/en-us/graph/api/table-headerrowrange */
+/**
+ * Retrieve the header row range of a table.
+ *
+ * @param tableRef - A reference to the table, optionally including session information.
+ * @returns The header row range of the specified table, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/table-headerrowrange
+ */
 export default function getWorkbookTableHeaderRange(tableRef: WorkbookTableRef): GraphOperation<WorkbookRange & WorkbookRangeRef>;
 //# sourceMappingURL=getWorkbookTableHeaderRange.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getWorkbookTableHeaderRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookTable/getWorkbookTableHeaderRange.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,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAIzE,sHAAsH;AACtH,MAAM,CAAC,OAAO,UAAU,2BAA2B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAsBhI"}
+{"version":3,"file":"getWorkbookTableHeaderRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookTable/getWorkbookTableHeaderRange.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,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAIzE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,2BAA2B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAsBhI"}

package/dist/operations/workbookTable/getWorkbookTableHeaderRange.js

@@ -2,7 +2,13 @@ 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 header row range of a table. @see https://learn.microsoft.com/en-us/graph/api/table-headerrowrange */
+/**
+ * Retrieve the header row range of a table.
+ *
+ * @param tableRef - A reference to the table, optionally including session information.
+ * @returns The header row range of the specified table, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/table-headerrowrange
+ */
 export default function getWorkbookTableHeaderRange(tableRef) {
     return operation({
         contextId: tableRef.contextId,

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.d.ts

@@ -1,6 +1,12 @@
 import type { WorkbookTableColumn } from "@microsoft/microsoft-graph-types";
 import type { GraphOperation } from "../../models/GraphOperation.ts";
 import type { WorkbookTableRef } from "../../models/WorkbookTableRef.ts";
-/** Retrieve a list of columns in a table. @see https://learn.microsoft.com/en-us/graph/api/tablecolumn-list */
+/**
+ * Retrieve a list of columns in a table.
+ *
+ * @param tableRef - A reference to the table, optionally including session information.
+ * @returns An array of columns in the specified table.
+ * @see https://learn.microsoft.com/en-us/graph/api/tablecolumn-list
+ */
 export default function listWorkbookTableColumns(tableRef: WorkbookTableRef): GraphOperation<WorkbookTableColumn[]>;
 //# sourceMappingURL=listWorkbookTableColumns.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"listWorkbookTableColumns.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookTable/listWorkbookTableColumns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,+GAA+G;AAC/G,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,mBAAmB,EAAE,CAAC,CAclH"}
+{"version":3,"file":"listWorkbookTableColumns.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookTable/listWorkbookTableColumns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,mBAAmB,EAAE,CAAC,CAclH"}

package/dist/operations/workbookTable/listWorkbookTableColumns.js

@@ -1,6 +1,12 @@
 import { operation } from "../../graphApi.js";
 import { generatePath } from "../../services/templatedPaths.js";
-/** Retrieve a list of columns in a table. @see https://learn.microsoft.com/en-us/graph/api/tablecolumn-list */
+/**
+ * Retrieve a list of columns in a table.
+ *
+ * @param tableRef - A reference to the table, optionally including session information.
+ * @returns An array of columns in the specified table.
+ * @see https://learn.microsoft.com/en-us/graph/api/tablecolumn-list
+ */
 export default function listWorkbookTableColumns(tableRef) {
     return operation({
         contextId: tableRef.contextId,

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.d.ts

@@ -1,6 +1,12 @@
 import type { WorkbookTableRow } from "@microsoft/microsoft-graph-types";
 import type { GraphOperation } from "../../models/GraphOperation.ts";
 import type { WorkbookTableRef } from "../../models/WorkbookTableRef.ts";
-/** Retrieve a list of rows in a table. @see https://learn.microsoft.com/en-us/graph/api/tablerow-list */
+/**
+ * Retrieve a list of rows in a table.
+ *
+ * @param tableRef - A reference to the table, optionally including session information.
+ * @returns An array of rows in the specified table.
+ * @see https://learn.microsoft.com/en-us/graph/api/tablerow-list
+ */
 export default function listWorkbookTableRows(tableRef: WorkbookTableRef): GraphOperation<WorkbookTableRow[]>;
 //# sourceMappingURL=listWorkbookTableRows.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"listWorkbookTableRows.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookTable/listWorkbookTableRows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,yGAAyG;AACzG,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,gBAAgB,EAAE,CAAC,CAc5G"}
+{"version":3,"file":"listWorkbookTableRows.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookTable/listWorkbookTableRows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,gBAAgB,EAAE,CAAC,CAc5G"}

package/dist/operations/workbookTable/listWorkbookTableRows.js

@@ -1,6 +1,12 @@
 import { operation } from "../../graphApi.js";
 import { generatePath } from "../../services/templatedPaths.js";
-/** Retrieve a list of rows in a table. @see https://learn.microsoft.com/en-us/graph/api/tablerow-list */
+/**
+ * Retrieve a list of rows in a table.
+ *
+ * @param tableRef - A reference to the table, optionally including session information.
+ * @returns An array of rows in the specified table.
+ * @see https://learn.microsoft.com/en-us/graph/api/tablerow-list
+ */
 export default function listWorkbookTableRows(tableRef) {
     return operation({
         contextId: tableRef.contextId,

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.d.ts

@@ -2,6 +2,12 @@ import type { WorkbookTable } from "@microsoft/microsoft-graph-types";
 import type { GraphOperation } from "../../models/GraphOperation.ts";
 import type { WorkbookRef } from "../../models/WorkbookRef.ts";
 import type { WorkbookWorksheetRef } from "../../models/WorkbookWorksheetRef.ts";
-/** Retrieve a list of tables in a worksheet. @see https://learn.microsoft.com/en-us/graph/api/worksheet-list-tables */
+/**
+ * Retrieve a list of tables in a worksheet.
+ *
+ * @param worksheetRef - A reference to the worksheet, optionally including session information.
+ * @returns An array of tables, each including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/worksheet-list-tables
+ */
 export default function listWorkbookTables(worksheetRef: WorkbookWorksheetRef): GraphOperation<(WorkbookTable & WorkbookRef)[]>;
 //# sourceMappingURL=listWorkbookTables.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"listWorkbookTables.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookTable/listWorkbookTables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAIjF,uHAAuH;AACvH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,YAAY,EAAE,oBAAoB,GAAG,cAAc,CAAC,CAAC,aAAa,GAAG,WAAW,CAAC,EAAE,CAAC,CAwB9H"}
+{"version":3,"file":"listWorkbookTables.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookTable/listWorkbookTables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAIjF;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,YAAY,EAAE,oBAAoB,GAAG,cAAc,CAAC,CAAC,aAAa,GAAG,WAAW,CAAC,EAAE,CAAC,CAwB9H"}

package/dist/operations/workbookTable/listWorkbookTables.js

@@ -1,7 +1,13 @@
 import { operation } from "../../graphApi.js";
 import { generatePath } from "../../services/templatedPaths.js";
 import { createWorkbookTableRef } from "../../services/workbookTable.js";
-/** Retrieve a list of tables in a worksheet. @see https://learn.microsoft.com/en-us/graph/api/worksheet-list-tables */
+/**
+ * Retrieve a list of tables in a worksheet.
+ *
+ * @param worksheetRef - A reference to the worksheet, optionally including session information.
+ * @returns An array of tables, each including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/worksheet-list-tables
+ */
 export default function listWorkbookTables(worksheetRef) {
     return operation({
         contextId: worksheetRef.contextId,

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.d.ts

@@ -3,6 +3,13 @@ import type { GraphOperation } from "../../models/GraphOperation.ts";
 import type { WorkbookRef } from "../../models/WorkbookRef.ts";
 import type { WorkbookWorksheetName } from "../../models/WorkbookWorksheetName.ts";
 import type { WorkbookWorksheetRef } from "../../models/WorkbookWorksheetRef.ts";
-/** Create a new worksheet, optionally with a defined name. @see https://learn.microsoft.com/en-us/graph/api/worksheetcollection-add */
+/**
+ * Create a new worksheet in a workbook, optionally with a defined name.
+ *
+ * @param workbookRef - A reference to the workbook where the worksheet will be created, optionally including session information.
+ * @param name - (Optional) The name of the new worksheet.
+ * @returns The newly created worksheet, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/worksheetcollection-add
+ */
 export default function createWorkbookWorksheet(workbookRef: WorkbookRef, name?: WorkbookWorksheetName): GraphOperation<WorkbookWorksheet & WorkbookWorksheetRef>;
 //# sourceMappingURL=createWorkbookWorksheet.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"createWorkbookWorksheet.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookWorksheet/createWorkbookWorksheet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AACnF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAIjF,uIAAuI;AACvI,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAAC,iBAAiB,GAAG,oBAAoB,CAAC,CAsBhK"}
+{"version":3,"file":"createWorkbookWorksheet.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookWorksheet/createWorkbookWorksheet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AACnF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAIjF;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAAC,iBAAiB,GAAG,oBAAoB,CAAC,CAsBhK"}

package/dist/operations/workbookWorksheet/createWorkbookWorksheet.js

@@ -1,7 +1,14 @@
 import { operation } from "../../graphApi.js";
 import { generatePath } from "../../services/templatedPaths.js";
 import { createWorkbookWorksheetRef } from "../../services/workbookWorksheet.js";
-/** Create a new worksheet, optionally with a defined name. @see https://learn.microsoft.com/en-us/graph/api/worksheetcollection-add */
+/**
+ * Create a new worksheet in a workbook, optionally with a defined name.
+ *
+ * @param workbookRef - A reference to the workbook where the worksheet will be created, optionally including session information.
+ * @param name - (Optional) The name of the new worksheet.
+ * @returns The newly created worksheet, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/worksheetcollection-add
+ */
 export default function createWorkbookWorksheet(workbookRef, name) {
     return operation({
         contextId: workbookRef.contextId,

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.d.ts

@@ -1,5 +1,11 @@
 import type { GraphOperation } from "../../models/GraphOperation.ts";
 import type { WorkbookWorksheetRef } from "../../models/WorkbookWorksheetRef.ts";
-/** Permanently delete a worksheet. @see https://learn.microsoft.com/en-us/graph/api/worksheet-delete */
+/**
+ * Permanently delete a worksheet.
+ *
+ * @param worksheetRef - A reference to the worksheet to be deleted, optionally including session information.
+ * @returns Nothing.
+ * @see https://learn.microsoft.com/en-us/graph/api/worksheet-delete
+ */
 export default function deleteWorkbookWorksheet(worksheetRef: WorkbookWorksheetRef): GraphOperation<void>;
 //# sourceMappingURL=deleteWorkbookWorksheet.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"deleteWorkbookWorksheet.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookWorksheet/deleteWorkbookWorksheet.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAGjF,wGAAwG;AACxG,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,YAAY,EAAE,oBAAoB,GAAG,cAAc,CAAC,IAAI,CAAC,CAWxG"}
+{"version":3,"file":"deleteWorkbookWorksheet.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookWorksheet/deleteWorkbookWorksheet.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAGjF;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,YAAY,EAAE,oBAAoB,GAAG,cAAc,CAAC,IAAI,CAAC,CAWxG"}

package/dist/operations/workbookWorksheet/deleteWorkbookWorksheet.js

@@ -1,6 +1,12 @@
 import { operation } from "../../graphApi.js";
 import { generatePath } from "../../services/templatedPaths.js";
-/** Permanently delete a worksheet. @see https://learn.microsoft.com/en-us/graph/api/worksheet-delete */
+/**
+ * Permanently delete a worksheet.
+ *
+ * @param worksheetRef - A reference to the worksheet to be deleted, optionally including session information.
+ * @returns Nothing.
+ * @see https://learn.microsoft.com/en-us/graph/api/worksheet-delete
+ */
 export default function deleteWorkbookWorksheet(worksheetRef) {
     return operation({
         contextId: worksheetRef.contextId,

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);
+        }
+    });
+});