microsoft-graph 2.6.0 → 2.7.0

package/dist/cjs/tasks/iterateWorkbookRangeValues.test.js

@@ -0,0 +1,61 @@
+import { describe, expect, it } from "vitest";
+import calculateWorkbook from "../operations/workbook/calculateWorkbook.js";
+import createWorkbook from "../operations/workbook/createWorkbook.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 iterateWorkbookRangeValues from "./iterateWorkbookRangeValues.js";
+import setWorkbookRangeValues from "./setWorkbookRangeValues.js";
+import tryDeleteDriveItem from "./tryDeleteDriveItem.js";
+describe("iterateWorkbookRangeValues", () => {
+    it("Single request", async () => {
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const driveRef = getDefaultDriveRef();
+        const workbook = await createWorkbook(driveRef, workbookPath);
+        const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+        try {
+            const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:C3");
+            const values = [
+                [1, 2, 3],
+                [4, 5, 6],
+                [7, 8, 9],
+            ];
+            await setWorkbookRangeValues(rangeRef, values);
+            await calculateWorkbook(workbook);
+            let idx = 0;
+            for await (const row of iterateWorkbookRangeValues(rangeRef)) {
+                expect(row).toEqual(values[idx++]);
+            }
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+    it("Multiple requests", async () => {
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const driveRef = getDefaultDriveRef();
+        const workbook = await createWorkbook(driveRef, workbookPath);
+        const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+        try {
+            const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:C3");
+            const values = [
+                [1, 2, 3],
+                [4, 5, 6],
+                [7, 8, 9],
+            ];
+            await setWorkbookRangeValues(rangeRef, values);
+            await calculateWorkbook(workbook);
+            let idx = 0;
+            for await (const row of iterateWorkbookRangeValues(rangeRef, 1)) {
+                expect(row).toEqual(values[idx++]);
+            }
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+});

package/dist/cjs/tasks/safeDeleteWorkbook.d.ts

@@ -0,0 +1,10 @@
+import type { WorkbookRef } from "../models/WorkbookRef.ts";
+/**
+ * Safely delete a workbook by first closing any open sessions and then deleting it with a back-off retry to allow for any outstanding locks to be closed.
+ *
+ * @param workbookRef - A reference to the workbook to be deleted.
+ * @returns Void when the workbook is successfully deleted.
+ * @see https://github.com/Future-Secure-AI/microsoft-graph/blob/main/docs/lockedWorkbook.md
+ */
+export default function safeDeleteWorkbook(workbookRef: WorkbookRef): Promise<void>;
+//# sourceMappingURL=safeDeleteWorkbook.d.ts.map

package/dist/cjs/tasks/safeDeleteWorkbook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeDeleteWorkbook.d.ts","sourceRoot":"","sources":["../../../src/tasks/safeDeleteWorkbook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAI5D;;;;;;GAMG;AACH,wBAA8B,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxF"}

package/dist/cjs/tasks/safeDeleteWorkbook.js

@@ -0,0 +1,15 @@
+import closeWorkbookSession from "../operations/workbookSession/closeWorkbookSession.js";
+import deleteDriveItemWithRetry from "./deleteDriveItemWithRetry.js";
+/**
+ * Safely delete a workbook by first closing any open sessions and then deleting it with a back-off retry to allow for any outstanding locks to be closed.
+ *
+ * @param workbookRef - A reference to the workbook to be deleted.
+ * @returns Void when the workbook is successfully deleted.
+ * @see https://github.com/Future-Secure-AI/microsoft-graph/blob/main/docs/lockedWorkbook.md
+ */
+export default async function safeDeleteWorkbook(workbookRef) {
+    if (workbookRef.sessionId) {
+        await closeWorkbookSession(workbookRef);
+    }
+    await deleteDriveItemWithRetry(workbookRef);
+}

package/dist/cjs/tasks/setColumnHidden.d.ts

@@ -0,0 +1,11 @@
+import type { WorkbookRange } from "@microsoft/microsoft-graph-types";
+import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
+/**
+ * Hide or show one or more columns.
+ *
+ * @param rangeRef - A reference to the workbook range representing the columns to hide or show.
+ * @param hidden - A boolean indicating whether to hide (`true`) or show (`false`) the columns.
+ * @returns The updated workbook range.
+ */
+export default function setColumnHidden(rangeRef: WorkbookRangeRef, hidden: boolean): Promise<WorkbookRange & WorkbookRangeRef>;
+//# sourceMappingURL=setColumnHidden.d.ts.map

package/dist/cjs/tasks/setColumnHidden.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setColumnHidden.d.ts","sourceRoot":"","sources":["../../../src/tasks/setColumnHidden.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE;;;;;;GAMG;AACH,wBAA8B,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAWpI"}

package/dist/cjs/tasks/setColumnHidden.js

@@ -0,0 +1,19 @@
+import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.js";
+import { decomposeAddress, isAllColumnsAddress } from "../services/addressManipulation.js";
+/**
+ * Hide or show one or more columns.
+ *
+ * @param rangeRef - A reference to the workbook range representing the columns to hide or show.
+ * @param hidden - A boolean indicating whether to hide (`true`) or show (`false`) the columns.
+ * @returns The updated workbook range.
+ */
+export default async function setColumnHidden(rangeRef, hidden) {
+    if (isAllColumnsAddress(rangeRef.address)) {
+        throw new Error("Cannot hide all columns");
+    }
+    const components = decomposeAddress(rangeRef.address);
+    rangeRef.address = `${components.startColumn}:${components.endColumn}`; // Workaround API explicitly wanting a range
+    return await updateWorkbookRange(rangeRef, {
+        columnHidden: hidden,
+    });
+}

package/dist/cjs/tasks/setColumnHidden.test.d.ts

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

package/dist/cjs/tasks/setColumnHidden.test.d.ts.map

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

package/dist/cjs/tasks/setColumnHidden.test.js

@@ -0,0 +1,68 @@
+import { describe, expect, it } from "vitest";
+import calculateWorkbook from "../operations/workbook/calculateWorkbook.js";
+import createWorkbook from "../operations/workbook/createWorkbook.js";
+import getWorkbookVisibleRange from "../operations/workbookRange/getWorkbookVisibleRange.js";
+import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.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 setColumnHidden from "./setColumnHidden.js";
+import tryDeleteDriveItem from "./tryDeleteDriveItem.js";
+describe("setColumnHidden", () => {
+    it("hides a single column in 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);
+        try {
+            const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:C3");
+            await updateWorkbookRange(rangeRef, {
+                values: [
+                    [1, 2, 3],
+                    [4, 5, 6],
+                    [7, 8, 9],
+                ],
+            });
+            const hiddenRange = createWorkbookRangeRef(worksheetRef, "B");
+            await setColumnHidden(hiddenRange, true);
+            await calculateWorkbook(workbook);
+            const visibleView = await getWorkbookVisibleRange(rangeRef);
+            expect(visibleView.values).toEqual([
+                [1, 3],
+                [4, 6],
+                [7, 9],
+            ]);
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+    it("hides a multiple columns in 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);
+        try {
+            const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:C3");
+            await updateWorkbookRange(rangeRef, {
+                values: [
+                    [1, 2, 3],
+                    [4, 5, 6],
+                    [7, 8, 9],
+                ],
+            });
+            const hiddenRange = createWorkbookRangeRef(worksheetRef, "B:C");
+            await setColumnHidden(hiddenRange, true);
+            await calculateWorkbook(workbook);
+            const visibleView = await getWorkbookVisibleRange(rangeRef);
+            expect(visibleView.values).toEqual([[1], [4], [7]]);
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+});

package/dist/cjs/tasks/setRowHidden.d.ts

@@ -0,0 +1,11 @@
+import type { WorkbookRange } from "@microsoft/microsoft-graph-types";
+import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
+/**
+ * Hide or show one or more rows.
+ *
+ * @param rangeRef - A reference to the workbook range representing the rows to hide or show.
+ * @param hidden - A boolean indicating whether to hide (`true`) or show (`false`) the rows.
+ * @returns The updated workbook range.
+ */
+export default function setRowHidden(rangeRef: WorkbookRangeRef, hidden: boolean): Promise<WorkbookRange & WorkbookRangeRef>;
+//# sourceMappingURL=setRowHidden.d.ts.map

package/dist/cjs/tasks/setRowHidden.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setRowHidden.d.ts","sourceRoot":"","sources":["../../../src/tasks/setRowHidden.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE;;;;;;GAMG;AACH,wBAA8B,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAWjI"}

package/dist/cjs/tasks/setRowHidden.js

@@ -0,0 +1,19 @@
+import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.js";
+import { decomposeAddress, isAllRowsAddress } from "../services/addressManipulation.js";
+/**
+ * Hide or show one or more rows.
+ *
+ * @param rangeRef - A reference to the workbook range representing the rows to hide or show.
+ * @param hidden - A boolean indicating whether to hide (`true`) or show (`false`) the rows.
+ * @returns The updated workbook range.
+ */
+export default async function setRowHidden(rangeRef, hidden) {
+    if (isAllRowsAddress(rangeRef.address)) {
+        throw new Error("Cannot hide all rows");
+    }
+    const components = decomposeAddress(rangeRef.address);
+    rangeRef.address = `${components.startRow}:${components.endRow}`; // Workaround API explicitly wanting a range
+    return await updateWorkbookRange(rangeRef, {
+        rowHidden: hidden,
+    });
+}

package/dist/cjs/tasks/setRowHidden.test.d.ts

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

package/dist/cjs/tasks/setRowHidden.test.d.ts.map

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

package/dist/cjs/tasks/setRowHidden.test.js

@@ -0,0 +1,67 @@
+import { describe, expect, it } from "vitest";
+import calculateWorkbook from "../operations/workbook/calculateWorkbook.js";
+import createWorkbook from "../operations/workbook/createWorkbook.js";
+import getWorkbookVisibleRange from "../operations/workbookRange/getWorkbookVisibleRange.js";
+import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.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 setRowHidden from "./setRowHidden.js";
+import tryDeleteDriveItem from "./tryDeleteDriveItem.js";
+describe("setRowHidden", () => {
+    it("hides a single row in 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);
+        try {
+            const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:C3");
+            await updateWorkbookRange(rangeRef, {
+                values: [
+                    [1, 2, 3],
+                    [4, 5, 6],
+                    [7, 8, 9],
+                ],
+            });
+            const hiddenRange = createWorkbookRangeRef(worksheetRef, "2");
+            await setRowHidden(hiddenRange, true);
+            await calculateWorkbook(workbook);
+            const visibleView = await getWorkbookVisibleRange(rangeRef);
+            expect(visibleView.values).toEqual([
+                [1, 2, 3],
+                [7, 8, 9],
+            ]);
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+    it("hides multiple rows in 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);
+        try {
+            const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:C3");
+            await updateWorkbookRange(rangeRef, {
+                values: [
+                    [1, 2, 3],
+                    [4, 5, 6],
+                    [7, 8, 9],
+                ],
+            });
+            const hiddenRange = createWorkbookRangeRef(worksheetRef, "2:3");
+            await setRowHidden(hiddenRange, true);
+            await calculateWorkbook(workbook);
+            const visibleView = await getWorkbookVisibleRange(rangeRef);
+            expect(visibleView.values).toEqual([[1, 2, 3]]);
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+});

package/dist/cjs/tasks/setWorkbookRangeValues.d.ts

@@ -0,0 +1,11 @@
+import type { CellRangeValues } from "../models/CellRangeValues.ts";
+import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
+/**
+ * Sets the values of a specified workbook range.
+ *
+ * @param {WorkbookRangeRef} rangeRef - A reference to the workbook range to update.
+ * @param {CellRangeValues} values - The values to set in the specified workbook range. Must match the range's dimensions.
+ * @returns Nothing
+ */
+export default function setWorkbookRangeValues(rangeRef: WorkbookRangeRef, values: CellRangeValues): Promise<void>;
+//# sourceMappingURL=setWorkbookRangeValues.d.ts.map

package/dist/cjs/tasks/setWorkbookRangeValues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setWorkbookRangeValues.d.ts","sourceRoot":"","sources":["../../../src/tasks/setWorkbookRangeValues.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE;;;;;;GAMG;AACH,wBAA8B,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,iBAcvG"}

package/dist/cjs/tasks/setWorkbookRangeValues.js

@@ -0,0 +1,23 @@
+import InvalidArgumentError from "../errors/InvalidArgumentError.js";
+import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.js";
+import { countAddressColumns, countAddressRows } from "../services/addressManipulation.js";
+/**
+ * Sets the values of a specified workbook range.
+ *
+ * @param {WorkbookRangeRef} rangeRef - A reference to the workbook range to update.
+ * @param {CellRangeValues} values - The values to set in the specified workbook range. Must match the range's dimensions.
+ * @returns Nothing
+ */
+export default async function setWorkbookRangeValues(rangeRef, values) {
+    const rowCount = countAddressRows(rangeRef.address);
+    if (values.length !== rowCount) {
+        throw new InvalidArgumentError(`The number of rows in the values array (${values.length}) does not match the number of rows in the range (${rowCount}).`);
+    }
+    const columnCount = countAddressColumns(rangeRef.address);
+    if (values.some((row) => row.length !== columnCount)) {
+        throw new InvalidArgumentError(`The number of columns in the values array does not match the number of columns in the range (${columnCount}).`);
+    }
+    await updateWorkbookRange(rangeRef, {
+        values: values,
+    });
+}

package/dist/cjs/tasks/setWorkbookRangeValues.test.d.ts

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

package/dist/cjs/tasks/setWorkbookRangeValues.test.d.ts.map

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

package/dist/cjs/tasks/setWorkbookRangeValues.test.js

@@ -0,0 +1,35 @@
+import { describe, expect, it } from "vitest";
+import calculateWorkbook from "../operations/workbook/calculateWorkbook.js";
+import createWorkbook from "../operations/workbook/createWorkbook.js";
+import getWorkbookWorksheetUsedRange from "../operations/workbookWorksheet/getWorkbookWorksheetUsedRange.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 setWorkbookRangeValues from "./setWorkbookRangeValues.js";
+import tryDeleteDriveItem from "./tryDeleteDriveItem.js";
+describe("setWorkbookRangeValues", () => {
+    it("calls updateWorkbookRange with the correct arguments when values match the range dimensions", async () => {
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const driveRef = getDefaultDriveRef();
+        const workbook = await createWorkbook(driveRef, workbookPath);
+        const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+        try {
+            const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:C3");
+            const values = [
+                [1, 2, 3],
+                [4, 5, 6],
+                [7, 8, 9],
+            ];
+            await setWorkbookRangeValues(rangeRef, values);
+            await calculateWorkbook(workbook);
+            const visibleView = await getWorkbookWorksheetUsedRange(rangeRef);
+            expect(visibleView.values).toEqual(values);
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+});

package/dist/cjs/tasks/setWorkbookTableBodyVisibleRows.d.ts

@@ -0,0 +1,12 @@
+import type { WorkbookTableRef } from "../models/WorkbookTableRef.ts";
+/**
+ * Overwrite visible rows of a workbook table with the provided 2D array of values, inserting new rows at the end if needed.
+ * THIS IS SLOW as it must check each row's visibility.
+ *
+ * @param tableRef - A reference to the workbook table.
+ * @param values - A 2D array of strings representing the values to set in the visible rows of the table.
+ * @throws {InvalidArgumentError} If the number of columns in any row of `values` does not match the table's column count.
+ * @returns Void when the operation is complete.
+ */
+export declare function setWorkbookTableBodyVisibleRows(tableRef: WorkbookTableRef, values: string[][]): Promise<void>;
+//# sourceMappingURL=setWorkbookTableBodyVisibleRows.d.ts.map

package/dist/cjs/tasks/setWorkbookTableBodyVisibleRows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setWorkbookTableBodyVisibleRows.d.ts","sourceRoot":"","sources":["../../../src/tasks/setWorkbookTableBodyVisibleRows.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAQtE;;;;;;;;GAQG;AACH,wBAAsB,+BAA+B,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BnH"}

package/dist/cjs/tasks/setWorkbookTableBodyVisibleRows.js

@@ -0,0 +1,41 @@
+import InvalidArgumentError from "../errors/InvalidArgumentError.js";
+import getWorkbookWorksheetRange from "../operations/workbookRange/getWorkbookWorksheetRange.js";
+import insertWorkbookCells from "../operations/workbookRange/insertWorkbookCells.js";
+import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.js";
+import getWorkbookTableBodyRange from "../operations/workbookTable/getWorkbookTableBodyRange.js";
+import { getFirstRowAddress, incrementRowAddress, isAddressOverlapping } from "../services/addressManipulation.js";
+import { createWorkbookRangeRef } from "../services/workbookRange.js";
+/**
+ * Overwrite visible rows of a workbook table with the provided 2D array of values, inserting new rows at the end if needed.
+ * THIS IS SLOW as it must check each row's visibility.
+ *
+ * @param tableRef - A reference to the workbook table.
+ * @param values - A 2D array of strings representing the values to set in the visible rows of the table.
+ * @throws {InvalidArgumentError} If the number of columns in any row of `values` does not match the table's column count.
+ * @returns Void when the operation is complete.
+ */
+export async function setWorkbookTableBodyVisibleRows(tableRef, values) {
+    const visibleRange = await getWorkbookTableBodyRange(tableRef);
+    if (values.some((row) => row.length !== visibleRange.columnCount)) {
+        throw new InvalidArgumentError(`Invalid number of columns in input values. Expected all rows to have ${visibleRange.columnCount}.`);
+    }
+    const firstRowAddress = getFirstRowAddress(visibleRange.address);
+    let currentRowAddress = firstRowAddress;
+    for (const rowValues of values) {
+        let rowRef;
+        let rowHidden = false;
+        do {
+            rowRef = createWorkbookRangeRef(tableRef, currentRowAddress);
+            if (isAddressOverlapping(currentRowAddress, visibleRange.address)) {
+                const row = await getWorkbookWorksheetRange(rowRef);
+                rowHidden = row.rowHidden ?? false;
+            }
+            else {
+                await insertWorkbookCells(rowRef, rowRef.address, "Down");
+                rowHidden = false;
+            }
+            currentRowAddress = incrementRowAddress(currentRowAddress);
+        } while (rowHidden);
+        await updateWorkbookRange(rowRef, { values: [rowValues] });
+    }
+}

package/dist/cjs/tasks/setWorkbookTableBodyVisibleRows.test.d.ts

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

package/dist/cjs/tasks/setWorkbookTableBodyVisibleRows.test.d.ts.map

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

package/dist/cjs/tasks/setWorkbookTableBodyVisibleRows.test.js

@@ -0,0 +1,85 @@
+import { describe, expect, it } from "vitest";
+import calculateWorkbook from "../operations/workbook/calculateWorkbook.js";
+import createWorkbook from "../operations/workbook/createWorkbook.js";
+import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.js";
+import createWorkbookTable from "../operations/workbookTable/createWorkbookTable.js";
+import getWorkbookTableBodyVisibleRange from "../operations/workbookTable/getWorkbookTableBodyVisibleRange.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 { createDefaultWorkbookWorksheetRef } from "../services/workbookWorksheet.js";
+import setRowHidden from "./setRowHidden.js";
+import { setWorkbookTableBodyVisibleRows } from "./setWorkbookTableBodyVisibleRows.js";
+import tryDeleteDriveItem from "./tryDeleteDriveItem.js";
+describe("setWorkbookTableBodyVisibleRows", () => {
+    it("writes input rows to visible rows of a table", { timeout: 30000 }, 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: [
+                    ["Header1", "Header2", "Header3", "Header4"],
+                    ["OldValue1", "OldValue2", "OldValue3", "OldValue4"],
+                    ["OldValue5", "OldValue6", "OldValue7", "OldValue8"], // <== Will be hidden and therefore preserved
+                    ["OldValue9", "OldValue10", "OldValue11", "OldValue12"],
+                ],
+            });
+            await setRowHidden(createWorkbookRangeRef(worksheetRef, "A3:A3"), true);
+            await setWorkbookTableBodyVisibleRows(table, [
+                ["NewValue1", "NewValue2", "NewValue3", "NewValue4"],
+                ["NewValue5", "NewValue6", "NewValue7", "NewValue8"],
+            ]);
+            await calculateWorkbook(workbook);
+            const visibleBodyRange = await getWorkbookTableBodyVisibleRange(table);
+            expect(visibleBodyRange.values).toEqual([
+                ["NewValue1", "NewValue2", "NewValue3", "NewValue4"],
+                ["OldValue5", "OldValue6", "OldValue7", "OldValue8"],
+                ["NewValue5", "NewValue6", "NewValue7", "NewValue8"],
+            ]);
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+    it("writes input rows to visible rows of a table with insert", { timeout: 30000 }, 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:D3");
+            const table = await createWorkbookTable(rangeRef, true);
+            await updateWorkbookRange(rangeRef, {
+                values: [
+                    ["Header1", "Header2", "Header3", "Header4"],
+                    ["OldValue1", "OldValue2", "OldValue3", "OldValue4"],
+                    ["OldValue5", "OldValue6", "OldValue7", "OldValue8"], // <== Will be hidden and therefore preserved
+                ],
+            });
+            await setRowHidden(createWorkbookRangeRef(worksheetRef, "A3:A3"), true);
+            await setWorkbookTableBodyVisibleRows(table, [
+                ["NewValue1", "NewValue2", "NewValue3", "NewValue4"],
+                ["NewValue5", "NewValue6", "NewValue7", "NewValue8"],
+                ["NewValue9", "NewValue10", "NewValue11", "NewValue12"],
+            ]);
+            await calculateWorkbook(workbook);
+            const visibleBodyRange = await getWorkbookTableBodyVisibleRange(table);
+            expect(visibleBodyRange.values).toEqual([
+                ["NewValue1", "NewValue2", "NewValue3", "NewValue4"],
+                ["OldValue5", "OldValue6", "OldValue7", "OldValue8"],
+                ["NewValue5", "NewValue6", "NewValue7", "NewValue8"],
+                ["NewValue9", "NewValue10", "NewValue11", "NewValue12"],
+            ]);
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+});

package/dist/cjs/tasks/tryDeleteDriveItem.d.ts

@@ -0,0 +1,9 @@
+import type { DriveItemRef } from "../models/DriveItemRef.ts";
+/**
+ * Attempts to delete a DriveItem, returning a boolean indicating success or failure.
+ *
+ * @param driveItemRef - A reference to the DriveItem to delete.
+ * @returns A boolean indicating whether the DriveItem was successfully deleted.
+ */
+export default function tryDeleteDriveItem(driveItemRef: DriveItemRef): Promise<boolean>;
+//# sourceMappingURL=tryDeleteDriveItem.d.ts.map

package/dist/cjs/tasks/tryDeleteDriveItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tryDeleteDriveItem.d.ts","sourceRoot":"","sources":["../../../src/tasks/tryDeleteDriveItem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D;;;;;GAKG;AACH,wBAA8B,kBAAkB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAO7F"}

package/dist/cjs/tasks/tryDeleteDriveItem.js

@@ -0,0 +1,16 @@
+import deleteDriveItem from "../operations/driveItem/deleteDriveItem.js";
+/**
+ * Attempts to delete a DriveItem, returning a boolean indicating success or failure.
+ *
+ * @param driveItemRef - A reference to the DriveItem to delete.
+ * @returns A boolean indicating whether the DriveItem was successfully deleted.
+ */
+export default async function tryDeleteDriveItem(driveItemRef) {
+    try {
+        await deleteDriveItem(driveItemRef);
+        return true;
+    }
+    catch (_) {
+        return false;
+    }
+}

package/dist/esm/errors/BadTemplateError.d.ts

@@ -0,0 +1,4 @@
+export default class BadTemplateError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=BadTemplateError.d.ts.map

package/dist/esm/errors/BadTemplateError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BadTemplateError.d.ts","sourceRoot":"","sources":["../../../src/errors/BadTemplateError.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAIlC"}

package/dist/esm/errors/BadTemplateError.js

@@ -0,0 +1,6 @@
+export default class BadTemplateError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "BadTemplateError";
+    }
+}

package/dist/esm/errors/ContextNotRegisteredError.d.ts

@@ -0,0 +1,4 @@
+export default class ContextNotRegisteredError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=ContextNotRegisteredError.d.ts.map

package/dist/esm/errors/ContextNotRegisteredError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextNotRegisteredError.d.ts","sourceRoot":"","sources":["../../../src/errors/ContextNotRegisteredError.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,yBAA0B,SAAQ,KAAK;gBACxC,OAAO,EAAE,MAAM;CAIlC"}

package/dist/esm/errors/ContextNotRegisteredError.js

@@ -0,0 +1,6 @@
+export default class ContextNotRegisteredError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ContextNotRegisteredError";
+    }
+}

package/dist/esm/errors/EnvironmentVariableMissingError.d.ts

@@ -0,0 +1,4 @@
+export default class EnvironmentVariableMissingError extends Error {
+    constructor(env: string);
+}
+//# sourceMappingURL=EnvironmentVariableMissingError.d.ts.map