microsoft-graph 2.22.3 → 2.24.0

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

@@ -1,5 +1,13 @@
+/**
+ * @module getWorkbookTableBodyVisibleRange
+ * @category Tasks
+ * @hidden
+ */
 import type { WorkbookRangeView } from "@microsoft/microsoft-graph-types";
 import type { WorkbookTableRef } from "../models/WorkbookTableRef.ts";
-/** @deprecated Use `getWorkbookTableBodyVisibleRange` instead. */
+/**
+ * @deprecated Use `getWorkbookTableBodyVisibleRange` instead.
+ * @hidden
+ */
 export declare function getWorkbookTableVisibleBody(tableRef: WorkbookTableRef): Promise<WorkbookRangeView>;
 //# sourceMappingURL=getWorkbookTableVisibleBody.d.ts.map

package/dist/esm/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,kEAAkE;AAClE,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;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE;;;GAGG;AACH,wBAAsB,2BAA2B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAKxG"}

package/dist/esm/tasks/getWorkbookTableVisibleBody.js

@@ -1,6 +1,14 @@
+/**
+ * @module getWorkbookTableBodyVisibleRange
+ * @category Tasks
+ * @hidden
+ */
 import getWorkbookVisibleRange from "../operations/workbookRange/getWorkbookVisibleRange.js";
 import getWorkbookTableBodyRange from "../operations/workbookTable/getWorkbookTableBodyRange.js";
