microsoft-graph 2.34.0 → 2.35.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"objectMapping.d.ts","sourceRoot":"","sources":["../../../src/services/objectMapping.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAa,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGpE;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;KAC7B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG;QACjB;;;WAGG;QACH,aAAa,EAAE,MAAM,CAAC;QAEtB;;;;;;;WAOG;QACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAE9B;;;;;;;WAOG;QACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;KAC9B;CACD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI;KACrC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG;QACjB,YAAY,EAAE,YAAY,CAAC;QAC3B,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;KAC7B;CACD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAuB,uBAAuB,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAW3I;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAsC1H;AAED;;;;;;GAMG;AACH,wBAAuB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAI3I;AAED;;;;;;GAMG;AACH,wBAAuB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAIlJ;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAe5E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,CAW3F"}

package/dist/esm/services/objectMapping.js

@@ -0,0 +1,132 @@
+/**
+ * Automated conversion of rows to objects and vice versa based on defined mapping rules.
+ * @module objectMapping
+ * @category Services
+ */
+import InvalidArgumentError from "../errors/InvalidArgumentError.js";
+import { generalCellFormat } from "./cell.js";
+/**
+ * Converts spreadsheet rows to objects using the first row as a header.
+ * @template T The object type to yield.
+ * @param rows Iterable or async iterable of cell arrays (rows).
+ * @param rules Mapping rules for converting columns to object properties.
+ * @yields Objects of type T, one for each data row.
+ */
+export async function* rowsToObjectsWithHeader(rows, rules) {
+    let mapping = null;
+    for await (const row of rows) {
+        if (!mapping) {
+            mapping = createObjectMapping(row, rules);
+            continue;
+        }
+        yield rowToObject(row, mapping);
+    }
+}
+/**
+ * Creates a mapping from a header row to object properties based on provided rules.
+ * @template T The object type being mapped.
+ * @param headerRow The header row, used to determine column offsets.
+ * @param rules The mapping rules for converting cells to object properties.
+ * @returns The resolved mapping for use in row/object conversion.
+ * @throws {InvalidArgumentError} If a column matching a pattern is not found in the header row.
+ */
+export function createObjectMapping(headerRow, rules) {
+    const headStrings = headerRow.map((c) => (typeof c === "object" ? c.text : c));
+    const resolved = {};
+    for (const key in rules) {
+        if (!Object.prototype.hasOwnProperty.call(rules, key)) {
+            continue;
+        }
+        const rule = rules[key];
+        const offset = headStrings.findIndex((h) => rule.columnPattern.test(h));
+        if (offset === -1) {
+            throw new InvalidArgumentError(`Column matching "${rule.columnPattern}" not found in header.`);
+        }
+        const columnOffset = offset;
+        const defaultDecode = (cell) => cell.value;
+        const defaultEncode = (prop) => ({
+            value: prop,
+            text: prop?.toString() ?? "",
+            format: generalCellFormat,
+            merge: {},
+            alignment: {},
+            borders: {},
+            fill: {},
+            font: {},
+        });
+        const decode = rule.decode ?? defaultDecode;
+        const encode = rule.encode ?? defaultEncode;
+        resolved[key] = {
+            columnOffset,
+            decode,
+            encode,
+        };
+    }
+    return resolved;
+}
+/**
+ * Converts spreadsheet rows to objects using a provided mapping.
+ * @template T The object type to yield.
+ * @param rows Iterable or async iterable of cell arrays (rows).
+ * @param mapping The resolved mapping for row/object conversion.
+ * @yields Objects of type T, one for each row.
+ */
+export async function* rowsToObjects(rows, mapping) {
+    for await (const row of rows) {
+        yield rowToObject(row, mapping);
+    }
+}
+/**
+ * Converts objects to spreadsheet rows using a provided mapping.
+ * @template T The object type to convert.
+ * @param objects Iterable or async iterable of objects.
+ * @param mapping The resolved mapping for object/row conversion.
+ * @yields Arrays of partial cells, one for each object.
+ */
+export async function* objectsToRows(objects, mapping) {
+    for await (const obj of objects) {
+        yield objectToRow(obj, mapping);
+    }
+}
+/**
+ * Converts a row of cells to an object using the provided mapping.
+ * @template T The object type to return.
+ * @param cells The array of cells representing a row.
+ * @param rules The resolved mapping for row/object conversion.
+ * @returns The object of type T.
+ * @throws {InvalidArgumentError} If a required column is missing in the row.
+ */
+export function rowToObject(cells, rules) {
+    const record = {};
+    for (const key in rules) {
+        if (!Object.prototype.hasOwnProperty.call(rules, key)) {
+            continue;
+        }
+        const rule = rules[key];
+        const cell = cells[rule.columnOffset];
+        if (!cell) {
+            throw new InvalidArgumentError(`Column at index ${rule.columnOffset} is missing for key "${key}".`);
+        }
+        record[key] = rule.decode(cell);
+    }
+    return record;
+}
+/**
+ * Converts an object to a row of cells using the provided mapping.
+ * @template T The object type to convert.
+ * @param record The object to convert.
+ * @param mapper The resolved mapping for object/row conversion.
+ * @returns An array of partial cells representing the row.
+ */
+export function objectToRow(record, mapper) {
+    const row = [];
+    for (const key in mapper) {
+        if (!Object.prototype.hasOwnProperty.call(mapper, key)) {
+            continue;
+        }
+        const { columnOffset, encode } = mapper[key];
+        const prop = record[key];
+        row[columnOffset] = encode(prop);
+    }
+    return row;
+}

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

