microsoft-graph 2.19.0 → 2.20.0

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

@@ -1,7 +1,8 @@
 import type { CellValue } from "../models/CellValue.ts";
+import type { CellText } from "./CellText.ts";
 import type { NumberFormat } from "./NumberFormat.ts";
 export type Cell = {
-    text: string;
+    text: CellText;
     value: CellValue;
     numberFormat: NumberFormat;
 };

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

@@ -1 +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"}
+{"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,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,IAAI,GAAG;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;CAC3B,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"CellText.d.ts","sourceRoot":"","sources":["../../../src/models/CellText.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAC/B,OAAO,EAAE,UAAU,CAAC;CACpB,CAAC"}

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

@@ -1,3 +1,6 @@
+/**
+ * Column name configured by user
+ */
 export type ColumnName = string & {
     __brand: "ColumnName";
 };

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

@@ -1 +1 @@
-{"version":3,"file":"ColumnName.d.ts","sourceRoot":"","sources":["../../../src/models/ColumnName.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IACjC,OAAO,EAAE,YAAY,CAAC;CACtB,CAAC"}
+{"version":3,"file":"ColumnName.d.ts","sourceRoot":"","sources":["../../../src/models/ColumnName.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IACjC,OAAO,EAAE,YAAY,CAAC;CACtB,CAAC"}

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

@@ -1,3 +1,6 @@
+/**
+ * Column offset in a table. First column is 0.
+ */
 export type ColumnOffset = number & {
     __brand: "ColumnOffset";
 };

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

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

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

@@ -0,0 +1,3 @@
+import type { Cell } from "./Cell.ts";
+export type Row = Cell[];
+//# sourceMappingURL=Row.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Row.d.ts","sourceRoot":"","sources":["../../../src/models/Row.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,MAAM,GAAG,GAAG,IAAI,EAAE,CAAC"}

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

@@ -1,3 +1,6 @@
+/**
+ * Row number as it appears in Excel. First row is 1.
+ */
 export type RowNumber = number & {
     __brand: "RowNumber";
 };

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

@@ -1 +1 @@
-{"version":3,"file":"RowNumber.d.ts","sourceRoot":"","sources":["../../../src/models/RowNumber.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAChC,OAAO,EAAE,WAAW,CAAC;CACrB,CAAC"}
+{"version":3,"file":"RowNumber.d.ts","sourceRoot":"","sources":["../../../src/models/RowNumber.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAChC,OAAO,EAAE,WAAW,CAAC;CACrB,CAAC"}

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

@@ -1,3 +1,6 @@
+/**
+ * Row offset index. First row is 0.
+ */
 export type RowOffset = number & {
     __brand: "RowOffset";
 };

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

@@ -1 +1 @@
-{"version":3,"file":"RowOffset.d.ts","sourceRoot":"","sources":["../../../src/models/RowOffset.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAChC,OAAO,EAAE,WAAW,CAAC;CACrB,CAAC"}
+{"version":3,"file":"RowOffset.d.ts","sourceRoot":"","sources":["../../../src/models/RowOffset.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAChC,OAAO,EAAE,WAAW,CAAC;CACrB,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * 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.
+ */
+export declare const maxCellsPerRequest = 10000;
+//# sourceMappingURL=batch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../../src/services/batch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,QAAQ,CAAC"}

package/dist/cjs/services/batch.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.maxCellsPerRequest = void 0;
+/**
+ * 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.
+ */
+exports.maxCellsPerRequest = 10000;

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

@@ -0,0 +1,6 @@
+import type { CellText } from "../models/CellText.ts";
+/**
+ * Casts a string to CellText.
+ */
+export declare function asCellText(text: string): CellText;
+//# sourceMappingURL=cellText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cellText.d.ts","sourceRoot":"","sources":["../../../src/services/cellText.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAEjD"}

package/dist/cjs/services/cellText.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asCellText = asCellText;
+/**
+ * Casts a string to CellText.
+ */
+function asCellText(text) {
+    return text;
+}

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

@@ -1,33 +1,42 @@
 import type { Address } from "../models/Address.ts";
-import type { CellRangeValues } from "../models/CellRangeValues.ts";
+import type { CellValue } from "../models/CellValue.ts";
 import type { ColumnOffset } from "../models/ColumnOffset.ts";
 import type { RowOffset } from "../models/RowOffset.ts";
 /**
  * Converts a 2D array of cell values into range address in the upper left.
  *
- * @param {CellRangeValues} values - A 2D array representing cell values.
+ * @param {CellValue[][]} values - A 2D array representing cell values.
  * @param {RowOffset} [rowOffset=0] - The row offset to apply to the range address.
  * @param {ColumnOffset} [columnOffset=0] - The column offset to apply to the range address.
  * @returns {Address} The default cell range address (e.g., "A1:C3").
  * @throws {InvalidArgumentError} If rows have inconsistent column counts.
  */
-export declare function inferRangeAddress(values: CellRangeValues, rowOffset?: RowOffset, columnOffset?: ColumnOffset): Address;
+export declare function inferRangeAddress(values: CellValue[][], rowOffset?: RowOffset, columnOffset?: ColumnOffset): Address;
+/**
+ * Converts a 2D array of cell values into a row address in the upper left.
+ *
+ * @param {CellValue[]} row - A single row of cell values.
+ * @param {RowOffset} [rowOffset=0] - The row offset to apply to the address.
+ * @param {ColumnOffset} [columnOffset=0] - The column offset to apply to the address.
+ * @returns {Address} The default cell range address for the row (e.g., "A1").
+ */
+export declare function inferRowAddress(row: CellValue[], rowOffset?: RowOffset, columnOffset?: ColumnOffset): Address;
 /**
  * Converts a 2D array of cell values into an array of objects.
  * Assumes the first row is a header and uses it as keys for the objects.
  *
- * @param {CellRangeValues} values - A 2D array representing cell values.
+ * @param {CellValue[][]} values - A 2D array representing cell values.
  * @returns {unknown[]} An array of objects where each object represents a row.
  * @throws {InvalidArgumentError} If rows have inconsistent column counts or no header row is present.
  */
-export declare function inferRangeObject(values: CellRangeValues): unknown[];
+export declare function inferRangeObject(values: CellValue[][]): unknown[];
 /**
  * Converts an array of objects into a 2D array of cell values.
  * The first row of the 2D array contains the keys as headers.
  *
  * @param {unknown[]} objs - An array of objects to convert.
  * @param {string[] | null} header - Optional header row. If not provided, it will be inferred from the object keys.
- * @returns {CellRangeValues} A 2D array where the first row is the header and subsequent rows are the object values.
+ * @returns {CellValue[][]} A 2D array where the first row is the header and subsequent rows are the object values.
  */
-export declare function inferObjectRange(objs: unknown[], header?: string[] | null): CellRangeValues;
+export declare function inferObjectRange(objs: unknown[], header?: string[] | null): CellValue[][];
 //# sourceMappingURL=rangeManipulation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"rangeManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/rangeManipulation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGxD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,GAAE,SAA0B,EAAE,YAAY,GAAE,YAAgC,GAAG,OAAO,CAyBzJ;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,EAAE,CAoBnE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,MAAM,GAAE,MAAM,EAAE,GAAG,IAAW,GAAG,eAAe,CASjG"}
+{"version":3,"file":"rangeManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/rangeManipulation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGxD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,GAAE,SAA0B,EAAE,YAAY,GAAE,YAAgC,GAAG,OAAO,CA8BvJ;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,SAAS,GAAE,SAA0B,EAAE,YAAY,GAAE,YAAgC,GAAG,OAAO,CAiBhJ;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,GAAG,OAAO,EAAE,CAoBjE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,MAAM,GAAE,MAAM,EAAE,GAAG,IAAW,GAAG,SAAS,EAAE,EAAE,CAS/F"}

package/dist/cjs/services/rangeManipulation.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.inferRangeAddress = inferRangeAddress;
+exports.inferRowAddress = inferRowAddress;
 exports.inferRangeObject = inferRangeObject;
 exports.inferObjectRange = inferObjectRange;
 const InvalidArgumentError_ts_1 = __importDefault(require("../errors/InvalidArgumentError.js"));
@@ -11,7 +12,7 @@ const cartesianAddress_ts_1 = require("./cartesianAddress.js");
 /**
  * Converts a 2D array of cell values into range address in the upper left.
  *
- * @param {CellRangeValues} values - A 2D array representing cell values.
+ * @param {CellValue[][]} values - A 2D array representing cell values.
  * @param {RowOffset} [rowOffset=0] - The row offset to apply to the range address.
  * @param {ColumnOffset} [columnOffset=0] - The column offset to apply to the range address.
  * @returns {Address} The default cell range address (e.g., "A1:C3").
@@ -20,7 +21,12 @@ const cartesianAddress_ts_1 = require("./cartesianAddress.js");
 function inferRangeAddress(values, rowOffset = 0, columnOffset = 0) {
     const first = values[0];
     if (!first || first.length === 0) {
-        return "A1";
+        return (0, cartesianAddress_ts_1.cartesianToAddress)({
+            ax: columnOffset,
+            bx: columnOffset,
+            ay: rowOffset,
+            by: rowOffset,
+        });
     }
     for (const row of values) {
         if (row.length !== first.length) {
@@ -38,11 +44,36 @@ function inferRangeAddress(values, rowOffset = 0, columnOffset = 0) {
         by: endRow,
     });
 }
+/**
+ * Converts a 2D array of cell values into a row address in the upper left.
+ *
+ * @param {CellValue[]} row - A single row of cell values.
+ * @param {RowOffset} [rowOffset=0] - The row offset to apply to the address.
+ * @param {ColumnOffset} [columnOffset=0] - The column offset to apply to the address.
+ * @returns {Address} The default cell range address for the row (e.g., "A1").
+ */
+function inferRowAddress(row, rowOffset = 0, columnOffset = 0) {
+    if (row.length === 0) {
+        return (0, cartesianAddress_ts_1.cartesianToAddress)({
+            ax: columnOffset,
+            bx: columnOffset,
+            ay: rowOffset,
+            by: rowOffset,
+        });
+    }
+    const endColumn = (columnOffset + row.length - 1);
+    return (0, cartesianAddress_ts_1.cartesianToAddress)({
+        ax: columnOffset,
+        bx: endColumn,
+        ay: rowOffset,
+        by: rowOffset,
+    });
+}
 /**
  * Converts a 2D array of cell values into an array of objects.
  * Assumes the first row is a header and uses it as keys for the objects.
  *
- * @param {CellRangeValues} values - A 2D array representing cell values.
+ * @param {CellValue[][]} values - A 2D array representing cell values.
  * @returns {unknown[]} An array of objects where each object represents a row.
  * @throws {InvalidArgumentError} If rows have inconsistent column counts or no header row is present.
  */
@@ -67,7 +98,7 @@ function inferRangeObject(values) {
  *
  * @param {unknown[]} objs - An array of objects to convert.
  * @param {string[] | null} header - Optional header row. If not provided, it will be inferred from the object keys.
- * @returns {CellRangeValues} A 2D array where the first row is the header and subsequent rows are the object values.
+ * @returns {CellValue[][]} A 2D array where the first row is the header and subsequent rows are the object values.
  */
 function inferObjectRange(objs, header = null) {
     if (objs.length === 0) {

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

@@ -1,4 +1,4 @@
-import type { Cell } from "../models/Cell.ts";
+import type { Row } from "../models/Row.ts";
 import type { RowOffset } from "../models/RowOffset.ts";
 import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
 /**
@@ -7,9 +7,10 @@ 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 `readWorkbookRows` instead.
  */
 export default function iterateWorkbookRange(rangeRef: WorkbookRangeRef, overwriteRowsPerRequest?: number | null): AsyncIterable<{
     rowOffset: RowOffset;
-    row: Cell[];
+    row: Row;
 }>;
 //# sourceMappingURL=iterateWorkbookRange.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"iterateWorkbookRange.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateWorkbookRange.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,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;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,IAAI,EAAE,CAAA;CAAE,CAAC,CAsDnL"}
+{"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"}

package/dist/cjs/tasks/iterateWorkbookRange.js

@@ -8,20 +8,15 @@ const InvalidArgumentError_ts_1 = __importDefault(require("../errors/InvalidArgu
 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 batch_ts_1 = require("../services/batch.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.
+ * @deprecated Use `readWorkbookRows` instead.
  */
 async function* iterateWorkbookRange(rangeRef, overwriteRowsPerRequest = null) {
     const address = rangeRef.address;
@@ -31,7 +26,7 @@ async function* iterateWorkbookRange(rangeRef, overwriteRowsPerRequest = null) {
         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 rowsPerRequest = overwriteRowsPerRequest ?? Math.floor(batch_ts_1.maxCellsPerRequest / columnsPerRow);
     const rangeStartRowOffset = (0, addressOffset_ts_1.rowAddressToOffset)(components.startRow);
     const rangeEndRowOffset = (0, addressOffset_ts_1.rowAddressToOffset)(components.endRow);
     let offset = 0;

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

@@ -1,4 +1,4 @@
-import type { RowRangeValues } from "../models/RowRangeValues.ts";
+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.
@@ -6,7 +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.
+ * @deprecated Use `readWorkbookRows` instead.
  */
-export default function iterateWorkbookRangeValues(rangeRef: WorkbookRangeRef, overwriteRowsPerRequest?: number | null): AsyncIterable<RowRangeValues>;
+export default function iterateWorkbookRangeValues(rangeRef: WorkbookRangeRef, overwriteRowsPerRequest?: number | null): AsyncIterable<CellValue[]>;
 //# 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;;;;;;;GAOG;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":"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"}

package/dist/cjs/tasks/iterateWorkbookRangeValues.js

@@ -8,21 +8,15 @@ const InvalidArgumentError_ts_1 = __importDefault(require("../errors/InvalidArgu
 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 batch_ts_1 = require("../services/batch.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.
- * @deprecated Use `iterateWorkbookRange` instead.
+ * @deprecated Use `readWorkbookRows` instead.
  */
 async function* iterateWorkbookRangeValues(rangeRef, overwriteRowsPerRequest = null) {
     const address = rangeRef.address;
@@ -31,7 +25,7 @@ async function* iterateWorkbookRangeValues(rangeRef, overwriteRowsPerRequest = n
     if (overwriteRowsPerRequest !== null && overwriteRowsPerRequest < 1) {
         throw new InvalidArgumentError_ts_1.default("overwriteRowsPerRequest must be greater than 0");
     }
-    const rowsPerRequest = overwriteRowsPerRequest ?? Math.floor(maxCellsPerRequest / columnsPerRow);
+    const rowsPerRequest = overwriteRowsPerRequest ?? Math.floor(batch_ts_1.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)) {

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

@@ -0,0 +1,11 @@
+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.
+ *
+ * @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.
+ * @returns An async iterable that yields rows of range values.
+ */
+export default function readWorkbookRows(rangeRef: WorkbookRangeRef, overwriteMaxRowsPerChunk?: number | null): AsyncIterable<Row>;
+//# sourceMappingURL=readWorkbookRows.d.ts.map

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

@@ -0,0 +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"}

package/dist/cjs/tasks/readWorkbookRows.js

@@ -0,0 +1,57 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = readWorkbookRows;
+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");
+const batch_ts_1 = require("../services/batch.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 overwriteMaxRowsPerChunk - 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* readWorkbookRows(rangeRef, overwriteMaxRowsPerChunk = 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 (overwriteMaxRowsPerChunk !== null && overwriteMaxRowsPerChunk < 1) {
+        throw new InvalidArgumentError_ts_1.default("overwriteRowsPerRequest must be greater than 0");
+    }
+    const columnCount = (0, addressManipulation_ts_1.countAddressColumns)(address);
+    const rowsPerRequest = overwriteMaxRowsPerChunk ?? Math.floor(batch_ts_1.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++) {
+            const row = Array.from({ length: columnCount }, (_, c) => ({
+                text: text[r]?.[c] ?? "",
+                value: values[r]?.[c] ?? "",
+                numberFormat: numberFormat?.[r]?.[c] ?? "",
+            }));
+            yield row;
+        }
+    }
+}

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

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

package/dist/cjs/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,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE;;;;;;GAMG;AACH,wBAA8B,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,iBAcvG"}
+{"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"}

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

@@ -0,0 +1,10 @@
+import type { Cell } from "../models/Cell.ts";
+import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
+/**
+ * Write rows to a workbook range. Uses batching to handle large datasets efficiently.
+ * @param originRef The reference to the workbook range where rows will be written. Only the upper-left is used as an origin point.
+ * @param rows An iterable or async iterable of rows to write. Each row is an array of cells.
+ * @param overrideMaxRowsPerUnderlyingRead Optional maximum number of rows to write in a single underlying read. If not provided, it will be automatically calculated based on a safe value.
+ */
+export declare function writeWorkbookRows(originRef: WorkbookRangeRef, rows: Iterable<Partial<Cell>[]> | AsyncIterable<Partial<Cell>[]>, overrideMaxRowsPerUnderlyingRead?: number | null): Promise<void>;
+//# sourceMappingURL=writeWorkbookRows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writeWorkbookRows.d.ts","sourceRoot":"","sources":["../../../src/tasks/writeWorkbookRows.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAMtE;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,gCAAgC,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB5M"}

package/dist/cjs/tasks/writeWorkbookRows.js

@@ -0,0 +1,59 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeWorkbookRows = writeWorkbookRows;
+const InvalidArgumentError_ts_1 = __importDefault(require("../errors/InvalidArgumentError.js"));
+const updateWorkbookRange_ts_1 = __importDefault(require("../operations/workbookRange/updateWorkbookRange.js"));
+const batch_ts_1 = require("../services/batch.js");
+const cartesianAddress_ts_1 = require("../services/cartesianAddress.js");
+const workbookRange_ts_1 = require("../services/workbookRange.js");
+/**
+ * Write rows to a workbook range. Uses batching to handle large datasets efficiently.
+ * @param originRef The reference to the workbook range where rows will be written. Only the upper-left is used as an origin point.
+ * @param rows An iterable or async iterable of rows to write. Each row is an array of cells.
+ * @param overrideMaxRowsPerUnderlyingRead Optional maximum number of rows to write in a single underlying read. If not provided, it will be automatically calculated based on a safe value.
+ */
+async function writeWorkbookRows(originRef, rows, overrideMaxRowsPerUnderlyingRead = null) {
+    let maxRowsPerUnderlyingRead = overrideMaxRowsPerUnderlyingRead;
+    let cellsPerRow = null;
+    let rowsCompleted = 0;
+    const batch = [];
+    for await (const row of rows) {
+        if (cellsPerRow === null) {
+            cellsPerRow = row.length;
+        }
+        else if (cellsPerRow !== row.length) {
+            throw new InvalidArgumentError_ts_1.default("Not all rows have the same number of cells. Ensure all rows are consistent in length.");
+        }
+        if (maxRowsPerUnderlyingRead === null) {
+            maxRowsPerUnderlyingRead = Math.max(1, Math.floor(batch_ts_1.maxCellsPerRequest / cellsPerRow)); // Excel supports up to 16k columns, which exceeds the assumed 10k cell limit per write. This might not be a problem, but not worth spending time checking this currently either.
+        }
+        if (batch.push(row) >= maxRowsPerUnderlyingRead) {
+            rowsCompleted += await flushBatch(batch, originRef, rowsCompleted);
+        }
+    }
+    await flushBatch(batch, originRef, rowsCompleted);
+}
+async function flushBatch(batch, originRef, rowsCompleted) {
+    if (batch.length === 0) {
+        return 0;
+    }
+    const { ay, ax, bx } = (0, cartesianAddress_ts_1.addressToCartesian)(originRef.address);
+    const count = batch.length;
+    const address = (0, cartesianAddress_ts_1.cartesianToAddress)({
+        ay: (rowsCompleted + ay),
+        by: (rowsCompleted + ay + count - 1),
+        ax,
+        bx,
+    });
+    const rangeRef = (0, workbookRange_ts_1.createWorkbookRangeRef)(originRef, address);
+    await (0, updateWorkbookRange_ts_1.default)(rangeRef, {
+        values: batch.map((r) => r.map((c) => c.value)),
+        text: batch.map((r) => r.map((c) => c.text)),
+        numberFormat: batch.map((r) => r.map((c) => c.numberFormat)),
+    });
+    batch.length = 0;
+    return count;
+}

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

@@ -1,7 +1,8 @@
 import type { CellValue } from "../models/CellValue.ts";
+import type { CellText } from "./CellText.ts";
 import type { NumberFormat } from "./NumberFormat.ts";
 export type Cell = {
-    text: string;
+    text: CellText;
     value: CellValue;
     numberFormat: NumberFormat;
 };

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

@@ -1 +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"}
+{"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,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,IAAI,GAAG;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;CAC3B,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"CellText.d.ts","sourceRoot":"","sources":["../../../src/models/CellText.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAC/B,OAAO,EAAE,UAAU,CAAC;CACpB,CAAC"}

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

@@ -1,3 +1,6 @@
+/**
+ * Column name configured by user
+ */
 export type ColumnName = string & {
     __brand: "ColumnName";
 };

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

@@ -1 +1 @@
-{"version":3,"file":"ColumnName.d.ts","sourceRoot":"","sources":["../../../src/models/ColumnName.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IACjC,OAAO,EAAE,YAAY,CAAC;CACtB,CAAC"}
+{"version":3,"file":"ColumnName.d.ts","sourceRoot":"","sources":["../../../src/models/ColumnName.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IACjC,OAAO,EAAE,YAAY,CAAC;CACtB,CAAC"}

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

@@ -1,3 +1,6 @@
+/**
+ * Column offset in a table. First column is 0.
+ */
 export type ColumnOffset = number & {
     __brand: "ColumnOffset";
 };

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

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

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

@@ -0,0 +1,3 @@
+import type { Cell } from "./Cell.ts";
+export type Row = Cell[];
+//# sourceMappingURL=Row.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Row.d.ts","sourceRoot":"","sources":["../../../src/models/Row.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,MAAM,GAAG,GAAG,IAAI,EAAE,CAAC"}