-/** @deprecated Use `getWorkbookTableBodyVisibleRange` instead. */
+/**
+ * @deprecated Use `getWorkbookTableBodyVisibleRange` instead.
+ * @hidden
+ */
 export async function getWorkbookTableVisibleBody(tableRef) {
     const range = await getWorkbookTableBodyRange(tableRef);
     const visibleRange = await getWorkbookVisibleRange(range);

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

@@ -1,13 +1,18 @@
+/**
+ * Get a worksheet by its name.
+ * @module getWorkbookWorksheetByName
+ * @category Tasks
+ */
 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 its name. Throws an error if not found.
+ * Get a worksheet by its name.
  *
- * @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.
+ * @param workbookRef A reference to the workbook containing the worksheet.
+ * @param name The name of the worksheet to retrieve.
+ * @throws {@link NotFoundError} If the worksheet with the specified name is not found.
+ * @returns Worksheet
  */
 export default function getWorkbookWorksheetByName(workbookRef: WorkbookRef, name: string): Promise<WorkbookWorksheet & WorkbookWorksheetRef>;
 //# sourceMappingURL=getWorkbookWorksheetByName.d.ts.map

package/dist/esm/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;;;;;;;GAOG;AACH,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;;;;GAIG;AAEH,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/esm/tasks/getWorkbookWorksheetByName.js

@@ -1,12 +1,17 @@
+/**
+ * Get a worksheet by its name.
+ * @module getWorkbookWorksheetByName
+ * @category Tasks
+ */
 import NotFoundError from "../errors/NotFoundError.js";
 import listWorkbookWorksheets from "../operations/workbookWorksheet/listWorkbookWorksheets.js";
 /**
- * Get a worksheet by its name. Throws an error if not found.
+ * Get a worksheet by its name.
  *
- * @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.
+ * @param workbookRef A reference to the workbook containing the worksheet.
+ * @param name The name of the worksheet to retrieve.
+ * @throws {@link NotFoundError} If the worksheet with the specified name is not found.
+ * @returns Worksheet
  */
 export default async function getWorkbookWorksheetByName(workbookRef, name) {
     // TODO: More performant to get it by a direct call without listing all workbooks?

package/dist/esm/tasks/iterateWorkbookRange.d.ts

@@ -1,13 +1,19 @@
+/**
+ * @module iterateWorkbookRange
+ * @category Tasks
+ * @hidden
+ */
 import type { Row } from "../models/Row.ts";
 import type { RowOffset } from "../models/RowOffset.ts";
 import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
 /**
  * Iterates over the values of a workbook range in chunks, fetching data in manageable sizes.
  *
- * @param rangeRef - A reference to the workbook range to iterate over.
+ * @param rangeRef Reference to the workbook range to iterate over.
  * @param overwriteRowsPerRequest - Optional. The number of rows to fetch per request. If omitted, it is automatically calculated.
  * @returns An async iterable that yields rows of range values.
  * @deprecated Use `readWorkbookRows` instead.
+ * @hidden
  */
 export default function iterateWorkbookRange(rangeRef: WorkbookRangeRef, overwriteRowsPerRequest?: number | null): AsyncIterable<{
     rowOffset: RowOffset;

package/dist/esm/tasks/iterateWorkbookRange.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"iterateWorkbookRange.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateWorkbookRange.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAOtE;;;;;;;GAOG;AACH,wBAA+B,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,uBAAuB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,CAAC,CAsDhL"}
+{"version":3,"file":"iterateWorkbookRange.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateWorkbookRange.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAOtE;;;;;;;;GAQG;AACH,wBAA+B,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,uBAAuB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,CAAC,CAsDhL"}

package/dist/esm/tasks/iterateWorkbookRange.js

@@ -1,3 +1,8 @@
+/**
+ * @module iterateWorkbookRange
+ * @category Tasks
+ * @hidden
+ */
 import InvalidArgumentError from "../errors/InvalidArgumentError.js";
 import getWorkbookWorksheetRange from "../operations/workbookRange/getWorkbookWorksheetRange.js";
 import { composeAddress, countAddressColumns, decomposeAddress } from "../services/addressManipulation.js";
@@ -7,10 +12,11 @@ import { createWorkbookRangeRef } from "../services/workbookRange.js";
 /**
  * Iterates over the values of a workbook range in chunks, fetching data in manageable sizes.
  *
- * @param rangeRef - A reference to the workbook range to iterate over.
+ * @param rangeRef Reference to the workbook range to iterate over.
  * @param overwriteRowsPerRequest - Optional. The number of rows to fetch per request. If omitted, it is automatically calculated.
  * @returns An async iterable that yields rows of range values.
  * @deprecated Use `readWorkbookRows` instead.
+ * @hidden
  */
 export default async function* iterateWorkbookRange(rangeRef, overwriteRowsPerRequest = null) {
     const address = rangeRef.address;

package/dist/esm/tasks/iterateWorkbookRangeValues.d.ts

@@ -1,12 +1,18 @@
+/**
+ * @module iterateWorkbookRangeValues
+ * @category Tasks
+ * @hidden
+ */
 import type { CellValue } from "../models/CellValue.ts";
 import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
 /**
  * Iterates over the values of a workbook range in chunks, fetching data in manageable sizes.
  *
- * @param rangeRef - A reference to the workbook range to iterate over.
+ * @param rangeRef Reference to the workbook range to iterate over.
  * @param overwriteRowsPerRequest - Optional. The number of rows to fetch per request. If omitted, it is automatically calculated.
  * @returns An async iterable that yields rows of range values.
  * @deprecated Use `readWorkbookRows` instead.
+ * @hidden
  */
 export default function iterateWorkbookRangeValues(rangeRef: WorkbookRangeRef, overwriteRowsPerRequest?: number | null): AsyncIterable<CellValue[]>;
 //# sourceMappingURL=iterateWorkbookRangeValues.d.ts.map

package/dist/esm/tasks/iterateWorkbookRangeValues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"iterateWorkbookRangeValues.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateWorkbookRangeValues.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAOtE;;;;;;;GAOG;AACH,wBAA+B,0BAA0B,CAAC,QAAQ,EAAE,gBAAgB,EAAE,uBAAuB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC,SAAS,EAAE,CAAC,CAoC/J"}
+{"version":3,"file":"iterateWorkbookRangeValues.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateWorkbookRangeValues.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAOtE;;;;;;;;GAQG;AACH,wBAA+B,0BAA0B,CAAC,QAAQ,EAAE,gBAAgB,EAAE,uBAAuB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC,SAAS,EAAE,CAAC,CAoC/J"}

package/dist/esm/tasks/iterateWorkbookRangeValues.js

@@ -1,3 +1,8 @@
+/**
+ * @module iterateWorkbookRangeValues
+ * @category Tasks
+ * @hidden
+ */
 import InvalidArgumentError from "../errors/InvalidArgumentError.js";
 import getWorkbookWorksheetRange from "../operations/workbookRange/getWorkbookWorksheetRange.js";
 import { composeAddress, decomposeAddress } from "../services/addressManipulation.js";
@@ -7,10 +12,11 @@ import { createWorkbookRangeRef } from "../services/workbookRange.js";
 /**
  * Iterates over the values of a workbook range in chunks, fetching data in manageable sizes.
  *
- * @param rangeRef - A reference to the workbook range to iterate over.
+ * @param rangeRef Reference to the workbook range to iterate over.
  * @param overwriteRowsPerRequest - Optional. The number of rows to fetch per request. If omitted, it is automatically calculated.
  * @returns An async iterable that yields rows of range values.
  * @deprecated Use `readWorkbookRows` instead.
+ * @hidden
  */
 export default async function* iterateWorkbookRangeValues(rangeRef, overwriteRowsPerRequest = null) {
     const address = rangeRef.address;

package/dist/esm/tasks/listDriveItems.d.ts

@@ -1,5 +1,17 @@
+/**
+ * List drive items in a drive or a drive item.
+ * @module listDriveItems
+ * @category Tasks
+ */
 import type { DriveItem } from "@microsoft/microsoft-graph-types";
 import type { DriveItemRef } from "../models/DriveItemRef.ts";
 import type { DriveRef } from "../models/DriveRef.ts";
+/**
+ * List drive items in a drive or a drive item.
+ * @param parentRef Parent drive or folder reference.
+ * @param pageSize Number of items to fetch per request.
+ * @returns
+ * @remarks `pageSize` should only be set for advanced performance tuning.
+ */
 export default function listDriveItems(parentRef: DriveRef | DriveItemRef, pageSize?: number): Promise<(DriveItem & DriveItemRef)[]>;
 //# sourceMappingURL=listDriveItems.d.ts.map

package/dist/esm/tasks/listDriveItems.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listDriveItems.d.ts","sourceRoot":"","sources":["../../../src/tasks/listDriveItems.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAGlE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAOtD,wBAA8B,cAAc,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,EAAE,QAAQ,SAAO,GAAG,OAAO,CAAC,CAAC,SAAS,GAAG,YAAY,CAAC,EAAE,CAAC,CAiCvI"}
+{"version":3,"file":"listDriveItems.d.ts","sourceRoot":"","sources":["../../../src/tasks/listDriveItems.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAKtD;;;;;;GAMG;AACH,wBAA8B,cAAc,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,EAAE,QAAQ,SAAO,GAAG,OAAO,CAAC,CAAC,SAAS,GAAG,YAAY,CAAC,EAAE,CAAC,CAiCvI"}

package/dist/esm/tasks/listDriveItems.js

@@ -1,16 +1,25 @@
-import { authenticationScope } from "../graphApi.js";
+/**
+ * List drive items in a drive or a drive item.
+ * @module listDriveItems
+ * @category Tasks
+ */
 import listDriveItemChildren from "../operations/driveItem/listDriveItemChildren.js";
-import { getCurrentAccessToken } from "../services/accessToken.js";
-import { getContext } from "../services/context.js";
 import { createDriveItemRef } from "../services/driveItem.js";
 import { executeHttpRequest } from "../services/http.js";
+/**
+ * List drive items in a drive or a drive item.
+ * @param parentRef Parent drive or folder reference.
+ * @param pageSize Number of items to fetch per request.
+ * @returns
+ * @remarks `pageSize` should only be set for advanced performance tuning.
+ */
 export default async function listDriveItems(parentRef, pageSize = 1000) {
+    // TODO: Make async iterable
     const output = [];
     let result = await listDriveItemChildren(parentRef, pageSize);
     output.push(...result.value);
     while (result["@odata.nextLink"]) {
-        const context = getContext(parentRef.contextId);
-        const accessToken = await getCurrentAccessToken(context.tenantId, context.clientId, context.clientSecret, authenticationScope);
+        const accessToken = await parentRef.context.generateAccessToken();
         const response = await executeHttpRequest({
             url: result["@odata.nextLink"],
             method: "GET",

package/dist/esm/tasks/readWorkbookRows.d.ts

@@ -1,11 +1,17 @@
+/**
+ * Iterates over the rows in a given worksheet range.
+ * @module readWorkbookRows
+ * @category Tasks
+ */
 import type { Row } from "../models/Row.ts";
 import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
 /**
- * Iterates over the values of a workbook range in chunks, fetching data in manageable sizes.
+ * Iterates over the rows in a given worksheet range.
  *
- * @param rangeRef - A reference to the workbook range to iterate over.
- * @param overwriteMaxRowsPerChunk - Optional. The number of rows to fetch per request. If omitted, it is automatically calculated.
+ * @param rangeRef Reference to the workbook range to iterate over.
+ * @param overwriteMaxRowsPerChunk Overwrite the number of rows per underlying request. DO NOT SET EXCEPT FOR ADVANCED TUNING.
  * @returns An async iterable that yields rows of range values.
+ * @throws {@link InvalidArgumentError} If `overwriteMaxRowsPerChunk` is set to a value less than 1.
  */
 export default function readWorkbookRows(rangeRef: WorkbookRangeRef, overwriteMaxRowsPerChunk?: number | null): AsyncIterable<Row>;
 //# sourceMappingURL=readWorkbookRows.d.ts.map

package/dist/esm/tasks/readWorkbookRows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readWorkbookRows.d.ts","sourceRoot":"","sources":["../../../src/tasks/readWorkbookRows.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAOtE;;;;;;GAMG;AACH,wBAA+B,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,wBAAwB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC,GAAG,CAAC,CA+C9I"}
+{"version":3,"file":"readWorkbookRows.d.ts","sourceRoot":"","sources":["../../../src/tasks/readWorkbookRows.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAOtE;;;;;;;GAOG;AACH,wBAA+B,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,wBAAwB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC,GAAG,CAAC,CA+C9I"}

package/dist/esm/tasks/readWorkbookRows.js

@@ -1,15 +1,21 @@
+/**
+ * Iterates over the rows in a given worksheet range.
+ * @module readWorkbookRows
+ * @category Tasks
+ */
 import InvalidArgumentError from "../errors/InvalidArgumentError.js";
 import getWorkbookWorksheetRange from "../operations/workbookRange/getWorkbookWorksheetRange.js";
 import { composeAddress, countAddressColumns, decomposeAddress } from "../services/addressManipulation.js";
 import { columnAddressToOffset, rowAddressToOffset, rowOffsetToAddress } from "../services/addressOffset.js";
-import { createWorkbookRangeRef } from "../services/workbookRange.js";
 import { maxCellsPerRequest } from "../services/batch.js";
+import { createWorkbookRangeRef } from "../services/workbookRange.js";
 /**
- * Iterates over the values of a workbook range in chunks, fetching data in manageable sizes.
+ * Iterates over the rows in a given worksheet range.
  *
- * @param rangeRef - A reference to the workbook range to iterate over.
- * @param overwriteMaxRowsPerChunk - Optional. The number of rows to fetch per request. If omitted, it is automatically calculated.
+ * @param rangeRef Reference to the workbook range to iterate over.
+ * @param overwriteMaxRowsPerChunk Overwrite the number of rows per underlying request. DO NOT SET EXCEPT FOR ADVANCED TUNING.
  * @returns An async iterable that yields rows of range values.
+ * @throws {@link InvalidArgumentError} If `overwriteMaxRowsPerChunk` is set to a value less than 1.
  */
 export default async function* readWorkbookRows(rangeRef, overwriteMaxRowsPerChunk = null) {
     const address = rangeRef.address;

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

@@ -1,9 +1,15 @@
+/**
+ * Safely delete a workbook by first closing any open sessions and then deleting it.
+ * @module safeDeleteWorkbook
+ * @category Tasks
+ */
 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.
+ * Safely delete a workbook by first closing any open sessions and then deleting it.
  *
- * @param workbookRef - A reference to the workbook to be deleted.
+ * @param workbookRef Reference to the workbook to be deleted.
  * @returns Void when the workbook is successfully deleted.
+ * @remarks Back-off retry to allow for any lingering locks to be closed.
  * @see https://github.com/Future-Secure-AI/microsoft-graph/blob/main/docs/lockedWorkbook.md
  */
 export default function safeDeleteWorkbook(workbookRef: WorkbookRef): Promise<void>;

package/dist/esm/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;;;;;;GAMG;AACH,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;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAI5D;;;;;;;GAOG;AACH,wBAA8B,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxF"}

package/dist/esm/tasks/safeDeleteWorkbook.js

@@ -1,10 +1,16 @@
+/**
+ * Safely delete a workbook by first closing any open sessions and then deleting it.
+ * @module safeDeleteWorkbook
+ * @category Tasks
+ */
 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.
+ * Safely delete a workbook by first closing any open sessions and then deleting it.
  *
- * @param workbookRef - A reference to the workbook to be deleted.
+ * @param workbookRef Reference to the workbook to be deleted.
  * @returns Void when the workbook is successfully deleted.
+ * @remarks Back-off retry to allow for any lingering locks to be closed.
  * @see https://github.com/Future-Secure-AI/microsoft-graph/blob/main/docs/lockedWorkbook.md
  */
 export default async function safeDeleteWorkbook(workbookRef) {

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

@@ -1,10 +1,14 @@
+/**
+ * Set one or more columns visibility.
+ * @module setColumnHidden
+ * @category Tasks
+ */
 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.
+ * Set one or more columns visibility.
+ * @param rangeRef Reference to the workbook range representing the columns to hide or show.
+ * @param hidden 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>;

package/dist/esm/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;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"}
+{"version":3,"file":"setColumnHidden.d.ts","sourceRoot":"","sources":["../../../src/tasks/setColumnHidden.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE;;;;;GAKG;AACH,wBAA8B,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,gBAAgB,CAAC,CASpI"}

package/dist/esm/tasks/setColumnHidden.js

@@ -1,18 +1,21 @@
+/**
+ * Set one or more columns visibility.
+ * @module setColumnHidden
+ * @category Tasks
+ */
 import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.js";
-import { decomposeAddress, isAllColumnsAddress } from "../services/addressManipulation.js";
+import { 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.
+ * Set one or more columns visibility.
+ * @param rangeRef Reference to the workbook range representing the columns to hide or show.
+ * @param hidden Boolean indicating whether to hide (`true`) or show (`false`) the columns.
  * @returns The updated workbook range.
  */
 export default async function setColumnHidden(rangeRef, hidden) {
+    // TODO: Remove return value
     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/esm/tasks/setRowHidden.d.ts

@@ -1,10 +1,14 @@
+/**
+ * Set one or more rows visibility.
+ * @module setRowHidden
+ * @category Tasks
+ */
 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.
+ * Set one or more rows visibility.
+ * @param rangeRef Reference to the workbook range representing the rows to hide or show.
+ * @param hidden 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>;

package/dist/esm/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;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"}
+{"version":3,"file":"setRowHidden.d.ts","sourceRoot":"","sources":["../../../src/tasks/setRowHidden.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE;;;;;GAKG;AACH,wBAA8B,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,gBAAgB,CAAC,CASjI"}

package/dist/esm/tasks/setRowHidden.js

@@ -1,18 +1,21 @@
+/**
+ * Set one or more rows visibility.
+ * @module setRowHidden
+ * @category Tasks
+ */
 import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.js";
-import { decomposeAddress, isAllRowsAddress } from "../services/addressManipulation.js";
+import { 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.
+ * Set one or more rows visibility.
+ * @param rangeRef Reference to the workbook range representing the rows to hide or show.
+ * @param hidden Boolean indicating whether to hide (`true`) or show (`false`) the rows.
  * @returns The updated workbook range.
  */
 export default async function setRowHidden(rangeRef, hidden) {
+    // TODO: Remove return value
     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/esm/tasks/setWorkbookRangeValues.d.ts

@@ -1,11 +1,17 @@
+/**
+ * @module setWorkbookRangeValues
+ * @category Tasks
+ * @hidden
+ */
 import type { CellValue } from "../models/CellValue.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 {WorkbookRangeRef} rangeRef 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
+ *  * @deprecated Use `writeWorkbookRows` instead.
+ * @hidden
  */
 export default function setWorkbookRangeValues(rangeRef: WorkbookRangeRef, values: CellValue[][]): Promise<void>;
 //# sourceMappingURL=setWorkbookRangeValues.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"setWorkbookRangeValues.d.ts","sourceRoot":"","sources":["../../../src/tasks/setWorkbookRangeValues.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE;;;;;;GAMG;AACH,wBAA8B,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,iBAcrG"}
+{"version":3,"file":"setWorkbookRangeValues.d.ts","sourceRoot":"","sources":["../../../src/tasks/setWorkbookRangeValues.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE;;;;;;;GAOG;AACH,wBAA8B,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,iBAcrG"}

package/dist/esm/tasks/setWorkbookRangeValues.js

@@ -1,12 +1,18 @@
+/**
+ * @module setWorkbookRangeValues
+ * @category Tasks
+ * @hidden
+ */
 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 {WorkbookRangeRef} rangeRef 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
+ *  * @deprecated Use `writeWorkbookRows` instead.
+ * @hidden
  */
 export default async function setWorkbookRangeValues(rangeRef, values) {
     const rowCount = countAddressRows(rangeRef.address);

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

@@ -1,12 +1,16 @@
+/**
+ * Set visible rows of a workbook table with the provided 2D array of values, ignoring hidden rows and inserting new rows at the end if needed.
+ * @module setWorkbookTableBodyVisibleRows
+ * @category Tasks
+ */
 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.
+ * Set visible rows of a workbook table with the provided 2D array of values, ignoring hidden rows and inserting new rows at the end if needed.
  *
- * @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.
+ * @param tableRef Reference to the workbook table.
+ * @param values 2D array of strings representing the values to set in the visible rows of the table.
+ * @throws {@link InvalidArgumentError} If the number of columns in any row of `values` does not match the table's column count.
+ *  * @remarks THIS FUNCTION IS SLOW, as it must check each row's visibility.
  */
 export declare function setWorkbookTableBodyVisibleRows(tableRef: WorkbookTableRef, values: string[][]): Promise<void>;
 //# sourceMappingURL=setWorkbookTableBodyVisibleRows.d.ts.map

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

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

package/dist/esm/tasks/setWorkbookTableBodyVisibleRows.js

@@ -1,3 +1,8 @@
+/**
+ * Set visible rows of a workbook table with the provided 2D array of values, ignoring hidden rows and inserting new rows at the end if needed.
+ * @module setWorkbookTableBodyVisibleRows
+ * @category Tasks
+ */
 import InvalidArgumentError from "../errors/InvalidArgumentError.js";
 import getWorkbookWorksheetRange from "../operations/workbookRange/getWorkbookWorksheetRange.js";
 import insertWorkbookCells from "../operations/workbookRange/insertWorkbookCells.js";
@@ -6,13 +11,12 @@ import getWorkbookTableBodyRange from "../operations/workbookTable/getWorkbookTa
 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.
+ * Set visible rows of a workbook table with the provided 2D array of values, ignoring hidden rows and inserting new rows at the end if needed.
  *
- * @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.
+ * @param tableRef Reference to the workbook table.
+ * @param values 2D array of strings representing the values to set in the visible rows of the table.
+ * @throws {@link InvalidArgumentError} If the number of columns in any row of `values` does not match the table's column count.
+ *  * @remarks THIS FUNCTION IS SLOW, as it must check each row's visibility.
  */
 export async function setWorkbookTableBodyVisibleRows(tableRef, values) {
     const visibleRange = await getWorkbookTableBodyRange(tableRef);

package/dist/esm/tasks/tryCloseWorkbookSession.d.ts

@@ -1,9 +1,14 @@
+/**
+ * Try and close a workbook session.
+ * @module tryCloseWorkbookSession
+ * @category Tasks
+ */
 import type { WorkbookRef } from "../models/WorkbookRef.ts";
 /**
- * Try and close a workbook session. Do not error if not possible
- *
- * @param workbookRef - A reference to the workbook, optionally including session information. The session ID is required.
- * @returns true if the session was closed, false if it was not possible to close the session.
+ * Try and close a workbook session.
+ * @param workbookRef Reference to the workbook. The session ID is required.
+ * @returns If the session was closed, false if it was not possible to close the session.
+ * @remarks Does not error if the session is already closed or expired.
  **/
 export default function tryCloseWorkbookSession(workbookRef: WorkbookRef): Promise<boolean>;
 //# sourceMappingURL=tryCloseWorkbookSession.d.ts.map

package/dist/esm/tasks/tryCloseWorkbookSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tryCloseWorkbookSession.d.ts","sourceRoot":"","sources":["../../../src/tasks/tryCloseWorkbookSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D;;;;;IAKI;AACJ,wBAA8B,uBAAuB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAOhG"}
+{"version":3,"file":"tryCloseWorkbookSession.d.ts","sourceRoot":"","sources":["../../../src/tasks/tryCloseWorkbookSession.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D;;;;;IAKI;AACJ,wBAA8B,uBAAuB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAOhG"}

package/dist/esm/tasks/tryCloseWorkbookSession.js

@@ -1,9 +1,9 @@
 import closeWorkbookSession from "../operations/workbookSession/closeWorkbookSession.js";
 /**
- * Try and close a workbook session. Do not error if not possible
- *
- * @param workbookRef - A reference to the workbook, optionally including session information. The session ID is required.
- * @returns true if the session was closed, false if it was not possible to close the session.
+ * Try and close a workbook session.
+ * @param workbookRef Reference to the workbook. The session ID is required.
+ * @returns If the session was closed, false if it was not possible to close the session.
+ * @remarks Does not error if the session is already closed or expired.
  **/
 export default async function tryCloseWorkbookSession(workbookRef) {
     try {