microsoft-graph 3.4.6 → 3.6.0

package/dist/cjs/services/error.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Utilities for handling errors
+ * @module error
+ * @category Services
+ */
+/**
+ * Determines if the error has a specific name.
+ * @param error Error to check.
+ * @param name Name to compare against.
+ * @returns True if the error has the specified name, false otherwise.
+ */
+export declare function isErrorWithName(error: unknown, name: string): boolean;
+//# sourceMappingURL=error.d.ts.map

package/dist/cjs/services/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/services/error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAErE"}

package/dist/cjs/services/error.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Utilities for handling errors
+ * @module error
+ * @category Services
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isErrorWithName = isErrorWithName;
+/**
+ * Determines if the error has a specific name.
+ * @param error Error to check.
+ * @param name Name to compare against.
+ * @returns True if the error has the specified name, false otherwise.
+ */
+function isErrorWithName(error, name) {
+    return !!error && typeof error === "object" && "name" in error && error.name === name;
+}

package/dist/cjs/tasks/tryGetDriveItemByPath.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Attempts to retrieve the metadata for an item in a drive by file path, returning null if the item does not exist.
+ * @module tryGetDriveItemByPath
+ * @category Tasks
+ */
+import type { DriveItem } from "@microsoft/microsoft-graph-types";
+import type { DriveRef } from "../models/Drive.ts";
+import type { DriveItemPath, DriveItemRef } from "../models/DriveItem.ts";
+/**
+ * Attempts to retrieve the metadata for an item in a drive by file path.
+ * Returns null if the item does not exist (NotFoundError).
+ * @param driveRef Reference to the drive containing the item.
+ * @param itemPath Path of the item within the drive.
+ * @returns The metadata of the specified drive item, or null if not found.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-get
+ */
+export default function tryGetDriveItemByPath(driveRef: DriveRef, itemPath: DriveItemPath): Promise<(DriveItem & DriveItemRef) | null>;
+//# sourceMappingURL=tryGetDriveItemByPath.d.ts.map

package/dist/cjs/tasks/tryGetDriveItemByPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tryGetDriveItemByPath.d.ts","sourceRoot":"","sources":["../../../src/tasks/tryGetDriveItemByPath.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI1E;;;;;;;GAOG;AACH,wBAA8B,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,SAAS,GAAG,YAAY,CAAC,GAAG,IAAI,CAAC,CAS3I"}

package/dist/cjs/tasks/tryGetDriveItemByPath.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = tryGetDriveItemByPath;
+const getDriveItemByPath_ts_1 = __importDefault(require("../operations/driveItem/getDriveItemByPath.js"));
+const error_ts_1 = require("../services/error.js");
+/**
+ * Attempts to retrieve the metadata for an item in a drive by file path.
+ * Returns null if the item does not exist (NotFoundError).
+ * @param driveRef Reference to the drive containing the item.
+ * @param itemPath Path of the item within the drive.
+ * @returns The metadata of the specified drive item, or null if not found.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-get
+ */
+async function tryGetDriveItemByPath(driveRef, itemPath) {
+    try {
+        return await (0, getDriveItemByPath_ts_1.default)(driveRef, itemPath);
+    }
+    catch (error) {
+        if ((0, error_ts_1.isErrorWithName)(error, "NotFoundError")) {
+            return null;
+        }
+        throw error;
+    }
+}

package/dist/cjs/tasks/tryGetWorkbookWorksheetUsedRangeRef.d.ts

@@ -0,0 +1,4 @@
+import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
+import type { WorkbookWorksheetRef } from "../models/WorkbookWorksheet.ts";
+export default function tryGetWorkbookWorksheetUsedRangeRef(worksheetRef: WorkbookWorksheetRef): Promise<WorkbookRangeRef | null>;
+//# sourceMappingURL=tryGetWorkbookWorksheetUsedRangeRef.d.ts.map

package/dist/cjs/tasks/tryGetWorkbookWorksheetUsedRangeRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tryGetWorkbookWorksheetUsedRangeRef.d.ts","sourceRoot":"","sources":["../../../src/tasks/tryGetWorkbookWorksheetUsedRangeRef.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAI3E,wBAA8B,mCAAmC,CAAC,YAAY,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAStI"}

