microsoft-graph 2.6.0 → 2.7.0

package/dist/esm/operations/workbookRange/getWorkbookNamedRange.js

@@ -0,0 +1,27 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/**
+ * Retrieve a range that has been defined using the "named range" functionality.
+ *
+ * @param rangeRef - A reference to the named range, optionally including session information.
+ * @returns The specified named range, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-get
+ */
+export default function getWorkbookNamedRange(rangeRef) {
+    return operation({
+        contextId: rangeRef.contextId,
+        method: "GET",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/names/{range-name}/range", rangeRef),
+        headers: {
+            "workbook-session-id": rangeRef.sessionId,
+        },
+        body: null,
+        responseTransform: (response) => {
+            const range = response;
+            return {
+                ...range,
+                ...rangeRef,
+            };
+        },
+    });
+}

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

@@ -0,0 +1,12 @@
+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.
+ *
+ * @param rangeRef - A reference to the range, optionally including session information.
+ * @returns The format of the specified range, including its metadata and reference information.
+ * @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/esm/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;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,mBAAmB,GAAG,gBAAgB,CAAC,CAiBjI"}

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

@@ -0,0 +1,27 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/**
+ * Retrieve the format of a workbook range.
+ *
+ * @param rangeRef - A reference to the range, optionally including session information.
+ * @returns The format of the specified range, including its metadata and reference information.
+ * @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/esm/operations/workbookRange/getWorkbookRangeFormat.test.d.ts

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

package/dist/esm/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/esm/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 tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.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 tryDeleteDriveItem(workbook);
+        }
+    });
+});

package/dist/esm/operations/workbookRange/getWorkbookUsedRange.d.ts

@@ -0,0 +1,9 @@
+import type { WorkbookRange } from "@microsoft/microsoft-graph-types";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+import type { WorkbookRangeRef } from "../../models/WorkbookRangeRef.ts";
+import type { WorkbookWorksheetRef } from "../../models/WorkbookWorksheetRef.ts";
+/**
+ * @deprecated Use `getWorkbookWorksheetUsedRange` instead.
+ */
+export default function getWorkbookUsedRange(worksheetRef: WorkbookWorksheetRef): GraphOperation<WorkbookRange & WorkbookRangeRef>;
+//# sourceMappingURL=getWorkbookUsedRange.d.ts.map

package/dist/esm/operations/workbookRange/getWorkbookUsedRange.d.ts.map

@@ -0,0 +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;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;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,YAAY,EAAE,oBAAoB,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAsBjI"}

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

@@ -0,0 +1,29 @@
+import ProtocolError from "../../errors/ProtocolError.js";
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+import { createWorkbookRangeRef } from "../../services/workbookRange.js";
+/**
+ * @deprecated Use `getWorkbookWorksheetUsedRange` instead.
+ */
+export default function getWorkbookUsedRange(worksheetRef) {
+    return operation({
+        contextId: worksheetRef.contextId,
+        method: "GET",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range/usedRange", worksheetRef),
+        headers: {
+            "workbook-session-id": worksheetRef.sessionId,
+        },
+        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,
+                ...rangeRef,
+            };
+        },
+    });
+}

package/dist/esm/operations/workbookRange/getWorkbookVisibleRange.d.ts

@@ -0,0 +1,12 @@
+import type { WorkbookRangeView } from "@microsoft/microsoft-graph-types";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+import type { WorkbookRangeRef } from "../../models/WorkbookRangeRef.ts";
+/**
+ * Retrieve the visible view of a range.
+ *
+ * @param rangeRef - A reference to the range to be fetched, optionally including session information.
+ * @returns The visible view of the specified range, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/workbookrange-visibleview
+ */
+export default function getWorkbookVisibleRange(rangeRef: WorkbookRangeRef): GraphOperation<WorkbookRangeView & WorkbookRangeRef>;
+//# sourceMappingURL=getWorkbookVisibleRange.d.ts.map

package/dist/esm/operations/workbookRange/getWorkbookVisibleRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWorkbookVisibleRange.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookRange/getWorkbookVisibleRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,iBAAiB,GAAG,gBAAgB,CAAC,CAmBhI"}

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

@@ -0,0 +1,28 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/**
+ * Retrieve the visible view of a range.
+ *
+ * @param rangeRef - A reference to the range to be fetched, optionally including session information.
+ * @returns The visible view of the specified range, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/workbookrange-visibleview
+ */
+export default function getWorkbookVisibleRange(rangeRef) {
+    // TODO: Should be a visible ref type?
+    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}')/visibleView`, rangeRef),
+        headers: {
+            "workbook-session-id": rangeRef.sessionId,
+        },
+        body: null,
+        responseTransform: (response) => {
+            const range = response;
+            return {
+                ...range,
+                ...rangeRef,
+            };
+        },
+    });
+}

package/dist/esm/operations/workbookRange/getWorkbookVisibleRange.test.d.ts

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

package/dist/esm/operations/workbookRange/getWorkbookVisibleRange.test.d.ts.map

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

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

