microsoft-graph 2.15.1 → 2.16.0

package/dist/cjs/models/Cell.d.ts

@@ -0,0 +1,8 @@
+import type { CellValue } from "../models/CellValue.ts";
+import type { NumberFormat } from "./NumberFormat.ts";
+export type Cell = {
+    text: string;
+    value: CellValue;
+    numberFormat: NumberFormat;
+};
+//# sourceMappingURL=Cell.d.ts.map

package/dist/cjs/models/Cell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cell.d.ts","sourceRoot":"","sources":["../../../src/models/Cell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,IAAI,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;CAC3B,CAAC"}

package/dist/cjs/models/Cell.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/models/NumberFormat.d.ts

@@ -0,0 +1,4 @@
+export type NumberFormat = string & {
+    __brand: "NumberFormat";
+};
+//# sourceMappingURL=NumberFormat.d.ts.map

package/dist/cjs/models/NumberFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumberFormat.d.ts","sourceRoot":"","sources":["../../../src/models/NumberFormat.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IACnC,OAAO,EAAE,cAAc,CAAC;CACxB,CAAC"}

package/dist/cjs/models/NumberFormat.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.d.ts

@@ -0,0 +1,12 @@
+import type { Address } from "../../models/Address.ts";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+import type { WorkbookWorksheetRef } from "../../models/WorkbookWorksheetRef.ts";
+/**
+ * Retrieve the address of the used range in a worksheet, ignoring trailing rows and columns that are blank.
+ *
+ * @param worksheetRef - A reference to the worksheet, optionally including session information.
+ * @returns Address of the used range of the worksheet.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-usedrange
+ */
+export default function getWorkbookWorksheetUsedRangeAddress(worksheetRef: WorkbookWorksheetRef): GraphOperation<Address>;
+//# sourceMappingURL=getWorkbookWorksheetUsedRangeAddress.d.ts.map

package/dist/cjs/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWorkbookWorksheetUsedRangeAddress.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAoB,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAIjF;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,oCAAoC,CAAC,YAAY,EAAE,oBAAoB,GAAG,cAAc,CAAC,OAAO,CAAC,CAmBxH"}

package/dist/cjs/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = getWorkbookWorksheetUsedRangeAddress;
+const ProtocolError_ts_1 = __importDefault(require("../../errors/ProtocolError.js"));
+const graphApi_ts_1 = require("../../graphApi.js");
+const addressManipulation_ts_1 = require("../../services/addressManipulation.js");
+const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
+/**
+ * Retrieve the address of the used range in a worksheet, ignoring trailing rows and columns that are blank.
+ *
+ * @param worksheetRef - A reference to the worksheet, optionally including session information.
+ * @returns Address of the used range of the worksheet.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-usedrange
+ */
+function getWorkbookWorksheetUsedRangeAddress(worksheetRef) {
+    return (0, graphApi_ts_1.operation)({
+        contextId: worksheetRef.contextId,
+        method: "GET",
+        path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range/usedRange?$select=address", worksheetRef),
+        headers: {
+            "workbook-session-id": worksheetRef.sessionId,
+        },
+        body: null,
+        responseTransform: (response) => {
+            const range = response;
+            if (!range.address) {
+                throw new ProtocolError_ts_1.default("Invalid response: address is missing");
+            }
+            const address = (0, addressManipulation_ts_1.composeAddress)((0, addressManipulation_ts_1.decomposeAddress)(range.address)); // Strip any prefixed sheet name
+            return address;
+        },
+    });
+}

package/dist/cjs/services/addressManipulation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addressManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/addressManipulation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAoB,aAAa,EAAsB,UAAU,EAAmB,MAAM,sBAAsB,CAAC;AAmBnJ,MAAM,MAAM,iBAAiB,GAAG;IAC/B,WAAW,EAAE,aAAa,CAAC;IAC3B,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAcpE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CA6BrE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS5D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS3D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS/D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAqChG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAKlF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG1D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAGzD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAG5D"}
+{"version":3,"file":"addressManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/addressManipulation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAoB,aAAa,EAAsB,UAAU,EAAmB,MAAM,sBAAsB,CAAC;AAmBnJ,MAAM,MAAM,iBAAiB,GAAG;IAC/B,WAAW,EAAE,aAAa,CAAC;IAC3B,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAcpE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAsBrE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS5D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS3D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS/D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAqChG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAKlF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG1D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAGzD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAG5D"}

