microsoft-graph 2.2.3 → 2.2.5

package/.github/workflows/{check.yml → quality.yml}

@@ -1,5 +1,7 @@
-name: Biome check
-
+name: Code quality
+permissions:
+  contents: read
+  pull-requests: write
 on:
   pull_request:
     branches: [main]

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 ColumnRangeAddress = `${CellAddress}:${CellAddress}`;
+export type RowAddress = `${number}`;
+export type RowRangeAddress = `${RowAddress}:${RowAddress}`;
+export type CellAddress = `${ColumnAddress}${RowAddress}`;
+export type CellRangeAddress = `${CellAddress}:${CellAddress}`;
+export type Address = ColumnAddress | RowAddress | ColumnRangeAddress | RowRangeAddress | CellRangeAddress | 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,kBAAkB,GAAG,GAAG,WAAW,IAAI,WAAW,EAAE,CAAC;AAEjE,MAAM,MAAM,UAAU,GAAG,GAAG,MAAM,EAAE,CAAC;AACrC,MAAM,MAAM,eAAe,GAAG,GAAG,UAAU,IAAI,UAAU,EAAE,CAAC;AAE5D,MAAM,MAAM,WAAW,GAAG,GAAG,aAAa,GAAG,UAAU,EAAE,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,GAAG,WAAW,IAAI,WAAW,EAAE,CAAC;AAE/D,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,UAAU,GAAG,kBAAkB,GAAG,eAAe,GAAG,gBAAgB,GAAG,WAAW,CAAC"}

package/dist/models/Address.js

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

package/dist/models/WorkbookRangeRef.d.ts

