microsoft-graph 2.2.1 → 2.2.3

package/.github/dependabot.yml

@@ -0,0 +1,12 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    

package/README.md

@@ -4,11 +4,6 @@ This is an extensible library that allows access to Microsoft's GraphAPI, includ
 
 Note that this is a THIRD PARTY library and not associated with Microsoft.
 
-## Breaking changes
-### v2.0.0 
-* Contextual authentication. Authentication details are no longer automatically loaded from envs. You need to call `const contextRef = register(tenantId, clientId, clientSecret, httpProxy);` 
-* References are created with new funcs. Like `createSiteRef`.
-
 ## Usage
 Install the NPM package `npm i microsoft-graph`, then:
 
@@ -19,8 +14,8 @@ Something like this, but whatever works in your context.
 const tenantId = getEnvironmentVariable("AZURE_TENANT_ID") as TenantId;
 const clientId = getEnvironmentVariable("AZURE_CLIENT_ID") as ClientId;
 const clientSecret = getEnvironmentVariable("AZURE_CLIENT_SECRET") as ClientSecret;
-const siteId = getEnvironmentVariable("SHAREPOINT_DEFAULT_SITE_ID") as SiteId;
-const driveId = getEnvironmentVariable("SHAREPOINT_DEFAULT_DRIVE_ID") as DriveId;
+const siteId = getEnvironmentVariable("SHAREPOINT_SITE_ID") as SiteId;
+const driveId = getEnvironmentVariable("SHAREPOINT_DRIVE_ID") as DriveId;
 ```
 
 ### Get reference to drive
@@ -61,8 +56,8 @@ for (const item of await listDriveItems(folder)) {
 
 ### Cleanup
 ```typescript