package/dist/cjs/tasks/tryGetWorkbookWorksheetUsedRangeRef.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = tryGetWorkbookWorksheetUsedRangeRef;
+const getWorkbookWorksheetUsedRangeRef_ts_1 = __importDefault(require("../operations/workbookWorksheet/getWorkbookWorksheetUsedRangeRef.js"));
+const error_ts_1 = require("../services/error.js");
+async function tryGetWorkbookWorksheetUsedRangeRef(worksheetRef) {
+    try {
+        return await (0, getWorkbookWorksheetUsedRangeRef_ts_1.default)(worksheetRef);
+    }
+    catch (error) {
+        if ((0, error_ts_1.isErrorWithName)(error, "NotFoundError")) {
+            return null;
+        }
+        throw error;
+    }
+}

package/dist/esm/services/error.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Utilities for handling errors
+ * @module error
+ * @category Services
+ */
+/**
+ * Determines if the error has a specific name.
+ * @param error Error to check.
+ * @param name Name to compare against.
+ * @returns True if the error has the specified name, false otherwise.
+ */
+export declare function isErrorWithName(error: unknown, name: string): boolean;
+//# sourceMappingURL=error.d.ts.map

package/dist/esm/services/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/services/error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAErE"}

package/dist/esm/services/error.js

@@ -0,0 +1,14 @@
+/**
+ * Utilities for handling errors
+ * @module error
+ * @category Services
+ */
+/**
+ * Determines if the error has a specific name.
+ * @param error Error to check.
+ * @param name Name to compare against.
+ * @returns True if the error has the specified name, false otherwise.
+ */
+export function isErrorWithName(error, name) {
+    return !!error && typeof error === "object" && "name" in error && error.name === name;
+}

package/dist/esm/tasks/tryGetDriveItemByPath.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Attempts to retrieve the metadata for an item in a drive by file path, returning null if the item does not exist.
+ * @module tryGetDriveItemByPath
+ * @category Tasks
+ */
+import type { DriveItem } from "@microsoft/microsoft-graph-types";
+import type { DriveRef } from "../models/Drive.ts";
+import type { DriveItemPath, DriveItemRef } from "../models/DriveItem.ts";
+/**
+ * Attempts to retrieve the metadata for an item in a drive by file path.
+ * Returns null if the item does not exist (NotFoundError).
+ * @param driveRef Reference to the drive containing the item.
+ * @param itemPath Path of the item within the drive.
+ * @returns The metadata of the specified drive item, or null if not found.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-get
+ */
+export default function tryGetDriveItemByPath(driveRef: DriveRef, itemPath: DriveItemPath): Promise<(DriveItem & DriveItemRef) | null>;
+//# sourceMappingURL=tryGetDriveItemByPath.d.ts.map

package/dist/esm/tasks/tryGetDriveItemByPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tryGetDriveItemByPath.d.ts","sourceRoot":"","sources":["../../../src/tasks/tryGetDriveItemByPath.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI1E;;;;;;;GAOG;AACH,wBAA8B,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,SAAS,GAAG,YAAY,CAAC,GAAG,IAAI,CAAC,CAS3I"}

package/dist/esm/tasks/tryGetDriveItemByPath.js

@@ -0,0 +1,21 @@
+import getDriveItemByPath from "../operations/driveItem/getDriveItemByPath.js";
+import { isErrorWithName } from "../services/error.js";
+/**
+ * Attempts to retrieve the metadata for an item in a drive by file path.
+ * Returns null if the item does not exist (NotFoundError).
+ * @param driveRef Reference to the drive containing the item.
+ * @param itemPath Path of the item within the drive.
+ * @returns The metadata of the specified drive item, or null if not found.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-get
+ */
+export default async function tryGetDriveItemByPath(driveRef, itemPath) {
+    try {
+        return await getDriveItemByPath(driveRef, itemPath);
+    }
+    catch (error) {
+        if (isErrorWithName(error, "NotFoundError")) {
+            return null;
+        }
+        throw error;
+    }
+}

package/dist/esm/tasks/tryGetWorkbookWorksheetUsedRangeRef.d.ts

@@ -0,0 +1,4 @@
+import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
+import type { WorkbookWorksheetRef } from "../models/WorkbookWorksheet.ts";
+export default function tryGetWorkbookWorksheetUsedRangeRef(worksheetRef: WorkbookWorksheetRef): Promise<WorkbookRangeRef | null>;
+//# sourceMappingURL=tryGetWorkbookWorksheetUsedRangeRef.d.ts.map

package/dist/esm/tasks/tryGetWorkbookWorksheetUsedRangeRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tryGetWorkbookWorksheetUsedRangeRef.d.ts","sourceRoot":"","sources":["../../../src/tasks/tryGetWorkbookWorksheetUsedRangeRef.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAI3E,wBAA8B,mCAAmC,CAAC,YAAY,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAStI"}

