microsoft-graph 2.16.0 → 2.17.0

package/dist/esm/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/esm/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/esm/models/SourceRow.js

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

package/dist/esm/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/esm/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/esm/models/SourceRowValue.js

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

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

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

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

@@ -46,3 +46,11 @@ export function isServiceUnavailable(status) {
 export 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.
+ */
+export function isLocked(status) {
+    return status === 423;
+}

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

@@ -0,0 +1 @@
+export const generalNumberFormat = "General";

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=source.d.ts.map

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

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

package/dist/esm/services/source.js

@@ -0,0 +1,178 @@
+// 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 {};
+// 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/esm/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/esm/tasks/iterateWorkbookRange.d.ts.map

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

@@ -28,6 +28,7 @@ export default async function* iterateWorkbookRange(rangeRef, overwriteRowsPerRe
     const rowsPerRequest = overwriteRowsPerRequest ?? Math.floor(maxCellsPerRequest / columnsPerRow);
     const rangeStartRowOffset = rowAddressToOffset(components.startRow);
     const rangeEndRowOffset = 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);
@@ -46,11 +47,16 @@ export default async function* iterateWorkbookRange(rangeRef, overwriteRowsPerRe
         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++;
         }
     }
 }