-await closeWorkbookSession(workbook);
-await deleteDriveItemWithRetry(folder); // May take a moment to unlock the file
+await safeDeleteWorkbook(workbook); // Closes session and waits for unlock
+await deleteDriveItem(folder);
 ```
 
 From here, have a look at:

package/SECURITY.md

@@ -0,0 +1,9 @@
+# Security Policy
+
+## Supported Versions
+
+Only the latest version is supported.
+
+## Reporting a Vulnerability
+
+To report a vunerability raise a [GitHub Issue](https://github.com/Future-Secure-AI/microsoft-graph/issues).

package/dist/errors/NotImplementedError.d.ts

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

package/dist/errors/NotImplementedError.d.ts.map

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

package/dist/errors/NotImplementedError.js

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

package/dist/models/Box.d.ts

@@ -0,0 +1,5 @@
+import type { Cell } from "./Cell.ts";
+import type { Column } from "./Column.ts";
+import type { Row } from "./Row.ts";
+export type Box = `${Cell}:${Cell}` | `${Column}:${Column}` | `${Row}:${Row}`;
+//# sourceMappingURL=Box.d.ts.map

package/dist/models/Box.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Box.d.ts","sourceRoot":"","sources":["../../src/models/Box.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,MAAM,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,GAAG,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC"}

package/dist/models/Cell.d.ts

@@ -0,0 +1,4 @@
+import type { Column } from "./Column.ts";
+import type { Row } from "./Row.ts";
+export type Cell = `${Column}${Row}`;
+//# sourceMappingURL=Cell.d.ts.map

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

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

package/dist/models/Column.d.ts

@@ -0,0 +1,2 @@
+export type Column = `${Uppercase<string>}`;
+//# sourceMappingURL=Column.d.ts.map

package/dist/models/Column.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Column.d.ts","sourceRoot":"","sources":["../../src/models/Column.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC"}

package/dist/models/ColumnIndex.d.ts

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

package/dist/models/ColumnIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColumnIndex.d.ts","sourceRoot":"","sources":["../../src/models/ColumnIndex.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IAClC,OAAO,EAAE,aAAa,CAAC;CACvB,CAAC"}

package/dist/models/RangeAddress.d.ts

@@ -0,0 +1,7 @@
+import type { Box } from "./Box.ts";
+import type { Cell } from "./Cell.ts";
+export type RangeAddressUnderlying = Cell | Box;
+export type RangeAddress = RangeAddressUnderlying & {
+    __brand: "WorkbookRangeAddress";
+};
+//# sourceMappingURL=RangeAddress.d.ts.map

package/dist/models/RangeAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RangeAddress.d.ts","sourceRoot":"","sources":["../../src/models/RangeAddress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,MAAM,sBAAsB,GAAG,IAAI,GAAG,GAAG,CAAC;AAEhD,MAAM,MAAM,YAAY,GAAG,sBAAsB,GAAG;IACnD,OAAO,EAAE,sBAAsB,CAAC;CAChC,CAAC"}

package/dist/models/Row.d.ts

@@ -0,0 +1,2 @@
+export type Row = `${number}`;
+//# sourceMappingURL=Row.d.ts.map

package/dist/models/Row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Row.d.ts","sourceRoot":"","sources":["../../src/models/Row.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,GAAG,GAAG,MAAM,EAAE,CAAC"}

package/dist/models/RowIndex.d.ts

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

package/dist/models/RowIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RowIndex.d.ts","sourceRoot":"","sources":["../../src/models/RowIndex.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAC/B,OAAO,EAAE,UAAU,CAAC;CACpB,CAAC"}

package/dist/models/WorkbookRangeRef.d.ts

@@ -1,4 +1,4 @@
-import type { WorkbookRangeAddress as WorkbookWorksheetRangeAddress } from "./WorkbookRangeAddress.ts";
+import type { RangeAddress as WorkbookWorksheetRangeAddress } from "./RangeAddress.ts";
 import type { WorkbookWorksheetRef } from "./WorkbookWorksheetRef.ts";
 export type WorkbookRangeRef = WorkbookWorksheetRef & {
     address: WorkbookWorksheetRangeAddress;

package/dist/models/WorkbookRangeRef.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkbookRangeRef.d.ts","sourceRoot":"","sources":["../../src/models/WorkbookRangeRef.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,IAAI,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AACvG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG;IACrD,OAAO,EAAE,6BAA6B,CAAC;CACvC,CAAC"}
+{"version":3,"file":"WorkbookRangeRef.d.ts","sourceRoot":"","sources":["../../src/models/WorkbookRangeRef.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,IAAI,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG;IACrD,OAAO,EAAE,6BAA6B,CAAC;CACvC,CAAC"}

package/dist/operations/workbookRange/getWorkbookRangeFormat.d.ts

@@ -0,0 +1,6 @@
+import type { WorkbookRangeFormat } from "@microsoft/microsoft-graph-types";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+import type { WorkbookRangeRef } from "../../models/WorkbookRangeRef.ts";
+/** Retrieve the format of a workbook range. @see https://learn.microsoft.com/en-us/graph/api/rangeformat-get */
+export default function getWorkbookRangeFormat(rangeRef: WorkbookRangeRef): GraphOperation<WorkbookRangeFormat & WorkbookRangeRef>;
+//# sourceMappingURL=getWorkbookRangeFormat.d.ts.map

package/dist/operations/workbookRange/getWorkbookRangeFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWorkbookRangeFormat.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookRange/getWorkbookRangeFormat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,gHAAgH;AAChH,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,mBAAmB,GAAG,gBAAgB,CAAC,CAiBjI"}

package/dist/operations/workbookRange/getWorkbookRangeFormat.js

@@ -0,0 +1,21 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/** Retrieve the format of a workbook range. @see https://learn.microsoft.com/en-us/graph/api/rangeformat-get */
+export default function getWorkbookRangeFormat(rangeRef) {
+    return operation({
+        contextId: rangeRef.contextId,
+        method: "GET",
+        path: generatePath(`/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range(address='${rangeRef.address}')/format`, rangeRef),
+        headers: {
+            "workbook-session-id": rangeRef.sessionId,
+        },
+        body: null,
+        responseTransform: (response) => {
+            const format = response;
+            return {
+                ...format,
+                ...rangeRef,
+            };
+        },
+    });
+}

package/dist/operations/workbookRange/getWorkbookRangeFormat.test.d.ts

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

package/dist/operations/workbookRange/getWorkbookRangeFormat.test.d.ts.map

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

package/dist/operations/workbookRange/getWorkbookRangeFormat.test.js

@@ -0,0 +1,33 @@
+import { describe, expect, it } from "vitest";
+import { getDefaultDriveRef } from "../../services/drive.js";
+import { driveItemPath } from "../../services/driveItem.js";
+import { generateTempFileName } from "../../services/temporaryFiles.js";
+import { createWorkbookRangeRef } from "../../services/workbookRange.js";
+import { createWorkbookWorksheetRef, defaultWorkbookWorksheetId } from "../../services/workbookWorksheet.js";
+import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import createWorkbook from "../workbook/createWorkbook.js";
+import getWorkbookRangeFormat from "./getWorkbookRangeFormat.js";
+import updateWorkbookRange from "./updateWorkbookRange.js";
+describe("getWorkbookRangeFormat", () => {
+    it("can retrieve the format of a range in an existing workbook", async () => {
+        const driveRef = getDefaultDriveRef();
+        const workbookPath = driveItemPath(generateTempFileName("xlsx"));
+        const workbook = await createWorkbook(driveRef, workbookPath);
+        const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+        const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:B2");
+        try {
+            await updateWorkbookRange(rangeRef, {
+                values: [
+                    [1, 2],
+                    [3, 4],
+                ],
+            });
+            const format = await getWorkbookRangeFormat(rangeRef);
+            expect(format.horizontalAlignment).toBe("General");
+            expect(format.verticalAlignment).toBe("Bottom");
+        }
+        finally {
+            await deleteDriveItemWithRetry(workbook);
+        }
+    });
+});

package/dist/operations/workbookRange/insertWorkbookCells.d.ts

@@ -1,8 +1,8 @@
 import type { WorkbookRange } from "@microsoft/microsoft-graph-types";
 import type { GraphOperation } from "../../models/GraphOperation.ts";
-import type { WorkbookRangeAddress } from "../../models/WorkbookRangeAddress.ts";
+import type { RangeAddress } from "../../models/RangeAddress.ts";
 import type { WorkbookRangeRef } from "../../models/WorkbookRangeRef.ts";
 import type { WorkbookWorksheetRef } from "../../models/WorkbookWorksheetRef.ts";
 /** Insert a new blank range at a specified address, shifting existing cells. Use `updateRange` after to set content. @see https://learn.microsoft.com/en-us/graph/api/range-insert */
-export default function insertWorkbookCells(worksheetRef: WorkbookWorksheetRef, address: WorkbookRangeAddress, shift: "Down" | "Right"): GraphOperation<WorkbookRange & WorkbookRangeRef>;
+export default function insertWorkbookCells(worksheetRef: WorkbookWorksheetRef, address: RangeAddress, shift: "Down" | "Right"): GraphOperation<WorkbookRange & WorkbookRangeRef>;
 //# sourceMappingURL=insertWorkbookCells.d.ts.map

package/dist/operations/workbookRange/insertWorkbookCells.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"insertWorkbookCells.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookRange/insertWorkbookCells.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAIjF,sLAAsL;AACtL,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAqBxL"}
+{"version":3,"file":"insertWorkbookCells.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookRange/insertWorkbookCells.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAIjF,sLAAsL;AACtL,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAqBhL"}

package/dist/operations/workbookWorksheet/getWorkbookWorksheetRange.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getWorkbookWorksheetRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookWorksheet/getWorkbookWorksheetRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,iHAAiH;AACjH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAkB9H"}
+{"version":3,"file":"getWorkbookWorksheetRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookWorksheet/getWorkbookWorksheetRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAKzE,iHAAiH;AACjH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAkB9H"}

package/dist/operations/workbookWorksheet/getWorkbookWorksheetRange.js

@@ -1,5 +1,6 @@
 import { operation } from "../../graphApi.js";
 import { generatePath } from "../../services/templatedPaths.js";
+// TODO: Move this to workbookRange
 /** Fetch a range, including values and formatting. @see https://learn.microsoft.com/en-us/graph/api/range-get */
 export default function getWorkbookWorksheetRange(rangeRef) {
     return operation({

package/dist/services/address.d.ts

@@ -1,2 +1,16 @@
-export declare function indexesToAddress(row: number, col: number): string;
+import type { Cell } from "../models/Cell.ts";
+import type { Column } from "../models/Column.ts";
+import type { ColumnIndex } from "../models/ColumnIndex.ts";
+import type { RangeAddress } from "../models/RangeAddress.ts";
+import type { Row } from "../models/Row.ts";
+import type { RowIndex } from "../models/RowIndex.ts";
+export declare function getAddressStart(address: RangeAddress): Cell;
+export declare function getAddressEnd(address: RangeAddress): Cell;
+export declare function cellToIndexes(cell: Cell): [RowIndex, ColumnIndex];
+export declare function indexesToCell(rowIndex: RowIndex, columnIndex: ColumnIndex): Cell;
+export declare function indexesToBox(startRowIndex: RowIndex, startColumnIndex: ColumnIndex, endRowIndex: RowIndex, endColumnIndex: ColumnIndex): RangeAddress;
+export declare function columnToIndex(column: Column): ColumnIndex;
+export declare function indexToColumn(index: ColumnIndex): Column;
+export declare function rowToIndex(row: Row): RowIndex;
+export declare function indexToRow(index: RowIndex): Row;
 //# sourceMappingURL=address.d.ts.map

package/dist/services/address.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../src/services/address.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjE"}
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../src/services/address.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMtD,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAE3D;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAEzD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAcjE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAEhF;AAED,wBAAgB,YAAY,CAAC,aAAa,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,GAAG,YAAY,CAErJ;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAMzD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CASxD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,QAAQ,CAE7C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,GAAG,CAE/C"}

package/dist/services/address.js

@@ -1,3 +1,50 @@
-export function indexesToAddress(row, col) {
-    return `${String.fromCharCode(65 + col)}${row + 1}`;
+// TODO: Tidy this
+const cellPattern = /^(?<sheet>[A-Za-z0-9_]+!)?(?<column>[A-Z]+)(?<row>\d+)$/; // Matches "A2" or "Sheet1!A2"
+export function getAddressStart(address) {
+    return address.split(":", 2)[0];
+}
+export function getAddressEnd(address) {
+    return (address.includes(":") ? address.split(":", 2)[1] : address);
+}
+export function cellToIndexes(cell) {
+    const match = cell.match(cellPattern);
+    if (!match?.groups) {
+        throw new Error(`Invalid cell format '${cell}', must match '${cellPattern}`);
+    }
+    // biome-ignore lint/complexity/useLiteralKeys: Named capture groups are used
+    const column = match.groups["column"];
+    // biome-ignore lint/complexity/useLiteralKeys: Named capture groups are used
+    const row = match.groups["row"];
+    const rowIndex = rowToIndex(row);
+    const columnIndex = columnToIndex(column);
+    return [rowIndex, columnIndex];
+}
+export function indexesToCell(rowIndex, columnIndex) {
+    return `${indexToColumn(columnIndex)}${indexToRow(rowIndex)}`;
+}
+export function indexesToBox(startRowIndex, startColumnIndex, endRowIndex, endColumnIndex) {
+    return `${indexesToCell(startRowIndex, startColumnIndex)}:${indexesToCell(endRowIndex, endColumnIndex)}`;
+}
+export function columnToIndex(column) {
+    let index = 0;
+    for (let i = 0; i < column.length; i++) {
+        index = index * 26 + (column.charCodeAt(i) - 65 + 1);
+    }
+    return (index - 1);
+}
+export function indexToColumn(index) {
+    let result = "";
+    let currentIndex = index + 1;
+    while (currentIndex > 0) {
+        currentIndex -= 1;
+        result = String.fromCharCode((currentIndex % 26) + 65) + result;
+        currentIndex = Math.floor(currentIndex / 26);
+    }
+    return result;
+}
+export function rowToIndex(row) {
+    return (Number.parseInt(row, 10) - 1);
+}
+export function indexToRow(index) {
+    return (index + 1).toString();
 }