package/dist/esm/tasks/tryGetWorkbookWorksheetUsedRangeRef.js

@@ -0,0 +1,13 @@
+import getWorkbookWorksheetUsedRangeRef from "../operations/workbookWorksheet/getWorkbookWorksheetUsedRangeRef.js";
+import { isErrorWithName } from "../services/error.js";
+export default async function tryGetWorkbookWorksheetUsedRangeRef(worksheetRef) {
+    try {
+        return await getWorkbookWorksheetUsedRangeRef(worksheetRef);
+    }
+    catch (error) {
+        if (isErrorWithName(error, "NotFoundError")) {
+            return null;
+        }
+        throw error;
+    }
+}

package/docs/api/README.md

@@ -145,6 +145,7 @@
 | ------ | ------ |
 | [services/sharepointUrl](services/sharepointUrl.md) | - |
 | [tasks/getSiteByUrl](tasks/getSiteByUrl.md) | - |
+| [tasks/tryGetWorkbookWorksheetUsedRangeRef](tasks/tryGetWorkbookWorksheetUsedRangeRef.md) | - |
 
 ## Services
 
@@ -160,6 +161,7 @@
 | [drive](drive.md) | Utilities for working with Microsoft Graph Drive references and operations. |
 | [driveItem](driveItem.md) | Utilities for working with Microsoft Graph Drive Items (files and folders). |
 | [environmentVariable](environmentVariable.md) | Utilities for accessing environment variables with error handling and fallbacks. |
+| [error](error.md) | Utilities for handling errors |
 | [http](http.md) | HTTP request utilities for Microsoft Graph API, with proxy support. |
 | [httpStatus](httpStatus.md) | Utilities for analyzing HTTP status codes for Microsoft Graph API responses. |
 | [Iteration](Iteration.md) | Utilities for iterating over AsyncIterables. |
@@ -202,6 +204,7 @@
 | [setWorkbookTableBodyVisibleRows](setWorkbookTableBodyVisibleRows.md) | Set visible rows of a workbook table with the provided 2D array of values, ignoring hidden rows and inserting new rows at the end if needed. |
 | [tryCloseWorkbookSession](tryCloseWorkbookSession.md) | Try and close a workbook session. |
 | [tryDeleteDriveItem](tryDeleteDriveItem.md) | Attempts to delete a drive item, returning success status. |
+| [tryGetDriveItemByPath](tryGetDriveItemByPath.md) | Attempts to retrieve the metadata for an item in a drive by file path, returning null if the item does not exist. |
 | [updateWorkbookRangeFirstRow](updateWorkbookRangeFirstRow.md) | Update first row in a given workbook range. |
 | [updateWorkbookRangeRows](updateWorkbookRangeRows.md) | Update rows in a given workbook range. |
 | [writeWorkbookRows](writeWorkbookRows.md) | Write rows to a workbook range. |

package/docs/api/error.md

