microsoft-graph 1.0.0

package/dist/operations/workbookRange/insertWorkbookCells.test.js

@@ -0,0 +1,41 @@
+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 { workbookRangeRef } from "../../services/workbookRange.js";
+import { defaultWorkbookWorksheetId, workbookWorksheetRef } from "../../services/workbookWorksheet.js";
+import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import calculateWorkbook from "../workbook/calculateWorkbook.js";
+import createWorkbook from "../workbook/createWorkbook.js";
+import getWorkbookUsedRange from "./getWorkbookUsedRange.js";
+import insertWorkbookCells from "./insertWorkbookCells.js";
+import updateWorkbookRange from "./updateWorkbookRange.js";
+describe("insertWorkbookCells", () => {
+    it("can insert cells in an existing workbook using sequential", { timeout: 20000 }, async () => {
+        const address = "A1:B2";
+        const initialValues = [
+            [1, 2],
+            [3, 4]
+        ];
+        const finalValues = [
+            ["", 2],
+            [1, 4],
+            [3, ""]
+        ];
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const workbook = await createWorkbook(getDefaultDriveRef(), workbookPath);
+        const worksheetRef = workbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+        const rangeRef = workbookRangeRef(worksheetRef, address);
+        try {
+            await updateWorkbookRange(rangeRef, { values: initialValues });
+            await insertWorkbookCells(worksheetRef, "A1", "Down");
+            await calculateWorkbook(workbook);
+            const insertedRange = await getWorkbookUsedRange(rangeRef);
+            expect(insertedRange.values).toEqual(finalValues);
+        }
+        finally {
+            await deleteDriveItemWithRetry(workbook);
+        }
+    });
+});

package/dist/operations/workbookRange/updateWorkbookNamedRange.js

@@ -0,0 +1,15 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/** Update range that has been defined using the "named range" functionality. Properties that aren't included in the request maintain their previous values or are recalculated based on changes to other property values. @see https://learn.microsoft.com/en-us/graph/api/range-update */
+export default function updateWorkbookNamedRange(rangeRef, value) {
+    return operation({
+        method: "PATCH",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/names/{range-name}/range", rangeRef),
+        headers: {
+            "workbook-session-id": rangeRef.sessionId,
+            "content-type": "application/json",
+        },
+        body: value,
+        responseTransform: () => undefined
+    });
+}

package/dist/operations/workbookRange/updateWorkbookRange.js

@@ -0,0 +1,21 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/** Update range, including values and formatting. Properties that aren't included in the request maintain their previous values or are recalculated based on changes to other property values. @see https://learn.microsoft.com/en-us/graph/api/range-update */
+export default function updateWorkbookRange(rangeRef, update) {
+    return operation({
+        method: "PATCH",
+        path: generatePath(`/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range(address='${rangeRef.address}')`, rangeRef),
+        headers: {
+            "workbook-session-id": rangeRef.sessionId,
+            "content-type": "application/json",
+        },
+        body: update,
+        responseTransform: response => {
+            const range = response;
+            return {
+                ...range,
+                ...rangeRef
+            };
+        }
+    });
+}

package/dist/operations/workbookRange/updateWorkbookRange.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 { workbookRangeRef } from "../../services/workbookRange.js";
+import { defaultWorkbookWorksheetId, workbookWorksheetRef } from "../../services/workbookWorksheet.js";
+import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import calculateWorkbook from "../workbook/calculateWorkbook.js";
+import createWorkbook from "../workbook/createWorkbook.js";
+import getWorkbookWorksheetRange from "../workbookWorksheet/getWorkbookWorksheetRange.js";
+import updateWorkbookRange from "./updateWorkbookRange.js";
+describe("updateWorkbookRange", () => {
+    it("can update a range in an existing workbook", { timeout: 10000 }, async () => {
+        const address = "A1:B2";
+        const values = [[1, 2], [3, 4]];
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const driveRef = getDefaultDriveRef();
+        const workbook = await createWorkbook(driveRef, workbookPath);
+        const worksheetRef = workbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+        const rangeRef = workbookRangeRef(worksheetRef, address);
+        try {
+            await updateWorkbookRange(rangeRef, {
+                values: values
+            });
+            await calculateWorkbook(workbook);
+            const updatedRange = await getWorkbookWorksheetRange(rangeRef);
+            expect(updatedRange.values).toEqual(values);
+        }
+        finally {
+            await deleteDriveItemWithRetry(workbook);
+        }
+    });
+    it("can update a range in an existing workbook sequential", { timeout: 10000 }, async () => {
+        const address = "A1:B2";
+        const values = [[1, 2], [3, 4]];
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const driveRef = getDefaultDriveRef();
+        const workbook = await createWorkbook(driveRef, workbookPath);
+        const worksheetRef = workbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+        const rangeRef = workbookRangeRef(worksheetRef, address);
+        try {
+            const [_, __, updatedRange] = await sequential(updateWorkbookRange(rangeRef, {
+                values: values
+            }), calculateWorkbook(workbook), getWorkbookWorksheetRange(rangeRef));
+            expect(updatedRange.values).toEqual(values);
+        }
+        finally {
+            await deleteDriveItemWithRetry(workbook);
+        }
+    });
+});

