microsoft-graph 2.2.2 → 2.2.4

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/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 { tryGetHttpAgent } from "./services/httpAgent.js";
-import { isHttpOk, isHttpTooManyRequests } from "./services/httpStatus.js";
+import { isHttpOk, isHttpTooManyRequests, 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";
@@ -103,8 +103,11 @@ async function executeBatch(...ops) {
         }
         if (!isHttpOk(r.status)) {
             const bodyError = body;
-            const errorMessage = bodyError?.error ? `[${bodyError.error.code}] ${bodyError.error.message}` : `HTTP ${r.status}`;
-            RequestFailedError.throw(`GraphAPI operation ${index} failed: '${errorMessage}'`, op, r);
+            let errorMessage = `${r.status}`;
+            if (bodyError?.error) {
+                errorMessage += `: [${bodyError.error.code}] '${bodyError.error.message}'`;
+            }
+            RequestFailedError.throw(`GraphAPI operation ${index} failed: ${errorMessage}`, op, r);
         }
         responses[index] = op.responseTransform(body);
     }
@@ -119,7 +122,7 @@ async function innerFetch(args) {
     while (attempts < maxRetries) {
         // Retry at most 3 times
         response = await fetch(url, options);
-        if (!isHttpTooManyRequests(response.status)) {
+        if (!(isHttpTooManyRequests(response.status) || isServiceUnavailable(response.status))) {
             break;
         }
         const requestedRetryAfterSeconds = Number.parseInt(response.headers.get("Retry-After") ?? "0", 10);
@@ -143,8 +146,11 @@ async function innerFetch(args) {
     const body = replyContentType?.startsWith("application/json") ? await response.json() : null;
     if (!isHttpOk(response.status)) {
         const bodyError = body;
-        const errorMessage = bodyError?.error ? `[${bodyError.error.code}] ${bodyError.error.message}` : `HTTP ${response.status} ${response.statusText}`;
-        RequestFailedError.throw(`GraphAPI fetch failed: '${errorMessage}'`, args, body);
+        let errorMessage = `${response.status} '${response.statusText}'`;
+        if (bodyError?.error) {
+            errorMessage += `: [${bodyError.error.code}] '${bodyError.error.message}'`;
+        }
+        RequestFailedError.throw(`GraphAPI fetch failed: ${errorMessage}`, args, body);
     }
     return body;
 }

package/dist/models/Address.d.ts

@@ -0,0 +1,8 @@
+export type ColumnAddress = `${Uppercase<string>}`;
+export type RowAddress = `${number}`;
+export type ColumnRangeAddress = `${CellAddress}:${CellAddress}`;
+export type RowRangeAddress = `${RowAddress}:${RowAddress}`;
+export type BoxRangeAddress = `${CellAddress}:${CellAddress}`;
+export type CellAddress = `${ColumnAddress}${RowAddress}`;
+export type Address = ColumnAddress | RowAddress | ColumnRangeAddress | RowRangeAddress | BoxRangeAddress | CellAddress;
+//# sourceMappingURL=Address.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Address.d.ts","sourceRoot":"","sources":["../../src/models/Address.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;AACnD,MAAM,MAAM,UAAU,GAAG,GAAG,MAAM,EAAE,CAAC;AAErC,MAAM,MAAM,kBAAkB,GAAG,GAAG,WAAW,IAAI,WAAW,EAAE,CAAC;AACjE,MAAM,MAAM,eAAe,GAAG,GAAG,UAAU,IAAI,UAAU,EAAE,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG,GAAG,WAAW,IAAI,WAAW,EAAE,CAAC;AAE9D,MAAM,MAAM,WAAW,GAAG,GAAG,aAAa,GAAG,UAAU,EAAE,CAAC;AAE1D,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,UAAU,GAAG,kBAAkB,GAAG,eAAe,GAAG,eAAe,GAAG,WAAW,CAAC"}

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,6 +1,6 @@
-import type { WorkbookRangeAddress as WorkbookWorksheetRangeAddress } from "./WorkbookRangeAddress.ts";
+import type { Address } from "./Address.ts";
 import type { WorkbookWorksheetRef } from "./WorkbookWorksheetRef.ts";
 export type WorkbookRangeRef = WorkbookWorksheetRef & {
-    address: WorkbookWorksheetRangeAddress;
+    address: Address;
 };
 //# sourceMappingURL=WorkbookRangeRef.d.ts.map

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,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG;IACrD,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC"}

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

@@ -8,22 +8,25 @@ import { createWorkbookWorksheetRef, defaultWorkbookWorksheetId } from "../../se
 import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
 import calculateWorkbook from "../workbook/calculateWorkbook.js";
 import createWorkbook from "../workbook/createWorkbook.js";
-import getWorkbookWorksheetRange from "../workbookWorksheet/getWorkbookWorksheetRange.js";
 import clearWorkbookRange from "./clearWorkbookRange.js";
+import getWorkbookWorksheetRange from "./getWorkbookWorksheetRange.js";
 import updateWorkbookRange from "./updateWorkbookRange.js";
+const values = [
+    [1, 2],
+    [3, 4],
+];
+const clearedValues = [
+    ["", ""],
+    ["", ""],
+];
 describe("clearWorkbookRange", () => {
     it("can clear a range in an existing workbook", async () => {
-        const address = "A1:B2";
-        const values = [
-            [1, 2],
-            [3, 4],
-        ];
         const workbookName = generateTempFileName("xlsx");
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
         const workbook = await createWorkbook(driveRef, workbookPath);
         const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
-        const rangeRef = createWorkbookRangeRef(worksheetRef, address);
+        const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:B2");
         try {
             await updateWorkbookRange(rangeRef, {
                 values: values,
@@ -31,35 +34,24 @@ describe("clearWorkbookRange", () => {
             await clearWorkbookRange(rangeRef);
             await calculateWorkbook(workbook);
             const clearedRange = await getWorkbookWorksheetRange(rangeRef);
-            expect(clearedRange.values).toEqual([
-                ["", ""],
-                ["", ""],
-            ]);
+            expect(clearedRange.values).toEqual(clearedValues);
         }
         finally {
             await deleteDriveItemWithRetry(workbook);
         }
     });
     it("can clear a range in an existing workbook sequential", async () => {
-        const address = "A1:B2";
-        const values = [
-            [1, 2],
-            [3, 4],
-        ];
         const workbookName = generateTempFileName("xlsx");
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
         const workbook = await createWorkbook(driveRef, workbookPath);
         const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
-        const rangeRef = createWorkbookRangeRef(worksheetRef, address);
+        const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:B2");
         try {
             const [_, __, ___, clearedRange] = await sequential(updateWorkbookRange(rangeRef, {
                 values: values,
             }), clearWorkbookRange(rangeRef), calculateWorkbook(workbook), getWorkbookWorksheetRange(rangeRef));
-            expect(clearedRange.values).toEqual([
-                ["", ""],
-                ["", ""],
-            ]);
+            expect(clearedRange.values).toEqual(clearedValues);
         }
         finally {
             await deleteDriveItemWithRetry(workbook);

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

@@ -8,22 +8,25 @@ import { createWorkbookWorksheetRef, defaultWorkbookWorksheetId } from "../../se
 import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
 import calculateWorkbook from "../workbook/calculateWorkbook.js";
 import createWorkbook from "../workbook/createWorkbook.js";
-import getWorkbookWorksheetRange from "../workbookWorksheet/getWorkbookWorksheetRange.js";
 import deleteWorkbookRange from "./deleteWorkbookRange.js";
+import getWorkbookWorksheetRange from "./getWorkbookWorksheetRange.js";
 import updateWorkbookRange from "./updateWorkbookRange.js";
+const values = [
+    [1, 2],
+    [3, 4],
+];
+const clearedValues = [
+    ["", ""],
+    ["", ""],
+];
 describe("deleteWorkbookRange", () => {
     it("can delete a range in an existing workbook", async () => {
-        const address = "A1:B2";
-        const values = [
-            [1, 2],
-            [3, 4],
-        ];
         const workbookName = generateTempFileName("xlsx");
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
         const workbook = await createWorkbook(driveRef, workbookPath);
         const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
-        const rangeRef = createWorkbookRangeRef(worksheetRef, address);
+        const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:B2");
         try {
             await updateWorkbookRange(rangeRef, {
                 values: values,
@@ -31,17 +34,13 @@ describe("deleteWorkbookRange", () => {
             await deleteWorkbookRange(rangeRef, "Up");
             await calculateWorkbook(workbook);
             const deletedRange = await getWorkbookWorksheetRange(rangeRef);
-            expect(deletedRange.values).toEqual([
-                ["", ""],
-                ["", ""],
-            ]);
+            expect(deletedRange.values).toEqual(clearedValues);
         }
         finally {
             await deleteDriveItemWithRetry(workbook);
         }
     });
     it("can delete a range in an existing workbook sequential", async () => {
-        const address = "A1:B2";
         const values = [
             [1, 2],
             [3, 4],
@@ -51,15 +50,12 @@ describe("deleteWorkbookRange", () => {
         const driveRef = getDefaultDriveRef();
         const workbook = await createWorkbook(driveRef, workbookPath);
         const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
-        const rangeRef = createWorkbookRangeRef(worksheetRef, address);
+        const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:B2");
         try {
             const [_, __, ___, deletedRange] = await sequential(updateWorkbookRange(rangeRef, {
                 values: values,
             }), deleteWorkbookRange(rangeRef, "Up"), calculateWorkbook(workbook), getWorkbookWorksheetRange(rangeRef));
-            expect(deletedRange.values).toEqual([
-                ["", ""],
-                ["", ""],
-            ]);
+            expect(deletedRange.values).toEqual(clearedValues);
         }
         finally {
             await deleteDriveItemWithRetry(workbook);

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/getWorkbookUsedRange.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getWorkbookUsedRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookRange/getWorkbookUsedRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAIjF,kKAAkK;AAClK,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,YAAY,EAAE,oBAAoB,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAmBjI"}
+{"version":3,"file":"getWorkbookUsedRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookRange/getWorkbookUsedRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAItE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAIjF,kKAAkK;AAClK,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,YAAY,EAAE,oBAAoB,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAsBjI"}

package/dist/operations/workbookRange/getWorkbookUsedRange.js

@@ -1,3 +1,4 @@
+import ProtocolError from "../../errors/ProtocolError.js";
 import { operation } from "../../graphApi.js";
 import { generatePath } from "../../services/templatedPaths.js";
 import { createWorkbookRangeRef } from "../../services/workbookRange.js";
@@ -13,6 +14,9 @@ export default function getWorkbookUsedRange(worksheetRef) {
         body: null,
         responseTransform: (response) => {
             const range = response;
+            if (!range.address) {
+                throw new ProtocolError("Invalid response: address is missing");
+            }
             const rangeRef = createWorkbookRangeRef(worksheetRef, range.address);
             return {
                 ...range,

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

@@ -10,19 +10,18 @@ import calculateWorkbook from "../workbook/calculateWorkbook.js";
 import createWorkbook from "../workbook/createWorkbook.js";
 import getWorkbookUsedRange from "./getWorkbookUsedRange.js";
 import updateWorkbookRange from "./updateWorkbookRange.js";
+const values = [
+    [1, 2],
+    [3, 4],
+];
 describe("getWorkbookUsedRange", () => {
     it("can retrieve the used range from an existing workbook", async () => {
-        const address = "A1:B2";
-        const values = [
-            [1, 2],
-            [3, 4],
-        ];
         const workbookName = generateTempFileName("xlsx");
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
         const workbook = await createWorkbook(driveRef, workbookPath);
         const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
-        const rangeRef = createWorkbookRangeRef(worksheetRef, address);
+        const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:B2");
         try {
             await updateWorkbookRange(rangeRef, {
                 values: values,
@@ -36,17 +35,12 @@ describe("getWorkbookUsedRange", () => {
         }
     });
     it("can retrieve the used range from an existing workbook sequential", async () => {
-        const address = "A1:B2";
-        const values = [
-            [1, 2],
-            [3, 4],
-        ];
         const workbookName = generateTempFileName("xlsx");
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
         const workbook = await createWorkbook(driveRef, workbookPath);
         const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
-        const rangeRef = createWorkbookRangeRef(worksheetRef, address);
+        const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:B2");
         try {
             const [_, __, usedRange] = await sequential(updateWorkbookRange(rangeRef, {
                 values: values,

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

@@ -10,19 +10,18 @@ import calculateWorkbook from "../workbook/calculateWorkbook.js";
 import createWorkbook from "../workbook/createWorkbook.js";
 import getWorkbookVisibleRange from "./getWorkbookVisibleRange.js";
 import updateWorkbookRange from "./updateWorkbookRange.js";
+const values = [
+    [1, 2],
+    [3, 4],
+];
 describe("getWorkbookRangeVisible", () => {
     it("can retrieve the visible view of a range in an existing workbook", async () => {
-        const address = "A1:B2";
-        const values = [
-            [1, 2],
-            [3, 4],
-        ];
         const workbookName = generateTempFileName("xlsx");
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
         const workbook = await createWorkbook(driveRef, workbookPath);
         const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
-        const rangeRef = createWorkbookRangeRef(worksheetRef, address);
+        const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:B2");
         try {
             await updateWorkbookRange(rangeRef, { values: values });
             await calculateWorkbook(workbook);
@@ -34,17 +33,12 @@ describe("getWorkbookRangeVisible", () => {
         }
     });
     it("can retrieve the visible view of a range in an existing workbook sequential", async () => {
-        const address = "A1:B2";
-        const values = [
-            [1, 2],
-            [3, 4],
-        ];
         const workbookName = generateTempFileName("xlsx");
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
         const workbook = await createWorkbook(driveRef, workbookPath);
         const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
-        const rangeRef = createWorkbookRangeRef(worksheetRef, address);
+        const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:B2");
         try {
             const [_, __, visibleView] = await sequential(updateWorkbookRange(rangeRef, { values: values }), calculateWorkbook(workbook), getWorkbookVisibleRange(rangeRef));
             expect(visibleView).toBeDefined();

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

@@ -0,0 +1,6 @@
+import type { WorkbookRange } from "@microsoft/microsoft-graph-types";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+import type { WorkbookRangeRef } from "../../models/WorkbookRangeRef.ts";
+/** Fetch a range, including values and formatting. @see https://learn.microsoft.com/en-us/graph/api/range-get */
+export default function getWorkbookWorksheetRange(rangeRef: WorkbookRangeRef): GraphOperation<WorkbookRange & WorkbookRangeRef>;
+//# sourceMappingURL=getWorkbookWorksheetRange.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getWorkbookWorksheetRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookRange/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"}

package/dist/operations/workbookRange/getWorkbookWorksheetRange.js

@@ -0,0 +1,21 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/** 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({
+        contextId: rangeRef.contextId,
+        method: "GET",
+        path: generatePath(`/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range(address='${rangeRef.address}')`, rangeRef),
+        headers: {
+            "workbook-session-id": rangeRef.sessionId,
+        },
+        body: null,
+        responseTransform: (response) => {
+            const range = response;
+            return {
+                ...range,
+                ...rangeRef,
+            };
+        },
+    });
+}

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

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

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

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

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

@@ -0,0 +1,32 @@
+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 updateWorkbookRange from "./updateWorkbookRange.js";
+const values = [
+    [1, 2],
+    [3, 4],
+];
+describe("getWorkbookRange", () => {
+    it("can retrieve a range from an existing worksheet", async () => {
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const driveRef = getDefaultDriveRef();
+        const workbook = await createWorkbook(driveRef, workbookPath);
+        const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+        const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:B2");
+        try {
+            const range = await updateWorkbookRange(rangeRef, {
+                values: values,
+            });
+            expect(range.values).toEqual(values);
+        }
+        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 { Address } from "../../models/Address.ts";
 import type { GraphOperation } from "../../models/GraphOperation.ts";
-import type { WorkbookRangeAddress } from "../../models/WorkbookRangeAddress.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: Address, 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;AAGtE,OAAO,KAAK,EAAE,OAAO,EAAmB,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,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,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAwB3K"}

package/dist/operations/workbookRange/insertWorkbookCells.js

@@ -1,3 +1,4 @@
+import ProtocolError from "../../errors/ProtocolError.js";
 import { operation } from "../../graphApi.js";
 import { generatePath } from "../../services/templatedPaths.js";
 import { createWorkbookRangeRef } from "../../services/workbookRange.js";
@@ -16,6 +17,9 @@ export default function insertWorkbookCells(worksheetRef, address, shift) {
         },
         responseTransform: (response) => {
             const workbook = response;
+            if (!workbook.address) {
+                throw new ProtocolError("Invalid response: address is missing");
+            }
             const rangeRef = createWorkbookRangeRef(worksheetRef, workbook.address);
             return {
                 ...workbook,