microsoft-graph 2.3.0 → 2.4.0

package/dist/operations/user/userSendMail.js

@@ -2,7 +2,16 @@ import InvalidArgumentError from "../../errors/InvalidArgumentError.js";
 import { operation } from "../../graphApi.js";
 // Overview of SendMail process: https://learn.microsoft.com/en-us/graph/outlook-things-to-know-about-send-mail
 const emailPattern = /^[a-zA-Z0-9._\-@]+$/; // Basic, but intended just to avoid URL escaping issues
-/** Send an email from the current or a specified user. @see https://learn.microsoft.com/en-us/graph/api/user-sendmail */
+/**
+ * Send an email.
+ *
+ * @param contextRef - A reference to the context.
+ * @param sender - The email address of the sender or NULL for the current user. Must match a valid email address in this tenant.
+ * @param message - The email message to be sent.
+ * @returns Nothing.
+ * @throws InvalidArgumentError if the sender email address does not match the required pattern.
+ * @see https://learn.microsoft.com/en-us/graph/api/user-sendmail
+ */
 export default function userSendMail(contextRef, sender, message) {
     if (sender && !emailPattern.test(sender)) {
         throw new InvalidArgumentError(`Invalid email address. Must match pattern '${emailPattern}'`);

package/dist/operations/workbook/calculateWorkbook.d.ts

@@ -1,7 +1,19 @@
 import type { GraphOperation } from "../../models/GraphOperation.ts";
 import type { WorkbookRef } from "../../models/WorkbookRef.ts";
-/** Recalculate a workbook. @see https://learn.microsoft.com/en-us/graph/api/workbookapplication-calculate */
+/**
+ * Recalculate a workbook.
+ *
+ * @param workbookRef - A reference to the workbook to be recalculated.
+ * @param calculationType - The type of recalculation to perform. Can be "Recalculate", "Full", or "FullRebuild". Defaults to "Recalculate".
+ * @returns Nothing.
+ * @see https://learn.microsoft.com/en-us/graph/api/workbookapplication-calculate
+ */
 export default function calculateWorkbook(workbookRef: WorkbookRef, calculationType?: "Recalculate" | "Full" | "FullRebuild"): GraphOperation<void>;
-/** @deprecated Use calculateWorkbook instead. */
+/**
+ * @deprecated Use calculateWorkbook instead.
+ *
+ * @param workbookRef - A reference to the workbook to be recalculated.
+ * @returns Nothing.
+ */
 export declare function recalculateWorkbook(workbookRef: WorkbookRef): GraphOperation<void>;
 //# sourceMappingURL=calculateWorkbook.d.ts.map

package/dist/operations/workbook/calculateWorkbook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calculateWorkbook.d.ts","sourceRoot":"","sources":["../../../src/operations/workbook/calculateWorkbook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG/D,6GAA6G;AAC7G,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,WAAW,EAAE,WAAW,EAAE,eAAe,GAAE,aAAa,GAAG,MAAM,GAAG,aAA6B,GAAG,cAAc,CAAC,IAAI,CAAC,CAajK;AAED,iDAAiD;AACjD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,CAElF"}
+{"version":3,"file":"calculateWorkbook.d.ts","sourceRoot":"","sources":["../../../src/operations/workbook/calculateWorkbook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG/D;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,WAAW,EAAE,WAAW,EAAE,eAAe,GAAE,aAAa,GAAG,MAAM,GAAG,aAA6B,GAAG,cAAc,CAAC,IAAI,CAAC,CAajK;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,CAElF"}

package/dist/operations/workbook/calculateWorkbook.js

@@ -1,6 +1,13 @@
 import { operation } from "../../graphApi.js";
 import { generatePath } from "../../services/templatedPaths.js";
-/** Recalculate a workbook. @see https://learn.microsoft.com/en-us/graph/api/workbookapplication-calculate */
+/**
+ * Recalculate a workbook.
+ *
+ * @param workbookRef - A reference to the workbook to be recalculated.
+ * @param calculationType - The type of recalculation to perform. Can be "Recalculate", "Full", or "FullRebuild". Defaults to "Recalculate".
+ * @returns Nothing.
+ * @see https://learn.microsoft.com/en-us/graph/api/workbookapplication-calculate
+ */
 export default function calculateWorkbook(workbookRef, calculationType = "Recalculate") {
     return operation({
         contextId: workbookRef.contextId,
@@ -15,7 +22,12 @@ export default function calculateWorkbook(workbookRef, calculationType = "Recalc
         responseTransform: () => undefined,
     });
 }
-/** @deprecated Use calculateWorkbook instead. */
+/**
+ * @deprecated Use calculateWorkbook instead.
+ *
+ * @param workbookRef - A reference to the workbook to be recalculated.
+ * @returns Nothing.
+ */
 export function recalculateWorkbook(workbookRef) {
     return calculateWorkbook(workbookRef, "Recalculate");
 }

package/dist/operations/workbook/calculateWorkbook.test.js

@@ -2,7 +2,7 @@ import { describe, it } from "vitest";
 import { getDefaultDriveRef } from "../../services/drive.js";
 import { driveItemPath } from "../../services/driveItem.js";
 import { generateTempFileName } from "../../services/temporaryFiles.js";
-import deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
 import calculateWorkbook from "./calculateWorkbook.js";
 import createWorkbook from "./createWorkbook.js";
 describe("calculateWorkbook", () => {
@@ -16,7 +16,7 @@ describe("calculateWorkbook", () => {
             await calculateWorkbook(workbook, "Recalculate");
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
     it(`can calculate workbook with calculation type: 'Full'`, async () => {
@@ -28,7 +28,7 @@ describe("calculateWorkbook", () => {
             await calculateWorkbook(workbook, "Full");
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
     it(`can calculate workbook with calculation type: 'FullRebuild'`, async () => {
@@ -40,7 +40,7 @@ describe("calculateWorkbook", () => {
             await calculateWorkbook(workbook, "FullRebuild");
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
 });

package/dist/operations/workbook/createWorkbook.d.ts

@@ -4,6 +4,14 @@ import type { DriveItemRef } from "../../models/DriveItemRef.ts";
 import type { DriveRef } from "../../models/DriveRef.ts";
 import type { GraphOperation } from "../../models/GraphOperation.ts";
 import type { WorkbookRef } from "../../models/WorkbookRef.ts";
-/** Create a new blank workbook. @see https://learn.microsoft.com/en-us/graph/api/driveitem-put-content */
+/**
+ * Create a new blank workbook.
+ *
+ * @param parentRef - A reference to the parent drive or folder where the workbook will be created.
+ * @param itemPath - The path (including the filename) for the new workbook. Must end with `.xlsx`.
+ * @returns The newly created workbook, including its metadata and reference information.
+ * @throws InvalidArgumentError if the item path does not end with `.xlsx`.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-put-content
+ */
 export default function createWorkbook(parentRef: DriveRef | DriveItemRef, itemPath: DriveItemPath): GraphOperation<DriveItem & WorkbookRef>;
 //# sourceMappingURL=createWorkbook.d.ts.map

package/dist/operations/workbook/createWorkbook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createWorkbook.d.ts","sourceRoot":"","sources":["../../../src/operations/workbook/createWorkbook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAIlE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI/D,0GAA0G;AAC1G,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,EAAE,QAAQ,EAAE,aAAa,GAAG,cAAc,CAAC,SAAS,GAAG,WAAW,CAAC,CAyB3I"}
+{"version":3,"file":"createWorkbook.d.ts","sourceRoot":"","sources":["../../../src/operations/workbook/createWorkbook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAIlE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI/D;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,EAAE,QAAQ,EAAE,aAAa,GAAG,cAAc,CAAC,SAAS,GAAG,WAAW,CAAC,CAyB3I"}

package/dist/operations/workbook/createWorkbook.js

@@ -2,7 +2,15 @@ import InvalidArgumentError from "../../errors/InvalidArgumentError.js";
 import { operation } from "../../graphApi.js";
 import { createDriveItemRef, workbookFileExtension } from "../../services/driveItem.js";
 import { generatePath } from "../../services/templatedPaths.js";
-/** Create a new blank workbook. @see https://learn.microsoft.com/en-us/graph/api/driveitem-put-content */
+/**
+ * Create a new blank workbook.
+ *
+ * @param parentRef - A reference to the parent drive or folder where the workbook will be created.
+ * @param itemPath - The path (including the filename) for the new workbook. Must end with `.xlsx`.
+ * @returns The newly created workbook, including its metadata and reference information.
+ * @throws InvalidArgumentError if the item path does not end with `.xlsx`.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-put-content
+ */
 export default function createWorkbook(parentRef, itemPath) {
     if (!itemPath.endsWith(`.${workbookFileExtension}`)) {
         throw new InvalidArgumentError(`Item path must end with '.${workbookFileExtension}'`);

package/dist/operations/workbook/createWorkbook.test.js

@@ -2,7 +2,7 @@ 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 deleteDriveItemWithRetry from "../../tasks/deleteDriveItemWithRetry.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
 import createWorkbook from "./createWorkbook.js";
 describe("createWorkbook", () => {
     it("can create a new workbook", async () => {
@@ -10,6 +10,6 @@ describe("createWorkbook", () => {
         const workbookPath = driveItemPath(workbookName);
         const workbook = await createWorkbook(getDefaultDriveRef(), workbookPath);
         expect(workbook.name).toBe(workbookName);
-        await deleteDriveItemWithRetry(workbook);
+        await tryDeleteDriveItem(workbook);
     });
 });

package/dist/operations/workbook/deleteWorkbook.d.ts

@@ -1,5 +1,11 @@
 import type { GraphOperation } from "../../models/GraphOperation.ts";
 import type { WorkbookRef } from "../../models/WorkbookRef.ts";
-/** Delete a workbook. @see https://learn.microsoft.com/en-us/graph/api/driveitem-delete */
+/**
+ * Delete a workbook.
+ *
+ * @param workbookRef - A reference to the workbook to be deleted.
+ * @returns Nothing.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-delete
+ */
 export default function deleteWorkbook(workbookRef: WorkbookRef): GraphOperation<void>;
 //# sourceMappingURL=deleteWorkbook.d.ts.map

package/dist/operations/workbook/deleteWorkbook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deleteWorkbook.d.ts","sourceRoot":"","sources":["../../../src/operations/workbook/deleteWorkbook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG/D,2FAA2F;AAC3F,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,CAErF"}
+{"version":3,"file":"deleteWorkbook.d.ts","sourceRoot":"","sources":["../../../src/operations/workbook/deleteWorkbook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG/D;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,CAErF"}

package/dist/operations/workbook/deleteWorkbook.js

@@ -1,5 +1,11 @@
 import deleteDriveItem from "../driveItem/deleteDriveItem.js";
-/** Delete a workbook. @see https://learn.microsoft.com/en-us/graph/api/driveitem-delete */
+/**
+ * Delete a workbook.
+ *
+ * @param workbookRef - A reference to the workbook to be deleted.
+ * @returns Nothing.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-delete
+ */
 export default function deleteWorkbook(workbookRef) {
     return deleteDriveItem(workbookRef);
 }

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

@@ -1,5 +1,12 @@
 import type { GraphOperation } from "../../models/GraphOperation.ts";
 import type { WorkbookRangeRef } from "../../models/WorkbookRangeRef.ts";
-/** Clear a range - content, formatting or both. @see https://learn.microsoft.com/en-us/graph/api/range-delete */
+/**
+ * Clear a range - content, formatting, or both.
+ *
+ * @param rangeRef - A reference to the range to be cleared, optionally including session information.
+ * @param applyTo - Specifies what to clear. Can be "All", "Formats", or "Contents". Defaults to "All".
+ * @returns Nothing.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-delete
+ */
 export default function clearWorkbookRange(rangeRef: WorkbookRangeRef, applyTo?: "All" | "Formats" | "Contents"): GraphOperation<void>;
 //# sourceMappingURL=clearWorkbookRange.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"clearWorkbookRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookRange/clearWorkbookRange.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,iHAAiH;AACjH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,GAAE,KAAK,GAAG,SAAS,GAAG,UAAkB,GAAG,cAAc,CAAC,IAAI,CAAC,CAc5I"}
+{"version":3,"file":"clearWorkbookRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookRange/clearWorkbookRange.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,GAAE,KAAK,GAAG,SAAS,GAAG,UAAkB,GAAG,cAAc,CAAC,IAAI,CAAC,CAc5I"}

package/dist/operations/workbookRange/clearWorkbookRange.js

@@ -1,6 +1,13 @@
 import { operation } from "../../graphApi.js";
 import { generatePath } from "../../services/templatedPaths.js";
-/** Clear a range - content, formatting or both. @see https://learn.microsoft.com/en-us/graph/api/range-delete */
+/**
+ * Clear a range - content, formatting, or both.
+ *
+ * @param rangeRef - A reference to the range to be cleared, optionally including session information.
+ * @param applyTo - Specifies what to clear. Can be "All", "Formats", or "Contents". Defaults to "All".
+ * @returns Nothing.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-delete
+ */
 export default function clearWorkbookRange(rangeRef, applyTo = "All") {
     return operation({
         contextId: rangeRef.contextId,

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

@@ -5,7 +5,7 @@ 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 tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
 import calculateWorkbook from "../workbook/calculateWorkbook.js";
 import createWorkbook from "../workbook/createWorkbook.js";
 import clearWorkbookRange from "./clearWorkbookRange.js";
@@ -37,7 +37,7 @@ describe("clearWorkbookRange", () => {
             expect(clearedRange.values).toEqual(clearedValues);
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
     it("can clear a range in an existing workbook sequential", async () => {
@@ -54,7 +54,7 @@ describe("clearWorkbookRange", () => {
             expect(clearedRange.values).toEqual(clearedValues);
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
 });

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

@@ -1,5 +1,12 @@
 import type { GraphOperation } from "../../models/GraphOperation.ts";
 import type { WorkbookRangeRef } from "../../models/WorkbookRangeRef.ts";
-/** Delete a range. @see https://learn.microsoft.com/en-us/graph/api/range-clear */
+/**
+ * Delete a range.
+ *
+ * @param rangeRef - A reference to the range to be deleted, optionally including session information.
+ * @param shift - The direction to shift existing cells after deletion. Can be "Up" or "Left".
+ * @returns Nothing.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-clear
+ */
 export default function deleteWorkbookRange(rangeRef: WorkbookRangeRef, shift: "Up" | "Left"): GraphOperation<void>;
 //# sourceMappingURL=deleteWorkbookRange.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"deleteWorkbookRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookRange/deleteWorkbookRange.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,mFAAmF;AACnF,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAclH"}
+{"version":3,"file":"deleteWorkbookRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookRange/deleteWorkbookRange.ts"],"names":[],"mappings":"AACA,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,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAclH"}

package/dist/operations/workbookRange/deleteWorkbookRange.js

@@ -1,6 +1,13 @@
 import { operation } from "../../graphApi.js";
 import { generatePath } from "../../services/templatedPaths.js";
-/** Delete a range. @see https://learn.microsoft.com/en-us/graph/api/range-clear */
+/**
+ * Delete a range.
+ *
+ * @param rangeRef - A reference to the range to be deleted, optionally including session information.
+ * @param shift - The direction to shift existing cells after deletion. Can be "Up" or "Left".
+ * @returns Nothing.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-clear
+ */
 export default function deleteWorkbookRange(rangeRef, shift) {
     return operation({
         contextId: rangeRef.contextId,

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

@@ -5,7 +5,7 @@ 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 tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
 import calculateWorkbook from "../workbook/calculateWorkbook.js";
 import createWorkbook from "../workbook/createWorkbook.js";
 import deleteWorkbookRange from "./deleteWorkbookRange.js";
@@ -37,7 +37,7 @@ describe("deleteWorkbookRange", () => {
             expect(deletedRange.values).toEqual(clearedValues);
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
     it("can delete a range in an existing workbook sequential", async () => {
@@ -58,7 +58,7 @@ describe("deleteWorkbookRange", () => {
             expect(deletedRange.values).toEqual(clearedValues);
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
 });

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

@@ -1,6 +1,12 @@
 import type { WorkbookRange } from "@microsoft/microsoft-graph-types";
 import type { GraphOperation } from "../../models/GraphOperation.ts";
 import type { WorkbookNamedRangeRef } from "../../models/WorkbookNamedRangeRef.ts";
-/** Retrieve range that has been defined using the "named range" functionality. @see https://learn.microsoft.com/en-us/graph/api/range-get */
+/**
+ * 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: WorkbookNamedRangeRef): GraphOperation<WorkbookRange & WorkbookNamedRangeRef>;
 //# sourceMappingURL=getWorkbookNamedRange.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getWorkbookNamedRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookRange/getWorkbookNamedRange.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,6IAA6I;AAC7I,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,cAAc,CAAC,aAAa,GAAG,qBAAqB,CAAC,CAiBpI"}
+{"version":3,"file":"getWorkbookNamedRange.d.ts","sourceRoot":"","sources":["../../../src/operations/workbookRange/getWorkbookNamedRange.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;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,cAAc,CAAC,aAAa,GAAG,qBAAqB,CAAC,CAiBpI"}

package/dist/operations/workbookRange/getWorkbookNamedRange.js

@@ -1,6 +1,12 @@
 import { operation } from "../../graphApi.js";
 import { generatePath } from "../../services/templatedPaths.js";
-/** Retrieve range that has been defined using the "named range" functionality. @see https://learn.microsoft.com/en-us/graph/api/range-get */
+/**
+ * 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,

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

@@ -1,6 +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. @see https://learn.microsoft.com/en-us/graph/api/rangeformat-get */
+/**
+ * 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/operations/workbookRange/getWorkbookRangeFormat.d.ts.map

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

@@ -1,6 +1,12 @@
 import { operation } from "../../graphApi.js";
 import { generatePath } from "../../services/templatedPaths.js";
-/** Retrieve the format of a workbook range. @see https://learn.microsoft.com/en-us/graph/api/rangeformat-get */
+/**
+ * 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,

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

@@ -4,7 +4,7 @@ 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 tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
 import createWorkbook from "../workbook/createWorkbook.js";
 import getWorkbookRangeFormat from "./getWorkbookRangeFormat.js";
 import updateWorkbookRange from "./updateWorkbookRange.js";
@@ -27,7 +27,7 @@ describe("getWorkbookRangeFormat", () => {
             expect(format.verticalAlignment).toBe("Bottom");
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
 });

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

@@ -2,6 +2,8 @@ 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";
-/** Retrieve the used range in a worksheet, ignoring trailing rows and columns that are blank. @see https://learn.microsoft.com/en-us/graph/api/range-usedrange */
+/**
+ * @deprecated Use `getWorkbookWorksheetUsedRange` instead.
+ */
 export default function getWorkbookUsedRange(worksheetRef: WorkbookWorksheetRef): GraphOperation<WorkbookRange & WorkbookRangeRef>;
 //# sourceMappingURL=getWorkbookUsedRange.d.ts.map

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;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"}
+{"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/operations/workbookRange/getWorkbookUsedRange.js

@@ -2,7 +2,9 @@ import ProtocolError from "../../errors/ProtocolError.js";
 import { operation } from "../../graphApi.js";
 import { generatePath } from "../../services/templatedPaths.js";
 import { createWorkbookRangeRef } from "../../services/workbookRange.js";
-/** Retrieve the used range in a worksheet, ignoring trailing rows and columns that are blank. @see https://learn.microsoft.com/en-us/graph/api/range-usedrange */
+/**
+ * @deprecated Use `getWorkbookWorksheetUsedRange` instead.
+ */
 export default function getWorkbookUsedRange(worksheetRef) {
     return operation({
         contextId: worksheetRef.contextId,

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

@@ -1,6 +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. @see https://learn.microsoft.com/en-us/graph/api/workbookrange-visibleview */
+/**
+ * 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/operations/workbookRange/getWorkbookVisibleRange.d.ts.map

@@ -1 +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,uHAAuH;AACvH,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,iBAAiB,GAAG,gBAAgB,CAAC,CAmBhI"}
+{"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/operations/workbookRange/getWorkbookVisibleRange.js

@@ -1,6 +1,12 @@
 import { operation } from "../../graphApi.js";
 import { generatePath } from "../../services/templatedPaths.js";
-/** Retrieve the visible view of a range. @see https://learn.microsoft.com/en-us/graph/api/workbookrange-visibleview */
+/**
+ * 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({

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

@@ -5,7 +5,7 @@ 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 tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
 import calculateWorkbook from "../workbook/calculateWorkbook.js";
 import createWorkbook from "../workbook/createWorkbook.js";
 import getWorkbookVisibleRange from "./getWorkbookVisibleRange.js";
@@ -29,7 +29,7 @@ describe("getWorkbookRangeVisible", () => {
             expect(visibleView).toBeDefined();
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
     it("can retrieve the visible view of a range in an existing workbook sequential", async () => {
@@ -44,7 +44,7 @@ describe("getWorkbookRangeVisible", () => {
             expect(visibleView).toBeDefined();
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
     it("omits hidden row from the visible view of a range", async () => {
@@ -75,7 +75,7 @@ describe("getWorkbookRangeVisible", () => {
             ]);
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
     it("omits hidden column from the visible view of a range", async () => {
@@ -103,7 +103,7 @@ describe("getWorkbookRangeVisible", () => {
             ]);
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
 });

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

@@ -1,6 +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. @see https://learn.microsoft.com/en-us/graph/api/range-get */
+/**
+ * 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/operations/workbookRange/getWorkbookWorksheetRange.d.ts.map

@@ -1 +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"}
+{"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/operations/workbookRange/getWorkbookWorksheetRange.js

@@ -1,6 +1,12 @@
 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 */
+/**
+ * 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,

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

@@ -4,7 +4,7 @@ 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 tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
 import createWorkbook from "../workbook/createWorkbook.js";
 import updateWorkbookRange from "./updateWorkbookRange.js";
 const values = [
@@ -26,7 +26,7 @@ describe("getWorkbookRange", () => {
             expect(range.values).toEqual(values);
         }
         finally {
-            await deleteDriveItemWithRetry(workbook);
+            await tryDeleteDriveItem(workbook);
         }
     });
 });

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

@@ -3,6 +3,14 @@ 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 `updateRange` after to set content. @see https://learn.microsoft.com/en-us/graph/api/range-insert */
+/**
+ * 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