package/dist/operations/workbookSession/closeWorkbookSession.js

@@ -0,0 +1,18 @@
+import InvalidArgumentError from "../../errors/InvalidArgumentError.js";
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/** Close an existing workbook session. @see https://learn.microsoft.com/en-us/graph/api/workbook-closesession */
+export default function closeWorkbookSession(workbookRef) {
+    if (!workbookRef.sessionId) {
+        throw new InvalidArgumentError("Workbook session ID is required to close a session.");
+    }
+    return operation({
+        method: "POST",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/closeSession", workbookRef),
+        headers: {
+            "workbook-session-id": workbookRef.sessionId,
+        },
+        body: null,
+        responseTransform: () => undefined
+    });
+}

package/dist/operations/workbookSession/createWorkbookSession.js

@@ -0,0 +1,22 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/** Create a new workbook session. Typically the persistent session expires after about 5 minutes of inactivity. Non persistent session expires after about 7 minutes of inactivity. Most performant with `persistChanges = true`. @see https://learn.microsoft.com/en-us/graph/api/workbook-createsession @see https://learn.microsoft.com/en-us/graph/api/resources/excel#usage */
+export default function createWorkbookSession(itemRef, persistChanges = true) {
+    return operation({
+        method: "POST",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/createSession", itemRef),
+        headers: {
+            "content-type": "application/json",
+        },
+        body: {
+            persistChanges
+        },
+        responseTransform: response => {
+            const session = response;
+            return ({
+                ...itemRef,
+                sessionId: session.id,
+            });
+        }
+    });
+}

package/dist/operations/workbookSession/refreshWorkbookSession.js

@@ -0,0 +1,19 @@
+import InvalidArgumentError from "../../errors/InvalidArgumentError.js";
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/** Refresh a workbook session. @see https://learn.microsoft.com/en-us/graph/api/workbook-refreshsession */
+export default function refreshWorkbookSession(workbookRef) {
+    if (!workbookRef.sessionId) {
+        throw new InvalidArgumentError("Workbook session ID is required to refresh a session.");
+    }
+    return operation({
+        method: "POST",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/refreshSession", workbookRef),
+        headers: {
+            "workbook-session-id": workbookRef.sessionId,
+            "content-type": "application/json",
+        },
+        body: null,
+        responseTransform: () => undefined
+    });
+}

package/dist/operations/workbookTable/createWorkbookTable.js

@@ -0,0 +1,26 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+import { workbookTableRef } from "../../services/workbookTable.js";
+/** Create a new table in a worksheet. @see https://learn.microsoft.com/en-us/graph/api/worksheet-post-tables */
+export default function createWorkbookTable(rangeRef, hasHeaders) {
+    return operation({
+        method: "POST",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables/add", rangeRef),
+        headers: {
+            "workbook-session-id": rangeRef.sessionId,
+            "content-type": "application/json",
+        },
+        body: {
+            address: rangeRef.address,
+            hasHeaders
+        },
+        responseTransform: response => {
+            const table = response;
+            const tableRef = workbookTableRef(rangeRef, table.id);
+            return {
+                ...table,
+                ...tableRef
+            };
+        }
+    });
+}

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

@@ -0,0 +1,25 @@
+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 { workbookRangeRef } from "../../services/workbookRange.js";
+import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import createWorkbook from "../workbook/createWorkbook.js";
+import createWorkbookWorksheet from "../workbookWorksheet/createWorkbookWorksheet.js";
+import createWorkbookTable from "./createWorkbookTable.js";
+describe("createWorkbookTable", () => {
+    it("can create a new table in an existing worksheet", { timeout: 10000 }, async () => {
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const workbook = await createWorkbook(getDefaultDriveRef(), workbookPath);
+        try {
+            const worksheet = await createWorkbookWorksheet(workbook);
+            const rangeRef = workbookRangeRef(worksheet, "A1:D4");
+            const table = await createWorkbookTable(rangeRef, true);
+            expect(table.id).toBeTruthy();
+        }
+        finally {
+            await deleteDriveItemWithRetry(workbook);
+        }
+    });
+});

