microsoft-graph 2.16.0 → 2.17.0

package/dist/cjs/errors/InvalidOperationError.d.ts

@@ -0,0 +1,4 @@
+export default class InvalidOperationError extends Error {
+    constructor(message?: string);
+}
+//# sourceMappingURL=InvalidOperationError.d.ts.map

package/dist/cjs/errors/InvalidOperationError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvalidOperationError.d.ts","sourceRoot":"","sources":["../../../src/errors/InvalidOperationError.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,KAAK;gBACpC,OAAO,CAAC,EAAE,MAAM;CAInC"}

package/dist/cjs/errors/InvalidOperationError.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class InvalidOperationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InvalidOperationError";
+    }
+}
+exports.default = InvalidOperationError;

package/dist/cjs/graphApi.js

@@ -45,7 +45,7 @@ async function sequential(...operations) {
     return (await executeBatch(...definitions));
 }
 const maxBatchOperations = 20; // https://learn.microsoft.com/en-us/graph/json-batching?tabs=http#batch-size-limitations
-const maxRetries = 3;
+const maxRetries = 5;
 const defaultRetryDelayMilliseconds = 1000;
 const consecutiveRetryDelayMultiplier = 2;
 async function executeSingle(definition) {
@@ -139,7 +139,7 @@ async function innerFetch(args) {
         catch (error) {
             if (axios_1.default.isAxiosError(error) && error.response) {
                 response = error.response;
-                if (!((0, httpStatus_ts_1.isHttpTooManyRequests)(response.status) || (0, httpStatus_ts_1.isServiceUnavailable)(response.status) || (0, httpStatus_ts_1.isGatewayTimeout)(response.status))) {
+                if (!((0, httpStatus_ts_1.isHttpTooManyRequests)(response.status) || (0, httpStatus_ts_1.isServiceUnavailable)(response.status) || (0, httpStatus_ts_1.isGatewayTimeout)(response.status) || (0, httpStatus_ts_1.isLocked)(response.status))) {
                     throw error;
                 }
                 const requestedRetryAfterSeconds = Number.parseInt(response.headers["retry-after"] ?? "0", 10);

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

@@ -0,0 +1,9 @@
+import type { RowOffset } from "../models/RowOffset.ts";
+import type { RecordBase } from "./RecordBase.ts";
+import type { RowNumber } from "./RowNumber.ts";
+export type Item<T extends RecordBase> = {
+    rowOffset: RowOffset;
+    rowNumber: RowNumber;
+    record: T;
+};
+//# sourceMappingURL=Item.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Item.d.ts","sourceRoot":"","sources":["../../../src/models/Item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,UAAU,IAAI;IACxC,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,CAAC,CAAC;CACV,CAAC"}

package/dist/cjs/models/Item.js

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

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

@@ -0,0 +1,3 @@
+import type { CellValue } from "./CellValue.ts";
+export type RecordBase = Record<string, CellValue>;
+//# sourceMappingURL=RecordBase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RecordBase.d.ts","sourceRoot":"","sources":["../../../src/models/RecordBase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC"}

package/dist/cjs/models/RecordBase.js

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

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

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

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

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

package/dist/cjs/models/RowNumber.js

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

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

@@ -0,0 +1,15 @@
+import type { ColumnName } from "./ColumnName.ts";
+import type { Item } from "./Item.ts";
+import type { RecordBase } from "./RecordBase.ts";
+import type { SourceDecoder } from "./SourceDecoder.ts";
+import type { SourceEncoder } from "./SourceEncoder.ts";
+import type { WorkbookRangeRef } from "./WorkbookRangeRef.ts";
+export type Source<T extends RecordBase> = {
+    rangeRef: WorkbookRangeRef;
+    head: ColumnName[];
+    coding: {
+        decode: SourceDecoder<T>;
+        encode: SourceEncoder<T>;
+    };
+} & AsyncIterable<Item<T>>;
+//# sourceMappingURL=Source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Source.d.ts","sourceRoot":"","sources":["../../../src/models/Source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,UAAU,IAAI;IAC1C,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,MAAM,EAAE;QACP,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;KACzB,CAAC;CACF,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/cjs/models/Source.js

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

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

@@ -0,0 +1,4 @@
+import type { RecordBase } from "./RecordBase.ts";
+import type { SourceRow } from "./SourceRow.ts";
+export type SourceDecoder<T extends RecordBase> = (row: SourceRow) => T;
+//# sourceMappingURL=SourceDecoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SourceDecoder.d.ts","sourceRoot":"","sources":["../../../src/models/SourceDecoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,GAAG,EAAE,SAAS,KAAK,CAAC,CAAC"}

package/dist/cjs/models/SourceDecoder.js

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

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

@@ -0,0 +1,4 @@
+import type { RecordBase } from "./RecordBase.ts";
+import type { SourceRow } from "./SourceRow.ts";
+export type SourceEncoder<T extends RecordBase> = (record: T) => SourceRow;
+//# sourceMappingURL=SourceEncoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SourceEncoder.d.ts","sourceRoot":"","sources":["../../../src/models/SourceEncoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,SAAS,CAAC"}

package/dist/cjs/models/SourceEncoder.js

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

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

@@ -0,0 +1,4 @@
+import type { Cell } from "../models/Cell.ts";
+import type { ColumnName } from "../models/ColumnName.ts";
+export type SourceRow = Record<ColumnName, Cell>;
+//# sourceMappingURL=SourceRow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SourceRow.d.ts","sourceRoot":"","sources":["../../../src/models/SourceRow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC"}

package/dist/cjs/models/SourceRow.js

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

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

@@ -0,0 +1,4 @@
+import type { CellValue } from "./CellValue.ts";
+import type { ColumnName } from "./ColumnName.ts";
+export type SourceRowValue = Record<ColumnName, CellValue>;
+//# sourceMappingURL=SourceRowValue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SourceRowValue.d.ts","sourceRoot":"","sources":["../../../src/models/SourceRowValue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC"}

package/dist/cjs/models/SourceRowValue.js

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

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

@@ -13,7 +13,7 @@ export declare function columnAddressToOffset(column: ColumnAddress): ColumnOffs
  * @returns The column address.
  */
 export declare function columnOffsetToAddress(offset: ColumnOffset): ColumnAddress;
-/** @deprecated Use columnAddressToOffset instead. */
+/** @deprecated Use columnOffsetToAddress instead. */
 export declare function offsetToColumnAddress(offset: ColumnOffset): ColumnAddress;
 /**
  * Converts a row address (e.g., "1") to a zero-based row offset.

package/dist/cjs/services/addressOffset.js

@@ -33,7 +33,7 @@ function columnOffsetToAddress(offset) {
     }
     return result;
 }
-/** @deprecated Use columnAddressToOffset instead. */
+/** @deprecated Use columnOffsetToAddress instead. */
 function offsetToColumnAddress(offset) {
     return columnOffsetToAddress(offset);
 }

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

@@ -34,4 +34,10 @@ export declare function isServiceUnavailable(status: number): boolean;
  * @returns True if the status code is 504, otherwise false.
  */
 export declare function isGatewayTimeout(status: number): boolean;
+/**
+ * Checks if the HTTP status code indicates the resource is locked
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 423, otherwise false.
+ */
+export declare function isLocked(status: number): boolean;
 //# sourceMappingURL=httpStatus.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"httpStatus.d.ts","sourceRoot":"","sources":["../../../src/services/httpStatus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD"}
+{"version":3,"file":"httpStatus.d.ts","sourceRoot":"","sources":["../../../src/services/httpStatus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhD"}

package/dist/cjs/services/httpStatus.js

@@ -6,6 +6,7 @@ exports.isHttpNotFound = isHttpNotFound;
 exports.isHttpTooManyRequests = isHttpTooManyRequests;
 exports.isServiceUnavailable = isServiceUnavailable;
 exports.isGatewayTimeout = isGatewayTimeout;
+exports.isLocked = isLocked;
 /**
  * Checks if the HTTP status code indicates a successful response.
  * @param status - The HTTP status code.
@@ -54,3 +55,11 @@ function isServiceUnavailable(status) {
 function isGatewayTimeout(status) {
     return status === 504;
 }
+/**
+ * Checks if the HTTP status code indicates the resource is locked
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 423, otherwise false.
+ */
+function isLocked(status) {
+    return status === 423;
+}

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

@@ -0,0 +1,3 @@
+import type { NumberFormat } from "../models/NumberFormat.ts";
+export declare const generalNumberFormat: NumberFormat;
+//# sourceMappingURL=numberFormat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"numberFormat.d.ts","sourceRoot":"","sources":["../../../src/services/numberFormat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,eAAO,MAAM,mBAAmB,EAAgB,YAAY,CAAC"}

package/dist/cjs/services/numberFormat.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generalNumberFormat = void 0;
+exports.generalNumberFormat = "General";

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

@@ -0,0 +1 @@
+//# sourceMappingURL=source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/services/source.ts"],"names":[],"mappings":""}

package/dist/cjs/services/source.js

@@ -0,0 +1,178 @@
+"use strict";
+// import InvalidOperationError from "../errors/InvalidOperationError.ts";
+// import NeverError from "../errors/NeverError.ts";
+// import type { Cell } from "../models/Cell.ts";
+// import type { ColumnName } from "../models/ColumnName.ts";
+// import type { ColumnOffset } from "../models/ColumnOffset.ts";
+// import type { Item } from "../models/Item.ts";
+// import type { RecordBase } from "../models/RecordBase.ts";
+// import type { RowNumber } from "../models/RowNumber.ts";
+// import type { RowOffset } from "../models/RowOffset.ts";
+// import type { Source } from "../models/source.ts";
+// import type { SourceDecoder } from "../models/SourceDecoder.ts";
+// import type { SourceEncoder } from "../models/SourceEncoder.ts";
+// import type { SourceRow } from "../models/SourceRow.ts";
+// import type { WorkbookWorksheetRef } from "../models/WorkbookWorksheetRef.ts";
+// import deleteWorkbookRange from "../operations/workbookRange/deleteWorkbookRange.ts";
+// import insertWorkbookCells from "../operations/workbookRange/insertWorkbookCells.ts";
+// import setWorkbookRangeFont from "../operations/workbookRange/setWorkbookRangeFont.ts";
+// import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.ts";
+// import getWorkbookWorksheetUsedRangeAddress from "../operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.ts";
+// import iterateWorkbookRange from "../tasks/iterateWorkbookRange.ts";
+// import { countAddressColumns, countAddressRows } from "./addressManipulation.ts";
+// import { rowOffsetToAddress } from "./addressOffset.ts";
+// import { addressToCartesian, cartesianToAddress } from "./cartesianAddress.ts";
+// import { createWorkbookRangeRef } from "./workbookRange.ts";
+// export async function defineSource<T extends RecordBase>(worksheetRef: WorkbookWorksheetRef, decode: SourceDecoder<T>, encode: SourceEncoder<T>): Promise<Source<T>> {
+// 	const usedRange = await getWorkbookWorksheetUsedRangeAddress(worksheetRef);
+// 	const rangeRef = createWorkbookRangeRef(worksheetRef, usedRange);
+// 	const b = addressToCartesian(usedRange);
+// 	// TODO: Header
+// 	const a = await getWorkbookWorksheetRange();
+// 	const source: Source<T> = {
+// 		rangeRef,
+// 		coding: {
+// 			decode,
+// 			encode,
+// 		},
+// 		head: [],
+// 		async *[Symbol.asyncIterator](): AsyncGenerator<Item<T>> {
+// 			let hasHead = false;
+// 			for await (const { rowOffset, row } of iterateWorkbookRange(rangeRef)) {
+// 				if (!hasHead) {
+// 					source.head = row.map((cell) => cell.text) as ColumnName[];
+// 					hasHead = true;
+// 					continue;
+// 				}
+// 				const record = rowToRecord<T>(row, source);
+// 				const rowNumber = rowOffsetToNumber(rowOffset);
+// 				yield {
+// 					rowOffset,
+// 					rowNumber,
+// 					record,
+// 				};
+// 			}
+// 		},
+// 	};
+// 	return source;
+// }
+// export async function initializeSource<T extends RecordBase>(source: Source<T>, empty: T): Promise<void> {
+// 	if (!isEmpty(source)) {
+// 		throw new InvalidOperationError("Cannot initialize source with non-empty worksheet.");
+// 	}
+// 	source.head = Object.keys(empty) as ColumnName[];
+// 	const address = cartesianToAddress({
+// 		ax: 0 as ColumnOffset,
+// 		bx: (source.head.length - 1) as ColumnOffset,
+// 		ay: 0 as RowOffset,
+// 		by: 0 as RowOffset,
+// 	});
+// 	source.rangeRef = createWorkbookRangeRef(source.rangeRef, address);
+// 	await updateWorkbookRange(source.rangeRef, {
+// 		values: [source.head],
+// 	});
+// 	await setWorkbookRangeFont(source.rangeRef, {
+// 		bold: true,
+// 	});
+// }
+// export async function readAllItems<T extends RecordBase>(source: Source<T>): Promise<Item<T>[]> {
+// 	const result: Item<T>[] = [];
+// 	for await (const item of source) {
+// 		result.push(item);
+// 	}
+// 	return result;
+// }
+// export async function createItem<T extends RecordBase>(source: Source<T>, record: T, after: RowOffset = 0 as RowOffset): Promise<Item<T>> {
+// 	if (!isInitialized(source)) {
+// 		throw new InvalidOperationError("Source not initialized.");
+// 	}
+// 	await insertWorkbookCells(source.rangeRef, rowOffsetToAddress(after), "Down");
+// 	const row = recordToRow(record, source);
+// 	const address = cartesianToAddress({
+// 		ax: 0 as ColumnOffset,
+// 		bx: (row.length - 1) as ColumnOffset,
+// 		ay: after,
+// 		by: after,
+// 	});
+// 	const rangeRef = createWorkbookRangeRef(source.rangeRef, address);
+// 	await updateWorkbookRange(rangeRef, {
+// 		values: [row],
+// 		// TODO: Format
+// 	});
+// 	const { ax, bx, ay, by } = addressToCartesian(source.rangeRef.address);
+// 	source.rangeRef.address = cartesianToAddress({
+// 		ax,
+// 		bx,
+// 		ay,
+// 		by: (by + 1) as RowOffset,
+// 	});
+// 	return {
+// 		rowOffset: after,
+// 		rowNumber: rowOffsetToNumber(after),
+// 		record,
+// 	};
+// }
+// export async function updateItem<T extends RecordBase>(source: Source<T>, offset: RowOffset, record: T): Promise<void> {
+// 	if (!isInitialized(source)) {
+// 		throw new InvalidOperationError("Source not initialized.");
+// 	}
+// 	const row = recordToRow(record, source);
+// 	const address = cartesianToAddress({
+// 		ax: 0 as ColumnOffset,
+// 		bx: (row.length - 1) as ColumnOffset,
+// 		ay: offset,
+// 		by: offset,
+// 	});
+// 	const rangeRef = createWorkbookRangeRef(source.rangeRef, address);
+// 	await updateWorkbookRange(rangeRef, {
+// 		values: [row],
+// 		// TODO: format
+// 	});
+// }
+// export async function deleteItem<T extends RecordBase>(source: Source<T>, offset: RowOffset): Promise<void> {
+// 	if (!isInitialized(source)) {
+// 		throw new InvalidOperationError("Source not initialized.");
+// 	}
+// 	const rangeRef = createWorkbookRangeRef(source.rangeRef, rowOffsetToAddress(offset));
+// 	await deleteWorkbookRange(rangeRef, "Up");
+// 	const { ax, bx, ay, by } = addressToCartesian(source.rangeRef.address);
+// 	source.rangeRef.address = cartesianToAddress({
+// 		ax,
+// 		bx,
+// 		ay,
+// 		by: (by - 1) as RowOffset,
+// 	});
+// }
+// function rowToRecord<T extends RecordBase>(row: Cell[], source: Source<T>): T {
+// 	const sourceRow = source.head.reduce((acc, heading, columnIndex) => {
+// 		const cell = row[columnIndex];
+// 		if (!cell) {
+// 			throw new NeverError(`Cell at index ${columnIndex} is undefined`);
+// 		}
+// 		acc[heading] = cell;
+// 		return acc;
+// 	}, {} as SourceRow);
+// 	const record = source.coding.decode(sourceRow);
+// 	return record;
+// }
+// function recordToRow<T extends RecordBase>(record: T, source: Source<T>): Cell[] {
+// 	const sourceRow = source.coding.encode(record);
+// 	const row = source.head.map((heading) => {
+// 		const cell = sourceRow[heading];
+// 		if (cell === undefined) {
+// 			throw new NeverError(`Cell at index ${heading} is undefined`);
+// 		}
+// 		return cell;
+// 	});
+// 	return row;
+// }
+// function rowOffsetToNumber(offset: RowOffset): RowNumber {
+// 	return (offset + 1) as RowNumber;
+// }
+// function isEmpty<T extends RecordBase>(source: Source<T>) {
+// 	return countAddressRows(source.rangeRef.address) <= 1 && countAddressColumns(source.rangeRef.address) <= 1;
+// }
+// function isInitialized<T extends RecordBase>(source: Source<T>) {
+// 	return source.head.length > 0;
+// }
+// // TODO: Tidy Cell/CellValue types

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

@@ -1,4 +1,5 @@
 import type { Cell } from "../models/Cell.ts";
+import type { RowOffset } from "../models/RowOffset.ts";
 import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
 /**
  * Iterates over the values of a workbook range in chunks, fetching data in manageable sizes.
@@ -7,5 +8,8 @@ import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
  * @param overwriteRowsPerRequest - Optional. The number of rows to fetch per request. If omitted, it is automatically calculated.
  * @returns An async iterable that yields rows of range values.
  */
-export default function iterateWorkbookRange(rangeRef: WorkbookRangeRef, overwriteRowsPerRequest?: number | null): AsyncIterable<Cell[]>;
+export default function iterateWorkbookRange(rangeRef: WorkbookRangeRef, overwriteRowsPerRequest?: number | null): AsyncIterable<{
+    rowOffset: RowOffset;
+    row: Cell[];
+}>;
 //# sourceMappingURL=iterateWorkbookRange.d.ts.map

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

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

package/dist/cjs/tasks/iterateWorkbookRange.js

@@ -34,6 +34,7 @@ async function* iterateWorkbookRange(rangeRef, overwriteRowsPerRequest = null) {
     const rowsPerRequest = overwriteRowsPerRequest ?? Math.floor(maxCellsPerRequest / columnsPerRow);
     const rangeStartRowOffset = (0, addressOffset_ts_1.rowAddressToOffset)(components.startRow);
     const rangeEndRowOffset = (0, addressOffset_ts_1.rowAddressToOffset)(components.endRow);
+    let offset = 0;
     for (let chunkRowOffset = rangeStartRowOffset; chunkRowOffset <= rangeEndRowOffset; chunkRowOffset = (chunkRowOffset + rowsPerRequest)) {
         const requestStartRowOffset = chunkRowOffset;
         const requestEndRowOffset = Math.min(chunkRowOffset + rowsPerRequest - 1, rangeEndRowOffset);
@@ -52,11 +53,16 @@ async function* iterateWorkbookRange(rangeRef, overwriteRowsPerRequest = null) {
         const numberFormat = range.numberFormat;
         const rowCount = values.length;
         for (let r = 0; r < rowCount; r++) {
-            yield Array.from({ length: columnCount }, (_, c) => ({
+            const row = Array.from({ length: columnCount }, (_, c) => ({
                 text: text[r]?.[c] ?? "",
                 value: values[r]?.[c] ?? "",
                 numberFormat: numberFormat?.[r]?.[c] ?? "",
             }));
+            yield {
+                rowOffset: offset,
+                row,
+            };
+            offset++;
         }
     }
 }

package/dist/esm/errors/InvalidOperationError.d.ts

@@ -0,0 +1,4 @@
+export default class InvalidOperationError extends Error {
+    constructor(message?: string);
+}
+//# sourceMappingURL=InvalidOperationError.d.ts.map

package/dist/esm/errors/InvalidOperationError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvalidOperationError.d.ts","sourceRoot":"","sources":["../../../src/errors/InvalidOperationError.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,KAAK;gBACpC,OAAO,CAAC,EAAE,MAAM;CAInC"}

package/dist/esm/errors/InvalidOperationError.js

@@ -0,0 +1,6 @@
+export default class InvalidOperationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InvalidOperationError";
+    }
+}

package/dist/esm/graphApi.js

@@ -7,7 +7,7 @@ import RequestFailedError from "./errors/RequestFailedError.js";
 import { getCurrentAccessToken } from "./services/accessToken.js";
 import { getContext } from "./services/context.js";
 import { executeHttpRequest } from "./services/http.js";
-import { isGatewayTimeout, isHttpSuccess, isHttpTooManyRequests, isServiceUnavailable } from "./services/httpStatus.js";
+import { isGatewayTimeout, isHttpSuccess, isHttpTooManyRequests, isLocked, isServiceUnavailable } from "./services/httpStatus.js";
 import { operationIdToIndex, operationIndexToId } from "./services/operationId.js";
 import { sleep } from "./services/sleep.js";
 export const authenticationScope = "https://graph.microsoft.com/.default";
@@ -36,7 +36,7 @@ export async function sequential(...operations) {
     return (await executeBatch(...definitions));
 }
 const maxBatchOperations = 20; // https://learn.microsoft.com/en-us/graph/json-batching?tabs=http#batch-size-limitations
-const maxRetries = 3;
+const maxRetries = 5;
 const defaultRetryDelayMilliseconds = 1000;
 const consecutiveRetryDelayMultiplier = 2;
 async function executeSingle(definition) {
@@ -130,7 +130,7 @@ async function innerFetch(args) {
         catch (error) {
             if (axios.isAxiosError(error) && error.response) {
                 response = error.response;
-                if (!(isHttpTooManyRequests(response.status) || isServiceUnavailable(response.status) || isGatewayTimeout(response.status))) {
+                if (!(isHttpTooManyRequests(response.status) || isServiceUnavailable(response.status) || isGatewayTimeout(response.status) || isLocked(response.status))) {
                     throw error;
                 }
                 const requestedRetryAfterSeconds = Number.parseInt(response.headers["retry-after"] ?? "0", 10);

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

@@ -0,0 +1,9 @@
+import type { RowOffset } from "../models/RowOffset.ts";
+import type { RecordBase } from "./RecordBase.ts";
+import type { RowNumber } from "./RowNumber.ts";
+export type Item<T extends RecordBase> = {
+    rowOffset: RowOffset;
+    rowNumber: RowNumber;
+    record: T;
+};
+//# sourceMappingURL=Item.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Item.d.ts","sourceRoot":"","sources":["../../../src/models/Item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,UAAU,IAAI;IACxC,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,CAAC,CAAC;CACV,CAAC"}

package/dist/esm/models/Item.js

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

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

@@ -0,0 +1,3 @@
+import type { CellValue } from "./CellValue.ts";
+export type RecordBase = Record<string, CellValue>;
+//# sourceMappingURL=RecordBase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RecordBase.d.ts","sourceRoot":"","sources":["../../../src/models/RecordBase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC"}

package/dist/esm/models/RecordBase.js

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

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

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

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

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

package/dist/esm/models/RowNumber.js

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

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

@@ -0,0 +1,15 @@
+import type { ColumnName } from "./ColumnName.ts";
+import type { Item } from "./Item.ts";
+import type { RecordBase } from "./RecordBase.ts";
+import type { SourceDecoder } from "./SourceDecoder.ts";
+import type { SourceEncoder } from "./SourceEncoder.ts";
+import type { WorkbookRangeRef } from "./WorkbookRangeRef.ts";
+export type Source<T extends RecordBase> = {
+    rangeRef: WorkbookRangeRef;
+    head: ColumnName[];
+    coding: {
+        decode: SourceDecoder<T>;
+        encode: SourceEncoder<T>;
+    };
+} & AsyncIterable<Item<T>>;
+//# sourceMappingURL=Source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Source.d.ts","sourceRoot":"","sources":["../../../src/models/Source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,UAAU,IAAI;IAC1C,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,MAAM,EAAE;QACP,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;KACzB,CAAC;CACF,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/esm/models/Source.js

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

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

@@ -0,0 +1,4 @@
+import type { RecordBase } from "./RecordBase.ts";
+import type { SourceRow } from "./SourceRow.ts";
+export type SourceDecoder<T extends RecordBase> = (row: SourceRow) => T;
+//# sourceMappingURL=SourceDecoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SourceDecoder.d.ts","sourceRoot":"","sources":["../../../src/models/SourceDecoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,GAAG,EAAE,SAAS,KAAK,CAAC,CAAC"}

package/dist/esm/models/SourceDecoder.js

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

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

@@ -0,0 +1,4 @@
+import type { RecordBase } from "./RecordBase.ts";
+import type { SourceRow } from "./SourceRow.ts";
+export type SourceEncoder<T extends RecordBase> = (record: T) => SourceRow;
+//# sourceMappingURL=SourceEncoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SourceEncoder.d.ts","sourceRoot":"","sources":["../../../src/models/SourceEncoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,SAAS,CAAC"}

package/dist/esm/models/SourceEncoder.js

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