microsoft-graph 2.19.0 → 2.20.0

package/dist/esm/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/esm/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/esm/models/RowOffset.d.ts

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

package/dist/esm/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/esm/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/esm/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/esm/services/batch.js

@@ -0,0 +1,7 @@
+/**
+ * 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 const maxCellsPerRequest = 10000;

package/dist/esm/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/esm/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/esm/services/cellText.js

@@ -0,0 +1,6 @@
+/**
+ * Casts a string to CellText.
+ */
+export function asCellText(text) {
+    return text;
+}

package/dist/esm/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/esm/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/esm/services/rangeManipulation.js

@@ -3,7 +3,7 @@ import { cartesianToAddress } from "./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").
@@ -12,7 +12,12 @@ import { cartesianToAddress } from "./cartesianAddress.js";
 export function inferRangeAddress(values, rowOffset = 0, columnOffset = 0) {
     const first = values[0];
     if (!first || first.length === 0) {
-        return "A1";
+        return cartesianToAddress({
+            ax: columnOffset,
+            bx: columnOffset,
+            ay: rowOffset,
+            by: rowOffset,
+        });
     }
     for (const row of values) {
         if (row.length !== first.length) {
@@ -30,11 +35,36 @@ export 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").
+ */
+export function inferRowAddress(row, rowOffset = 0, columnOffset = 0) {
+    if (row.length === 0) {
+        return cartesianToAddress({
+            ax: columnOffset,
+            bx: columnOffset,
+            ay: rowOffset,
+            by: rowOffset,
+        });
+    }
+    const endColumn = (columnOffset + row.length - 1);
+    return 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.
  */
@@ -59,7 +89,7 @@ export 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.
  */
 export function inferObjectRange(objs, header = null) {
     if (objs.length === 0) {

package/dist/esm/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/esm/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/esm/tasks/iterateWorkbookRange.js

@@ -2,20 +2,15 @@ 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 { maxCellsPerRequest } from "../services/batch.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.
+ * @deprecated Use `readWorkbookRows` instead.
  */
 export default async function* iterateWorkbookRange(rangeRef, overwriteRowsPerRequest = null) {
     const address = rangeRef.address;

package/dist/esm/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/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;;;;;;;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/esm/tasks/iterateWorkbookRangeValues.js

@@ -2,21 +2,15 @@ import InvalidArgumentError from "../errors/InvalidArgumentError.js";
 import getWorkbookWorksheetRange from "../operations/workbookRange/getWorkbookWorksheetRange.js";
 import { composeAddress, decomposeAddress } from "../services/addressManipulation.js";
 import { columnAddressToOffset, rowAddressToOffset, rowOffsetToAddress } from "../services/addressOffset.js";
+import { maxCellsPerRequest } from "../services/batch.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.
- * @deprecated Use `iterateWorkbookRange` instead.
+ * @deprecated Use `readWorkbookRows` instead.
  */
 export default async function* iterateWorkbookRangeValues(rangeRef, overwriteRowsPerRequest = null) {
     const address = rangeRef.address;

package/dist/esm/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/esm/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/esm/tasks/readWorkbookRows.js

@@ -0,0 +1,51 @@
+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";
+/**
+ * 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 async function* readWorkbookRows(rangeRef, overwriteMaxRowsPerChunk = null) {
+    const address = rangeRef.address;
+    const components = decomposeAddress(address);
+    const columnsPerRow = columnAddressToOffset(components.endColumn) - columnAddressToOffset(components.startColumn) + 1;
+    if (overwriteMaxRowsPerChunk !== null && overwriteMaxRowsPerChunk < 1) {
+        throw new InvalidArgumentError("overwriteRowsPerRequest must be greater than 0");
+    }
+    const columnCount = countAddressColumns(address);
+    const rowsPerRequest = overwriteMaxRowsPerChunk ?? 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++) {
+            const row = Array.from({ length: columnCount }, (_, c) => ({
+                text: text[r]?.[c] ?? "",
+                value: values[r]?.[c] ?? "",
+                numberFormat: numberFormat?.[r]?.[c] ?? "",
+            }));
+            yield row;
+        }
+    }
+}

package/dist/esm/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/esm/tasks/setWorkbookRangeValues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setWorkbookRangeValues.d.ts","sourceRoot":"","sources":["../../../src/tasks/setWorkbookRangeValues.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,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/esm/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/esm/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/esm/tasks/writeWorkbookRows.js

@@ -0,0 +1,53 @@
+import InvalidArgumentError from "../errors/InvalidArgumentError.js";
+import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.js";
+import { maxCellsPerRequest } from "../services/batch.js";
+import { addressToCartesian, cartesianToAddress } from "../services/cartesianAddress.js";
+import { createWorkbookRangeRef } from "../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.
+ */
+export 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("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(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 } = addressToCartesian(originRef.address);
+    const count = batch.length;
+    const address = cartesianToAddress({
+        ay: (rowsCompleted + ay),
+        by: (rowsCompleted + ay + count - 1),
+        ax,
+        bx,
+    });
+    const rangeRef = createWorkbookRangeRef(originRef, address);
+    await updateWorkbookRange(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;
+}