microsoft-graph 3.1.1 → 3.2.0

package/SECURITY.md

@@ -6,4 +6,4 @@ Only the latest version is supported.
 
 ## Reporting a Vulnerability
 
-To report a vunerability raise a [GitHub Issue](https://github.com/Future-Secure-AI/microsoft-graph/issues).
+To report a vulnerability raise a [GitHub Issue](https://github.com/Future-Secure-AI/microsoft-graph/issues).

package/dist/cjs/models/Drive.d.ts

@@ -16,4 +16,10 @@ export type DriveId = string & {
 export type DriveRef = SiteRef & {
     driveId: DriveId;
 };
+/**
+ * Name of a drive.
+ */
+export type DriveName = string & {
+    __brand: "DriveName";
+};
 //# sourceMappingURL=Drive.d.ts.map

package/dist/cjs/models/Drive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Drive.d.ts","sourceRoot":"","sources":["../../../src/models/Drive.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAC9B,OAAO,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG;IAChC,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC"}
+{"version":3,"file":"Drive.d.ts","sourceRoot":"","sources":["../../../src/models/Drive.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAC9B,OAAO,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG;IAChC,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAChC,OAAO,EAAE,WAAW,CAAC;CACrB,CAAC"}

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

@@ -3,18 +3,21 @@
  * @module sharepointUrl
  * @category Services
  */
+import type { DriveName } from "../models/Drive.ts";
 import type { DriveItemId } from "../models/DriveItem.ts";
 import type { HostName } from "../models/HostName.ts";
 import type { SiteName } from "../models/Site.ts";
+export type SharepointUrlComponents = {
+    hostName: HostName | null;
+    siteName: SiteName | null;
+    driveName: DriveName | null;
+    itemId: DriveItemId | null;
+};
 /**
- * Parses a SharePoint document URL to extract the site name, host name, and item ID.
- * @param url - The SharePoint document URL.
- * @returns An object containing the host name, site name, and item ID.
+ * Parses a SharePoint document URL string to extract the site name, host name, drive name and item ID if present.
+ * @param urlString SharePoint URL as a string.
+ * @returns An object containing the host name, site name, drive name (if present), and item ID (if present).
  * @throws InvalidArgumentError if the URL is invalid or required components are missing.
  */
-export declare function parseSharepointUrl(url: URL): {
-    hostName: HostName;
-    siteName: SiteName;
-    itemId: DriveItemId;
-};
+export declare function parseSharepointUrl(urlString: string): SharepointUrlComponents;
 //# sourceMappingURL=sharepointUrl.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sharepointUrl.d.ts","sourceRoot":"","sources":["../../../src/services/sharepointUrl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAyB5G"}
+{"version":3,"file":"sharepointUrl.d.ts","sourceRoot":"","sources":["../../../src/services/sharepointUrl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,MAAM,uBAAuB,GAAG;IACrC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,uBAAuB,CAiD7E"}

package/dist/cjs/services/sharepointUrl.js

@@ -4,37 +4,57 @@
  * @module sharepointUrl
  * @category Services
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseSharepointUrl = parseSharepointUrl;
-const InvalidArgumentError_ts_1 = __importDefault(require("../errors/InvalidArgumentError.js"));
 /**
- * Parses a SharePoint document URL to extract the site name, host name, and item ID.
- * @param url - The SharePoint document URL.
- * @returns An object containing the host name, site name, and item ID.
+ * Parses a SharePoint document URL string to extract the site name, host name, drive name and item ID if present.
+ * @param urlString SharePoint URL as a string.
+ * @returns An object containing the host name, site name, drive name (if present), and item ID (if present).
  * @throws InvalidArgumentError if the URL is invalid or required components are missing.
  */
-function parseSharepointUrl(url) {
+function parseSharepointUrl(urlString) {
+    let url;
+    let hostName = null;
+    let siteName = null;
+    let driveName = null;
+    let itemId = null;
+    try {
+        url = new URL(urlString);
+    }
+    catch {
+        return {
+            hostName: null,
+            siteName: null,
+            driveName: null,
+            itemId: null,
+        };
+    }
     if (!url.hostname.endsWith(".sharepoint.com")) {
-        throw new InvalidArgumentError_ts_1.default("Invalid SharePoint URL. Hostname must end with '.sharepoint.com'.");
+        return {
+            hostName: null,
+            siteName: null,
+            driveName: null,
+            itemId: null,
+        };
     }
-    const hostName = url.hostname;
-    const pathSegments = url.pathname.split("/");
-    const siteNameIndex = pathSegments.indexOf("sites") + 1;
-    if (siteNameIndex <= 0 || !pathSegments[siteNameIndex]) {
-        throw new InvalidArgumentError_ts_1.default("Invalid SharePoint URL. Site name not found.");
+    hostName = url.hostname;
+    const pathSegments = url.pathname.split("/").filter(Boolean);
+    const sitesIdx = pathSegments.findIndex((seg) => seg.toLowerCase() === "sites");
+    if (sitesIdx !== -1 && pathSegments[sitesIdx + 1]) {
+        siteName = pathSegments[sitesIdx + 1];
+        const afterSite = pathSegments[sitesIdx + 2];
+        if (afterSite && afterSite.toLowerCase() !== "_layouts" && afterSite.toLowerCase() !== "forms") {
+            driveName = afterSite;
+        }
     }
-    const siteName = pathSegments[siteNameIndex];
     const sourcedoc = url.searchParams.get("sourcedoc");
-    if (!sourcedoc) {
-        throw new InvalidArgumentError_ts_1.default("Invalid SharePoint URL. Path not found in parameters.");
+    if (sourcedoc) {
+        itemId = decodeURIComponent(sourcedoc.replace(/[{}]/g, "")).toUpperCase();
     }
-    const itemId = sourcedoc.replace(/[{}]/g, "").toLocaleUpperCase();
     return {
         hostName,
         siteName,
+        driveName,
         itemId,
     };
 }

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

@@ -0,0 +1,20 @@
+/**
+ * Retrieves a Drive from a SharePoint URL.
+ * @module getDriveFromUrl
+ * @category Tasks
+ */
+import type { Drive } from "@microsoft/microsoft-graph-types";
+import type { ContextRef } from "../models/Context.ts";
+import type { DriveRef } from "../models/Drive.ts";
+/**
+ * Retrieves a Drive from a SharePoint URL.
+ *
+ * Parses the given SharePoint URL to extract the host, site, and drive names, then locates and returns the corresponding Drive object.
+ *
+ * @param contextRef - The context reference containing authentication and environment information.
+ * @param url - The SharePoint URL pointing to the drive.
+ * @returns A Promise that resolves to the Drive object with additional DriveRef properties.
+ * @throws If the URL is invalid or the drive cannot be found.
+ */
+export default function getDriveFromUrl(contextRef: ContextRef, url: string): Promise<Drive & DriveRef>;
+//# sourceMappingURL=getDriveFromUrl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getDriveFromUrl.d.ts","sourceRoot":"","sources":["../../../src/tasks/getDriveFromUrl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAKnD;;;;;;;;;GASG;AACH,wBAA8B,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC,CA2B5G"}

package/dist/cjs/tasks/getDriveFromUrl.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Retrieves a Drive from a SharePoint URL.
+ * @module getDriveFromUrl
+ * @category Tasks
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = getDriveFromUrl;
+const getSiteByName_ts_1 = __importDefault(require("../operations/site/getSiteByName.js"));
+const sharepointUrl_ts_1 = require("../services/sharepointUrl.js");
+const iterateDrives_ts_1 = __importDefault(require("./iterateDrives.js"));
+/**
+ * Retrieves a Drive from a SharePoint URL.
+ *
+ * Parses the given SharePoint URL to extract the host, site, and drive names, then locates and returns the corresponding Drive object.
+ *
+ * @param contextRef - The context reference containing authentication and environment information.
+ * @param url - The SharePoint URL pointing to the drive.
+ * @returns A Promise that resolves to the Drive object with additional DriveRef properties.
+ * @throws If the URL is invalid or the drive cannot be found.
+ */
+async function getDriveFromUrl(contextRef, url) {
+    const { hostName, siteName, driveName } = (0, sharepointUrl_ts_1.parseSharepointUrl)(url);
+    if (!hostName) {
+        throw new Error("Invalid SharePoint URL: Host name is missing.");
+    }
+    if (!siteName) {
+        throw new Error("Invalid SharePoint URL: Site name is missing.");
+    }
+    if (!driveName) {
+        throw new Error("Invalid SharePoint URL: Drive name is missing.");
+    }
+    const site = await (0, getSiteByName_ts_1.default)(contextRef, hostName, siteName);
+    let drive = null;
+    for await (const d of (0, iterateDrives_ts_1.default)(site)) {
+        if (sanitizeUrlName(d.name ?? "") === driveName) {
+            drive = d;
+        }
+    }
+    if (!drive) {
+        throw new Error(`Drive "${driveName}" not found in site "${siteName}" on host "${hostName}".`);
+    }
+    return drive;
+}
+function sanitizeUrlName(name) {
+    return name.replace(/[^A-Za-z0-9\-_.~]/g, "");
+}

package/dist/esm/models/Drive.d.ts

@@ -16,4 +16,10 @@ export type DriveId = string & {
 export type DriveRef = SiteRef & {
     driveId: DriveId;
 };
+/**
+ * Name of a drive.
+ */
+export type DriveName = string & {
+    __brand: "DriveName";
+};
 //# sourceMappingURL=Drive.d.ts.map

package/dist/esm/models/Drive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Drive.d.ts","sourceRoot":"","sources":["../../../src/models/Drive.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAC9B,OAAO,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG;IAChC,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC"}
+{"version":3,"file":"Drive.d.ts","sourceRoot":"","sources":["../../../src/models/Drive.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAC9B,OAAO,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG;IAChC,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAChC,OAAO,EAAE,WAAW,CAAC;CACrB,CAAC"}

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

@@ -3,18 +3,21 @@
  * @module sharepointUrl
  * @category Services
  */
+import type { DriveName } from "../models/Drive.ts";
 import type { DriveItemId } from "../models/DriveItem.ts";
 import type { HostName } from "../models/HostName.ts";
 import type { SiteName } from "../models/Site.ts";
+export type SharepointUrlComponents = {
+    hostName: HostName | null;
+    siteName: SiteName | null;
+    driveName: DriveName | null;
+    itemId: DriveItemId | null;
+};
 /**
- * Parses a SharePoint document URL to extract the site name, host name, and item ID.
- * @param url - The SharePoint document URL.
- * @returns An object containing the host name, site name, and item ID.
+ * Parses a SharePoint document URL string to extract the site name, host name, drive name and item ID if present.
+ * @param urlString SharePoint URL as a string.
+ * @returns An object containing the host name, site name, drive name (if present), and item ID (if present).
  * @throws InvalidArgumentError if the URL is invalid or required components are missing.
  */
-export declare function parseSharepointUrl(url: URL): {
-    hostName: HostName;
-    siteName: SiteName;
-    itemId: DriveItemId;
-};
+export declare function parseSharepointUrl(urlString: string): SharepointUrlComponents;
 //# sourceMappingURL=sharepointUrl.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sharepointUrl.d.ts","sourceRoot":"","sources":["../../../src/services/sharepointUrl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAyB5G"}
+{"version":3,"file":"sharepointUrl.d.ts","sourceRoot":"","sources":["../../../src/services/sharepointUrl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,MAAM,uBAAuB,GAAG;IACrC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,uBAAuB,CAiD7E"}

package/dist/esm/services/sharepointUrl.js

@@ -3,32 +3,55 @@
  * @module sharepointUrl
  * @category Services
  */
-import InvalidArgumentError from "../errors/InvalidArgumentError.js";
 /**
- * Parses a SharePoint document URL to extract the site name, host name, and item ID.
- * @param url - The SharePoint document URL.
- * @returns An object containing the host name, site name, and item ID.
+ * Parses a SharePoint document URL string to extract the site name, host name, drive name and item ID if present.
+ * @param urlString SharePoint URL as a string.
+ * @returns An object containing the host name, site name, drive name (if present), and item ID (if present).
  * @throws InvalidArgumentError if the URL is invalid or required components are missing.
  */
-export function parseSharepointUrl(url) {
+export function parseSharepointUrl(urlString) {
+    let url;
+    let hostName = null;
+    let siteName = null;
+    let driveName = null;
+    let itemId = null;
+    try {
+        url = new URL(urlString);
+    }
+    catch {
+        return {
+            hostName: null,
+            siteName: null,
+            driveName: null,
+            itemId: null,
+        };
+    }
     if (!url.hostname.endsWith(".sharepoint.com")) {
-        throw new InvalidArgumentError("Invalid SharePoint URL. Hostname must end with '.sharepoint.com'.");
+        return {
+            hostName: null,
+            siteName: null,
+            driveName: null,
+            itemId: null,
+        };
     }
-    const hostName = url.hostname;
-    const pathSegments = url.pathname.split("/");
-    const siteNameIndex = pathSegments.indexOf("sites") + 1;
-    if (siteNameIndex <= 0 || !pathSegments[siteNameIndex]) {
-        throw new InvalidArgumentError("Invalid SharePoint URL. Site name not found.");
+    hostName = url.hostname;
+    const pathSegments = url.pathname.split("/").filter(Boolean);
+    const sitesIdx = pathSegments.findIndex((seg) => seg.toLowerCase() === "sites");
+    if (sitesIdx !== -1 && pathSegments[sitesIdx + 1]) {
+        siteName = pathSegments[sitesIdx + 1];
+        const afterSite = pathSegments[sitesIdx + 2];
+        if (afterSite && afterSite.toLowerCase() !== "_layouts" && afterSite.toLowerCase() !== "forms") {
+            driveName = afterSite;
+        }
     }
-    const siteName = pathSegments[siteNameIndex];
     const sourcedoc = url.searchParams.get("sourcedoc");
-    if (!sourcedoc) {
-        throw new InvalidArgumentError("Invalid SharePoint URL. Path not found in parameters.");
+    if (sourcedoc) {
+        itemId = decodeURIComponent(sourcedoc.replace(/[{}]/g, "")).toUpperCase();
     }
-    const itemId = sourcedoc.replace(/[{}]/g, "").toLocaleUpperCase();
     return {
         hostName,
         siteName,
+        driveName,
         itemId,
     };
 }

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

@@ -0,0 +1,20 @@
+/**
+ * Retrieves a Drive from a SharePoint URL.
+ * @module getDriveFromUrl
+ * @category Tasks
+ */
+import type { Drive } from "@microsoft/microsoft-graph-types";
+import type { ContextRef } from "../models/Context.ts";
+import type { DriveRef } from "../models/Drive.ts";
+/**
+ * Retrieves a Drive from a SharePoint URL.
+ *
+ * Parses the given SharePoint URL to extract the host, site, and drive names, then locates and returns the corresponding Drive object.
+ *
+ * @param contextRef - The context reference containing authentication and environment information.
+ * @param url - The SharePoint URL pointing to the drive.
+ * @returns A Promise that resolves to the Drive object with additional DriveRef properties.
+ * @throws If the URL is invalid or the drive cannot be found.
+ */
+export default function getDriveFromUrl(contextRef: ContextRef, url: string): Promise<Drive & DriveRef>;
+//# sourceMappingURL=getDriveFromUrl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getDriveFromUrl.d.ts","sourceRoot":"","sources":["../../../src/tasks/getDriveFromUrl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAKnD;;;;;;;;;GASG;AACH,wBAA8B,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC,CA2B5G"}

package/dist/esm/tasks/getDriveFromUrl.js

@@ -0,0 +1,44 @@
+/**
+ * Retrieves a Drive from a SharePoint URL.
+ * @module getDriveFromUrl
+ * @category Tasks
+ */
+import getSiteByName from "../operations/site/getSiteByName.js";
+import { parseSharepointUrl } from "../services/sharepointUrl.js";
+import iterateDrives from "./iterateDrives.js";
+/**
+ * Retrieves a Drive from a SharePoint URL.
+ *
+ * Parses the given SharePoint URL to extract the host, site, and drive names, then locates and returns the corresponding Drive object.
+ *
+ * @param contextRef - The context reference containing authentication and environment information.
+ * @param url - The SharePoint URL pointing to the drive.
+ * @returns A Promise that resolves to the Drive object with additional DriveRef properties.
+ * @throws If the URL is invalid or the drive cannot be found.
+ */
+export default async function getDriveFromUrl(contextRef, url) {
+    const { hostName, siteName, driveName } = parseSharepointUrl(url);
+    if (!hostName) {
+        throw new Error("Invalid SharePoint URL: Host name is missing.");
+    }
+    if (!siteName) {
+        throw new Error("Invalid SharePoint URL: Site name is missing.");
+    }
+    if (!driveName) {
+        throw new Error("Invalid SharePoint URL: Drive name is missing.");
+    }
+    const site = await getSiteByName(contextRef, hostName, siteName);
+    let drive = null;
+    for await (const d of iterateDrives(site)) {
+        if (sanitizeUrlName(d.name ?? "") === driveName) {
+            drive = d;
+        }
+    }
+    if (!drive) {
+        throw new Error(`Drive "${driveName}" not found in site "${siteName}" on host "${hostName}".`);
+    }
+    return drive;
+}
+function sanitizeUrlName(name) {
+    return name.replace(/[^A-Za-z0-9\-_.~]/g, "");
+}

package/docs/api/Drive-1.md

@@ -22,6 +22,22 @@ Identifier for a drive.
 
 ***
 
+### DriveName
+
+> **DriveName** = `string` & `object`
+
+Defined in: [src/models/Drive.ts:28](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Drive.ts#L28)
+
+Name of a drive.
+
+#### Type declaration
+
+##### \_\_brand
+
+> **\_\_brand**: `"DriveName"`
+
+***
+
 ### DriveRef
 
 > **DriveRef** = [`SiteRef`](Site-1.md#siteref) & `object`

package/docs/api/README.md

@@ -180,6 +180,7 @@
 | [copyDriveItem](copyDriveItem.md) | Copy a drive item. |
 | [createWorkbookAndStartSession](createWorkbookAndStartSession.md) | Create a new workbook and open a session for that workbook. |
 | [downloadDriveItemContent](downloadDriveItemContent.md) | Download a drive item and save it to the local disk. |
+| [getDriveFromUrl](getDriveFromUrl.md) | Retrieves a Drive from a SharePoint URL. |
 | [insertWorkbookRangeRow](insertWorkbookRangeRow.md) | Inserts a single row into a workbook range. |
 | [insertWorkbookRangeRows](insertWorkbookRangeRows.md) | Inserts rows into a workbook range. |
 | [iterateDriveItems](iterateDriveItems.md) | List drive items in a drive or a drive item. |

package/docs/api/getDriveFromUrl.md

@@ -0,0 +1,34 @@
+[Microsoft Graph SDK](README.md) / getDriveFromUrl
+
+# getDriveFromUrl
+
+Retrieves a Drive from a SharePoint URL.
+
+## Functions
+
+### getDriveFromUrl()
+
+> **getDriveFromUrl**(`contextRef`, `url`): [`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`Drive` & [`SiteRef`](Site-1.md#siteref) & `object`\>
+
+Defined in: [src/tasks/getDriveFromUrl.ts:24](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/tasks/getDriveFromUrl.ts#L24)
+
+Retrieves a Drive from a SharePoint URL.
+
+Parses the given SharePoint URL to extract the host, site, and drive names, then locates and returns the corresponding Drive object.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `contextRef` | [`ContextRef`](Context-1.md#contextref) | The context reference containing authentication and environment information. |
+| `url` | `string` | The SharePoint URL pointing to the drive. |
+
+#### Returns
+
+[`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`Drive` & [`SiteRef`](Site-1.md#siteref) & `object`\>
+
+A Promise that resolves to the Drive object with additional DriveRef properties.
+
+#### Throws
+
+If the URL is invalid or the drive cannot be found.

package/docs/api/sharepointUrl.md

@@ -4,39 +4,44 @@
 
 Utilities for parsing and extracting information from SharePoint URLs.
 
-## Functions
-
-### parseSharepointUrl()
+## Type Aliases
 
-> **parseSharepointUrl**(`url`): `object`
+### SharepointUrlComponents
 
-Defined in: [src/services/sharepointUrl.ts:18](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/sharepointUrl.ts#L18)
+> **SharepointUrlComponents** = `object`
 
-Parses a SharePoint document URL to extract the site name, host name, and item ID.
+Defined in: [src/services/sharepointUrl.ts:12](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/sharepointUrl.ts#L12)
 
-#### Parameters
+#### Properties
 
-| Parameter | Type | Description |
+| Property | Type | Defined in |
 | ------ | ------ | ------ |
-| `url` | [`URL`](https://developer.mozilla.org/docs/Web/API/URL) | The SharePoint document URL. |
+| <a id="drivename"></a> `driveName` | [`DriveName`](Drive-1.md#drivename) \| `null` | [src/services/sharepointUrl.ts:15](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/sharepointUrl.ts#L15) |
+| <a id="hostname"></a> `hostName` | [`HostName`](HostName.md#hostname) \| `null` | [src/services/sharepointUrl.ts:13](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/sharepointUrl.ts#L13) |
+| <a id="itemid"></a> `itemId` | [`DriveItemId`](DriveItem-1.md#driveitemid) \| `null` | [src/services/sharepointUrl.ts:16](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/sharepointUrl.ts#L16) |
+| <a id="sitename"></a> `siteName` | [`SiteName`](Site-1.md#sitename) \| `null` | [src/services/sharepointUrl.ts:14](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/sharepointUrl.ts#L14) |
 
-#### Returns
+## Functions
 
-`object`
+### parseSharepointUrl()
+
+> **parseSharepointUrl**(`urlString`): [`SharepointUrlComponents`](#sharepointurlcomponents)
 
-An object containing the host name, site name, and item ID.
+Defined in: [src/services/sharepointUrl.ts:25](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/sharepointUrl.ts#L25)
 
-##### hostName
+Parses a SharePoint document URL string to extract the site name, host name, drive name and item ID if present.
 
-> **hostName**: [`HostName`](HostName.md#hostname)
+#### Parameters
 
-##### itemId
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `urlString` | `string` | SharePoint URL as a string. |
 
-> **itemId**: [`DriveItemId`](DriveItem-1.md#driveitemid)
+#### Returns
 
-##### siteName
+[`SharepointUrlComponents`](#sharepointurlcomponents)
 
-> **siteName**: [`SiteName`](Site-1.md#sitename)
+An object containing the host name, site name, drive name (if present), and item ID (if present).
 
 #### Throws
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "microsoft-graph",
-  "version": "3.1.1",
+  "version": "3.2.0",
   "description": "Microsoft GraphAPI SDK for NodeJS",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -1649,6 +1649,16 @@
       "require": "./dist/cjs/tasks/downloadDriveItemContent.js",
       "types": "./dist/esm/tasks/downloadDriveItemContent.d.ts"
     },
+    "./getDriveFromUrl": {
+      "import": "./dist/esm/tasks/getDriveFromUrl.js",
+      "require": "./dist/cjs/tasks/getDriveFromUrl.js",
+      "types": "./dist/esm/tasks/getDriveFromUrl.d.ts"
+    },
+    "./dist/cjs/tasks/getDriveFromUrl": {
+      "import": "./dist/esm/tasks/getDriveFromUrl.js",
+      "require": "./dist/cjs/tasks/getDriveFromUrl.js",
+      "types": "./dist/esm/tasks/getDriveFromUrl.d.ts"
+    },
     "./getRangeLastUsedCell": {
       "import": "./dist/esm/tasks/getRangeLastUsedCell.js",
       "require": "./dist/cjs/tasks/getRangeLastUsedCell.js",