microsoft-graph 2.2.5 → 2.3.1

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

@@ -1 +1 @@
-{"version":3,"file":"workbookTable.d.ts","sourceRoot":"","sources":["../../src/services/workbookTable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,eAAe,GAAG,SAAS,GAAG,gBAAgB,CAajI"}
+{"version":3,"file":"workbookTable.d.ts","sourceRoot":"","sources":["../../src/services/workbookTable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,eAAe,GAAG,SAAS,GAAG,gBAAgB,CAcjI"}

package/dist/services/workbookTable.js

@@ -1,3 +1,10 @@
+/**
+ * Creates a reference to a workbook table.
+ * @param worksheetRef - The reference to the worksheet containing the table.
+ * @param tableId - The ID of the table.
+ * @returns A reference to the workbook table.
+ * @throws Error if the table ID is missing.
+ */
 export function createWorkbookTableRef(worksheetRef, tableId) {
     if (!tableId) {
         throw new Error("TableId is missing");

package/dist/services/workbookWorksheet.d.ts

@@ -2,6 +2,18 @@ import type { WorkbookRef } from "../models/WorkbookRef.ts";
 import type { WorkbookWorksheetId } from "../models/WorkbookWorksheetId.ts";
 import type { WorkbookWorksheetRef } from "../models/WorkbookWorksheetRef.ts";
 export declare const defaultWorkbookWorksheetId: WorkbookWorksheetId;
+/**
+ * Creates a reference to a workbook worksheet.
+ * @param workbookRef - The reference to the workbook.
+ * @param worksheetId - The ID of the worksheet.
+ * @returns A reference to the workbook worksheet.
+ * @throws Error if the worksheet ID is missing.
+ */
 export declare function createWorkbookWorksheetRef(workbookRef: WorkbookRef, worksheetId: WorkbookWorksheetId | undefined): WorkbookWorksheetRef;
+/**
+ * Creates a reference to the default workbook worksheet that is initially included in all new workbooks.
+ * @param workbookRef - The reference to the workbook.
+ * @returns A reference to the default workbook worksheet.
+ */
 export declare function createDefaultWorkbookWorksheetRef(workbookRef: WorkbookRef): WorkbookWorksheetRef;
 //# sourceMappingURL=workbookWorksheet.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"workbookWorksheet.d.ts","sourceRoot":"","sources":["../../src/services/workbookWorksheet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,eAAO,MAAM,0BAA0B,EAA+C,mBAAmB,CAAC;AAE1G,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,GAAG,SAAS,GAAG,oBAAoB,CAavI;AAED,wBAAgB,iCAAiC,CAAC,WAAW,EAAE,WAAW,GAAG,oBAAoB,CAEhG"}
+{"version":3,"file":"workbookWorksheet.d.ts","sourceRoot":"","sources":["../../src/services/workbookWorksheet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,eAAO,MAAM,0BAA0B,EAA+C,mBAAmB,CAAC;AAE1G;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,GAAG,SAAS,GAAG,oBAAoB,CAavI;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,WAAW,EAAE,WAAW,GAAG,oBAAoB,CAEhG"}

package/dist/services/workbookWorksheet.js

@@ -1,4 +1,11 @@
 export const defaultWorkbookWorksheetId = "{00000000-0001-0000-0000-000000000000}"; // Program Manager in Microsoft Office Extensibility team says this ID is used for the first sheet of all workbooks by design, but not documented. https://github.com/OfficeDev/office-js/issues/552#issuecomment-800841930
+/**
+ * Creates a reference to a workbook worksheet.
+ * @param workbookRef - The reference to the workbook.
+ * @param worksheetId - The ID of the worksheet.
+ * @returns A reference to the workbook worksheet.
+ * @throws Error if the worksheet ID is missing.
+ */
 export function createWorkbookWorksheetRef(workbookRef, worksheetId) {
     if (!worksheetId) {
         throw new Error("WorksheetID is missing");
@@ -12,6 +19,11 @@ export function createWorkbookWorksheetRef(workbookRef, worksheetId) {
         worksheetId,
     };
 }
+/**
+ * Creates a reference to the default workbook worksheet that is initially included in all new workbooks.
+ * @param workbookRef - The reference to the workbook.
+ * @returns A reference to the default workbook worksheet.
+ */
 export function createDefaultWorkbookWorksheetRef(workbookRef) {
     return createWorkbookWorksheetRef(workbookRef, defaultWorkbookWorksheetId);
 }

package/dist/tasks/createWorkbookAndStartSession.d.ts

@@ -2,6 +2,12 @@ import type { Workbook } from "@microsoft/microsoft-graph-types";
 import type { DriveItemPath } from "../models/DriveItemPath.ts";
 import type { DriveRef } from "../models/DriveRef.ts";
 import type { WorkbookRef } from "../models/WorkbookRef.ts";
-/** One-shot creation of a new workbook and opening a session for that workbook. */
+/**
+ * Create a new workbook and open a session for that workbook in a single operation.
+ *
+ * @param driveRef - A reference to the drive where the workbook will be created.
+ * @param itemPath - The path of the new workbook within the drive.
+ * @returns The created workbook and session details.
+ */
 export default function createWorkbookAndStartSession(driveRef: DriveRef, itemPath: DriveItemPath): Promise<Workbook & WorkbookRef>;
 //# sourceMappingURL=createWorkbookAndStartSession.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"createWorkbookAndStartSession.d.ts","sourceRoot":"","sources":["../../src/tasks/createWorkbookAndStartSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAI5D,mFAAmF;AACnF,wBAA8B,6BAA6B,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,GAAG,WAAW,CAAC,CAQxI"}
+{"version":3,"file":"createWorkbookAndStartSession.d.ts","sourceRoot":"","sources":["../../src/tasks/createWorkbookAndStartSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAI5D;;;;;;GAMG;AACH,wBAA8B,6BAA6B,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,GAAG,WAAW,CAAC,CAQxI"}

package/dist/tasks/createWorkbookAndStartSession.js

@@ -1,6 +1,12 @@
 import createWorkbook from "../operations/workbook/createWorkbook.js";
 import createWorkbookSession from "../operations/workbookSession/createWorkbookSession.js";
-/** One-shot creation of a new workbook and opening a session for that workbook. */
+/**
+ * Create a new workbook and open a session for that workbook in a single operation.
+ *
+ * @param driveRef - A reference to the drive where the workbook will be created.
+ * @param itemPath - The path of the new workbook within the drive.
+ * @returns The created workbook and session details.
+ */
 export default async function createWorkbookAndStartSession(driveRef, itemPath) {
     const workbook = await createWorkbook(driveRef, itemPath);
     const workbookRef = await createWorkbookSession(workbook);

package/dist/tasks/deleteDriveItemWithRetry.d.ts

@@ -1,4 +1,9 @@
 import type { DriveItemRef } from "../models/DriveItemRef.ts";
-/** Delete an item, avoiding locking issues through automatically retrying. */
+/**
+ * Delete a DriveItem, avoiding locking issues through automatic retries.
+ *
+ * @param driveItemRef - A reference to the DriveItem to delete.
+ * @returns Void when the DriveItem is successfully deleted.
+ */
 export default function deleteDriveItemWithRetry(driveItemRef: DriveItemRef): Promise<void>;
 //# sourceMappingURL=deleteDriveItemWithRetry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"deleteDriveItemWithRetry.d.ts","sourceRoot":"","sources":["../../src/tasks/deleteDriveItemWithRetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D,8EAA8E;AAC9E,wBAA8B,wBAAwB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAchG"}
+{"version":3,"file":"deleteDriveItemWithRetry.d.ts","sourceRoot":"","sources":["../../src/tasks/deleteDriveItemWithRetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D;;;;;GAKG;AACH,wBAA8B,wBAAwB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAahG"}

package/dist/tasks/deleteDriveItemWithRetry.js

@@ -1,6 +1,11 @@
 import deleteDriveItem from "../operations/driveItem/deleteDriveItem.js";
 import { sleep } from "../services/sleep.js";
-/** Delete an item, avoiding locking issues through automatically retrying. */
+/**
+ * Delete a DriveItem, avoiding locking issues through automatic retries.
+ *
+ * @param driveItemRef - A reference to the DriveItem to delete.
+ * @returns Void when the DriveItem is successfully deleted.
+ */
 export default async function deleteDriveItemWithRetry(driveItemRef) {
     const retryDelays = [1000, 2000, 4000];
     for (const delay of retryDelays) {
@@ -12,6 +17,5 @@ export default async function deleteDriveItemWithRetry(driveItemRef) {
             await sleep(delay);
         }
     }
-    // Final attempt without delay
     await deleteDriveItem(driveItemRef);
 }

package/dist/tasks/downloadDriveItemContent.d.ts

@@ -1,4 +1,10 @@
 import type { DriveItemRef } from "../models/DriveItemRef.ts";
-/** Download a DriveItem and save it as a local file. */
+/**
+ * Download a DriveItem and save it as a local file.
+ *
+ * @param itemRef - A reference to the DriveItem to download.
+ * @param localFilePath - The local file path where the content should be saved.
+ * @returns Void when the content is successfully downloaded and saved.
+ */
 export default function downloadDriveItemContent(itemRef: DriveItemRef, localFilePath: string): Promise<void>;
 //# sourceMappingURL=downloadDriveItemContent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"downloadDriveItemContent.d.ts","sourceRoot":"","sources":["../../src/tasks/downloadDriveItemContent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,wDAAwD;AACxD,wBAA8B,wBAAwB,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKlH"}
+{"version":3,"file":"downloadDriveItemContent.d.ts","sourceRoot":"","sources":["../../src/tasks/downloadDriveItemContent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D;;;;;;GAMG;AACH,wBAA8B,wBAAwB,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKlH"}

package/dist/tasks/downloadDriveItemContent.js

@@ -1,6 +1,12 @@
 import { writeFile } from "node:fs/promises";
 import getDriveItemContent from "../operations/driveItem/getDriveItemContent.js";
-/** Download a DriveItem and save it as a local file. */
+/**
+ * Download a DriveItem and save it as a local file.
+ *
+ * @param itemRef - A reference to the DriveItem to download.
+ * @param localFilePath - The local file path where the content should be saved.
+ * @returns Void when the content is successfully downloaded and saved.
+ */
 export default async function downloadDriveItemContent(itemRef, localFilePath) {
     const arrayBuffer = await getDriveItemContent(itemRef);
     const buffer = Buffer.from(arrayBuffer);

package/dist/tasks/getRangeLastUsedCell.d.ts

@@ -1,9 +1,13 @@
 import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
-/** Get the last used cell (ie, the most-lower-right) in a given range. */
+/**
+ * Get the last used cell (i.e., the most lower-right cell) in a given range.
+ *
+ * @param rangeRef - A reference to the workbook range to search.
+ * @throws {ProtocolError} If the range's row or column counts, or values, are missing.
+ * @returns The last used cell's value and address, or `null` if no cells are used.
+ */
 export default function getRangeLastUsedCell(rangeRef: WorkbookRangeRef): Promise<{
     value: string | number | boolean | null;
     address: string;
-    rowIndex: number;
-    columnIndex: number;
 } | null>;
 //# sourceMappingURL=getRangeLastUsedCell.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getRangeLastUsedCell.d.ts","sourceRoot":"","sources":["../../src/tasks/getRangeLastUsedCell.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE,0EAA0E;AAC1E,wBAA8B,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAyClM"}
+{"version":3,"file":"getRangeLastUsedCell.d.ts","sourceRoot":"","sources":["../../src/tasks/getRangeLastUsedCell.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE;;;;;;GAMG;AACH,wBAA8B,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAyC3J"}

package/dist/tasks/getRangeLastUsedCell.js

@@ -1,7 +1,13 @@
 import ProtocolError from "../errors/ProtocolError.js";
 import getWorkbookWorksheetRange from "../operations/workbookRange/getWorkbookWorksheetRange.js";
-import { indexesToCellAddress } from "../services/address.js";
-/** Get the last used cell (ie, the most-lower-right) in a given range. */
+import { getFirstCellAddress, offsetAddress } from "../services/addressManipulation.js";
+/**
+ * Get the last used cell (i.e., the most lower-right cell) in a given range.
+ *
+ * @param rangeRef - A reference to the workbook range to search.
+ * @throws {ProtocolError} If the range's row or column counts, or values, are missing.
+ * @returns The last used cell's value and address, or `null` if no cells are used.
+ */
 export default async function getRangeLastUsedCell(rangeRef) {
     // TODO: Consider adding chunking if the range is too large
     // TODO: Reduce cells returned by using "used range"?
@@ -25,12 +31,11 @@ export default async function getRangeLastUsedCell(rangeRef) {
                 throw new ProtocolError("Cell missing");
             }
             if (cell !== null && cell !== "") {
-                const address = indexesToCellAddress(rowIndex, columnIndex);
+                const firstCellAddress = getFirstCellAddress(rangeRef.address);
+                const lastUsedCellAddress = offsetAddress(firstCellAddress, columnIndex, rowIndex);
                 return {
                     value: cell,
-                    address,
-                    rowIndex: rowIndex,
-                    columnIndex: columnIndex,
+                    address: lastUsedCellAddress,
                 };
             }
         }

package/dist/tasks/getRangeLastUsedCell.test.js

@@ -31,8 +31,6 @@ describe("getRangeLastUsedCell", () => {
             }
             expect(result.value).toBe(4);
             expect(result.address).toBe("B2");
-            expect(result.rowIndex).toBe(1);
-            expect(result.columnIndex).toBe(1);
         }
         finally {
             await deleteDriveItemWithRetry(workbook);
@@ -58,8 +56,6 @@ describe("getRangeLastUsedCell", () => {
             }
             expect(result.value).toBe(3);
             expect(result.address).toBe("A2");
-            expect(result.rowIndex).toBe(1);
-            expect(result.columnIndex).toBe(0);
         }
         finally {
             await deleteDriveItemWithRetry(workbook);

package/dist/tasks/getWorkbookTableVisibleBody.d.ts

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

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

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

package/dist/tasks/getWorkbookTableVisibleBody.js

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

package/dist/tasks/getWorkbookWorksheetByName.d.ts

@@ -1,6 +1,13 @@
 import type { WorkbookWorksheet } from "@microsoft/microsoft-graph-types";
 import type { WorkbookRef } from "../models/WorkbookRef.ts";
 import type { WorkbookWorksheetRef } from "../models/WorkbookWorksheetRef.ts";
-/** Get a worksheet by it's name. Throws error if not found. */
+/**
+ * Get a worksheet by its name. Throws an error if not found.
+ *
+ * @param workbookRef - A reference to the workbook containing the worksheet.
+ * @param name - The name of the worksheet to retrieve.
+ * @throws {NotFoundError} If the worksheet with the specified name is not found.
+ * @returns The worksheet details.
+ */
 export default function getWorkbookWorksheetByName(workbookRef: WorkbookRef, name: string): Promise<WorkbookWorksheet & WorkbookWorksheetRef>;
 //# sourceMappingURL=getWorkbookWorksheetByName.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getWorkbookWorksheetByName.d.ts","sourceRoot":"","sources":["../../src/tasks/getWorkbookWorksheetByName.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAG9E,+DAA+D;AAC/D,wBAA8B,0BAA0B,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,oBAAoB,CAAC,CAUlJ"}
+{"version":3,"file":"getWorkbookWorksheetByName.d.ts","sourceRoot":"","sources":["../../src/tasks/getWorkbookWorksheetByName.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAG9E;;;;;;;GAOG;AACH,wBAA8B,0BAA0B,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,oBAAoB,CAAC,CAUlJ"}

package/dist/tasks/getWorkbookWorksheetByName.js

@@ -1,6 +1,13 @@
 import NotFoundError from "../errors/NotFoundError.js";
 import listWorkbookWorksheets from "../operations/workbookWorksheet/listWorkbookWorksheets.js";
-/** Get a worksheet by it's name. Throws error if not found. */
+/**
+ * Get a worksheet by its name. Throws an error if not found.
+ *
+ * @param workbookRef - A reference to the workbook containing the worksheet.
+ * @param name - The name of the worksheet to retrieve.
+ * @throws {NotFoundError} If the worksheet with the specified name is not found.
+ * @returns The worksheet details.
+ */
 export default async function getWorkbookWorksheetByName(workbookRef, name) {
     // TODO: More performant to get it by a direct call without listing all workbooks?
     const worksheets = await listWorkbookWorksheets(workbookRef);

package/dist/tasks/safeDeleteWorkbook.d.ts

@@ -1,4 +1,10 @@
 import type { WorkbookRef } from "../models/WorkbookRef.ts";
-/** Safely delete a workbook by first closing any open sessions and then delete with a back-off retry to allow for any outstanding locks to be closed. @see https://github.com/Future-Secure-AI/microsoft-graph/blob/main/docs/lockedWorkbook.md */
+/**
+ * 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/tasks/safeDeleteWorkbook.d.ts.map

@@ -1 +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,mPAAmP;AACnP,wBAA8B,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxF"}
+{"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/tasks/safeDeleteWorkbook.js

@@ -1,6 +1,12 @@
 import closeWorkbookSession from "../operations/workbookSession/closeWorkbookSession.js";
 import deleteDriveItemWithRetry from "./deleteDriveItemWithRetry.js";
-/** Safely delete a workbook by first closing any open sessions and then delete with a back-off retry to allow for any outstanding locks to be closed. @see https://github.com/Future-Secure-AI/microsoft-graph/blob/main/docs/lockedWorkbook.md */
+/**
+ * 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);

package/dist/tasks/setColumnHidden.d.ts

@@ -1,5 +1,11 @@
 import type { WorkbookRange } from "@microsoft/microsoft-graph-types";
 import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
-/** Hide or show one or more columns. */
+/**
+ * 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/tasks/setColumnHidden.d.ts.map

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

package/dist/tasks/setColumnHidden.js

@@ -1,5 +1,11 @@
 import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.js";
-/** Hide or show one or more columns. */
+/**
+ * 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) {
     return await updateWorkbookRange(rangeRef, {
         columnHidden: hidden,

package/dist/tasks/setRowHidden.d.ts

@@ -1,5 +1,11 @@
 import type { WorkbookRange } from "@microsoft/microsoft-graph-types";
 import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
-/** Hide or show one or more rows. */
+/**
+ * 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/tasks/setRowHidden.d.ts.map

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

package/dist/tasks/setRowHidden.js

@@ -1,5 +1,11 @@
 import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.js";
-/** Hide or show one or more rows. */
+/**
+ * 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) {
     return await updateWorkbookRange(rangeRef, {
         rowHidden: hidden,

package/dist/tasks/setWorkbookTableBodyVisibleRows.d.ts

@@ -1,4 +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 rows visibility. */
+/**
+ * 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/tasks/setWorkbookTableBodyVisibleRows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setWorkbookTableBodyVisibleRows.d.ts","sourceRoot":"","sources":["../../src/tasks/setWorkbookTableBodyVisibleRows.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAQtE,oLAAoL;AACpL,wBAAsB,+BAA+B,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCnH"}
+{"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/tasks/setWorkbookTableBodyVisibleRows.js

@@ -1,39 +1,41 @@
 import InvalidArgumentError from "../errors/InvalidArgumentError.js";
-import NeverError from "../errors/NeverError.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 { cellAddressToIndexes, getAddressFirstCell, getAddressLastCell, indexesToBoxRangeAddress } from "../services/address.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 rows visibility. */
+/**
+ * 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 [startRowIndex, startColumnIndex] = cellAddressToIndexes(getAddressFirstCell(visibleRange.address));
-    const [endRowIndex, endColumnIndex] = cellAddressToIndexes(getAddressLastCell(visibleRange.address));
-    if (endColumnIndex - startColumnIndex + 1 !== visibleRange.columnCount) {
-        throw new NeverError("Insane address");
-    }
-    let currentRowIndex = startRowIndex;
-    for (const srcRowValues of values) {
-        let dstRowRef;
-        let dstRow;
-        let dstRowHidden = false;
+    const firstRowAddress = getFirstRowAddress(visibleRange.address);
+    let currentRowAddress = firstRowAddress;
+    for (const rowValues of values) {
+        let rowRef;
+        let rowHidden = false;
         do {
-            dstRowRef = createWorkbookRangeRef(tableRef, indexesToBoxRangeAddress(currentRowIndex, startColumnIndex, currentRowIndex, endColumnIndex));
-            if (currentRowIndex > endRowIndex) {
-                await insertWorkbookCells(dstRowRef, dstRowRef.address, "Down");
-                dstRowHidden = false;
+            rowRef = createWorkbookRangeRef(tableRef, currentRowAddress);
+            if (isAddressOverlapping(currentRowAddress, visibleRange.address)) {
+                const row = await getWorkbookWorksheetRange(rowRef);
+                rowHidden = row.rowHidden ?? false;
             }
             else {
-                dstRow = await getWorkbookWorksheetRange(dstRowRef);
-                dstRowHidden = dstRow.rowHidden ?? false;
+                await insertWorkbookCells(rowRef, rowRef.address, "Down");
+                rowHidden = false;
             }
-            currentRowIndex++;
-        } while (dstRowHidden);
-        await updateWorkbookRange(dstRowRef, { values: [srcRowValues] });
+            currentRowAddress = incrementRowAddress(currentRowAddress);
+        } while (rowHidden);
+        await updateWorkbookRange(rowRef, { values: [rowValues] });
     }
 }

package/dist/tasks/setWorkbookTableBodyVisibleRows.test.js

@@ -68,12 +68,14 @@ describe("setWorkbookTableBodyVisibleRows", () => {
             await setWorkbookTableBodyVisibleRows(table, [
                 ["NewValue1", "NewValue2", "NewValue3", "NewValue4"],
                 ["NewValue5", "NewValue6", "NewValue7", "NewValue8"],
+                ["NewValue9", "NewValue10", "NewValue11", "NewValue12"],
             ]);
             const visibleBodyRange = await getWorkbookTableVisibleBody(table);
             expect(visibleBodyRange.values).toEqual([
                 ["NewValue1", "NewValue2", "NewValue3", "NewValue4"],
                 ["OldValue5", "OldValue6", "OldValue7", "OldValue8"],
                 ["NewValue5", "NewValue6", "NewValue7", "NewValue8"],
+                ["NewValue9", "NewValue10", "NewValue11", "NewValue12"],
             ]);
         }
         finally {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "microsoft-graph",
-  "version": "2.2.5",
+  "version": "2.3.1",
   "description": "Microsoft GraphAPI SDK for NodeJS",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -85,6 +85,10 @@
       "import": "./dist/errors/RequestFailedError.js",
       "types": "./dist/errors/RequestFailedError.d.ts"
     },
+    "./errors/UnsupportedAddressTypeError": {
+      "import": "./dist/errors/UnsupportedAddressTypeError.js",
+      "types": "./dist/errors/UnsupportedAddressTypeError.d.ts"
+    },
     "./graphApi": {
       "import": "./dist/graphApi.js",
       "types": "./dist/graphApi.d.ts"
@@ -121,6 +125,10 @@
       "import": "./dist/models/ColumnIndex.js",
       "types": "./dist/models/ColumnIndex.d.ts"
     },
+    "./models/ColumnOffset": {
+      "import": "./dist/models/ColumnOffset.js",
+      "types": "./dist/models/ColumnOffset.d.ts"
+    },
     "./models/Context": {
       "import": "./dist/models/Context.js",
       "types": "./dist/models/Context.d.ts"
@@ -181,6 +189,10 @@
       "import": "./dist/models/RowIndex.js",
       "types": "./dist/models/RowIndex.d.ts"
     },
+    "./models/RowOffset": {
+      "import": "./dist/models/RowOffset.js",
+      "types": "./dist/models/RowOffset.d.ts"
+    },
     "./models/Scope": {
       "import": "./dist/models/Scope.js",
       "types": "./dist/models/Scope.d.ts"
@@ -413,6 +425,14 @@
       "import": "./dist/services/address.js",
       "types": "./dist/services/address.d.ts"
     },
+    "./services/addressManipulation": {
+      "import": "./dist/services/addressManipulation.js",
+      "types": "./dist/services/addressManipulation.d.ts"
+    },
+    "./services/addressOffset": {
+      "import": "./dist/services/addressOffset.js",
+      "types": "./dist/services/addressOffset.d.ts"
+    },
     "./services/context": {
       "import": "./dist/services/context.js",
       "types": "./dist/services/context.d.ts"