microsoft-graph 2.23.0 → 2.25.0

package/dist/esm/tasks/createWorkbookAndStartSession.js

@@ -1,9 +1,14 @@
+/**
+ * Create a new workbook and open a session for that workbook.
+ * @module createWorkbookAndStartSession
+ * @category Tasks
+ */
 import createWorkbook from "../operations/workbook/createWorkbook.js";
 import createWorkbookSession from "../operations/workbookSession/createWorkbookSession.js";
 /**
- * Create a new workbook and open a session for that workbook in a single operation.
+ * Create a new workbook and open a session for that workbook/
  *
- * @param parentRef - A reference to the drive or driveItem where the workbook will be created.
+ * @param parentRef Reference to the drive or driveItem where the workbook will be created.
  * @param itemPath - The path of the new workbook within the drive.
  * @returns The created workbook and session details.
  */

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

@@ -1,9 +1,15 @@
-import type { DriveItemRef } from "../models/DriveItemRef.ts";
 /**
- * Delete a DriveItem, avoiding locking issues through automatic retries.
+ * Delete a drive item, avoiding locking issues through automatic retries.
+ * @module deleteDriveItemWithRetry
+ * @category Tasks
+ */
+import type { DriveItemRef } from "../models/DriveItem.ts";
+/**
+ * Delete a drive item, avoiding locking issues through automatic retries.
  *
- * @param driveItemRef - A reference to the DriveItem to delete.
- * @returns Void when the DriveItem is successfully deleted.
+ * @param driveItemRef Reference to the DriveItem to delete.
+ * @remarks This function attempts to delete the drive item up to three times with increasing delays (1s, 2s, 4s) in case of failure.
+ * @deprecated Use `deleteDriveItem` directly as this is now handled by the lowest level API
  */
 export default function deleteDriveItemWithRetry(driveItemRef: DriveItemRef): Promise<void>;
 //# sourceMappingURL=deleteDriveItemWithRetry.d.ts.map

