microsoft-graph 2.25.0 → 2.27.0

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

@@ -26,9 +26,7 @@ export type Cell = {
  * Text content of a cell in a worksheet.
  * @remarks This is a string that represents the text displayed in the cell, which may differ from the actual value of the cell (e.g., due to formatting).
  */
-export type CellText = string & {
-    __brand: "CellText";
-};
+export type CellText = string;
 /**
  * CellValue represents the value of a cell in a spreadsheet.
  * @see {@link Cell} for a more comprehensive representation of a cell, which includes text and formatting.

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;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG;IAClB;;;OAGG;IACH,IAAI,EAAE,QAAQ,CAAC;IAEf;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAC/B,OAAO,EAAE,UAAU,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IACjC,OAAO,EAAE,YAAY,CAAC;CACtB,CAAC"}
+{"version":3,"file":"Cell.d.ts","sourceRoot":"","sources":["../../../src/models/Cell.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG;IAClB;;;OAGG;IACH,IAAI,EAAE,QAAQ,CAAC;IAEf;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IACjC,OAAO,EAAE,YAAY,CAAC;CACtB,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { Cell, CellValue } from "./Cell.ts";
+import type { ColumnName } from "./Column.ts";
+import type { RowNumber, RowOffset } from "./Row.ts";
+import type { WorkbookRangeRef } from "./WorkbookRange.ts";
+export type DataSource<T extends RecordBase> = {
+    bodyRef: WorkbookRangeRef;
+    bodyOffset: RowOffset;
+    head: ColumnName[];
+    coding: {
+        decode: RowDecoder<T>;
+        encode: RowEncoder<T> | null;
+    };
+} & AsyncIterable<Item<T>>;
+export type RowDecoder<T extends RecordBase> = (row: DataSourceRow) => T;
+export type RowEncoder<T extends RecordBase> = (record: T) => DataSourceRow;
+export type ItemIndex = number & {
+    __brand: "ItemIndex";
+};
+export type Item<T extends RecordBase> = {
+    index: ItemIndex;
+    rowNumber: RowNumber;
+    record: T;
+};
+export type RecordBase = Record<string, CellValue>;
+export type DataSourceRow = Record<ColumnName, Partial<Cell>>;
+export type RangeOperationCallback = (rangeRef: WorkbookRangeRef) => Promise<void>;
+//# sourceMappingURL=DataSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataSource.d.ts","sourceRoot":"","sources":["../../../src/models/DataSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,UAAU,IAAI;IAC9C,OAAO,EAAE,gBAAgB,CAAC;IAC1B,UAAU,EAAE,SAAS,CAAC;IACtB,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,MAAM,EAAE;QACP,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;KAC7B,CAAC;CACF,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3B,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,GAAG,EAAE,aAAa,KAAK,CAAC,CAAC;AACzE,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,aAAa,CAAC;AAE5E,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAChC,OAAO,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,UAAU,IAAI;IACxC,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,CAAC,CAAC;CACV,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AACnD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9D,MAAM,MAAM,sBAAsB,GAAG,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/cjs/models/DataSource.js

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

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

@@ -13,6 +13,7 @@ import type { WorkbookWorksheetName, WorkbookWorksheetRef } from "../../models/W
  * @param name (Optional) The name of the new worksheet.
  * @returns The newly created worksheet.
  * @see https://learn.microsoft.com/en-us/graph/api/worksheetcollection-add
+ * @remarks While `createWorkbookWorksheet` returns a reference to the worksheet, `getWorkbookWorksheetByName` and `listWorkbookWorksheets` may be unable to see the worksheet for a number of seconds. Calling `calculateWorkbook` can hasten the availability of the new worksheet for these operations.
  */
 export default function createWorkbookWorksheet(workbookRef: WorkbookRef, name?: WorkbookWorksheetName): GraphOperation<WorkbookWorksheet & WorkbookWorksheetRef>;
 //# sourceMappingURL=createWorkbookWorksheet.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"createWorkbookWorksheet.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookWorksheet/createWorkbookWorksheet.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAuB,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAK1H;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAAC,iBAAiB,GAAG,oBAAoB,CAAC,CAsBhK"}
+{"version":3,"file":"createWorkbookWorksheet.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookWorksheet/createWorkbookWorksheet.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAuB,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAK1H;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAAC,iBAAiB,GAAG,oBAAoB,CAAC,CAsBhK"}

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

@@ -15,6 +15,7 @@ const workbookWorksheet_ts_1 = require("../../services/workbookWorksheet.js");
  * @param name (Optional) The name of the new worksheet.
  * @returns The newly created worksheet.
  * @see https://learn.microsoft.com/en-us/graph/api/worksheetcollection-add
+ * @remarks While `createWorkbookWorksheet` returns a reference to the worksheet, `getWorkbookWorksheetByName` and `listWorkbookWorksheets` may be unable to see the worksheet for a number of seconds. Calling `calculateWorkbook` can hasten the availability of the new worksheet for these operations.
  */
 function createWorkbookWorksheet(workbookRef, name) {
     return (0, operationInvoker_ts_1.operation)({

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

@@ -0,0 +1,18 @@
+/**
+ * Retrieve a worksheet by its name from a workbook.
+ * @module getWorkbookWorksheetByName
+ * @category Operations
+ */
+import type { WorkbookWorksheet } from "@microsoft/microsoft-graph-types";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+import type { WorkbookRef } from "../../models/Workbook.ts";
+import type { WorkbookWorksheetName, WorkbookWorksheetRef } from "../../models/WorkbookWorksheet.ts";
+/**
+ * Retrieve a worksheet by its name from a workbook.
+ * @param workbookRef Reference to the workbook.
+ * @param worksheetName The name of the worksheet to retrieve.
+ * @returns The worksheet object.
+ * @see https://learn.microsoft.com/en-us/graph/api/worksheet-get
+ */
+export default function getWorkbookWorksheetByName(workbookRef: WorkbookRef, worksheetName: WorkbookWorksheetName): GraphOperation<WorkbookWorksheet & WorkbookWorksheetRef>;
+//# sourceMappingURL=getWorkbookWorksheetByName.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getWorkbookWorksheetByName.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookWorksheet/getWorkbookWorksheetByName.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAuB,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAK1H;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,0BAA0B,CAAC,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,qBAAqB,GAAG,cAAc,CAAC,iBAAiB,GAAG,oBAAoB,CAAC,CAmB3K"}

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

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Retrieve a worksheet by its name from a workbook.
+ * @module getWorkbookWorksheetByName
+ * @category Operations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = getWorkbookWorksheetByName;
+const operationInvoker_ts_1 = require("../../services/operationInvoker.js");
+const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
+const workbookWorksheet_ts_1 = require("../../services/workbookWorksheet.js");
+/**
+ * Retrieve a worksheet by its name from a workbook.
+ * @param workbookRef Reference to the workbook.
+ * @param worksheetName The name of the worksheet to retrieve.
+ * @returns The worksheet object.
+ * @see https://learn.microsoft.com/en-us/graph/api/worksheet-get
+ */
+function getWorkbookWorksheetByName(workbookRef, worksheetName) {
+    return (0, operationInvoker_ts_1.operation)({
+        context: workbookRef.context,
+        method: "GET",
+        path: (0, templatedPaths_ts_1.generatePath)(`/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets('${encodeURIComponent(worksheetName)}')`, workbookRef),
+        headers: {
+            "workbook-session-id": workbookRef.sessionId,
+        },
+        body: null,
+        responseTransform: (response) => {
+            const worksheet = response;
+            const worksheetRef = (0, workbookWorksheet_ts_1.createWorkbookWorksheetRef)(workbookRef, worksheet.id);
+            return {
+                ...worksheet,
+                ...worksheetRef,
+            };
+        },
+    });
+}

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

@@ -1 +1 @@
-{"version":3,"file":"addressManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/addressManipulation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"addressManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/addressManipulation.ts"],"names":[],"mappings":"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"}

package/dist/cjs/services/addressManipulation.js

@@ -374,7 +374,8 @@ function subAddress(address, skipRows = 0, takeRows = Number.POSITIVE_INFINITY,
     const [startRow, endRow] = slice(ay, by, skipRows, takeRows);
     const [startCol, endCol] = slice(ax, bx, skipCols, takeCols);
     if (startRow < ay || endRow > by || startRow > endRow || startCol < ax || endCol > bx || startCol > endCol) {
-        throw new InvalidArgumentError_ts_1.default(`Requested subaddress is out of bounds: rows [${startRow + 1},${endRow + 1}], cols [${startCol + 1},${endCol + 1}] in range.`);
+        const requestedAddress = (0, cartesianAddress_ts_1.cartesianToAddress)({ ax: startCol, bx: endCol, ay: startRow, by: endRow });
+        throw new InvalidArgumentError_ts_1.default(`Requested subaddress ${requestedAddress} is out of bounds of the base address ${address}.`);
     }
     return (0, cartesianAddress_ts_1.cartesianToAddress)({
         ay: startRow,

package/dist/cjs/services/cartesianAddress.js

@@ -39,10 +39,10 @@ function cartesianToAddress({ ax, ay, bx, by }) {
     const endColumn = (0, addressOffset_ts_1.columnOffsetToAddress)(bx);
     const endRow = (0, addressOffset_ts_1.rowOffsetToAddress)(by);
     if (ax > bx) {
-        throw new InvalidArgumentError_ts_1.default("Invalid address. End column is before start column.");
+        throw new InvalidArgumentError_ts_1.default(`Invalid address. End column is before start column. ax=${ax} bx=${bx}.`);
     }
     if (ay > by) {
-        throw new InvalidArgumentError_ts_1.default("Invalid address. End row is before start row.");
+        throw new InvalidArgumentError_ts_1.default(`Invalid address. End row is before start row. ay=${ay} by=${by}.`);
     }
     const address = (0, addressManipulation_ts_1.composeAddress)({
         startRow,

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

@@ -0,0 +1,58 @@
+import type { DataSource, Item, ItemIndex, RecordBase, RowDecoder, RowEncoder } from "../models/DataSource.ts";
+import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
+/**
+ * Define a datasource from an entire worksheet.
+ * @template T Type of the record, extending RecordBase.
+ * @param worksheetRef Workbook range reference to define the data source on.
+ * @param decode Function to decode a row into a record.
+ * @param encode Function to encode a record into a row. Optional.
+ * @returns The initialized data source.
+ */
+export declare function dataSourceFromWorksheet<T extends RecordBase>(worksheetRef: WorkbookRangeRef, decode: RowDecoder<T>, encode?: RowEncoder<T> | null): Promise<DataSource<T>>;
+/**
+ * Defines a data source from a given range.
+ * @template T Type of the record, extending RecordBase.
+ * @param rangeRef Workbook range reference to define the data source on.
+ * @param decode Function to decode a row into a record.
+ * @param encode Function to encode a record into a row. Optional.
+ * @returns The initialized data source.
+ */
+export declare function dataSourceFromRange<T extends RecordBase>(rangeRef: WorkbookRangeRef, decode: RowDecoder<T>, encode?: RowEncoder<T> | null): Promise<DataSource<T>>;
+/**
+ * Reads all items from the data source.
+ * @template T Type of the record, extending RecordBase.
+ * @param source Data source to read from.
+ * @returns Array of all items in the data source.
+ * @deprecated Iterate on the source directly using `for await (const item of source)`.
+ */
+export declare function listItems<T extends RecordBase>(source: DataSource<T>): AsyncIterable<Item<T>>;
+/**
+ * Creates a new item in the data source.
+ * @template T Type of the record, extending RecordBase.
+ * @param source Data source to insert into. Must be initialized.
+ * @param record Record to insert.
+ * @param after Index after which to insert the new item. If null, inserts at the end. If -1 inserts at top.
+ * @returns Newly created item, including its index, row number, and record.
+ * @throws {InvalidOperationError} If the data source is not initialized.
+ * @throws {InvalidArgumentError} If the 'after' index is out of range.
+ */
+export declare function createItem<T extends RecordBase>(source: DataSource<T>, record: T, after?: ItemIndex | null): Promise<Item<T>>;
+/**
+ * Updates an item in the data source at the specified index.
+ * @template T Type of the record, extending RecordBase.
+ * @param source Data source to update. Must be initialized.
+ * @param index Index of the item to update.
+ * @param record New record to write at the specified index.
+ * @throws {InvalidOperationError} If the data source is not initialized.
+ * @throws {InvalidArgumentError} If the index is out of range.
+ */
+export declare function updateItem<T extends RecordBase>(source: DataSource<T>, index: ItemIndex, record: T): Promise<void>;
+/**
+ * Deletes an item from the data source at the specified index.
+ * @template T Type of the record, extending RecordBase.
+ * @param source Data source to delete from. Must be initialized.
+ * @param index Index of the item to delete.
+ * @throws {InvalidOperationError} If the data source is not initialized.
+ */
+export declare function deleteItem<T extends RecordBase>(source: DataSource<T>, index: ItemIndex): Promise<void>;
+//# sourceMappingURL=dataSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dataSource.d.ts","sourceRoot":"","sources":["../../../src/services/dataSource.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAiB,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE9H,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAWnE;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAAC,CAAC,SAAS,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,GAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAGtL;AACD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,SAAS,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,GAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAqC9K;AAED;;;;;;GAMG;AACH,wBAAuB,SAAS,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAIpG;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,GAAE,SAAS,GAAG,IAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAgBzI;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CASxH;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7G"}

package/dist/cjs/services/dataSource.js

@@ -0,0 +1,177 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dataSourceFromWorksheet = dataSourceFromWorksheet;
+exports.dataSourceFromRange = dataSourceFromRange;
+exports.listItems = listItems;
+exports.createItem = createItem;
+exports.updateItem = updateItem;
+exports.deleteItem = deleteItem;
+const InvalidOperationError_ts_1 = __importDefault(require("../errors/InvalidOperationError.js"));
+const NeverError_ts_1 = __importDefault(require("../errors/NeverError.js"));
+const deleteWorkbookRange_ts_1 = __importDefault(require("../operations/workbookRange/deleteWorkbookRange.js"));
+const getWorkbookWorksheetRange_ts_1 = __importDefault(require("../operations/workbookRange/getWorkbookWorksheetRange.js"));
+const insertWorkbookCells_ts_1 = __importDefault(require("../operations/workbookRange/insertWorkbookCells.js"));
+const updateWorkbookRange_ts_1 = __importDefault(require("../operations/workbookRange/updateWorkbookRange.js"));
+const getWorkbookWorksheetUsedRangeRef_ts_1 = __importDefault(require("../operations/workbookWorksheet/getWorkbookWorksheetUsedRangeRef.js"));
+const readWorkbookRows_ts_1 = __importDefault(require("../tasks/readWorkbookRows.js"));
+const addressManipulation_ts_1 = require("./addressManipulation.js");
+const cartesianAddress_ts_1 = require("./cartesianAddress.js");
+const cellFormat_ts_1 = require("./cellFormat.js");
+/**
+ * Define a datasource from an entire worksheet.
+ * @template T Type of the record, extending RecordBase.
+ * @param worksheetRef Workbook range reference to define the data source on.
+ * @param decode Function to decode a row into a record.
+ * @param encode Function to encode a record into a row. Optional.
+ * @returns The initialized data source.
+ */
+async function dataSourceFromWorksheet(worksheetRef, decode, encode = null) {
+    const rangeRef = await (0, getWorkbookWorksheetUsedRangeRef_ts_1.default)(worksheetRef);
+    return dataSourceFromRange(rangeRef, decode, encode);
+}
+/**
+ * Defines a data source from a given range.
+ * @template T Type of the record, extending RecordBase.
+ * @param rangeRef Workbook range reference to define the data source on.
+ * @param decode Function to decode a row into a record.
+ * @param encode Function to encode a record into a row. Optional.
+ * @returns The initialized data source.
+ */
+async function dataSourceFromRange(rangeRef, decode, encode = null) {
+    if ((0, addressManipulation_ts_1.countAddressRows)(rangeRef.address) < 1) {
+        throw new InvalidOperationError_ts_1.default("Cannot create a data source from an empty range. It must at least contain a header row.");
+    }
+    const headRef = (0, addressManipulation_ts_1.subRange)(rangeRef, 0, 1);
+    const bodyRef = (0, addressManipulation_ts_1.subRange)(rangeRef, 1);
+    const head = await getHead(headRef);
+    const { ay: bodyOffset } = (0, cartesianAddress_ts_1.addressToCartesian)(bodyRef.address);
+    const source = {
+        bodyRef,
+        bodyOffset,
+        coding: {
+            decode,
+            encode,
+        },
+        head,
+        async *[Symbol.asyncIterator]() {
+            let index = 0;
+            for await (const row of (0, readWorkbookRows_ts_1.default)(source.bodyRef)) {
+                const record = rowToRecord(row, source);
+                const rowNumber = indexToRowNumber(source.bodyOffset, index);
+                yield {
+                    index,
+                    rowNumber,
+                    record,
+                };
+                index++;
+            }
+        },
+    };
+    return source;
+}
+/**
+ * Reads all items from the data source.
+ * @template T Type of the record, extending RecordBase.
+ * @param source Data source to read from.
+ * @returns Array of all items in the data source.
+ * @deprecated Iterate on the source directly using `for await (const item of source)`.
+ */
+async function* listItems(source) {
+    for await (const item of source) {
+        yield item;
+    }
+}
+/**
+ * Creates a new item in the data source.
+ * @template T Type of the record, extending RecordBase.
+ * @param source Data source to insert into. Must be initialized.
+ * @param record Record to insert.
+ * @param after Index after which to insert the new item. If null, inserts at the end. If -1 inserts at top.
+ * @returns Newly created item, including its index, row number, and record.
+ * @throws {InvalidOperationError} If the data source is not initialized.
+ * @throws {InvalidArgumentError} If the 'after' index is out of range.
+ */
+async function createItem(source, record, after = null) {
+    const count = (0, addressManipulation_ts_1.countAddressRows)(source.bodyRef.address);
+    const index = (after === null ? count : after + 1);
+    const rowNumber = indexToRowNumber(source.bodyOffset, index);
+    await (0, insertWorkbookCells_ts_1.default)((0, addressManipulation_ts_1.superRange)(source.bodyRef, index, 1), "Down");
+    source.bodyRef = (0, addressManipulation_ts_1.superRange)(source.bodyRef, 0, count + 1);
+    await updateItem(source, index, record);
+    return {
+        index,
+        rowNumber,
+        record,
+    };
+}
+/**
+ * Updates an item in the data source at the specified index.
+ * @template T Type of the record, extending RecordBase.
+ * @param source Data source to update. Must be initialized.
+ * @param index Index of the item to update.
+ * @param record New record to write at the specified index.
+ * @throws {InvalidOperationError} If the data source is not initialized.
+ * @throws {InvalidArgumentError} If the index is out of range.
+ */
+async function updateItem(source, index, record) {
+    const row = recordToRow(record, source);
+    const rowRef = (0, addressManipulation_ts_1.subRange)(source.bodyRef, index, 1);
+    await (0, updateWorkbookRange_ts_1.default)(rowRef, {
+        values: [row.map((x) => x.value)],
+        text: [row.map((x) => x.text)],
+        numberFormat: [row.map((x) => x.format)],
+    });
+}
+/**
+ * Deletes an item from the data source at the specified index.
+ * @template T Type of the record, extending RecordBase.
+ * @param source Data source to delete from. Must be initialized.
+ * @param index Index of the item to delete.
+ * @throws {InvalidOperationError} If the data source is not initialized.
+ */
+async function deleteItem(source, index) {
+    const rowRef = (0, addressManipulation_ts_1.subRange)(source.bodyRef, index, 1);
+    await (0, deleteWorkbookRange_ts_1.default)(rowRef, "Up");
+    source.bodyRef = (0, addressManipulation_ts_1.subRange)(source.bodyRef, 0, -1);
+}
+function rowToRecord(row, source) {
+    const sourceRow = source.head.reduce((acc, heading, columnIndex) => {
+        const cell = row[columnIndex];
+        if (!cell) {
+            throw new NeverError_ts_1.default(`Cell at index ${columnIndex} is undefined`);
+        }
+        acc[heading] = cell;
+        return acc;
+    }, {});
+    const record = source.coding.decode(sourceRow);
+    return record;
+}
+function recordToRow(record, source) {
+    if (!source.coding.encode) {
+        throw new InvalidOperationError_ts_1.default("Data source does not have an encoder defined. Add an encoder for reading.");
+    }
+    const sourceRow = source.coding.encode(record);
+    const row = source.head.map((heading) => {
+        const cell = sourceRow[heading];
+        if (cell === undefined) {
+            throw new Error(`Encoder produced undefined value for '${heading}'.`);
+        }
+        return {
+            value: cell.value ?? "",
+            text: cell.text ?? (cell.value ?? "").toString(),
+            format: cell.format ?? cellFormat_ts_1.generalCellFormat,
+        };
+    });
+    return row;
+}
+function indexToRowNumber(bodyOffset, index) {
+    return (bodyOffset + index + 1); // +1 to convert to 1-based index
+}
+async function getHead(headRef) {
+    const headRange = await (0, getWorkbookWorksheetRange_ts_1.default)(headRef);
+    const head = headRange.text[0].map((x) => x);
+    return head;
+}

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

@@ -2,6 +2,7 @@
  * Delete a drive item, avoiding locking issues through automatic retries.
  * @module deleteDriveItemWithRetry
  * @category Tasks
+ * @hidden
  */
 import type { DriveItemRef } from "../models/DriveItem.ts";
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"deleteDriveItemWithRetry.d.ts","sourceRoot":"","sources":["../../../src/tasks/deleteDriveItemWithRetry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D;;;;;;GAMG;AACH,wBAA8B,wBAAwB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAahG"}
+{"version":3,"file":"deleteDriveItemWithRetry.d.ts","sourceRoot":"","sources":["../../../src/tasks/deleteDriveItemWithRetry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D;;;;;;GAMG;AACH,wBAA8B,wBAAwB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAahG"}

package/dist/cjs/tasks/deleteDriveItemWithRetry.js

@@ -3,6 +3,7 @@
  * Delete a drive item, avoiding locking issues through automatic retries.
  * @module deleteDriveItemWithRetry
  * @category Tasks
+ * @hidden
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };

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

@@ -1,3 +1,8 @@
+/**
+ * Set one or more columns visibility.
+ * @module setColumnHidden
+ * @category Tasks
+ */
 import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
 /**
  * Set one or more columns visibility.

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

@@ -1 +1 @@
-{"version":3,"file":"setColumnHidden.d.ts","sourceRoot":"","sources":["../../../src/tasks/setColumnHidden.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE;;;;GAIG;AACH,wBAA8B,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxG"}
+{"version":3,"file":"setColumnHidden.d.ts","sourceRoot":"","sources":["../../../src/tasks/setColumnHidden.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE;;;;GAIG;AACH,wBAA8B,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxG"}

package/dist/cjs/tasks/setColumnHidden.js

@@ -1,4 +1,9 @@
 "use strict";
+/**
+ * Set one or more columns visibility.
+ * @module setColumnHidden
+ * @category Tasks
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

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

@@ -1,3 +1,8 @@
+/**
+ * Set one or more rows visibility.
+ * @module setRowHidden
+ * @category Tasks
+ */
 import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
 /**
  * Set one or more rows visibility.

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

@@ -1 +1 @@
-{"version":3,"file":"setRowHidden.d.ts","sourceRoot":"","sources":["../../../src/tasks/setRowHidden.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE;;;;;GAKG;AACH,wBAA8B,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQrG"}
+{"version":3,"file":"setRowHidden.d.ts","sourceRoot":"","sources":["../../../src/tasks/setRowHidden.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE;;;;;GAKG;AACH,wBAA8B,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQrG"}

package/dist/cjs/tasks/setRowHidden.js

@@ -1,4 +1,9 @@
 "use strict";
+/**
+ * Set one or more rows visibility.
+ * @module setRowHidden
+ * @category Tasks
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

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

@@ -1,11 +1,16 @@
+/**
+ * Sets the values of a specified workbook range.
+ * @module setWorkbookRangeValues
+ * @category Tasks
+ * @hidden
+ */
 import type { CellValue } from "../models/Cell.ts";
 import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
 /**
  * Sets the values of a specified workbook range.
- *
  * @param {WorkbookRangeRef} rangeRef Reference to the workbook range to update.
  * @param {CellRangeValues} values - The values to set in the specified workbook range. Must match the range's dimensions.
- *  * @deprecated Use `writeWorkbookRows` instead.
+ * @deprecated Use `writeWorkbookRows` instead.
  * @hidden
  */
 export default function setWorkbookRangeValues(rangeRef: WorkbookRangeRef, values: CellValue[][]): Promise<void>;

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,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE;;;;;;;GAOG;AACH,wBAA8B,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,iBAcrG"}
+{"version":3,"file":"setWorkbookRangeValues.d.ts","sourceRoot":"","sources":["../../../src/tasks/setWorkbookRangeValues.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE;;;;;;GAMG;AACH,wBAA8B,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,iBAcrG"}

package/dist/cjs/tasks/setWorkbookRangeValues.js

@@ -1,4 +1,10 @@
 "use strict";
+/**
+ * Sets the values of a specified workbook range.
+ * @module setWorkbookRangeValues
+ * @category Tasks
+ * @hidden
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -9,10 +15,9 @@ const updateWorkbookRange_ts_1 = __importDefault(require("../operations/workbook
 const addressManipulation_ts_1 = require("../services/addressManipulation.js");
 /**
  * Sets the values of a specified workbook range.
- *
  * @param {WorkbookRangeRef} rangeRef Reference to the workbook range to update.
  * @param {CellRangeValues} values - The values to set in the specified workbook range. Must match the range's dimensions.
- *  * @deprecated Use `writeWorkbookRows` instead.
+ * @deprecated Use `writeWorkbookRows` instead.
  * @hidden
  */
 async function setWorkbookRangeValues(rangeRef, values) {

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

@@ -26,9 +26,7 @@ export type Cell = {
  * Text content of a cell in a worksheet.
  * @remarks This is a string that represents the text displayed in the cell, which may differ from the actual value of the cell (e.g., due to formatting).
  */
-export type CellText = string & {
-    __brand: "CellText";
-};
+export type CellText = string;
 /**
  * CellValue represents the value of a cell in a spreadsheet.
  * @see {@link Cell} for a more comprehensive representation of a cell, which includes text and formatting.

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;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG;IAClB;;;OAGG;IACH,IAAI,EAAE,QAAQ,CAAC;IAEf;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAC/B,OAAO,EAAE,UAAU,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IACjC,OAAO,EAAE,YAAY,CAAC;CACtB,CAAC"}
+{"version":3,"file":"Cell.d.ts","sourceRoot":"","sources":["../../../src/models/Cell.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG;IAClB;;;OAGG;IACH,IAAI,EAAE,QAAQ,CAAC;IAEf;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IACjC,OAAO,EAAE,YAAY,CAAC;CACtB,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { Cell, CellValue } from "./Cell.ts";
+import type { ColumnName } from "./Column.ts";
+import type { RowNumber, RowOffset } from "./Row.ts";
+import type { WorkbookRangeRef } from "./WorkbookRange.ts";
+export type DataSource<T extends RecordBase> = {
+    bodyRef: WorkbookRangeRef;
+    bodyOffset: RowOffset;
+    head: ColumnName[];
+    coding: {
+        decode: RowDecoder<T>;
+        encode: RowEncoder<T> | null;
+    };
+} & AsyncIterable<Item<T>>;
+export type RowDecoder<T extends RecordBase> = (row: DataSourceRow) => T;
+export type RowEncoder<T extends RecordBase> = (record: T) => DataSourceRow;
+export type ItemIndex = number & {
+    __brand: "ItemIndex";
+};
+export type Item<T extends RecordBase> = {
+    index: ItemIndex;
+    rowNumber: RowNumber;
+    record: T;
+};
+export type RecordBase = Record<string, CellValue>;
+export type DataSourceRow = Record<ColumnName, Partial<Cell>>;
+export type RangeOperationCallback = (rangeRef: WorkbookRangeRef) => Promise<void>;
+//# sourceMappingURL=DataSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataSource.d.ts","sourceRoot":"","sources":["../../../src/models/DataSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,UAAU,IAAI;IAC9C,OAAO,EAAE,gBAAgB,CAAC;IAC1B,UAAU,EAAE,SAAS,CAAC;IACtB,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,MAAM,EAAE;QACP,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;KAC7B,CAAC;CACF,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3B,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,GAAG,EAAE,aAAa,KAAK,CAAC,CAAC;AACzE,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,aAAa,CAAC;AAE5E,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAChC,OAAO,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,UAAU,IAAI;IACxC,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,CAAC,CAAC;CACV,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AACnD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9D,MAAM,MAAM,sBAAsB,GAAG,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/esm/models/DataSource.js

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

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

@@ -13,6 +13,7 @@ import type { WorkbookWorksheetName, WorkbookWorksheetRef } from "../../models/W
  * @param name (Optional) The name of the new worksheet.
  * @returns The newly created worksheet.
  * @see https://learn.microsoft.com/en-us/graph/api/worksheetcollection-add
+ * @remarks While `createWorkbookWorksheet` returns a reference to the worksheet, `getWorkbookWorksheetByName` and `listWorkbookWorksheets` may be unable to see the worksheet for a number of seconds. Calling `calculateWorkbook` can hasten the availability of the new worksheet for these operations.
  */
 export default function createWorkbookWorksheet(workbookRef: WorkbookRef, name?: WorkbookWorksheetName): GraphOperation<WorkbookWorksheet & WorkbookWorksheetRef>;
 //# sourceMappingURL=createWorkbookWorksheet.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"createWorkbookWorksheet.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookWorksheet/createWorkbookWorksheet.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAuB,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAK1H;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAAC,iBAAiB,GAAG,oBAAoB,CAAC,CAsBhK"}
+{"version":3,"file":"createWorkbookWorksheet.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookWorksheet/createWorkbookWorksheet.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAuB,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAK1H;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAAC,iBAAiB,GAAG,oBAAoB,CAAC,CAsBhK"}

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

@@ -12,6 +12,7 @@ import { createWorkbookWorksheetRef } from "../../services/workbookWorksheet.js"
  * @param name (Optional) The name of the new worksheet.
  * @returns The newly created worksheet.
  * @see https://learn.microsoft.com/en-us/graph/api/worksheetcollection-add
+ * @remarks While `createWorkbookWorksheet` returns a reference to the worksheet, `getWorkbookWorksheetByName` and `listWorkbookWorksheets` may be unable to see the worksheet for a number of seconds. Calling `calculateWorkbook` can hasten the availability of the new worksheet for these operations.
  */
 export default function createWorkbookWorksheet(workbookRef, name) {
     return operation({