package/dist/operations/workbookTable/getWorkbookTable.js

@@ -0,0 +1,20 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/** Retrieve a table by its ID. @see https://learn.microsoft.com/en-us/graph/api/table-get */
+export default function getWorkbookTable(tableRef) {
+    return operation({
+        method: "GET",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables/{table-id}", tableRef),
+        headers: {
+            "workbook-session-id": tableRef.sessionId,
+        },
+        body: null,
+        responseTransform: response => {
+            const table = response;
+            return {
+                ...table,
+                ...tableRef
+            };
+        }
+    });
+}

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

@@ -0,0 +1,30 @@
+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 { workbookRangeRef } from "../../services/workbookRange.js";
+import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import calculateWorkbook from "../workbook/calculateWorkbook.js";
+import createWorkbook from "../workbook/createWorkbook.js";
+import createWorkbookWorksheet from "../workbookWorksheet/createWorkbookWorksheet.js";
+import createWorkbookTable from "./createWorkbookTable.js";
+import getWorkbookTable from "./getWorkbookTable.js";
+describe("getWorkbookTable", () => {
+    it("can retrieve a table by its ID", { timeout: 10000 }, async () => {
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const driveRef = getDefaultDriveRef();
+        const workbook = await createWorkbook(driveRef, workbookPath);
+        try {
+            const worksheet = await createWorkbookWorksheet(workbook);
+            const rangeRef = workbookRangeRef(worksheet, "A1:D4");
+            const table = await createWorkbookTable(rangeRef, true);
+            await calculateWorkbook(workbook);
+            const retrievedTable = await getWorkbookTable(table);
+            expect(retrievedTable.tableId).toBe(table.tableId);
+        }
+        finally {
+            await deleteDriveItemWithRetry(workbook);
+        }
+    });
+});

package/dist/operations/workbookTable/getWorkbookTableBodyRange.js

@@ -0,0 +1,22 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+import { workbookRangeRef } from "../../services/workbookRange.js";
+/** Retrieve the data body range of a table. @see https://learn.microsoft.com/en-us/graph/api/table-databodyrange */
+export default function getWorkbookTableBodyRange(tableRef) {
+    return operation({
+        method: "GET",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables/{table-id}/dataBodyRange", tableRef),
+        headers: {
+            "workbook-session-id": tableRef.sessionId,
+        },
+        body: null,
+        responseTransform: response => {
+            const range = response;
+            const rangeRef = workbookRangeRef(tableRef, range.address);
+            return {
+                ...range,
+                ...rangeRef
+            };
+        }
+    });
+}

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

@@ -0,0 +1,45 @@
+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 { workbookRangeRef } from "../../services/workbookRange.js";
+import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import calculateWorkbook from "../workbook/calculateWorkbook.js";
+import createWorkbook from "../workbook/createWorkbook.js";
+import updateWorkbookRange from "../workbookRange/updateWorkbookRange.js";
+import createWorkbookWorksheet from "../workbookWorksheet/createWorkbookWorksheet.js";
+import createWorkbookTable from "./createWorkbookTable.js";
+import getWorkbookTableBodyRange from "./getWorkbookTableBodyRange.js";
+describe("getWorkbookTableBodyRange", () => {
+    it("can retrieve the data body range of a table", { timeout: 10000 }, async () => {
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const driveRef = getDefaultDriveRef();
+        const workbook = await createWorkbook(driveRef, workbookPath);
+        try {
+            const worksheet = await createWorkbookWorksheet(workbook);
+            const rangeRef = workbookRangeRef(worksheet, "A1:D4");
+            const table = await createWorkbookTable(rangeRef, true);
+            await updateWorkbookRange(rangeRef, {
+                values: [
+                    ["Header1", "Header2", "Header3", "Header4"],
+                    ["Value1", "Value2", "Value3", "Value4"],
+                    ["Value5", "Value6", "Value7", "Value8"],
+                    ["Value9", "Value10", "Value11", "Value12"]
+                ]
+            });
+            await calculateWorkbook(workbook);
+            const [_, dataBodyRange] = await sequential(calculateWorkbook(workbook), getWorkbookTableBodyRange(table));
+            expect(dataBodyRange.address).toBeTruthy();
+            expect(dataBodyRange.values).toEqual([
+                ["Value1", "Value2", "Value3", "Value4"],
+                ["Value5", "Value6", "Value7", "Value8"],
+                ["Value9", "Value10", "Value11", "Value12"]
+            ]);
+        }
+        finally {
+            await deleteDriveItemWithRetry(workbook);
+        }
+    });
+});