package/dist/esm/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;;;;;GAKG;AACH,wBAA8B,wBAAwB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAahG"}
+{"version":3,"file":"deleteDriveItemWithRetry.d.ts","sourceRoot":"","sources":["../../../src/tasks/deleteDriveItemWithRetry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D;;;;;;GAMG;AACH,wBAA8B,wBAAwB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAahG"}

package/dist/esm/tasks/deleteDriveItemWithRetry.js

@@ -1,10 +1,16 @@
+/**
+ * Delete a drive item, avoiding locking issues through automatic retries.
+ * @module deleteDriveItemWithRetry
+ * @category Tasks
+ */
 import deleteDriveItem from "../operations/driveItem/deleteDriveItem.js";
 import { sleep } from "../services/sleep.js";
 /**
- * Delete a DriveItem, avoiding locking issues through automatic retries.
+ * Delete a drive item, avoiding locking issues through automatic retries.
  *
- * @param driveItemRef - A reference to the DriveItem to delete.
- * @returns Void when the DriveItem is successfully deleted.
+ * @param driveItemRef Reference to the DriveItem to delete.
+ * @remarks This function attempts to delete the drive item up to three times with increasing delays (1s, 2s, 4s) in case of failure.
+ * @deprecated Use `deleteDriveItem` directly as this is now handled by the lowest level API
  */
 export default async function deleteDriveItemWithRetry(driveItemRef) {
     const retryDelays = [1000, 2000, 4000];

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

@@ -1,10 +1,14 @@
-import type { DriveItemRef } from "../models/DriveItemRef.ts";
 /**
- * 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.
+ * Download a drive item and save it to the local disk.
+ * @module downloadDriveItemContent
+ * @category Tasks
  */
+import type { DriveItemRef } from "../models/DriveItem.ts";
+/**
+ * Download a drive item and save it to the local disk.
+ *
+ * @param itemRef A reference to the DriveItem to download.
+ * @param localFilePath The local file path where the content should be saved.
+ *  */
 export default function downloadDriveItemContent(itemRef: DriveItemRef, localFilePath: string): Promise<void>;
 //# sourceMappingURL=downloadDriveItemContent.d.ts.map

package/dist/esm/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;;;;;;GAMG;AACH,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":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D;;;;;MAKM;AACN,wBAA8B,wBAAwB,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKlH"}

package/dist/esm/tasks/downloadDriveItemContent.js

@@ -1,12 +1,16 @@
+/**
+ * Download a drive item and save it to the local disk.
+ * @module downloadDriveItemContent
+ * @category Tasks
+ */
 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 drive item and save it to the local disk.
  *
- * @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.
- */
+ * @param itemRef A reference to the DriveItem to download.
+ * @param localFilePath The local file path where the content should be saved.
+ *  */
 export default async function downloadDriveItemContent(itemRef, localFilePath) {
     const arrayBuffer = await getDriveItemContent(itemRef);
     const buffer = Buffer.from(arrayBuffer);

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

@@ -1,13 +1,22 @@
-import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
+/**
+ * @module getRangeLastUsedCell
+ * @category Tasks
+ * @hidden
+ */
+import type { CellAddress } from "../models/Address.ts";
+import type { CellValue } from "../models/Cell.ts";
+import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
 /**
  * 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.
+ * @param rangeRef Reference to the workbook range to search.
+ * @throws {@link ProtocolError} Server returns an unexpected value.
  * @returns The last used cell's value and address, or `null` if no cells are used.
+ * @deprecated Use `getWorkbookWorksheetUsedRangeRef` and `subAddress` instead.
+ * @hidden
  */
 export default function getRangeLastUsedCell(rangeRef: WorkbookRangeRef): Promise<{
-    value: string | number | boolean | null;
-    address: string;
+    value: CellValue;
+    address: CellAddress;
 } | null>;
 //# sourceMappingURL=getRangeLastUsedCell.d.ts.map

package/dist/esm/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;;;;;;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"}
+{"version":3,"file":"getRangeLastUsedCell.d.ts","sourceRoot":"","sources":["../../../src/tasks/getRangeLastUsedCell.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE;;;;;;;;GAQG;AACH,wBAA8B,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG,IAAI,CAAC,CAsCzI"}

package/dist/esm/tasks/getRangeLastUsedCell.js

@@ -1,16 +1,21 @@
+/**
+ * @module getRangeLastUsedCell
+ * @category Tasks
+ * @hidden
+ */
 import ProtocolError from "../errors/ProtocolError.js";
 import getWorkbookWorksheetRange from "../operations/workbookRange/getWorkbookWorksheetRange.js";
 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.
+ * @param rangeRef Reference to the workbook range to search.
+ * @throws {@link ProtocolError} Server returns an unexpected value.
  * @returns The last used cell's value and address, or `null` if no cells are used.
+ * @deprecated Use `getWorkbookWorksheetUsedRangeRef` and `subAddress` instead.
+ * @hidden
  */
 export default async function getRangeLastUsedCell(rangeRef) {
-    // TODO: Consider adding chunking if the range is too large
-    // TODO: Reduce cells returned by using "used range"?
     const range = await getWorkbookWorksheetRange(rangeRef);
     const { rowCount, columnCount } = range;
     if (rowCount === undefined || columnCount === undefined) {

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. */
+import type { WorkbookTableRef } from "../models/WorkbookTable.ts";
+/**
+ * @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,4BAA4B,CAAC;AAInE;;;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";
+import type { WorkbookRef } from "../models/Workbook.ts";
+import type { WorkbookWorksheetRef } from "../models/WorkbookWorksheet.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,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAG3E;;;;;;;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,18 @@
-import type { Row } from "../models/Row.ts";
-import type { RowOffset } from "../models/RowOffset.ts";
-import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
+/**
+ * @module iterateWorkbookRange
+ * @category Tasks
+ * @hidden
+ */
+import type { Row, RowOffset } from "../models/Row.ts";
+import type { WorkbookRangeRef } from "../models/WorkbookRange.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;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAOnE;;;;;;;;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,CA0DhL"}

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;
@@ -39,13 +45,13 @@ export default async function* iterateWorkbookRange(rangeRef, overwriteRowsPerRe
         const range = await getWorkbookWorksheetRange(requestRef);
         const values = range.values;
         const text = range.text;
-        const numberFormat = range.numberFormat;
+        const format = range.numberFormat;
         const rowCount = values.length;
         for (let r = 0; r < rowCount; r++) {
             const row = Array.from({ length: columnCount }, (_, c) => ({
                 text: text[r]?.[c] ?? "",
                 value: values[r]?.[c] ?? "",
-                numberFormat: numberFormat?.[r]?.[c] ?? "",
+                format: format?.[r]?.[c] ?? "",
             }));
             yield {
                 rowOffset: offset,

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

@@ -1,12 +1,18 @@
-import type { CellValue } from "../models/CellValue.ts";
-import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
+/**
+ * @module iterateWorkbookRangeValues
+ * @category Tasks
+ * @hidden
+ */
+import type { CellValue } from "../models/Cell.ts";
+import type { WorkbookRangeRef } from "../models/WorkbookRange.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,mBAAmB,CAAC;AAEnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAOnE;;;;;;;;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";
-export default function listDriveItems(parentRef: DriveRef | DriveItemRef, pageSize?: number): Promise<(DriveItem & DriveItemRef)[]>;
+import type { DriveRef } from "../models/Drive.ts";
+import type { DriveItemRef } from "../models/DriveItem.ts";
+/**
+ * List drive items in a drive or a drive item as an async iterable.
+ * @param parentRef Parent drive or folder reference.
+ * @param maxPerChunk Number of items to fetch per request. DO NOT SET EXCEPT FOR ADVANCED TUNING.
+ * @returns Async iterable of drive items.
+ * @remarks `pageSize` should only be set for advanced performance tuning.
+ */
+export default function listDriveItems(parentRef: DriveRef | DriveItemRef, maxPerChunk?: number): AsyncGenerator<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;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAKtD,wBAA8B,cAAc,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,EAAE,QAAQ,SAAO,GAAG,OAAO,CAAC,CAAC,SAAS,GAAG,YAAY,CAAC,EAAE,CAAC,CAgCvI"}
+{"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;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAKxE;;;;;;GAMG;AACH,wBAA+B,cAAc,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,EAAE,WAAW,SAAO,GAAG,cAAc,CAAC,SAAS,GAAG,YAAY,CAAC,CAgC9I"}

package/dist/esm/tasks/listDriveItems.js

@@ -1,10 +1,27 @@
+/**
+ * List drive items in a drive or a drive item.
+ * @module listDriveItems
+ * @category Tasks
+ */
 import listDriveItemChildren from "../operations/driveItem/listDriveItemChildren.js";
 import { createDriveItemRef } from "../services/driveItem.js";
 import { executeHttpRequest } from "../services/http.js";
-export default async function listDriveItems(parentRef, pageSize = 1000) {
-    const output = [];
-    let result = await listDriveItemChildren(parentRef, pageSize);
-    output.push(...result.value);
+/**
+ * List drive items in a drive or a drive item as an async iterable.
+ * @param parentRef Parent drive or folder reference.
+ * @param maxPerChunk Number of items to fetch per request. DO NOT SET EXCEPT FOR ADVANCED TUNING.
+ * @returns Async iterable of drive items.
+ * @remarks `pageSize` should only be set for advanced performance tuning.
+ */
+export default async function* listDriveItems(parentRef, maxPerChunk = 1000) {
+    let result = await listDriveItemChildren(parentRef, maxPerChunk);
+    for (const item of result.value) {
+        const itemRef = createDriveItemRef(parentRef, item.id);
+        yield {
+            ...item,
+            ...itemRef,
+        };
+    }
     while (result["@odata.nextLink"]) {
         const accessToken = await parentRef.context.generateAccessToken();
         const response = await executeHttpRequest({
@@ -15,14 +32,12 @@ export default async function listDriveItems(parentRef, pageSize = 1000) {
             },
         });
         result = response.data;
-        const items = result.value.map((item) => {
+        for (const item of result.value) {
             const itemRef = createDriveItemRef(parentRef, item.id);
-            return {
+            yield {
                 ...item,
                 ...itemRef,
             };
-        });
-        output.push(...items);
+        }
     }
-    return output;
 }

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";
+import type { WorkbookRangeRef } from "../models/WorkbookRange.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;AAIH,OAAO,KAAK,EAAE,GAAG,EAAa,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAOnE;;;;;;;GAOG;AACH,wBAA+B,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,wBAAwB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC,GAAG,CAAC,CAmD9I"}

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;
@@ -43,7 +49,7 @@ export default async function* readWorkbookRows(rangeRef, overwriteMaxRowsPerChu
             const row = Array.from({ length: columnCount }, (_, c) => ({
                 text: text[r]?.[c] ?? "",
                 value: values[r]?.[c] ?? "",
-                numberFormat: numberFormat?.[r]?.[c] ?? "",
+                format: numberFormat?.[r]?.[c] ?? "",
             }));
             yield row;
         }

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

@@ -1,8 +1,13 @@
-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.
+ * @module safeDeleteWorkbook
+ * @category Tasks
+ */
+import type { WorkbookRef } from "../models/Workbook.ts";
+/**
+ * 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.
  * @see https://github.com/Future-Secure-AI/microsoft-graph/blob/main/docs/lockedWorkbook.md
  */

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,uBAAuB,CAAC;AAIzD;;;;;;GAMG;AACH,wBAA8B,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxF"}

package/dist/esm/tasks/safeDeleteWorkbook.js

@@ -1,9 +1,14 @@
+/**
+ * Safely delete a workbook by first closing any open sessions and then deleting it.
+ * @module safeDeleteWorkbook
+ * @category Tasks
+ */
+import deleteDriveItem from "../operations/driveItem/deleteDriveItem.js";
 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.
  * @see https://github.com/Future-Secure-AI/microsoft-graph/blob/main/docs/lockedWorkbook.md
  */
@@ -11,5 +16,5 @@ export default async function safeDeleteWorkbook(workbookRef) {
     if (workbookRef.sessionId) {
         await closeWorkbookSession(workbookRef);
     }
-    await deleteDriveItemWithRetry(workbookRef);
+    await deleteDriveItem(workbookRef);
 }

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

@@ -1,11 +1,8 @@
-import type { WorkbookRange } from "@microsoft/microsoft-graph-types";
-import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
+import type { WorkbookRangeRef } from "../models/WorkbookRange.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.
+ * 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.
  */
-export default function setColumnHidden(rangeRef: WorkbookRangeRef, hidden: boolean): Promise<WorkbookRange & WorkbookRangeRef>;
+export default function setColumnHidden(rangeRef: WorkbookRangeRef, hidden: boolean): Promise<void>;
 //# sourceMappingURL=setColumnHidden.d.ts.map

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,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE;;;;GAIG;AACH,wBAA8B,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxG"}