microsoft-graph 2.1.0 → 2.2.1

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

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

package/dist/tasks/getRangeLastUsedCell.js

@@ -1,6 +1,7 @@
 import ProtocolError from "../errors/ProtocolError.js";
 import getWorkbookWorksheetRange from "../operations/workbookWorksheet/getWorkbookWorksheetRange.js";
 import { indexesToAddress as cellIndexesToAddress } from "../services/address.js";
+/** Get the last used cell (ie, the most-lower-right) in a given range. */
 export default async function getRangeLastUsedCell(rangeRef) {
     // TODO: Consider adding chunking if the range is too large
     // TODO: Reduce cells returned by using "used range"?
@@ -29,7 +30,7 @@ export default async function getRangeLastUsedCell(rangeRef) {
                     value: cell,
                     address,
                     rowIndex: rowIndex,
-                    columnIndex: columnIndex
+                    columnIndex: columnIndex,
                 };
             }
         }

package/dist/tasks/getRangeLastUsedCell.test.js

@@ -11,7 +11,7 @@ import { createWorkbookWorksheetRef, defaultWorkbookWorksheetId } from "../servi
 import deleteDriveItemWithRetry from "./deleteDriveItemWithRetry.js";
 import getRangeLastUsedCell from "./getRangeLastUsedCell.js";
 describe("getRangeLastUsedCell", () => {
-    it("should return the last used cell value", { timeout: 10000 }, async () => {
+    it("should return the last used cell value", async () => {
         const workbookName = generateTempFileName("xlsx");
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
@@ -22,8 +22,8 @@ describe("getRangeLastUsedCell", () => {
             await sequential(updateWorkbookRange(rangeRef, {
                 values: [
                     [1, 2],
-                    [3, 4]
-                ]
+                    [3, 4],
+                ],
             }), calculateWorkbook(workbook));
             const result = await getRangeLastUsedCell(rangeRef);
             if (result === null) {
@@ -38,7 +38,7 @@ describe("getRangeLastUsedCell", () => {
             await deleteDriveItemWithRetry(workbook);
         }
     });
-    it("should return the last non-empty cell value when the last cell is empty", { timeout: 10000 }, async () => {
+    it("should return the last non-empty cell value when the last cell is empty", async () => {
         const workbookName = generateTempFileName("xlsx");
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
@@ -49,8 +49,8 @@ describe("getRangeLastUsedCell", () => {
             await sequential(updateWorkbookRange(rangeRef, {
                 values: [
                     [1, 2],
-                    [3, null]
-                ]
+                    [3, null],
+                ],
             }), calculateWorkbook(workbook));
             const result = await getRangeLastUsedCell(rangeRef);
             if (result === null) {
@@ -65,7 +65,7 @@ describe("getRangeLastUsedCell", () => {
             await deleteDriveItemWithRetry(workbook);
         }
     });
-    it("should return null when no cells are used", { timeout: 10000 }, async () => {
+    it("should return null when no cells are used", async () => {
         const workbookName = generateTempFileName("xlsx");
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
@@ -76,8 +76,8 @@ describe("getRangeLastUsedCell", () => {
             await sequential(updateWorkbookRange(rangeRef, {
                 values: [
                     [null, null],
-                    [null, null]
-                ]
+                    [null, null],
+                ],
             }), calculateWorkbook(workbook));
             const result = await getRangeLastUsedCell(rangeRef);
             expect(result).toBeNull();

package/dist/tasks/getWorkbookTableVisibleBody.d.ts

@@ -1,4 +1,5 @@
 import type { WorkbookRangeView } from "@microsoft/microsoft-graph-types";
 import type { WorkbookTableRef } from "../models/WorkbookTableRef.ts";
+/** Get the visible cells of a workbook table. Ie any hidden cells are omitted. */
 export declare function getWorkbookTableVisibleBody(tableRef: WorkbookTableRef): Promise<WorkbookRangeView>;
 //# sourceMappingURL=getWorkbookTableVisibleBody.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getWorkbookTableVisibleBody.d.ts","sourceRoot":"","sources":["../../src/tasks/getWorkbookTableVisibleBody.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE,wBAAsB,2BAA2B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA2BxG"}
+{"version":3,"file":"getWorkbookTableVisibleBody.d.ts","sourceRoot":"","sources":["../../src/tasks/getWorkbookTableVisibleBody.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE,kFAAkF;AAClF,wBAAsB,2BAA2B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAKxG"}

package/dist/tasks/getWorkbookTableVisibleBody.js

@@ -1,24 +1,8 @@
 import getWorkbookVisibleRange from "../operations/workbookRange/getWorkbookVisibleRange.js";
 import getWorkbookTableBodyRange from "../operations/workbookTable/getWorkbookTableBodyRange.js";
+/** Get the visible cells of a workbook table. Ie any hidden cells are omitted. */
 export async function getWorkbookTableVisibleBody(tableRef) {
     const range = await getWorkbookTableBodyRange(tableRef);
     const visibleRange = await getWorkbookVisibleRange(range);
     return visibleRange;
-    // TODO: Alternate approach. More performant, but doesn't handle hidden columns yet. Pondering!
-    // const rows = await listWorkbookTableRows(tableRef);
-    // const visibleRows: WorkbookTableRow[] = [];
-    // for (const row of rows) {
-    //     const index = row.index;
-    //     if (index === undefined) {
-    //         throw new ProtocolError("Row index is undefined");
-    //     }
-    //     const rowRange = await getWorkbookWorksheetRange({
-    //         ...tableRef,
-    //         address: workbookRangeAddress(`${index + 1}:${index + 1}`)
-    //     });
-    //     if (!rowRange.rowHidden) {
-    //         visibleRows.push(row);
-    //     }
-    // }
-    // return visibleRows;
 }

package/dist/tasks/getWorkbookTableVisibleBody.test.js

@@ -3,98 +3,98 @@ import calculateWorkbook from "../operations/workbook/calculateWorkbook.js";
 import createWorkbook from "../operations/workbook/createWorkbook.js";
 import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.js";
 import createWorkbookTable from "../operations/workbookTable/createWorkbookTable.js";
-import createWorkbookWorksheet from "../operations/workbookWorksheet/createWorkbookWorksheet.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 deleteDriveItemWithRetry from "./deleteDriveItemWithRetry.js";
 import { getWorkbookTableVisibleBody } from "./getWorkbookTableVisibleBody.js";
 describe("getWorkbookTableVisibleBody", () => {
-    it("can retrieve the visible body range of a table", { timeout: 10000 }, async () => {
+    it("can retrieve the visible body range of a table", async () => {
         const workbookName = generateTempFileName("xlsx");
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
         const workbook = await createWorkbook(driveRef, workbookPath);
         try {
-            const worksheet = await createWorkbookWorksheet(workbook);
-            const rangeRef = createWorkbookRangeRef(worksheet, "A1:D4");
+            const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+            const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:D4");
             const table = await createWorkbookTable(rangeRef, true);
             await updateWorkbookRange(rangeRef, {
                 values: [
                     ["Header1", "Header2", "Header3", "Header4"],
                     ["Value1", "Value2", "Value3", "Value4"],
                     ["Value5", "Value6", "Value7", "Value8"],
-                    ["Value9", "Value10", "Value11", "Value12"]
-                ]
+                    ["Value9", "Value10", "Value11", "Value12"],
+                ],
             });
             await calculateWorkbook(workbook);
             const visibleBodyRange = await getWorkbookTableVisibleBody(table);
             expect(visibleBodyRange.values).toEqual([
                 ["Value1", "Value2", "Value3", "Value4"],
                 ["Value5", "Value6", "Value7", "Value8"],
-                ["Value9", "Value10", "Value11", "Value12"]
+                ["Value9", "Value10", "Value11", "Value12"],
             ]);
         }
         finally {
             await deleteDriveItemWithRetry(workbook);
         }
     });
-    it("omits hidden rows from the visible body range of a table", { timeout: 10000 }, async () => {
+    it("omits hidden rows from the visible body range of a table", async () => {
         const workbookName = generateTempFileName("xlsx");
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
         const workbook = await createWorkbook(driveRef, workbookPath);
         try {
-            const worksheet = await createWorkbookWorksheet(workbook);
-            const rangeRef = createWorkbookRangeRef(worksheet, "A1:D4");
+            const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+            const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:D4");
             const table = await createWorkbookTable(rangeRef, true);
             await updateWorkbookRange(rangeRef, {
                 values: [
                     ["Header1", "Header2", "Header3", "Header4"],
                     ["Value1", "Value2", "Value3", "Value4"],
                     ["Value5", "Value6", "Value7", "Value8"],
-                    ["Value9", "Value10", "Value11", "Value12"]
-                ]
+                    ["Value9", "Value10", "Value11", "Value12"],
+                ],
             });
-            const hiddenRange = createWorkbookRangeRef(worksheet, "2:2");
+            const hiddenRange = createWorkbookRangeRef(worksheetRef, "2:2");
             await updateWorkbookRange(hiddenRange, { rowHidden: true });
             await calculateWorkbook(workbook);
             const visibleBodyRange = await getWorkbookTableVisibleBody(table);
             expect(visibleBodyRange.values).toEqual([
                 ["Value5", "Value6", "Value7", "Value8"],
-                ["Value9", "Value10", "Value11", "Value12"]
+                ["Value9", "Value10", "Value11", "Value12"],
             ]);
         }
         finally {
             await deleteDriveItemWithRetry(workbook);
         }
     });
-    it("omits hidden columns from the visible body range of a table", { timeout: 10000 }, async () => {
+    it("omits hidden columns from the visible body range of a table", async () => {
         const workbookName = generateTempFileName("xlsx");
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
         const workbook = await createWorkbook(driveRef, workbookPath);
         try {
-            const worksheet = await createWorkbookWorksheet(workbook);
-            const rangeRef = createWorkbookRangeRef(worksheet, "A1:D4");
+            const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+            const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:D4");
             const table = await createWorkbookTable(rangeRef, true);
             await updateWorkbookRange(rangeRef, {
                 values: [
                     ["Header1", "Header2", "Header3", "Header4"],
                     ["Value1", "Value2", "Value3", "Value4"],
                     ["Value5", "Value6", "Value7", "Value8"],
-                    ["Value9", "Value10", "Value11", "Value12"]
-                ]
+                    ["Value9", "Value10", "Value11", "Value12"],
+                ],
             });
-            const hiddenRange = createWorkbookRangeRef(worksheet, "B:B");
+            const hiddenRange = createWorkbookRangeRef(worksheetRef, "B:B");
             await updateWorkbookRange(hiddenRange, { columnHidden: true });
             await calculateWorkbook(workbook);
             const visibleBodyRange = await getWorkbookTableVisibleBody(table);
             expect(visibleBodyRange.values).toEqual([
                 ["Value1", "Value3", "Value4"],
                 ["Value5", "Value7", "Value8"],
-                ["Value9", "Value11", "Value12"]
+                ["Value9", "Value11", "Value12"],
             ]);
         }
         finally {

package/dist/tasks/getWorkbookWorksheetByName.d.ts

@@ -0,0 +1,6 @@
+import type { WorkbookWorksheet } from "@microsoft/microsoft-graph-types";
+import type { WorkbookRef } from "../models/WorkbookRef.ts";
+import type { WorkbookWorksheetRef } from "../models/WorkbookWorksheetRef.ts";
+/** Get a worksheet by it's name. Throws error if not found. */
+export default function getWorkbookWorksheetByName(workbookRef: WorkbookRef, name: string): Promise<WorkbookWorksheet & WorkbookWorksheetRef>;
+//# sourceMappingURL=getWorkbookWorksheetByName.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getWorkbookWorksheetByName.d.ts","sourceRoot":"","sources":["../../src/tasks/getWorkbookWorksheetByName.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAG9E,+DAA+D;AAC/D,wBAA8B,0BAA0B,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,oBAAoB,CAAC,CAUlJ"}

package/dist/tasks/getWorkbookWorksheetByName.js

@@ -0,0 +1,12 @@
+import NotFoundError from "../errors/NotFoundError.js";
+import listWorkbookWorksheets from "../operations/workbookWorksheet/listWorkbookWorksheets.js";
+/** Get a worksheet by it's name. Throws error if not found. */
+export default async function getWorkbookWorksheetByName(workbookRef, name) {
+    // TODO: More performant to get it by a direct call without listing all workbooks?
+    const worksheets = await listWorkbookWorksheets(workbookRef);
+    const worksheet = worksheets.find((worksheetRef) => worksheetRef.name === name);
+    if (!worksheet) {
+        throw new NotFoundError(`Worksheet '${name}' not found.`);
+    }
+    return worksheet;
+}

package/dist/tasks/getWorkbookWorksheetRefByName.js

@@ -2,7 +2,7 @@ import listWorkbookWorksheets from "../operations/workbookWorksheet/listWorkbook
 export default async function getWorkbookWorksheetByName(workbookRef, name) {
     // TODO: Probably can get this from a direct API call without fetching all worksheets
     const worksheets = await listWorkbookWorksheets(workbookRef);
-    const worksheet = worksheets.find(worksheetRef => worksheetRef.name === name);
+    const worksheet = worksheets.find((worksheetRef) => worksheetRef.name === name);
     if (!worksheet) {
         throw new Error(`Worksheet '${name}' not found.`); // TODO: Make NotFoundError
     }

package/dist/tasks/safeDeleteWorkbook.d.ts

@@ -0,0 +1,4 @@
+import type { WorkbookRef } from "../models/WorkbookRef.ts";
+/** Safely delete a workbook by first closing any open sessions and then delete with a back-off retry to allow for any outstanding locks to be closed. @see https://github.com/Future-Secure-AI/microsoft-graph/blob/main/docs/lockedWorkbook.md */
+export default function safeDeleteWorkbook(workbookRef: WorkbookRef): Promise<void>;
+//# sourceMappingURL=safeDeleteWorkbook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safeDeleteWorkbook.d.ts","sourceRoot":"","sources":["../../src/tasks/safeDeleteWorkbook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAI5D,mPAAmP;AACnP,wBAA8B,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxF"}

package/dist/tasks/safeDeleteWorkbook.js

@@ -0,0 +1,9 @@
+import closeWorkbookSession from "../operations/workbookSession/closeWorkbookSession.js";
+import deleteDriveItemWithRetry from "./deleteDriveItemWithRetry.js";
+/** Safely delete a workbook by first closing any open sessions and then delete with a back-off retry to allow for any outstanding locks to be closed. @see https://github.com/Future-Secure-AI/microsoft-graph/blob/main/docs/lockedWorkbook.md */
+export default async function safeDeleteWorkbook(workbookRef) {
+    if (workbookRef.sessionId) {
+        await closeWorkbookSession(workbookRef);
+    }
+    await deleteDriveItemWithRetry(workbookRef);
+}

package/dist/tasks/setColumnHidden.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"setColumnHidden.d.ts","sourceRoot":"","sources":["../../src/tasks/setColumnHidden.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,wBAA8B,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxG"}
+{"version":3,"file":"setColumnHidden.d.ts","sourceRoot":"","sources":["../../src/tasks/setColumnHidden.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,wCAAwC;AACxC,wBAA8B,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxG"}

package/dist/tasks/setColumnHidden.js

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

package/dist/tasks/setColumnHidden.test.js

@@ -4,14 +4,14 @@ import createWorkbook from "../operations/workbook/createWorkbook.js";
 import getWorkbookVisibleRange from "../operations/workbookRange/getWorkbookVisibleRange.js";
 import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.js";
 import { getDefaultDriveRef } from "../services/drive.js";
-import { driveItemPath, } from "../services/driveItem.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 "./deleteDriveItemWithRetry.js";
 import setColumnHidden from "./setColumnHidden.js";
 describe("setColumnHidden", () => {
-    it("hides a column in an existing workbook", { timeout: 10000 }, async () => {
+    it("hides a column in an existing workbook", async () => {
         const workbookName = generateTempFileName("xlsx");
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
@@ -23,8 +23,8 @@ describe("setColumnHidden", () => {
                 values: [
                     [1, 2, 3],
                     [4, 5, 6],
-                    [7, 8, 9]
-                ]
+                    [7, 8, 9],
+                ],
             });
             const hiddenRange = createWorkbookRangeRef(worksheetRef, "B:B");
             await setColumnHidden(hiddenRange, true);
@@ -33,7 +33,7 @@ describe("setColumnHidden", () => {
             expect(visibleView.values).toEqual([
                 [1, 3],
                 [4, 6],
-                [7, 9]
+                [7, 9],
             ]);
         }
         finally {

package/dist/tasks/setRowHidden.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"setRowHidden.d.ts","sourceRoot":"","sources":["../../src/tasks/setRowHidden.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,wBAA8B,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAIrG"}
+{"version":3,"file":"setRowHidden.d.ts","sourceRoot":"","sources":["../../src/tasks/setRowHidden.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,qCAAqC;AACrC,wBAA8B,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAIrG"}

package/dist/tasks/setRowHidden.js

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

package/dist/tasks/setRowHidden.test.js

@@ -4,14 +4,14 @@ import createWorkbook from "../operations/workbook/createWorkbook.js";
 import getWorkbookVisibleRange from "../operations/workbookRange/getWorkbookVisibleRange.js";
 import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.js";
 import { getDefaultDriveRef } from "../services/drive.js";
-import { driveItemPath, } from "../services/driveItem.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 "./deleteDriveItemWithRetry.js";
 import setRowHidden from "./setRowHidden.js";
 describe("setRowHidden", () => {
-    it("hides a row in an existing workbook", { timeout: 10000 }, async () => {
+    it("hides a row in an existing workbook", async () => {
         const workbookName = generateTempFileName("xlsx");
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
@@ -23,8 +23,8 @@ describe("setRowHidden", () => {
                 values: [
                     [1, 2, 3],
                     [4, 5, 6],
-                    [7, 8, 9]
-                ]
+                    [7, 8, 9],
+                ],
             });
             const hiddenRange = createWorkbookRangeRef(worksheetRef, "2:2");
             await setRowHidden(hiddenRange, true);
@@ -32,7 +32,7 @@ describe("setRowHidden", () => {
             const visibleView = await getWorkbookVisibleRange(rangeRef);
             expect(visibleView.values).toEqual([
                 [1, 2, 3],
-                [7, 8, 9]
+                [7, 8, 9],
             ]);
         }
         finally {

package/docs/lockedWorkbook.md

@@ -0,0 +1,2 @@
+# "The resource you are attempting to access is locked"
+If you attempt to delete a workbook you may occasionally get this error. To mitigate this call [`safeDeleteWorkbook`](/src/tasks/safeDeleteWorkbook.ts) instead of `deleteDriveItem`. It will attempt to close any active session first, and then delete with a retry in case it takes some time for the lock to be removed.

package/docs/pivotTables.md

@@ -0,0 +1,9 @@
+# Pivot Tables
+
+As of the time of writing, the Graph API does not support creating or modifying pivot tables. Consequently, this SDK does not include pivot table support. Additionally, most Excel manipulation libraries do not provide robust support for pivot tables. If you require pivot table functionality, your options are limited to the following:
+
+* **Use a pre-designed template**: Create an Excel template with a pivot table, upload it to SharePoint (possibly using this SDK), and modify it using the Graph API.
+* **Explore specialized Excel libraries**: Some commercial Excel libraries offer pivot table support, but they typically require a paid license.
+* **Manually edit the workbook's XML**: This involves directly manipulating the XML structure of the workbook locally.
+
+In summary: There are no straightforward solutions for working with pivot tables via the Graph API or this SDK. If possible, it is recommended to avoid relying on pivot tables.

package/docs/requestRetrying.md

@@ -0,0 +1,3 @@
+# Request retrying
+
+[GraphAPI has unmerciful throttling limits](https://learn.microsoft.com/en-us/graph/throttling). If the rate of requests exceed it's predefined limits it will reject requests with a HTTP 429. It appears there are general limits, and then more restrictive limits applied to workbook manipulation. To cater for these limits. This library supports retrying. If a request is throttled, and GraphAPI has provided a retry time, then the library will honour that request and retry automatically. Nothing needs to be done when consuming the library.

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "microsoft-graph",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "description": "Microsoft GraphAPI SDK for NodeJS",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "check": "biome check",
+    "fix": "biome check --fix",
     "build": "npm run check && tsc && npx tsx update-exports.ts",
     "release": "npm run build && npm publish --access public",
     "test": "vitest --bail=3"
@@ -66,6 +67,14 @@
       "import": "./dist/errors/InvalidArgumentError.js",
       "types": "./dist/errors/InvalidArgumentError.d.ts"
     },
+    "./errors/NeverError": {
+      "import": "./dist/errors/NeverError.js",
+      "types": "./dist/errors/NeverError.d.ts"
+    },
+    "./errors/NotFoundError": {
+      "import": "./dist/errors/NotFoundError.js",
+      "types": "./dist/errors/NotFoundError.d.ts"
+    },
     "./errors/ProtocolError": {
       "import": "./dist/errors/ProtocolError.js",
       "types": "./dist/errors/ProtocolError.d.ts"
@@ -966,10 +975,18 @@
       "import": "./dist/tasks/getWorkbookTableVisibleBody.js",
       "types": "./dist/tasks/getWorkbookTableVisibleBody.d.ts"
     },
+    "./tasks/getWorkbookWorksheetByName": {
+      "import": "./dist/tasks/getWorkbookWorksheetByName.js",
+      "types": "./dist/tasks/getWorkbookWorksheetByName.d.ts"
+    },
     "./tasks/getWorkbookWorksheetRefByName": {
       "import": "./dist/tasks/getWorkbookWorksheetRefByName.js",
       "types": "./dist/tasks/getWorkbookWorksheetRefByName.d.ts"
     },
+    "./tasks/safeDeleteWorkbook": {
+      "import": "./dist/tasks/safeDeleteWorkbook.js",
+      "types": "./dist/tasks/safeDeleteWorkbook.d.ts"
+    },
     "./tasks/setColumnHidden": {
       "import": "./dist/tasks/setColumnHidden.js",
       "types": "./dist/tasks/setColumnHidden.d.ts"