package/dist/operations/workbookTable/getWorkbookTableHeaderRange.js

@@ -0,0 +1,22 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+import { workbookRangeRef } from "../../services/workbookRange.js";
+/** Retrieve the header row range of a table. @see https://learn.microsoft.com/en-us/graph/api/table-headerrowrange */
+export default function getWorkbookTableHeaderRange(tableRef) {
+    return operation({
+        method: "GET",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables/{table-id}/headerRowRange", tableRef),
+        headers: {
+            "workbook-session-id": tableRef.sessionId,
+        },
+        body: null,
+        responseTransform: response => {
+            const range = response;
+            const rangeRef = workbookRangeRef(tableRef, range.address);
+            return {
+                ...range,
+                ...rangeRef
+            };
+        }
+    });
+}

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

@@ -0,0 +1,41 @@
+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 { workbookRangeRef } from "../../services/workbookRange.js";
+import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import calculateWorkbook from "../workbook/calculateWorkbook.js";
+import createWorkbook from "../workbook/createWorkbook.js";
+import updateWorkbookRange from "../workbookRange/updateWorkbookRange.js";
+import createWorkbookWorksheet from "../workbookWorksheet/createWorkbookWorksheet.js";
+import createWorkbookTable from "./createWorkbookTable.js";
+import getWorkbookTableHeaderRange from "./getWorkbookTableHeaderRange.js";
+describe("getWorkbookTableHeaderRange", () => {
+    it("can retrieve the header row range of a table", { timeout: 10000 }, async () => {
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const driveRef = getDefaultDriveRef();
+        const workbook = await createWorkbook(driveRef, workbookPath);
+        try {
+            const worksheet = await createWorkbookWorksheet(workbook);
+            const rangeRef = workbookRangeRef(worksheet, "A1:D4");
+            const table = await createWorkbookTable(rangeRef, true);
+            await updateWorkbookRange(rangeRef, {
+                values: [
+                    ["Header1", "Header2", "Header3", "Header4"],
+                    ["Value1", "Value2", "Value3", "Value4"],
+                    ["Value5", "Value6", "Value7", "Value8"],
+                    ["Value9", "Value10", "Value11", "Value12"]
+                ]
+            });
+            await calculateWorkbook(workbook);
+            const [_, headerRange] = await sequential(calculateWorkbook(workbook), getWorkbookTableHeaderRange(table));
+            expect(headerRange.address).toBeTruthy();
+            expect(headerRange.values).toEqual([["Header1", "Header2", "Header3", "Header4"]]);
+        }
+        finally {
+            await deleteDriveItemWithRetry(workbook);
+        }
+    });
+});

package/dist/operations/workbookTable/listWorkbookTableColumns.js

@@ -0,0 +1,17 @@
+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 */
+export default function listWorkbookTableColumns(tableRef) {
+    return operation({
+        method: "GET",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/tables/{table-id}/columns", tableRef),
+        headers: {
+            "workbook-session-id": tableRef.sessionId,
+        },
+        body: null,
+        responseTransform: response => {
+            const list = response;
+            return list.value;
+        }
+    });
+}

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

@@ -0,0 +1,29 @@
+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 { workbookRangeRef } from "../../services/workbookRange.js";
+import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import calculateWorkbook from "../workbook/calculateWorkbook.js";
+import createWorkbook from "../workbook/createWorkbook.js";
+import createWorkbookWorksheet from "../workbookWorksheet/createWorkbookWorksheet.js";
+import createWorkbookTable from "./createWorkbookTable.js";
+import listWorkbookTableColumns from "./listWorkbookTableColumns.js";
+describe("listWorkbookTableColumns", () => {
+    it("can list columns in an existing table", { timeout: 10000 }, async () => {
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const workbook = await createWorkbook(getDefaultDriveRef(), workbookPath);
+        try {
+            const worksheet = await createWorkbookWorksheet(workbook);
+            const rangeRef = workbookRangeRef(worksheet, "A1:D4");
+            const table = await createWorkbookTable(rangeRef, true);
+            await calculateWorkbook(workbook);
+            const columns = await listWorkbookTableColumns(table);
+            expect(columns.length).toBeGreaterThan(0);
+        }
+        finally {
+            await deleteDriveItemWithRetry(workbook);
+        }
+    });
+});