@@ -1,6 +1,6 @@
-import type { RangeAddress as WorkbookWorksheetRangeAddress } from "./RangeAddress.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,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"}
+{"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/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 { 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: RangeAddress, 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,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"}
+{"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,EAAoB,MAAM,yBAAyB,CAAC;AACzE,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,

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

@@ -12,7 +12,6 @@ import insertWorkbookCells from "./insertWorkbookCells.js";
 import updateWorkbookRange from "./updateWorkbookRange.js";
 describe("insertWorkbookCells", () => {
     it("can insert cells in an existing workbook using sequential", { timeout: 20000 }, async () => {
-        const address = "A1:B2";
         const initialValues = [
             [1, 2],
             [3, 4],
@@ -26,7 +25,7 @@ describe("insertWorkbookCells", () => {
         const workbookPath = driveItemPath(workbookName);
         const workbook = await createWorkbook(getDefaultDriveRef(), workbookPath);
         const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
-        const rangeRef = createWorkbookRangeRef(worksheetRef, address);
+        const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:B2");
         try {
             await updateWorkbookRange(rangeRef, { values: initialValues });
             await insertWorkbookCells(worksheetRef, "A1", "Down");

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

@@ -8,21 +8,20 @@ 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 getWorkbookWorksheetRange from "./getWorkbookWorksheetRange.js";
 import updateWorkbookRange from "./updateWorkbookRange.js";
+const values = [
+    [1, 2],
+    [3, 4],
+];
 describe("updateWorkbookRange", () => {
     it("can update 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,
@@ -36,17 +35,12 @@ describe("updateWorkbookRange", () => {
         }
     });
     it("can update 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 [_, __, updatedRange] = await sequential(updateWorkbookRange(rangeRef, {
                 values: values,

package/dist/operations/workbookTable/createWorkbookTable.test.js

@@ -3,9 +3,9 @@ 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 { createDefaultWorkbookWorksheetRef } from "../../services/workbookWorksheet.js";
 import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
 import createWorkbook from "../workbook/createWorkbook.js";
-import createWorkbookWorksheet from "../workbookWorksheet/createWorkbookWorksheet.js";
 import createWorkbookTable from "./createWorkbookTable.js";
 describe("createWorkbookTable", () => {
     it("can create a new table in an existing worksheet", async () => {
@@ -13,8 +13,8 @@ describe("createWorkbookTable", () => {
         const workbookPath = driveItemPath(workbookName);
         const workbook = await createWorkbook(getDefaultDriveRef(), workbookPath);
         try {
-            const worksheet = await createWorkbookWorksheet(workbook);
-            const rangeRef = createWorkbookRangeRef(worksheet, "A1:D4");
+            const worksheetRef = createDefaultWorkbookWorksheetRef(workbook);
+            const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:D4");
             const table = await createWorkbookTable(rangeRef, true);
             expect(table.id).toBeTruthy();
         }

package/dist/operations/workbookTable/getWorkbookTable.test.js

@@ -3,10 +3,10 @@ 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 { createDefaultWorkbookWorksheetRef } from "../../services/workbookWorksheet.js";
 import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
 import calculateWorkbook from "../workbook/calculateWorkbook.js";
 import createWorkbook from "../workbook/createWorkbook.js";
-import createWorkbookWorksheet from "../workbookWorksheet/createWorkbookWorksheet.js";
 import createWorkbookTable from "./createWorkbookTable.js";
 import getWorkbookTable from "./getWorkbookTable.js";
 describe("getWorkbookTable", () => {
@@ -16,8 +16,8 @@ describe("getWorkbookTable", () => {
         const driveRef = getDefaultDriveRef();
         const workbook = await createWorkbook(driveRef, workbookPath);
         try {
-            const worksheet = await createWorkbookWorksheet(workbook);
-            const rangeRef = createWorkbookRangeRef(worksheet, "A1:D4");
+            const worksheetRef = createDefaultWorkbookWorksheetRef(workbook);
+            const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:D4");
             const table = await createWorkbookTable(rangeRef, true);
             await calculateWorkbook(workbook);
             const retrievedTable = await getWorkbookTable(table);

package/dist/operations/workbookTable/getWorkbookTableBodyRange.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getWorkbookTableBodyRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookTable/getWorkbookTableBodyRange.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,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAIzE,oHAAoH;AACpH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAmB9H"}
+{"version":3,"file":"getWorkbookTableBodyRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookTable/getWorkbookTableBodyRange.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,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAIzE,oHAAoH;AACpH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAsB9H"}

package/dist/operations/workbookTable/getWorkbookTableBodyRange.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 getWorkbookTableBodyRange(tableRef) {
         body: null,
         responseTransform: (response) => {
             const range = response;
+            if (!range.address) {
+                throw new ProtocolError("Invalid response: address is missing");
+            }
             const rangeRef = createWorkbookRangeRef(tableRef, range.address);
             return {
                 ...range,

package/dist/operations/workbookTable/getWorkbookTableBodyRange.test.js

@@ -8,9 +8,9 @@ import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
 import calculateWorkbook from "../workbook/calculateWorkbook.js";
 import createWorkbook from "../workbook/createWorkbook.js";
 import updateWorkbookRange from "../workbookRange/updateWorkbookRange.js";
-import createWorkbookWorksheet from "../workbookWorksheet/createWorkbookWorksheet.js";
 import createWorkbookTable from "./createWorkbookTable.js";
 import getWorkbookTableBodyRange from "./getWorkbookTableBodyRange.js";
+import { createDefaultWorkbookWorksheetRef } from "../../services/workbookWorksheet.js";
 describe("getWorkbookTableBodyRange", () => {
     it("can retrieve the data body range of a table", async () => {
         const workbookName = generateTempFileName("xlsx");
@@ -18,8 +18,8 @@ describe("getWorkbookTableBodyRange", () => {
         const driveRef = getDefaultDriveRef();
         const workbook = await createWorkbook(driveRef, workbookPath);
         try {
-            const worksheet = await createWorkbookWorksheet(workbook);
-            const rangeRef = createWorkbookRangeRef(worksheet, "A1:D4");
+            const worksheetRef = createDefaultWorkbookWorksheetRef(workbook);
+            const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:D4");
             const table = await createWorkbookTable(rangeRef, true);
             await updateWorkbookRange(rangeRef, {
                 values: [

package/dist/operations/workbookTable/getWorkbookTableHeaderRange.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getWorkbookTableHeaderRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookTable/getWorkbookTableHeaderRange.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,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAIzE,sHAAsH;AACtH,MAAM,CAAC,OAAO,UAAU,2BAA2B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAmBhI"}
+{"version":3,"file":"getWorkbookTableHeaderRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookTable/getWorkbookTableHeaderRange.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,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAIzE,sHAAsH;AACtH,MAAM,CAAC,OAAO,UAAU,2BAA2B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAsBhI"}

package/dist/operations/workbookTable/getWorkbookTableHeaderRange.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 getWorkbookTableHeaderRange(tableRef) {
         body: null,
         responseTransform: (response) => {
             const range = response;
+            if (!range.address) {
+                throw new ProtocolError("Invalid response: address is missing");
+            }
             const rangeRef = createWorkbookRangeRef(tableRef, range.address);
             return {
                 ...range,