package/dist/services/address.test.d.ts

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

package/dist/services/address.test.d.ts.map

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

package/dist/services/address.test.js

@@ -0,0 +1,64 @@
+import { describe, expect, it } from "vitest";
+import { cellToIndexes, columnToIndex, getAddressEnd, getAddressStart, indexesToCell, indexToColumn, indexToRow, rowToIndex } from "./address.js";
+describe("indexesToAddress", () => {
+    it("should convert row and column indexes to an address", () => {
+        expect(indexesToCell(0, 0)).toBe("A1");
+        expect(indexesToCell(4, 2)).toBe("C5");
+        expect(indexesToCell(10, 25)).toBe("Z11");
+    });
+});
+describe("columnToIndex", () => {
+    it("should convert column letters to a zero-based index", () => {
+        expect(columnToIndex("A")).toBe(0);
+        expect(columnToIndex("Z")).toBe(25);
+        expect(columnToIndex("AA")).toBe(26);
+        expect(columnToIndex("AB")).toBe(27);
+        expect(columnToIndex("ZZ")).toBe(701);
+    });
+});
+describe("indexToColumn", () => {
+    it("should convert a zero-based index to column letters", () => {
+        expect(indexToColumn(0)).toBe("A");
+        expect(indexToColumn(25)).toBe("Z");
+        expect(indexToColumn(26)).toBe("AA");
+        expect(indexToColumn(27)).toBe("AB");
+        expect(indexToColumn(701)).toBe("ZZ");
+    });
+});
+describe("rowToIndex", () => {
+    it("should convert a 1-based row to a 0-based index", () => {
+        expect(rowToIndex("1")).toBe(0);
+        expect(rowToIndex("5")).toBe(4);
+        expect(rowToIndex("100")).toBe(99);
+    });
+});
+describe("indexToRow", () => {
+    it("should convert a 0-based index to a 1-based row", () => {
+        expect(indexToRow(0)).toBe("1");
+        expect(indexToRow(4)).toBe("5");
+        expect(indexToRow(99)).toBe("100");
+    });
+});
+describe("cellToIndexes", () => {
+    it("should convert a cell address to row and column indexes", () => {
+        expect(cellToIndexes("A1")).toEqual([0, 0]);
+        expect(cellToIndexes("C5")).toEqual([4, 2]);
+        expect(cellToIndexes("Z11")).toEqual([10, 25]);
+        expect(cellToIndexes("AA1")).toEqual([0, 26]);
+        expect(cellToIndexes("ZZ100")).toEqual([99, 701]);
+    });
+});
+describe("getAddressStart", () => {
+    it("should return the start cell of a range address", () => {
+        expect(getAddressStart("A1:B2")).toBe("A1");
+        expect(getAddressStart("C3:D4")).toBe("C3");
+        expect(getAddressStart("E5")).toBe("E5"); // Single cell address
+    });
+});
+describe("getAddressEnd", () => {
+    it("should return the end cell of a range address", () => {
+        expect(getAddressEnd("A1:B2")).toBe("B2");
+        expect(getAddressEnd("C3:D4")).toBe("D4");
+        expect(getAddressEnd("E5")).toBe("E5"); // Single cell address
+    });
+});