@@ -1,6 +1,6 @@
 /**
  * Inserts a single row into a workbook range.
- * @module insertRow
+ * @module insertWorkbookRangeRow
  * @category Tasks
  * @experimental
  */
@@ -12,7 +12,7 @@ import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
  * @param row Array of cells to insert as a single row.
  * @experimental
  * @example
- * await insertRow(originRef, [{ value: "A1" }, { value: "B1" }, { value: "C1" }]);
+ * await insertWorkbookRangeRow(originRef, [{ value: "A1" }, { value: "B1" }, { value: "C1" }]);
  */
 export default function insertWorkbookRangeRow(originRef: WorkbookRangeRef, row: Partial<Cell>[]): Promise<void>;
 //# sourceMappingURL=insertWorkbookRangeRow.d.ts.map

package/dist/esm/tasks/insertWorkbookRangeRow.js

@@ -1,6 +1,6 @@
 /**
  * Inserts a single row into a workbook range.
- * @module insertRow
+ * @module insertWorkbookRangeRow
  * @category Tasks
  * @experimental
  */
@@ -11,7 +11,7 @@ import insertWorkbookRangeRows from "./insertWorkbookRangeRows.js";
  * @param row Array of cells to insert as a single row.
  * @experimental
  * @example
- * await insertRow(originRef, [{ value: "A1" }, { value: "B1" }, { value: "C1" }]);
+ * await insertWorkbookRangeRow(originRef, [{ value: "A1" }, { value: "B1" }, { value: "C1" }]);
  */
 export default async function insertWorkbookRangeRow(originRef, row) {
     await insertWorkbookRangeRows(originRef, [row]);

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

@@ -1,6 +1,6 @@
 /**
  * Inserts rows into a workbook range.
- * @module insertRows
+ * @module insertWorkbookRangeRows
  * @category Tasks
  * @experimental
  */
@@ -14,14 +14,14 @@ import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
  * @experimental
  * @example
  * // Basic example:
- * await insertRows(originRef, [
+ * await insertWorkbookRangeRows(originRef, [
  *   [{ value: "A1" }, { value: "B1" }, { value: "C1" }],
  *   [{ value: "A2" }, { value: "B2" }, { value: "C2" }],
  *  [{ value: "A3" }, { value: "B3" }, { value: "C3" }],
  * ])
  *
  * // Advanced example with cell formatting:
- * await insertRows(originRef, [
+ * await insertWorkbookRangeRows(originRef, [
  *   [{ value: "A1", format: { fontColor: "red" } }, { value: "B1" }, { value: "C1" }],
  *   [{ value: "A2" }, { value: "B2", format: { fontColor: "blue" } }, { value: "C2" }],
  *   [{ value: "A3" }, { value: "B3" }, { value: "C3", format: { fontColor: "green" } }],

package/dist/esm/tasks/insertWorkbookRangeRows.js

@@ -1,6 +1,6 @@
 /**
  * Inserts rows into a workbook range.
- * @module insertRows
+ * @module insertWorkbookRangeRows
  * @category Tasks
  * @experimental
  */
@@ -17,14 +17,14 @@ import updateWorkbookRangeRows from "./updateWorkbookRangeRows.js";
  * @experimental
  * @example
  * // Basic example:
- * await insertRows(originRef, [
+ * await insertWorkbookRangeRows(originRef, [
  *   [{ value: "A1" }, { value: "B1" }, { value: "C1" }],
  *   [{ value: "A2" }, { value: "B2" }, { value: "C2" }],
  *  [{ value: "A3" }, { value: "B3" }, { value: "C3" }],
  * ])
  *
  * // Advanced example with cell formatting:
- * await insertRows(originRef, [
+ * await insertWorkbookRangeRows(originRef, [
  *   [{ value: "A1", format: { fontColor: "red" } }, { value: "B1" }, { value: "C1" }],
  *   [{ value: "A2" }, { value: "B2", format: { fontColor: "blue" } }, { value: "C2" }],
  *   [{ value: "A3" }, { value: "B3" }, { value: "C3", format: { fontColor: "green" } }],

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

@@ -1,6 +1,6 @@
 /**
  * Iterate over the rows in a given worksheet range.
- * @module iterateRows
+ * @module iterateWorkbookRangeRows
  * @category Tasks
  * @experimental
  */

package/dist/esm/tasks/iterateWorkbookRangeRows.js

@@ -1,6 +1,6 @@
 /**
  * Iterate over the rows in a given worksheet range.
- * @module iterateRows
+ * @module iterateWorkbookRangeRows
  * @category Tasks
  * @experimental
  */

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

@@ -1,6 +1,6 @@
 /**
  * Read the first row from a given workbook range.
- * @module readFirstRow
+ * @module readWorkbookRangeFirstRow
  * @category Tasks
  * @experimental
  */
@@ -12,7 +12,7 @@ import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
  * @returns A promise that resolves to an array of cells in the first row.
  * @remarks Particularly useful for reading header rows.
  * @example
- * const firstRow = await readFirstRow(rangeRef);
+ * const firstRow = await readWorkbookRangeFirstRow(rangeRef);
  */
 export default function readWorkbookRangeFirstRow(rangeRef: WorkbookRangeRef, scope?: import("../models/Cell.ts").CellScope): Promise<Cell[]>;
 //# sourceMappingURL=readWorkbookRangeFirstRow.d.ts.map

package/dist/esm/tasks/readWorkbookRangeFirstRow.js

@@ -1,6 +1,6 @@
 /**
  * Read the first row from a given workbook range.
- * @module readFirstRow
+ * @module readWorkbookRangeFirstRow
  * @category Tasks
  * @experimental
  */
@@ -14,7 +14,7 @@ import { iterateWorkbookRangeRows } from "./iterateWorkbookRangeRows.js";
  * @returns A promise that resolves to an array of cells in the first row.
  * @remarks Particularly useful for reading header rows.
  * @example
- * const firstRow = await readFirstRow(rangeRef);
+ * const firstRow = await readWorkbookRangeFirstRow(rangeRef);
  */
 export default async function readWorkbookRangeFirstRow(rangeRef, scope = defaultCellScope) {
     const firstRowRef = subRange(rangeRef, 0, 1);

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

@@ -1,6 +1,6 @@
 /**
  * Read all rows from a given workbook range.
- * @module readRows
+ * @module readWorkbookRangeRows
  * @category Tasks
  * @experimental
  */
@@ -14,7 +14,7 @@ import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
  * @remarks Where practical, prefer using {@link iterateWorkbookRangeRows} for more efficient memory usage.
  * @experimental
  * @example
- * const rows = await readRows(rangeRef);
+ * const rows = await readWorkbookRangeRows(rangeRef);
  */
 export default function readWorkbookRangeRows(rangeRef: WorkbookRangeRef, scope?: import("../models/Cell.ts").CellScope): Promise<Cell[][]>;
 //# sourceMappingURL=readWorkbookRangeRows.d.ts.map

package/dist/esm/tasks/readWorkbookRangeRows.js

@@ -1,6 +1,6 @@
 /**
  * Read all rows from a given workbook range.
- * @module readRows
+ * @module readWorkbookRangeRows
  * @category Tasks
  * @experimental
  */
@@ -14,7 +14,7 @@ import { iterateWorkbookRangeRows } from "./iterateWorkbookRangeRows.js";
  * @remarks Where practical, prefer using {@link iterateWorkbookRangeRows} for more efficient memory usage.
  * @experimental
  * @example
- * const rows = await readRows(rangeRef);
+ * const rows = await readWorkbookRangeRows(rangeRef);
  */
 export default async function readWorkbookRangeRows(rangeRef, scope = defaultCellScope) {
     const rows = [];

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

@@ -1,6 +1,6 @@
 /**
  * Update first row in a given workbook range.
- * @module updateFirstRow
+ * @module updateWorkbookRangeFirstRow
  * @category Tasks
  * @experimental
  */
@@ -14,10 +14,10 @@ import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
  * @experimental
  * @example
  * // Basic example:
- * await updateFirstRow(rangeRef, [{ value: 1 }, { value: 2 }]);
+ * await updateWorkbookRangeFirstRow(rangeRef, [{ value: 1 }, { value: 2 }]);
  *
  * // Advanced example with cell formatting:
- * await updateRows(rangeRef, [
+ * await updateWorkbookRangeFirstRow(rangeRef, [
  *  { value: "Column A", style: { alignment: { horizontal: "Right" }, font: { bold: true } } },
  *  { value: "Column B", style: { alignment: { horizontal: "Right" }, font: { bold: true } } }
  * ]);

package/dist/esm/tasks/updateWorkbookRangeFirstRow.js

@@ -1,6 +1,6 @@
 /**
  * Update first row in a given workbook range.
- * @module updateFirstRow
+ * @module updateWorkbookRangeFirstRow
  * @category Tasks
  * @experimental
  */
@@ -13,10 +13,10 @@ import updateWorkbookRangeRows from "./updateWorkbookRangeRows.js";
  * @experimental
  * @example
  * // Basic example:
- * await updateFirstRow(rangeRef, [{ value: 1 }, { value: 2 }]);
+ * await updateWorkbookRangeFirstRow(rangeRef, [{ value: 1 }, { value: 2 }]);
  *
  * // Advanced example with cell formatting:
- * await updateRows(rangeRef, [
+ * await updateWorkbookRangeFirstRow(rangeRef, [
  *  { value: "Column A", style: { alignment: { horizontal: "Right" }, font: { bold: true } } },
  *  { value: "Column B", style: { alignment: { horizontal: "Right" }, font: { bold: true } } }
  * ]);

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

@@ -9,18 +9,27 @@ import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
  * @experimental
  * @example
  * // Basic example:
- * await updateRows(rangeRef, [
+ * await updateWorkbookRangeRows(rangeRef, [
  *   [{ value: 1 }, { value: 2 }],
  *   [{ value: 3 }, { value: 4 }],
  *   [{ value: 5 }, { value: 6 }],
  * ]);
  *
  * // Advanced example with cell formatting:
- * await updateRows(rangeRef, [
- *   [{ value: "Column A", style: { alignment: { horizontal: "Right" }, font: { bold: true } } }, { value: "Column B", style: { alignment: { horizontal: "Right" }, font: { bold: true } }  }],
- *   [{ value: 1, format: accountingCellFormat }, { value: "A" }],
- *   [{ value: 2, format: accountingCellFormat }, { value: "B" }],
- * ]);
+ * await updateWorkbookRangeRows(rangeRef, [
+ * [
+ * 	{ value: "Column A", alignment: { horizontal: "Right" }, font: { bold: true, color: "#ffffff" as Color }, fill: { color: "#000000" as Color } },
+ * 	{ value: "Column B", alignment: { horizontal: "Right" }, font: { bold: true, color: "#ffffff" as Color }, fill: { color: "#000000" as Color } },
+ * ],
+ * [
+ * 	{ value: 1, format: accountingCellFormat },
+ * 	{ value: "A" },
+ * ],
+ * [
+ * 	{ value: 2, format: accountingCellFormat },
+ * 	{ value: "B" }],
+ * ],
+ * );
  */
 export default function updateWorkbookRangeRows(originRef: WorkbookRangeRef, cells: Iterable<Partial<Cell>[]> | AsyncIterable<Partial<Cell>[]>, maxCellsPerOperation?: number | null): Promise<void>;
 //# sourceMappingURL=updateWorkbookRangeRows.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"updateWorkbookRangeRows.d.ts","sourceRoot":"","sources":["../../../src/tasks/updateWorkbookRangeRows.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAWnE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAA8B,uBAAuB,CAAC,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,oBAAoB,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB/M"}
+{"version":3,"file":"updateWorkbookRangeRows.d.ts","sourceRoot":"","sources":["../../../src/tasks/updateWorkbookRangeRows.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAWnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,wBAA8B,uBAAuB,CAAC,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,oBAAoB,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB/M"}

package/dist/esm/tasks/updateWorkbookRangeRows.js

@@ -1,6 +1,6 @@
 /**
  * Update rows in a given workbook range.
- * @module updateRows
+ * @module updateWorkbookRangeRows
  * @category Tasks
  * @experimental
  */
@@ -24,18 +24,27 @@ import { camelCaseToPascalCase } from "../services/stringCaseConversion.js";
  * @experimental
  * @example
  * // Basic example:
- * await updateRows(rangeRef, [
+ * await updateWorkbookRangeRows(rangeRef, [
  *   [{ value: 1 }, { value: 2 }],
  *   [{ value: 3 }, { value: 4 }],
  *   [{ value: 5 }, { value: 6 }],
  * ]);
  *
  * // Advanced example with cell formatting:
- * await updateRows(rangeRef, [
- *   [{ value: "Column A", style: { alignment: { horizontal: "Right" }, font: { bold: true } } }, { value: "Column B", style: { alignment: { horizontal: "Right" }, font: { bold: true } }  }],
- *   [{ value: 1, format: accountingCellFormat }, { value: "A" }],
- *   [{ value: 2, format: accountingCellFormat }, { value: "B" }],
- * ]);
+ * await updateWorkbookRangeRows(rangeRef, [
+ * [
+ * 	{ value: "Column A", alignment: { horizontal: "Right" }, font: { bold: true, color: "#ffffff" as Color }, fill: { color: "#000000" as Color } },
+ * 	{ value: "Column B", alignment: { horizontal: "Right" }, font: { bold: true, color: "#ffffff" as Color }, fill: { color: "#000000" as Color } },
+ * ],
+ * [
+ * 	{ value: 1, format: accountingCellFormat },
+ * 	{ value: "A" },
+ * ],
+ * [
+ * 	{ value: 2, format: accountingCellFormat },
+ * 	{ value: "B" }],
+ * ],
+ * );
  */
 export default async function updateWorkbookRangeRows(originRef, cells, maxCellsPerOperation = null) {
     let maxRowsPerOperation = maxCellsPerOperation;

package/docs/api/README.md

@@ -31,7 +31,6 @@
 | [Color](Color.md) | Color has a hexadecimal representation (ie #ffffff"). |
 | [Column](Column.md) | Column pointers. |
 | [Context](Context-1.md) | Context of requests. |
-| [DataSource](DataSource-1.md) | Tooling for easily creating, updating, and deleting items in a worksheet or range. |
 | [Drive](Drive-1.md) | Drive pointers. |
 | [DriveItem](DriveItem-1.md) | Drive item pointers. |
 | [FontName](FontName.md) | Name of a font. |
@@ -126,13 +125,13 @@
 | [cartesianAddress](cartesianAddress.md) | Utilities for converting between A1 addresses and Cartesian coordinates. |
 | [CellFormat](CellFormat.md) | Cell utilities. |
 | [context](context.md) | Context creation and management utilities for Microsoft Graph API authentication. |
-| [dataSource](dataSource.md) | Tooling for easily creating, updating, and deleting items in a worksheet or range. |
 | [drive](drive.md) | Utilities for working with Microsoft Graph Drive references and operations. |
 | [driveItem](driveItem.md) | Utilities for working with Microsoft Graph Drive Items (files and folders). |
 | [environmentVariable](environmentVariable.md) | Utilities for accessing environment variables with error handling and fallbacks. |
 | [http](http.md) | HTTP request utilities for Microsoft Graph API, with proxy support. |
 | [httpStatus](httpStatus.md) | Utilities for analyzing HTTP status codes for Microsoft Graph API responses. |
 | [Iteration](Iteration.md) | Utilities for iterating over AsyncIterables. |
+| [objectMapping](objectMapping.md) | Automated conversion of rows to objects and vice versa based on defined mapping rules. |
 | [operationId](operationId.md) | Utilities for converting between operation IDs and indexes. |
 | [operationInvoker](operationInvoker.md) | Invoke operations, potentially as parallel or sequential batches. |
 | [random](random.md) | Utilities for generating random values for spreadsheet and API operations. |
@@ -156,12 +155,12 @@
 | [createWorkbookAndStartSession](createWorkbookAndStartSession.md) | Create a new workbook and open a session for that workbook. |
 | [downloadDriveItemContent](downloadDriveItemContent.md) | Download a drive item and save it to the local disk. |
 | [getWorkbookWorksheetByName](getWorkbookWorksheetByName-1.md) | Get a worksheet by its name. |
-| [insertRow](insertRow.md) | Inserts a single row into a workbook range. |
-| [insertRows](insertRows.md) | Inserts rows into a workbook range. |
-| [iterateRows](iterateRows.md) | Iterate over the rows in a given worksheet range. |
+| [insertWorkbookRangeRow](insertWorkbookRangeRow.md) | Inserts a single row into a workbook range. |
+| [insertWorkbookRangeRows](insertWorkbookRangeRows.md) | Inserts rows into a workbook range. |
+| [iterateWorkbookRangeRows](iterateWorkbookRangeRows.md) | Iterate over the rows in a given worksheet range. |
 | [listDriveItems](listDriveItems.md) | List drive items in a drive or a drive item. |
-| [readFirstRow](readFirstRow.md) | Read the first row from a given workbook range. |
-| [readRows](readRows.md) | Read all rows from a given workbook range. |
+| [readWorkbookRangeFirstRow](readWorkbookRangeFirstRow.md) | Read the first row from a given workbook range. |
+| [readWorkbookRangeRows](readWorkbookRangeRows.md) | Read all rows from a given workbook range. |
 | [readWorkbookRows](readWorkbookRows.md) | Iterates over the rows in a given worksheet range. |
 | [safeDeleteWorkbook](safeDeleteWorkbook.md) | Safely delete a workbook by first closing any open sessions and then deleting it. |
 | [setColumnHidden](setColumnHidden.md) | Set one or more columns visibility. |
@@ -169,6 +168,6 @@
 | [setWorkbookTableBodyVisibleRows](setWorkbookTableBodyVisibleRows.md) | Set visible rows of a workbook table with the provided 2D array of values, ignoring hidden rows and inserting new rows at the end if needed. |
 | [tryCloseWorkbookSession](tryCloseWorkbookSession.md) | Try and close a workbook session. |
 | [tryDeleteDriveItem](tryDeleteDriveItem.md) | Attempts to delete a drive item, returning success status. |
-| [updateFirstRow](updateFirstRow.md) | Update first row in a given workbook range. |
-| [updateRows](updateRows.md) | Update rows in a given workbook range. |
+| [updateWorkbookRangeFirstRow](updateWorkbookRangeFirstRow.md) | Update first row in a given workbook range. |
+| [updateWorkbookRangeRows](updateWorkbookRangeRows.md) | Update rows in a given workbook range. |
 | [writeWorkbookRows](writeWorkbookRows.md) | Write rows to a workbook range. |

package/docs/api/{insertRow.md → insertWorkbookRangeRow.md}

@@ -1,6 +1,6 @@
-[Microsoft Graph SDK](README.md) / insertRow
+[Microsoft Graph SDK](README.md) / insertWorkbookRangeRow
 
-# insertRow
+# insertWorkbookRangeRow
 
 **`Experimental`**
 
@@ -30,5 +30,5 @@ Defined in: [src/tasks/insertWorkbookRangeRow.ts:20](https://github.com/Future-S
 #### Example
 
 ```ts
-await insertRow(originRef, [{ value: "A1" }, { value: "B1" }, { value: "C1" }]);
+await insertWorkbookRangeRow(originRef, [{ value: "A1" }, { value: "B1" }, { value: "C1" }]);
 ```

package/docs/api/{insertRows.md → insertWorkbookRangeRows.md}

@@ -1,6 +1,6 @@
-[Microsoft Graph SDK](README.md) / insertRows
+[Microsoft Graph SDK](README.md) / insertWorkbookRangeRows
 
-# insertRows
+# insertWorkbookRangeRows
 
 **`Experimental`**
 
@@ -21,7 +21,7 @@ Defined in: [src/tasks/insertWorkbookRangeRows.ts:38](https://github.com/Future-
 | Parameter | Type | Default value | Description |
 | ------ | ------ | ------ | ------ |
 | `originRef` | [`WorkbookRangeRef`](WorkbookRange-1.md#workbookrangeref) | `undefined` | Reference to the workbook range to update. Only the upper-left cell is used as an origin point. |
-| `cells` | [`Iterable`](https://www.typescriptlang.org/docs/handbook/iterators-and-generators.html#iterable-interface)\<[`Partial`](https://www.typescriptlang.org/docs/handbook/utility-types.html#partialtype)\<[`Cell`](Cell.md#cell)\>[], `any`, `any`\> \| `AsyncIterable`\<[`Partial`](https://www.typescriptlang.org/docs/handbook/utility-types.html#partialtype)\<[`Cell`](Cell.md#cell)\>[], `any`, `any`\> | `undefined` | Array of arrays of cells to update in the specified range. |
+| `cells` | `AsyncIterable`\<[`Partial`](https://www.typescriptlang.org/docs/handbook/utility-types.html#partialtype)\<[`Cell`](Cell.md#cell)\>[], `any`, `any`\> \| [`Iterable`](https://www.typescriptlang.org/docs/handbook/iterators-and-generators.html#iterable-interface)\<[`Partial`](https://www.typescriptlang.org/docs/handbook/utility-types.html#partialtype)\<[`Cell`](Cell.md#cell)\>[], `any`, `any`\> | `undefined` | Array of arrays of cells to update in the specified range. |
 | `maxCellsPerOperation` | `null` \| `number` | `null` | Prescribe max cells to retrieve per operation. `null` automatically determines value. DO NOT SET EXCEPT FOR ADVANCED TUNING. |
 
 #### Returns
@@ -32,14 +32,14 @@ Defined in: [src/tasks/insertWorkbookRangeRows.ts:38](https://github.com/Future-
 
 ```ts
 // Basic example:
-await insertRows(originRef, [
+await insertWorkbookRangeRows(originRef, [
   [{ value: "A1" }, { value: "B1" }, { value: "C1" }],
   [{ value: "A2" }, { value: "B2" }, { value: "C2" }],
  [{ value: "A3" }, { value: "B3" }, { value: "C3" }],
 ])
 
 // Advanced example with cell formatting:
-await insertRows(originRef, [
+await insertWorkbookRangeRows(originRef, [
   [{ value: "A1", format: { fontColor: "red" } }, { value: "B1" }, { value: "C1" }],
   [{ value: "A2" }, { value: "B2", format: { fontColor: "blue" } }, { value: "C2" }],
   [{ value: "A3" }, { value: "B3" }, { value: "C3", format: { fontColor: "green" } }],

package/docs/api/{iterateRows.md → iterateWorkbookRangeRows.md}

@@ -1,6 +1,6 @@
-[Microsoft Graph SDK](README.md) / iterateRows
+[Microsoft Graph SDK](README.md) / iterateWorkbookRangeRows
 
-# iterateRows
+# iterateWorkbookRangeRows
 
 **`Experimental`**