@@ -0,0 +1,109 @@
+import { describe, expect, it } from "vitest";
+import { sequential } from "../../graphApi.js";
+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 tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
+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 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 {
+            await updateWorkbookRange(rangeRef, { values: values });
+            await calculateWorkbook(workbook);
+            const visibleView = await getWorkbookVisibleRange(rangeRef);
+            expect(visibleView).toBeDefined();
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+    it("can retrieve the visible view of a range in an existing workbook sequential", 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 [_, __, visibleView] = await sequential(updateWorkbookRange(rangeRef, { values: values }), calculateWorkbook(workbook), getWorkbookVisibleRange(rangeRef));
+            expect(visibleView).toBeDefined();
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+    it("omits hidden row from the visible view of a range", async () => {
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const driveRef = getDefaultDriveRef();
+        const workbook = await createWorkbook(driveRef, workbookPath);
+        const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+        try {
+            const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:C3");
+            await updateWorkbookRange(rangeRef, {
+                values: [
+                    [1, 2, 3],
+                    [4, 5, 6],
+                    [7, 8, 9],
+                ],
+            });
+            const hiddenRange = createWorkbookRangeRef(worksheetRef, "B:B");
+            await updateWorkbookRange(hiddenRange, {
+                columnHidden: true,
+            });
+            await calculateWorkbook(workbook);
+            const visibleView = await getWorkbookVisibleRange(rangeRef);
+            expect(visibleView.values).toEqual([
+                [1, 3],
+                [4, 6],
+                [7, 9],
+            ]);
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+    it("omits hidden column from the visible view of a range", async () => {
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const driveRef = getDefaultDriveRef();
+        const workbook = await createWorkbook(driveRef, workbookPath);
+        const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+        try {
+            const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:C3");
+            await updateWorkbookRange(rangeRef, {
+                values: [
+                    [1, 2, 3],
+                    [4, 5, 6],
+                    [7, 8, 9],
+                ],
+            });
+            const hiddenRange = createWorkbookRangeRef(worksheetRef, "2:2");
+            const [_, __, visibleView] = await sequential(updateWorkbookRange(hiddenRange, {
+                rowHidden: true,
+            }), calculateWorkbook(workbook), getWorkbookVisibleRange(rangeRef));
+            expect(visibleView.values).toEqual([
+                [1, 2, 3],
+                [7, 8, 9],
+            ]);
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+});

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

@@ -0,0 +1,12 @@
+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.
+ *
+ * @param rangeRef - A reference to the range to be fetched, optionally including session information.
+ * @returns The fetched range, including its metadata and reference information.
+ * @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/esm/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;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAkB9H"}

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

@@ -0,0 +1,27 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/**
+ * Fetch a range, including values and formatting.
+ *
+ * @param rangeRef - A reference to the range to be fetched, optionally including session information.
+ * @returns The fetched range, including its metadata and reference information.
+ * @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/esm/operations/workbookRange/getWorkbookWorksheetRange.test.d.ts

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

package/dist/esm/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/esm/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 tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.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 tryDeleteDriveItem(workbook);
+        }
+    });
+});

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

@@ -0,0 +1,16 @@
+import type { WorkbookRange } from "@microsoft/microsoft-graph-types";
+import type { Address } from "../../models/Address.ts";
+import type { GraphOperation } from "../../models/GraphOperation.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 `updateWorkbookRange` afterward to set content.
+ *
+ * @param worksheetRef - A reference to the worksheet where the range will be inserted, optionally including session information.
+ * @param address - The address where the new range will be inserted.
+ * @param shift - The direction to shift existing cells. Can be "Down" or "Right".
+ * @returns The newly inserted range, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-insert
+ */
+export default function insertWorkbookCells(worksheetRef: WorkbookWorksheetRef, address: Address, shift: "Down" | "Right"): GraphOperation<WorkbookRange & WorkbookRangeRef>;
+//# sourceMappingURL=insertWorkbookCells.d.ts.map

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

@@ -0,0 +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;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;;;;;;;;GAQG;AACH,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/esm/operations/workbookRange/insertWorkbookCells.js

@@ -0,0 +1,38 @@
+import ProtocolError from "../../errors/ProtocolError.js";
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+import { createWorkbookRangeRef } from "../../services/workbookRange.js";
+/**
+ * Insert a new blank range at a specified address, shifting existing cells. Use `updateWorkbookRange` afterward to set content.
+ *
+ * @param worksheetRef - A reference to the worksheet where the range will be inserted, optionally including session information.
+ * @param address - The address where the new range will be inserted.
+ * @param shift - The direction to shift existing cells. Can be "Down" or "Right".
+ * @returns The newly inserted range, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-insert
+ */
+export default function insertWorkbookCells(worksheetRef, address, shift) {
+    return operation({
+        contextId: worksheetRef.contextId,
+        method: "POST",
+        path: generatePath(`/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range(address='${address}')/insert`, worksheetRef),
+        headers: {
+            "workbook-session-id": worksheetRef.sessionId,
+            "content-type": "application/json",
+        },
+        body: {
+            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,
+                ...rangeRef,
+            };
+        },
+    });
+}

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

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

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

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

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

@@ -0,0 +1,40 @@
+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 tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
+import calculateWorkbook from "../workbook/calculateWorkbook.js";
+import createWorkbook from "../workbook/createWorkbook.js";
+import getWorkbookUsedRange from "./getWorkbookUsedRange.js";
+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 initialValues = [
+            [1, 2],
+            [3, 4],
+        ];
+        const finalValues = [
+            ["", 2],
+            [1, 4],
+            [3, ""],
+        ];
+        const workbookName = generateTempFileName("xlsx");
+        const workbookPath = driveItemPath(workbookName);
+        const workbook = await createWorkbook(getDefaultDriveRef(), workbookPath);
+        const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+        const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:B2");
+        try {
+            await updateWorkbookRange(rangeRef, { values: initialValues });
+            await insertWorkbookCells(worksheetRef, "A1", "Down");
+            await calculateWorkbook(workbook);
+            const insertedRange = await getWorkbookUsedRange(rangeRef);
+            expect(insertedRange.values).toEqual(finalValues);
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+});

package/dist/esm/operations/workbookRange/updateWorkbookNamedRange.d.ts

@@ -0,0 +1,13 @@
+import type { WorkbookRange } from "@microsoft/microsoft-graph-types";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+import type { WorkbookNamedRangeRef } from "../../models/WorkbookNamedRangeRef.ts";
+/**
+ * Update a range that has been defined using the "named range" functionality. Properties that aren't included in the request maintain their previous values or are recalculated based on changes to other property values.
+ *
+ * @param rangeRef - A reference to the named range to be updated, optionally including session information.
+ * @param value - The updated properties for the named range.
+ * @returns Nothing.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-update
+ */
+export default function updateWorkbookNamedRange(rangeRef: WorkbookNamedRangeRef, value: WorkbookRange): GraphOperation<void>;
+//# sourceMappingURL=updateWorkbookNamedRange.d.ts.map

package/dist/esm/operations/workbookRange/updateWorkbookNamedRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateWorkbookNamedRange.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookRange/updateWorkbookNamedRange.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,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAGnF;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,QAAQ,EAAE,qBAAqB,EAAE,KAAK,EAAE,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC,CAY5H"}

package/dist/esm/operations/workbookRange/updateWorkbookNamedRange.js

@@ -0,0 +1,23 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/**
+ * Update a range that has been defined using the "named range" functionality. Properties that aren't included in the request maintain their previous values or are recalculated based on changes to other property values.
+ *
+ * @param rangeRef - A reference to the named range to be updated, optionally including session information.
+ * @param value - The updated properties for the named range.
+ * @returns Nothing.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-update
+ */
+export default function updateWorkbookNamedRange(rangeRef, value) {
+    return operation({
+        contextId: rangeRef.contextId,
+        method: "PATCH",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/names/{range-name}/range", rangeRef),
+        headers: {
+            "workbook-session-id": rangeRef.sessionId,
+            "content-type": "application/json",
+        },
+        body: value,
+        responseTransform: () => undefined,
+    });
+}

package/dist/esm/operations/workbookRange/updateWorkbookRange.d.ts

@@ -0,0 +1,13 @@
+import type { WorkbookRange } from "@microsoft/microsoft-graph-types";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+import type { WorkbookRangeRef } from "../../models/WorkbookRangeRef.ts";
+/**
+ * Update a range, including values and formatting. Properties that aren't included in the request maintain their previous values or are recalculated based on changes to other property values.
+ *
+ * @param rangeRef - A reference to the range to be updated, optionally including session information.
+ * @param update - The updated properties for the range.
+ * @returns The updated range, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-update
+ */
+export default function updateWorkbookRange(rangeRef: WorkbookRangeRef, update: WorkbookRange): GraphOperation<WorkbookRange & WorkbookRangeRef>;
+//# sourceMappingURL=updateWorkbookRange.d.ts.map

package/dist/esm/operations/workbookRange/updateWorkbookRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateWorkbookRange.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookRange/updateWorkbookRange.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;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,aAAa,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAmB/I"}

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

@@ -0,0 +1,29 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/**
+ * Update a range, including values and formatting. Properties that aren't included in the request maintain their previous values or are recalculated based on changes to other property values.
+ *
+ * @param rangeRef - A reference to the range to be updated, optionally including session information.
+ * @param update - The updated properties for the range.
+ * @returns The updated range, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-update
+ */
+export default function updateWorkbookRange(rangeRef, update) {
+    return operation({
+        contextId: rangeRef.contextId,
+        method: "PATCH",
+        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,
+            "content-type": "application/json",
+        },
+        body: update,
+        responseTransform: (response) => {
+            const range = response;
+            return {
+                ...range,
+                ...rangeRef,
+            };
+        },
+    });
+}

package/dist/esm/operations/workbookRange/updateWorkbookRange.test.d.ts

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

package/dist/esm/operations/workbookRange/updateWorkbookRange.test.d.ts.map

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