package/dist/services/workbookRange.d.ts

@@ -1,5 +1,5 @@
-import type { WorkbookRangeAddressUnderlying } from "../models/WorkbookRangeAddress.ts";
+import type { RangeAddressUnderlying } from "../models/RangeAddress.ts";
 import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
 import type { WorkbookWorksheetRef } from "../models/WorkbookWorksheetRef.ts";
-export declare function createWorkbookRangeRef(worksheetRef: WorkbookWorksheetRef, address: WorkbookRangeAddressUnderlying): WorkbookRangeRef;
+export declare function createWorkbookRangeRef(worksheetRef: WorkbookWorksheetRef, address: RangeAddressUnderlying): WorkbookRangeRef;
 //# sourceMappingURL=workbookRange.d.ts.map

package/dist/services/workbookRange.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workbookRange.d.ts","sourceRoot":"","sources":["../../src/services/workbookRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAC9G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,8BAA8B,GAAG,gBAAgB,CAUpI"}
+{"version":3,"file":"workbookRange.d.ts","sourceRoot":"","sources":["../../src/services/workbookRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,sBAAsB,GAAG,gBAAgB,CAU5H"}

package/dist/services/workbookRangeAddress.d.ts

@@ -1,3 +1,3 @@
-import type { WorkbookRangeAddress, WorkbookRangeAddressUnderlying } from "../models/WorkbookRangeAddress.ts";
-export declare function createWorkbookRangeAddress(address: WorkbookRangeAddressUnderlying): WorkbookRangeAddress;
+import type { RangeAddress, RangeAddressUnderlying } from "../models/RangeAddress.ts";
+export declare function createWorkbookRangeAddress(address: RangeAddressUnderlying): RangeAddress;
 //# sourceMappingURL=workbookRangeAddress.d.ts.map

package/dist/services/workbookRangeAddress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workbookRangeAddress.d.ts","sourceRoot":"","sources":["../../src/services/workbookRangeAddress.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAI9G,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,8BAA8B,GAAG,oBAAoB,CAMxG"}
+{"version":3,"file":"workbookRangeAddress.d.ts","sourceRoot":"","sources":["../../src/services/workbookRangeAddress.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAItF,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,sBAAsB,GAAG,YAAY,CAMxF"}

package/dist/services/workbookWorksheet.d.ts

@@ -3,4 +3,5 @@ import type { WorkbookWorksheetId } from "../models/WorkbookWorksheetId.ts";
 import type { WorkbookWorksheetRef } from "../models/WorkbookWorksheetRef.ts";
 export declare const defaultWorkbookWorksheetId: WorkbookWorksheetId;
 export declare function createWorkbookWorksheetRef(workbookRef: WorkbookRef, worksheetId: WorkbookWorksheetId | undefined): WorkbookWorksheetRef;
+export declare function createDefaultWorkbookWorksheetRef(workbookRef: WorkbookRef): WorkbookWorksheetRef;
 //# sourceMappingURL=workbookWorksheet.d.ts.map

package/dist/services/workbookWorksheet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workbookWorksheet.d.ts","sourceRoot":"","sources":["../../src/services/workbookWorksheet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,eAAO,MAAM,0BAA0B,EAA+C,mBAAmB,CAAC;AAE1G,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,GAAG,SAAS,GAAG,oBAAoB,CAavI"}
+{"version":3,"file":"workbookWorksheet.d.ts","sourceRoot":"","sources":["../../src/services/workbookWorksheet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,eAAO,MAAM,0BAA0B,EAA+C,mBAAmB,CAAC;AAE1G,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,GAAG,SAAS,GAAG,oBAAoB,CAavI;AAED,wBAAgB,iCAAiC,CAAC,WAAW,EAAE,WAAW,GAAG,oBAAoB,CAEhG"}

package/dist/services/workbookWorksheet.js

@@ -12,3 +12,6 @@ export function createWorkbookWorksheetRef(workbookRef, worksheetId) {
         worksheetId,
     };
 }
+export function createDefaultWorkbookWorksheetRef(workbookRef) {
+    return createWorkbookWorksheetRef(workbookRef, defaultWorkbookWorksheetId);
+}

package/dist/tasks/getRangeLastUsedCell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getRangeLastUsedCell.d.ts","sourceRoot":"","sources":["../../src/tasks/getRangeLastUsedCell.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE,0EAA0E;AAC1E,wBAA8B,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAyClM"}
+{"version":3,"file":"getRangeLastUsedCell.d.ts","sourceRoot":"","sources":["../../src/tasks/getRangeLastUsedCell.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE,0EAA0E;AAC1E,wBAA8B,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAyClM"}

package/dist/tasks/getRangeLastUsedCell.js

@@ -1,6 +1,6 @@
 import ProtocolError from "../errors/ProtocolError.js";
 import getWorkbookWorksheetRange from "../operations/workbookWorksheet/getWorkbookWorksheetRange.js";
-import { indexesToAddress as cellIndexesToAddress } from "../services/address.js";
+import { indexesToCell } from "../services/address.js";
 /** Get the last used cell (ie, the most-lower-right) in a given range. */
 export default async function getRangeLastUsedCell(rangeRef) {
     // TODO: Consider adding chunking if the range is too large
@@ -14,18 +14,18 @@ export default async function getRangeLastUsedCell(rangeRef) {
     if (values === undefined) {
         throw new ProtocolError("Range values missing");
     }
-    for (let rowIndex = rowCount - 1; rowIndex >= 0; rowIndex--) {
+    for (let rowIndex = (rowCount - 1); rowIndex >= 0; rowIndex--) {
         const row = values[rowIndex];
         if (row === undefined) {
             throw new ProtocolError("Row missing");
         }
-        for (let columnIndex = columnCount - 1; columnIndex >= 0; columnIndex--) {
+        for (let columnIndex = (columnCount - 1); columnIndex >= 0; columnIndex--) {
             const cell = row[columnIndex];
             if (cell === undefined) {
                 throw new ProtocolError("Cell missing");
             }
             if (cell !== null && cell !== "") {
-                const address = cellIndexesToAddress(rowIndex, columnIndex);
+                const address = indexesToCell(rowIndex, columnIndex);
                 return {
                     value: cell,
                     address,

package/dist/tasks/setColumnHidden.d.ts

@@ -1,4 +1,5 @@
+import type { WorkbookRange } from "@microsoft/microsoft-graph-types";
 import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
 /** Hide or show one or more columns. */
-export default function setColumnHidden(rangeRef: WorkbookRangeRef, hidden: boolean): Promise<void>;
+export default function setColumnHidden(rangeRef: WorkbookRangeRef, hidden: boolean): Promise<WorkbookRange & WorkbookRangeRef>;
 //# sourceMappingURL=setColumnHidden.d.ts.map

package/dist/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,+BAA+B,CAAC;AAGtE,wCAAwC;AACxC,wBAA8B,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxG"}
+{"version":3,"file":"setColumnHidden.d.ts","sourceRoot":"","sources":["../../src/tasks/setColumnHidden.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,wCAAwC;AACxC,wBAA8B,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAIpI"}

package/dist/tasks/setColumnHidden.js

@@ -1,7 +1,7 @@
 import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.js";
 /** Hide or show one or more columns. */
 export default async function setColumnHidden(rangeRef, hidden) {
-    await updateWorkbookRange(rangeRef, {
+    return await updateWorkbookRange(rangeRef, {
         columnHidden: hidden,
     });
 }

package/dist/tasks/setRowHidden.d.ts

@@ -1,4 +1,5 @@
+import type { WorkbookRange } from "@microsoft/microsoft-graph-types";
 import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
 /** Hide or show one or more rows. */
-export default function setRowHidden(rangeRef: WorkbookRangeRef, hidden: boolean): Promise<void>;
+export default function setRowHidden(rangeRef: WorkbookRangeRef, hidden: boolean): Promise<WorkbookRange & WorkbookRangeRef>;
 //# sourceMappingURL=setRowHidden.d.ts.map

package/dist/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,+BAA+B,CAAC;AAGtE,qCAAqC;AACrC,wBAA8B,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAIrG"}
+{"version":3,"file":"setRowHidden.d.ts","sourceRoot":"","sources":["../../src/tasks/setRowHidden.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,qCAAqC;AACrC,wBAA8B,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAIjI"}

package/dist/tasks/setRowHidden.js

@@ -1,7 +1,7 @@
 import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.js";
 /** Hide or show one or more rows. */
 export default async function setRowHidden(rangeRef, hidden) {
-    await updateWorkbookRange(rangeRef, {
+    return await updateWorkbookRange(rangeRef, {
         rowHidden: hidden,
     });
 }

package/dist/tasks/setWorkbookTableBodyVisibleRows.d.ts

@@ -0,0 +1,4 @@
+import type { WorkbookTableRef } from "../models/WorkbookTableRef.ts";
+/** Overwrite visible rows of a workbook table with the provided 2D array of values, inserting new rows at the end if needed. THIS IS SLOW as it must check each rows visibility. */
+export declare function setWorkbookTableBodyVisibleRows(tableRef: WorkbookTableRef, values: string[][]): Promise<void>;
+//# sourceMappingURL=setWorkbookTableBodyVisibleRows.d.ts.map

package/dist/tasks/setWorkbookTableBodyVisibleRows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setWorkbookTableBodyVisibleRows.d.ts","sourceRoot":"","sources":["../../src/tasks/setWorkbookTableBodyVisibleRows.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAQtE,oLAAoL;AACpL,wBAAsB,+BAA+B,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCnH"}