package/dist/operations/workbookTable/listWorkbookTableRows.js

@@ -0,0 +1,17 @@
+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 */
+export default function listWorkbookTableRows(tableRef) {
+    return operation({
+        method: "GET",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/tables/{table-id}/rows", tableRef),
+        headers: {
+            "workbook-session-id": tableRef.sessionId,
+        },
+        body: null,
+        responseTransform: response => {
+            const list = response;
+            return list.value;
+        }
+    });
+}

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

@@ -0,0 +1,29 @@
+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 { workbookRangeRef } from "../../services/workbookRange.js";
+import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import calculateWorkbook from "../workbook/calculateWorkbook.js";
+import createWorkbook from "../workbook/createWorkbook.js";
+import createWorkbookWorksheet from "../workbookWorksheet/createWorkbookWorksheet.js";
+import createWorkbookTable from "./createWorkbookTable.js";
+import listWorkbookTableRows from "./listWorkbookTableRows.js";
+describe("listWorkbookTableRows", () => {
+    it("can list rows in an existing table", { timeout: 10000 }, async () => {
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const workbook = await createWorkbook(getDefaultDriveRef(), workbookPath);
+        try {
+            const worksheet = await createWorkbookWorksheet(workbook);
+            const rangeRef = workbookRangeRef(worksheet, "A1:D4");
+            const table = await createWorkbookTable(rangeRef, true);
+            await calculateWorkbook(workbook);
+            const rows = await listWorkbookTableRows(table);
+            expect(rows.length).toBeGreaterThan(0);
+        }
+        finally {
+            await deleteDriveItemWithRetry(workbook);
+        }
+    });
+});

package/dist/operations/workbookTable/listWorkbookTables.js

@@ -0,0 +1,25 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+import { workbookTableRef } from "../../services/workbookTable.js";
+/** Retrieve a list of tables in a worksheet. @see https://learn.microsoft.com/en-us/graph/api/worksheet-list-tables */
+export default function listWorkbookTables(worksheetRef) {
+    return operation({
+        method: "GET",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables", worksheetRef),
+        headers: {
+            "workbook-session-id": worksheetRef.sessionId,
+        },
+        body: null,
+        responseTransform: response => {
+            const list = response;
+            const tables = list.value.map(table => {
+                const tableRef = workbookTableRef(worksheetRef, table.id);
+                return {
+                    ...table,
+                    ...tableRef,
+                };
+            });
+            return tables;
+        }
+    });
+}

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

@@ -0,0 +1,30 @@
+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 { workbookRangeRef } from "../../services/workbookRange.js";
+import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import calculateWorkbook from "../workbook/calculateWorkbook.js";
+import createWorkbook from "../workbook/createWorkbook.js";
+import createWorkbookWorksheet from "../workbookWorksheet/createWorkbookWorksheet.js";
+import createWorkbookTable from "./createWorkbookTable.js";
+import listTables from "./listWorkbookTables.js";
+describe("listWorkbookTables", () => {
+    it("can list tables in an existing worksheet", { timeout: 10000 }, async () => {
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const driveRef = getDefaultDriveRef();
+        const workbook = await createWorkbook(driveRef, workbookPath);
+        try {
+            const worksheet = await createWorkbookWorksheet(workbook);
+            const rangeRef = workbookRangeRef(worksheet, "A1:D4");
+            await createWorkbookTable(rangeRef, true);
+            await calculateWorkbook(workbook);
+            const tables = await listTables(worksheet);
+            expect(tables.length).toBeGreaterThan(0);
+        }
+        finally {
+            await deleteDriveItemWithRetry(workbook);
+        }
+    });
+});

package/dist/operations/workbookWorksheet/createWorkbookWorksheet.js

@@ -0,0 +1,25 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+import { workbookWorksheetRef } from "../../services/workbookWorksheet.js";
+/** Create a new worksheet, optionally with a defined name. @see https://learn.microsoft.com/en-us/graph/api/worksheetcollection-add */
+export default function createWorkbookWorksheet(workbookRef, name) {
+    return operation({
+        method: "POST",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/add", workbookRef),
+        headers: {
+            "workbook-session-id": workbookRef.sessionId,
+            "content-type": "application/json",
+        },
+        body: {
+            name
+        },
+        responseTransform: response => {
+            const worksheet = response;
+            const worksheetRef = workbookWorksheetRef(workbookRef, worksheet.id);
+            return {
+                ...worksheet,
+                ...worksheetRef
+            };
+        }
+    });
+}