@@ -0,0 +1,28 @@
+[Microsoft Graph SDK](README.md) / error
+
+# error
+
+Utilities for handling errors
+
+## Functions
+
+### isErrorWithName()
+
+> **isErrorWithName**(`error`, `name`): `boolean`
+
+Defined in: [src/services/error.ts:13](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/error.ts#L13)
+
+Determines if the error has a specific name.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `error` | `unknown` | Error to check. |
+| `name` | `string` | Name to compare against. |
+
+#### Returns
+
+`boolean`
+
+True if the error has the specified name, false otherwise.

package/docs/api/tasks/tryGetWorkbookWorksheetUsedRangeRef.md

@@ -0,0 +1,21 @@
+[Microsoft Graph SDK](../README.md) / tasks/tryGetWorkbookWorksheetUsedRangeRef
+
+# tasks/tryGetWorkbookWorksheetUsedRangeRef
+
+## Functions
+
+### tryGetWorkbookWorksheetUsedRangeRef()
+
+> **tryGetWorkbookWorksheetUsedRangeRef**(`worksheetRef`): [`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`null` \| [`WorkbookRangeRef`](../WorkbookRange-1.md#workbookrangeref)\>
+
+Defined in: [src/tasks/tryGetWorkbookWorksheetUsedRangeRef.ts:6](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/tasks/tryGetWorkbookWorksheetUsedRangeRef.ts#L6)
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `worksheetRef` | [`WorkbookWorksheetRef`](../WorkbookWorksheet-1.md#workbookworksheetref) |
+
+#### Returns
+
+[`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`null` \| [`WorkbookRangeRef`](../WorkbookRange-1.md#workbookrangeref)\>

package/docs/api/tryGetDriveItemByPath.md

@@ -0,0 +1,33 @@
+[Microsoft Graph SDK](README.md) / tryGetDriveItemByPath
+
+# tryGetDriveItemByPath
+
+Attempts to retrieve the metadata for an item in a drive by file path, returning null if the item does not exist.
+
+## Functions
+
+### tryGetDriveItemByPath()
+
+> **tryGetDriveItemByPath**(`driveRef`, `itemPath`): [`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`null` \| `DriveItem` & [`SiteRef`](Site-1.md#siteref) & `object` & `object`\>
+
+Defined in: [src/tasks/tryGetDriveItemByPath.ts:20](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/tasks/tryGetDriveItemByPath.ts#L20)
+
+Attempts to retrieve the metadata for an item in a drive by file path.
+Returns null if the item does not exist (NotFoundError).
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `driveRef` | [`DriveRef`](Drive-1.md#driveref) | Reference to the drive containing the item. |
+| `itemPath` | [`DriveItemPath`](DriveItem-1.md#driveitempath) | Path of the item within the drive. |
+
+#### Returns
+
+[`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`null` \| `DriveItem` & [`SiteRef`](Site-1.md#siteref) & `object` & `object`\>
+
+The metadata of the specified drive item, or null if not found.
+
+#### See
+
+https://learn.microsoft.com/en-us/graph/api/driveitem-get

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "microsoft-graph",
-	"version": "3.4.6",
+	"version": "3.6.0",
 	"description": "Microsoft GraphAPI SDK for NodeJS",
 	"main": "./dist/cjs/index.js",
 	"module": "./dist/esm/index.js",
@@ -1417,6 +1417,16 @@
 			"require": "./dist/cjs/services/environmentVariable.js",
 			"types": "./dist/esm/services/environmentVariable.d.ts"
 		},
+		"./error": {
+			"import": "./dist/esm/services/error.js",
+			"require": "./dist/cjs/services/error.js",
+			"types": "./dist/esm/services/error.d.ts"
+		},
+		"./dist/cjs/services/error": {
+			"import": "./dist/esm/services/error.js",
+			"require": "./dist/cjs/services/error.js",
+			"types": "./dist/esm/services/error.d.ts"
+		},
 		"./http": {
 			"import": "./dist/esm/services/http.js",
 			"require": "./dist/cjs/services/http.js",
@@ -1872,6 +1882,26 @@
 			"require": "./dist/cjs/tasks/tryDeleteDriveItem.js",
 			"types": "./dist/esm/tasks/tryDeleteDriveItem.d.ts"
 		},
+		"./tryGetDriveItemByPath": {
+			"import": "./dist/esm/tasks/tryGetDriveItemByPath.js",
+			"require": "./dist/cjs/tasks/tryGetDriveItemByPath.js",
+			"types": "./dist/esm/tasks/tryGetDriveItemByPath.d.ts"
+		},
+		"./dist/cjs/tasks/tryGetDriveItemByPath": {
+			"import": "./dist/esm/tasks/tryGetDriveItemByPath.js",
+			"require": "./dist/cjs/tasks/tryGetDriveItemByPath.js",
+			"types": "./dist/esm/tasks/tryGetDriveItemByPath.d.ts"
+		},
+		"./tryGetWorkbookWorksheetUsedRangeRef": {
+			"import": "./dist/esm/tasks/tryGetWorkbookWorksheetUsedRangeRef.js",
+			"require": "./dist/cjs/tasks/tryGetWorkbookWorksheetUsedRangeRef.js",
+			"types": "./dist/esm/tasks/tryGetWorkbookWorksheetUsedRangeRef.d.ts"
+		},
+		"./dist/cjs/tasks/tryGetWorkbookWorksheetUsedRangeRef": {
+			"import": "./dist/esm/tasks/tryGetWorkbookWorksheetUsedRangeRef.js",
+			"require": "./dist/cjs/tasks/tryGetWorkbookWorksheetUsedRangeRef.js",
+			"types": "./dist/esm/tasks/tryGetWorkbookWorksheetUsedRangeRef.d.ts"
+		},
 		"./updateWorkbookRangeFirstRow": {
 			"import": "./dist/esm/tasks/updateWorkbookRangeFirstRow.js",
 			"require": "./dist/cjs/tasks/updateWorkbookRangeFirstRow.js",