package/dist/cjs/services/addressManipulation.js

@@ -70,12 +70,6 @@ function composeAddress(components) {
     if (isSingleColumn(components) && isSingleRow(components)) {
         return composeCellAddress(components.startColumn, components.startRow);
     }
-    if (components.startColumn > components.endColumn) {
-        throw new InvalidArgumentError_ts_1.default("Invalid address. End column is before start column.");
-    }
-    if (components.startRow > components.endRow) {
-        throw new InvalidArgumentError_ts_1.default("Invalid address. End row is before start row.");
-    }
     return composeCellRangeAddress(components.startColumn, components.startRow, components.endColumn, components.endRow);
 }
 /**

package/dist/cjs/services/cartesianAddress.d.ts

@@ -13,5 +13,5 @@ export declare function addressToCartesian(address: Address): Cartesian;
  * @param {Cartesian} cartesian - The Cartesian coordinates, including start (ax, ay) and end (bx, by).
  * @returns {Address} The cell range address (e.g., "A1:C3").
  */
-export declare function cartesianToAddress(cartesian: Cartesian): Address;
+export declare function cartesianToAddress({ ax, ay, bx, by }: Cartesian): Address;
 //# sourceMappingURL=cartesianAddress.d.ts.map

package/dist/cjs/services/cartesianAddress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cartesianAddress.d.ts","sourceRoot":"","sources":["../../../src/services/cartesianAddress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAIxD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAU9D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAchE"}
+{"version":3,"file":"cartesianAddress.d.ts","sourceRoot":"","sources":["../../../src/services/cartesianAddress.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAIxD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAU9D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO,CAqBzE"}

package/dist/cjs/services/cartesianAddress.js

@@ -1,7 +1,11 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addressToCartesian = addressToCartesian;
 exports.cartesianToAddress = cartesianToAddress;
+const InvalidArgumentError_ts_1 = __importDefault(require("../errors/InvalidArgumentError.js"));
 const addressManipulation_ts_1 = require("./addressManipulation.js");
 const addressOffset_ts_1 = require("./addressOffset.js");
 /**
@@ -24,11 +28,17 @@ function addressToCartesian(address) {
  * @param {Cartesian} cartesian - The Cartesian coordinates, including start (ax, ay) and end (bx, by).
  * @returns {Address} The cell range address (e.g., "A1:C3").
  */
-function cartesianToAddress(cartesian) {
-    const startColumn = (0, addressOffset_ts_1.columnOffsetToAddress)(cartesian.ax);
-    const startRow = (0, addressOffset_ts_1.rowOffsetToAddress)(cartesian.ay);
-    const endColumn = (0, addressOffset_ts_1.columnOffsetToAddress)(cartesian.bx);
-    const endRow = (0, addressOffset_ts_1.rowOffsetToAddress)(cartesian.by);
+function cartesianToAddress({ ax, ay, bx, by }) {
+    const startColumn = (0, addressOffset_ts_1.columnOffsetToAddress)(ax);
+    const startRow = (0, addressOffset_ts_1.rowOffsetToAddress)(ay);
+    const endColumn = (0, addressOffset_ts_1.columnOffsetToAddress)(bx);
+    const endRow = (0, addressOffset_ts_1.rowOffsetToAddress)(by);
+    if (ax > bx) {
+        throw new InvalidArgumentError_ts_1.default("Invalid address. End column is before start column.");
+    }
+    if (ay > by) {
+        throw new InvalidArgumentError_ts_1.default("Invalid address. End row is before start row.");
+    }
     const address = (0, addressManipulation_ts_1.composeAddress)({
         startRow,
         startColumn,

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

@@ -0,0 +1,11 @@
+import type { Cell } from "../models/Cell.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 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.
+ */
+export default function iterateWorkbookRange(rangeRef: WorkbookRangeRef, overwriteRowsPerRequest?: number | null): AsyncIterable<Cell[]>;
+//# sourceMappingURL=iterateWorkbookRange.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"iterateWorkbookRange.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateWorkbookRange.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAI9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AActE;;;;;;GAMG;AACH,wBAA+B,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,uBAAuB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,CA6CpJ"}

package/dist/cjs/tasks/iterateWorkbookRange.js

@@ -0,0 +1,62 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = iterateWorkbookRange;
+const InvalidArgumentError_ts_1 = __importDefault(require("../errors/InvalidArgumentError.js"));
+const getWorkbookWorksheetRange_ts_1 = __importDefault(require("../operations/workbookRange/getWorkbookWorksheetRange.js"));
+const addressManipulation_ts_1 = require("../services/addressManipulation.js");
+const addressOffset_ts_1 = require("../services/addressOffset.js");
+const workbookRange_ts_1 = require("../services/workbookRange.js");
+/**
+ * Maximum number of cells that can be retrieved in a single request, unless overwritten.
+ * @remarks The Microsoft Graph API documentation does not specify a fixed maximum number of cells that can be retrieved in a single request.
+ * However, it mentions that large ranges may result in errors due to resource constraints. Additionally, discussions in developer
+ * communities suggest that requests exceeding 10,000 cells may encounter issues.
+ */
+const maxCellsPerRequest = 10_000;
+/**
+ * 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 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.
+ */
+async function* iterateWorkbookRange(rangeRef, overwriteRowsPerRequest = null) {
+    const address = rangeRef.address;
+    const components = (0, addressManipulation_ts_1.decomposeAddress)(address);
+    const columnsPerRow = (0, addressOffset_ts_1.columnAddressToOffset)(components.endColumn) - (0, addressOffset_ts_1.columnAddressToOffset)(components.startColumn) + 1;
+    if (overwriteRowsPerRequest !== null && overwriteRowsPerRequest < 1) {
+        throw new InvalidArgumentError_ts_1.default("overwriteRowsPerRequest must be greater than 0");
+    }
+    const columnCount = (0, addressManipulation_ts_1.countAddressColumns)(address);
+    const rowsPerRequest = overwriteRowsPerRequest ?? Math.floor(maxCellsPerRequest / columnsPerRow);
+    const rangeStartRowOffset = (0, addressOffset_ts_1.rowAddressToOffset)(components.startRow);
+    const rangeEndRowOffset = (0, addressOffset_ts_1.rowAddressToOffset)(components.endRow);
+    for (let chunkRowOffset = rangeStartRowOffset; chunkRowOffset <= rangeEndRowOffset; chunkRowOffset = (chunkRowOffset + rowsPerRequest)) {
+        const requestStartRowOffset = chunkRowOffset;
+        const requestEndRowOffset = Math.min(chunkRowOffset + rowsPerRequest - 1, rangeEndRowOffset);
+        const chunkStartRow = (0, addressOffset_ts_1.rowOffsetToAddress)(requestStartRowOffset);
+        const chunkEndRow = (0, addressOffset_ts_1.rowOffsetToAddress)(requestEndRowOffset);
+        const requestAddress = (0, addressManipulation_ts_1.composeAddress)({
+            startRow: chunkStartRow,
+            endRow: chunkEndRow,
+            startColumn: components.startColumn,
+            endColumn: components.endColumn,
+        });
+        const requestRef = (0, workbookRange_ts_1.createWorkbookRangeRef)(rangeRef, requestAddress);
+        const range = await (0, getWorkbookWorksheetRange_ts_1.default)(requestRef);
+        const values = range.values;
+        const text = range.text;
+        const numberFormat = range.numberFormat;
+        const rowCount = values.length;
+        for (let r = 0; r < rowCount; r++) {
+            yield Array.from({ length: columnCount }, (_, c) => ({
+                text: text[r]?.[c] ?? "",
+                value: values[r]?.[c] ?? "",
+                numberFormat: numberFormat?.[r]?.[c] ?? "",
+            }));
+        }
+    }
+}

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

@@ -6,6 +6,7 @@ import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
  * @param rangeRef - A 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 `iterateWorkbookRange` instead.
  */
 export default function iterateWorkbookRangeValues(rangeRef: WorkbookRangeRef, overwriteRowsPerRequest?: number | null): AsyncIterable<RowRangeValues>;
 //# sourceMappingURL=iterateWorkbookRangeValues.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"iterateWorkbookRangeValues.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateWorkbookRangeValues.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AActE;;;;;;GAMG;AACH,wBAA+B,0BAA0B,CAAC,QAAQ,EAAE,gBAAgB,EAAE,uBAAuB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC,cAAc,CAAC,CAoClK"}
+{"version":3,"file":"iterateWorkbookRangeValues.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateWorkbookRangeValues.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AActE;;;;;;;GAOG;AACH,wBAA+B,0BAA0B,CAAC,QAAQ,EAAE,gBAAgB,EAAE,uBAAuB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC,cAAc,CAAC,CAoClK"}

package/dist/cjs/tasks/iterateWorkbookRangeValues.js

@@ -22,6 +22,7 @@ const maxCellsPerRequest = 10_000;
  * @param rangeRef - A 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 `iterateWorkbookRange` instead.
  */
 async function* iterateWorkbookRangeValues(rangeRef, overwriteRowsPerRequest = null) {
     const address = rangeRef.address;

package/dist/esm/models/Cell.d.ts

@@ -0,0 +1,8 @@
+import type { CellValue } from "../models/CellValue.ts";
+import type { NumberFormat } from "./NumberFormat.ts";
+export type Cell = {
+    text: string;
+    value: CellValue;
+    numberFormat: NumberFormat;
+};
+//# sourceMappingURL=Cell.d.ts.map

package/dist/esm/models/Cell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cell.d.ts","sourceRoot":"","sources":["../../../src/models/Cell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,IAAI,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;CAC3B,CAAC"}

package/dist/esm/models/Cell.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/NumberFormat.d.ts

@@ -0,0 +1,4 @@
+export type NumberFormat = string & {
+    __brand: "NumberFormat";
+};
+//# sourceMappingURL=NumberFormat.d.ts.map

package/dist/esm/models/NumberFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumberFormat.d.ts","sourceRoot":"","sources":["../../../src/models/NumberFormat.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IACnC,OAAO,EAAE,cAAc,CAAC;CACxB,CAAC"}

package/dist/esm/models/NumberFormat.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.d.ts

@@ -0,0 +1,12 @@
+import type { Address } from "../../models/Address.ts";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+import type { WorkbookWorksheetRef } from "../../models/WorkbookWorksheetRef.ts";
+/**
+ * Retrieve the address of the used range in a worksheet, ignoring trailing rows and columns that are blank.
+ *
+ * @param worksheetRef - A reference to the worksheet, optionally including session information.
+ * @returns Address of the used range of the worksheet.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-usedrange
+ */
+export default function getWorkbookWorksheetUsedRangeAddress(worksheetRef: WorkbookWorksheetRef): GraphOperation<Address>;
+//# sourceMappingURL=getWorkbookWorksheetUsedRangeAddress.d.ts.map

package/dist/esm/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWorkbookWorksheetUsedRangeAddress.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAoB,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAIjF;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,oCAAoC,CAAC,YAAY,EAAE,oBAAoB,GAAG,cAAc,CAAC,OAAO,CAAC,CAmBxH"}

package/dist/esm/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.js

@@ -0,0 +1,30 @@
+import ProtocolError from "../../errors/ProtocolError.js";
+import { operation } from "../../graphApi.js";
+import { composeAddress, decomposeAddress } from "../../services/addressManipulation.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/**
+ * Retrieve the address of the used range in a worksheet, ignoring trailing rows and columns that are blank.
+ *
+ * @param worksheetRef - A reference to the worksheet, optionally including session information.
+ * @returns Address of the used range of the worksheet.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-usedrange
+ */
+export default function getWorkbookWorksheetUsedRangeAddress(worksheetRef) {
+    return operation({
+        contextId: worksheetRef.contextId,
+        method: "GET",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range/usedRange?$select=address", worksheetRef),
+        headers: {
+            "workbook-session-id": worksheetRef.sessionId,
+        },
+        body: null,
+        responseTransform: (response) => {
+            const range = response;
+            if (!range.address) {
+                throw new ProtocolError("Invalid response: address is missing");
+            }
+            const address = composeAddress(decomposeAddress(range.address)); // Strip any prefixed sheet name
+            return address;
+        },
+    });
+}

package/dist/esm/services/addressManipulation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addressManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/addressManipulation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAoB,aAAa,EAAsB,UAAU,EAAmB,MAAM,sBAAsB,CAAC;AAmBnJ,MAAM,MAAM,iBAAiB,GAAG;IAC/B,WAAW,EAAE,aAAa,CAAC;IAC3B,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAcpE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CA6BrE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS5D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS3D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS/D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAqChG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAKlF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG1D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAGzD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAG5D"}
+{"version":3,"file":"addressManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/addressManipulation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAoB,aAAa,EAAsB,UAAU,EAAmB,MAAM,sBAAsB,CAAC;AAmBnJ,MAAM,MAAM,iBAAiB,GAAG;IAC/B,WAAW,EAAE,aAAa,CAAC;IAC3B,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAcpE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAsBrE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS5D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS3D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS/D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAqChG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAKlF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG1D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAGzD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAG5D"}

package/dist/esm/services/addressManipulation.js

@@ -47,12 +47,6 @@ export function composeAddress(components) {
     if (isSingleColumn(components) && isSingleRow(components)) {
         return composeCellAddress(components.startColumn, components.startRow);
     }
-    if (components.startColumn > components.endColumn) {
-        throw new InvalidArgumentError("Invalid address. End column is before start column.");
-    }
-    if (components.startRow > components.endRow) {
-        throw new InvalidArgumentError("Invalid address. End row is before start row.");
-    }
     return composeCellRangeAddress(components.startColumn, components.startRow, components.endColumn, components.endRow);
 }
 /**

package/dist/esm/services/cartesianAddress.d.ts

@@ -13,5 +13,5 @@ export declare function addressToCartesian(address: Address): Cartesian;
  * @param {Cartesian} cartesian - The Cartesian coordinates, including start (ax, ay) and end (bx, by).
  * @returns {Address} The cell range address (e.g., "A1:C3").
  */
-export declare function cartesianToAddress(cartesian: Cartesian): Address;
+export declare function cartesianToAddress({ ax, ay, bx, by }: Cartesian): Address;
 //# sourceMappingURL=cartesianAddress.d.ts.map

package/dist/esm/services/cartesianAddress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cartesianAddress.d.ts","sourceRoot":"","sources":["../../../src/services/cartesianAddress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAIxD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAU9D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAchE"}
+{"version":3,"file":"cartesianAddress.d.ts","sourceRoot":"","sources":["../../../src/services/cartesianAddress.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAIxD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAU9D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO,CAqBzE"}

package/dist/esm/services/cartesianAddress.js

@@ -1,3 +1,4 @@
+import InvalidArgumentError from "../errors/InvalidArgumentError.js";
 import { composeAddress, decomposeAddress } from "./addressManipulation.js";
 import { columnAddressToOffset, columnOffsetToAddress, rowAddressToOffset, rowOffsetToAddress } from "./addressOffset.js";
 /**
@@ -20,11 +21,17 @@ export function addressToCartesian(address) {
  * @param {Cartesian} cartesian - The Cartesian coordinates, including start (ax, ay) and end (bx, by).
  * @returns {Address} The cell range address (e.g., "A1:C3").
  */
-export function cartesianToAddress(cartesian) {
-    const startColumn = columnOffsetToAddress(cartesian.ax);
-    const startRow = rowOffsetToAddress(cartesian.ay);
-    const endColumn = columnOffsetToAddress(cartesian.bx);
-    const endRow = rowOffsetToAddress(cartesian.by);
+export function cartesianToAddress({ ax, ay, bx, by }) {
+    const startColumn = columnOffsetToAddress(ax);
+    const startRow = rowOffsetToAddress(ay);
+    const endColumn = columnOffsetToAddress(bx);
+    const endRow = rowOffsetToAddress(by);
+    if (ax > bx) {
+        throw new InvalidArgumentError("Invalid address. End column is before start column.");
+    }
+    if (ay > by) {
+        throw new InvalidArgumentError("Invalid address. End row is before start row.");
+    }
     const address = composeAddress({
         startRow,
         startColumn,

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

@@ -0,0 +1,11 @@
+import type { Cell } from "../models/Cell.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 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.
+ */
+export default function iterateWorkbookRange(rangeRef: WorkbookRangeRef, overwriteRowsPerRequest?: number | null): AsyncIterable<Cell[]>;
+//# sourceMappingURL=iterateWorkbookRange.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"iterateWorkbookRange.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateWorkbookRange.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAI9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AActE;;;;;;GAMG;AACH,wBAA+B,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,uBAAuB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,CA6CpJ"}

package/dist/esm/tasks/iterateWorkbookRange.js

@@ -0,0 +1,56 @@
+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";
+/**
+ * Maximum number of cells that can be retrieved in a single request, unless overwritten.
+ * @remarks The Microsoft Graph API documentation does not specify a fixed maximum number of cells that can be retrieved in a single request.
+ * However, it mentions that large ranges may result in errors due to resource constraints. Additionally, discussions in developer
+ * communities suggest that requests exceeding 10,000 cells may encounter issues.
+ */
+const maxCellsPerRequest = 10_000;
+/**
+ * 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 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.
+ */
+export default async function* iterateWorkbookRange(rangeRef, overwriteRowsPerRequest = null) {
+    const address = rangeRef.address;
+    const components = decomposeAddress(address);
+    const columnsPerRow = columnAddressToOffset(components.endColumn) - columnAddressToOffset(components.startColumn) + 1;
+    if (overwriteRowsPerRequest !== null && overwriteRowsPerRequest < 1) {
+        throw new InvalidArgumentError("overwriteRowsPerRequest must be greater than 0");
+    }
+    const columnCount = countAddressColumns(address);
+    const rowsPerRequest = overwriteRowsPerRequest ?? Math.floor(maxCellsPerRequest / columnsPerRow);
+    const rangeStartRowOffset = rowAddressToOffset(components.startRow);
+    const rangeEndRowOffset = rowAddressToOffset(components.endRow);
+    for (let chunkRowOffset = rangeStartRowOffset; chunkRowOffset <= rangeEndRowOffset; chunkRowOffset = (chunkRowOffset + rowsPerRequest)) {
+        const requestStartRowOffset = chunkRowOffset;
+        const requestEndRowOffset = Math.min(chunkRowOffset + rowsPerRequest - 1, rangeEndRowOffset);
+        const chunkStartRow = rowOffsetToAddress(requestStartRowOffset);
+        const chunkEndRow = rowOffsetToAddress(requestEndRowOffset);
+        const requestAddress = composeAddress({
+            startRow: chunkStartRow,
+            endRow: chunkEndRow,
+            startColumn: components.startColumn,
+            endColumn: components.endColumn,
+        });
+        const requestRef = createWorkbookRangeRef(rangeRef, requestAddress);
+        const range = await getWorkbookWorksheetRange(requestRef);
+        const values = range.values;
+        const text = range.text;
+        const numberFormat = range.numberFormat;
+        const rowCount = values.length;
+        for (let r = 0; r < rowCount; r++) {
+            yield Array.from({ length: columnCount }, (_, c) => ({
+                text: text[r]?.[c] ?? "",
+                value: values[r]?.[c] ?? "",
+                numberFormat: numberFormat?.[r]?.[c] ?? "",
+            }));
+        }
+    }
+}

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

@@ -6,6 +6,7 @@ import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
  * @param rangeRef - A 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 `iterateWorkbookRange` instead.
  */
 export default function iterateWorkbookRangeValues(rangeRef: WorkbookRangeRef, overwriteRowsPerRequest?: number | null): AsyncIterable<RowRangeValues>;
 //# 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":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AActE;;;;;;GAMG;AACH,wBAA+B,0BAA0B,CAAC,QAAQ,EAAE,gBAAgB,EAAE,uBAAuB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC,cAAc,CAAC,CAoClK"}
+{"version":3,"file":"iterateWorkbookRangeValues.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateWorkbookRangeValues.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AActE;;;;;;;GAOG;AACH,wBAA+B,0BAA0B,CAAC,QAAQ,EAAE,gBAAgB,EAAE,uBAAuB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC,cAAc,CAAC,CAoClK"}

package/dist/esm/tasks/iterateWorkbookRangeValues.js

@@ -16,6 +16,7 @@ const maxCellsPerRequest = 10_000;
  * @param rangeRef - A 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 `iterateWorkbookRange` instead.
  */
 export default async function* iterateWorkbookRangeValues(rangeRef, overwriteRowsPerRequest = null) {
     const address = rangeRef.address;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "microsoft-graph",
-  "version": "2.15.1",
+  "version": "2.16.0",
   "description": "Microsoft GraphAPI SDK for NodeJS",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -442,6 +442,31 @@
       "require": "./dist/cjs/models/Cartesian.js",
       "types": "./dist/esm/models/Cartesian.d.ts"
     },
+    "./Cell": {
+      "import": "./dist/esm/models/Cell.js",
+      "require": "./dist/cjs/models/Cell.js",
+      "types": "./dist/esm/models/Cell.d.ts"
+    },
+    "./dist/cjs/models/Cell.js": {
+      "import": "./dist/esm/models/Cell.js",
+      "require": "./dist/cjs/models/Cell.js",
+      "types": "./dist/esm/models/Cell.d.ts"
+    },
+    "./dist/cjs/models/Cell": {
+      "import": "./dist/esm/models/Cell.js",
+      "require": "./dist/cjs/models/Cell.js",
+      "types": "./dist/esm/models/Cell.d.ts"
+    },
+    "./models/Cell": {
+      "import": "./dist/esm/models/Cell.js",
+      "require": "./dist/cjs/models/Cell.js",
+      "types": "./dist/esm/models/Cell.d.ts"
+    },
+    "./models/Cell.js": {
+      "import": "./dist/esm/models/Cell.js",
+      "require": "./dist/cjs/models/Cell.js",
+      "types": "./dist/esm/models/Cell.d.ts"
+    },
     "./CellRangeValues": {
       "import": "./dist/esm/models/CellRangeValues.js",
       "require": "./dist/cjs/models/CellRangeValues.js",
@@ -892,6 +917,31 @@
       "require": "./dist/cjs/models/HttpProxy.js",
       "types": "./dist/esm/models/HttpProxy.d.ts"
     },
+    "./NumberFormat": {
+      "import": "./dist/esm/models/NumberFormat.js",
+      "require": "./dist/cjs/models/NumberFormat.js",
+      "types": "./dist/esm/models/NumberFormat.d.ts"
+    },
+    "./dist/cjs/models/NumberFormat.js": {
+      "import": "./dist/esm/models/NumberFormat.js",
+      "require": "./dist/cjs/models/NumberFormat.js",
+      "types": "./dist/esm/models/NumberFormat.d.ts"
+    },
+    "./dist/cjs/models/NumberFormat": {
+      "import": "./dist/esm/models/NumberFormat.js",
+      "require": "./dist/cjs/models/NumberFormat.js",
+      "types": "./dist/esm/models/NumberFormat.d.ts"
+    },
+    "./models/NumberFormat": {
+      "import": "./dist/esm/models/NumberFormat.js",
+      "require": "./dist/cjs/models/NumberFormat.js",
+      "types": "./dist/esm/models/NumberFormat.d.ts"
+    },
+    "./models/NumberFormat.js": {
+      "import": "./dist/esm/models/NumberFormat.js",
+      "require": "./dist/cjs/models/NumberFormat.js",
+      "types": "./dist/esm/models/NumberFormat.d.ts"
+    },
     "./RowOffset": {
       "import": "./dist/esm/models/RowOffset.js",
       "require": "./dist/cjs/models/RowOffset.js",
@@ -2667,6 +2717,31 @@
       "require": "./dist/cjs/operations/workbookWorksheet/getWorkbookWorksheetUsedRange.js",
       "types": "./dist/esm/operations/workbookWorksheet/getWorkbookWorksheetUsedRange.d.ts"
     },
+    "./getWorkbookWorksheetUsedRangeAddress": {
+      "import": "./dist/esm/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.js",
+      "require": "./dist/cjs/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.js",
+      "types": "./dist/esm/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.d.ts"
+    },
+    "./dist/cjs/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.js": {
+      "import": "./dist/esm/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.js",
+      "require": "./dist/cjs/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.js",
+      "types": "./dist/esm/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.d.ts"
+    },
+    "./dist/cjs/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress": {
+      "import": "./dist/esm/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.js",
+      "require": "./dist/cjs/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.js",
+      "types": "./dist/esm/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.d.ts"
+    },
+    "./operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress": {
+      "import": "./dist/esm/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.js",
+      "require": "./dist/cjs/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.js",
+      "types": "./dist/esm/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.d.ts"
+    },
+    "./operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.js": {
+      "import": "./dist/esm/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.js",
+      "require": "./dist/cjs/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.js",
+      "types": "./dist/esm/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.d.ts"
+    },
     "./getWorkbookWorksheetUsedVisibleRange": {
       "import": "./dist/esm/operations/workbookWorksheet/getWorkbookWorksheetUsedVisibleRange.js",
       "require": "./dist/cjs/operations/workbookWorksheet/getWorkbookWorksheetUsedVisibleRange.js",
@@ -3492,6 +3567,31 @@
       "require": "./dist/cjs/tasks/getWorkbookWorksheetByName.js",
       "types": "./dist/esm/tasks/getWorkbookWorksheetByName.d.ts"
     },
+    "./iterateWorkbookRange": {
+      "import": "./dist/esm/tasks/iterateWorkbookRange.js",
+      "require": "./dist/cjs/tasks/iterateWorkbookRange.js",
+      "types": "./dist/esm/tasks/iterateWorkbookRange.d.ts"
+    },
+    "./dist/cjs/tasks/iterateWorkbookRange.js": {
+      "import": "./dist/esm/tasks/iterateWorkbookRange.js",
+      "require": "./dist/cjs/tasks/iterateWorkbookRange.js",
+      "types": "./dist/esm/tasks/iterateWorkbookRange.d.ts"
+    },
+    "./dist/cjs/tasks/iterateWorkbookRange": {
+      "import": "./dist/esm/tasks/iterateWorkbookRange.js",
+      "require": "./dist/cjs/tasks/iterateWorkbookRange.js",
+      "types": "./dist/esm/tasks/iterateWorkbookRange.d.ts"
+    },
+    "./tasks/iterateWorkbookRange": {
+      "import": "./dist/esm/tasks/iterateWorkbookRange.js",
+      "require": "./dist/cjs/tasks/iterateWorkbookRange.js",
+      "types": "./dist/esm/tasks/iterateWorkbookRange.d.ts"
+    },
+    "./tasks/iterateWorkbookRange.js": {
+      "import": "./dist/esm/tasks/iterateWorkbookRange.js",
+      "require": "./dist/cjs/tasks/iterateWorkbookRange.js",
+      "types": "./dist/esm/tasks/iterateWorkbookRange.d.ts"
+    },
     "./iterateWorkbookRangeValues": {
       "import": "./dist/esm/tasks/iterateWorkbookRangeValues.js",
       "require": "./dist/cjs/tasks/iterateWorkbookRangeValues.js",