microsoft-graph 3.1.1 → 3.1.2

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,22 @@
  * @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";
+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;
+export {};
 //# 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,KAAK,uBAAuB,GAAG;IAC9B,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/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,22 @@
  * @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";
+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;
+export {};
 //# 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,KAAK,uBAAuB,GAAG;IAC9B,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/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/sharepointUrl.md

@@ -8,35 +8,23 @@ Utilities for parsing and extracting information from SharePoint URLs.
 
 ### parseSharepointUrl()
 
-> **parseSharepointUrl**(`url`): `object`
+> **parseSharepointUrl**(`urlString`): `SharepointUrlComponents`
 
-Defined in: [src/services/sharepointUrl.ts:18](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/sharepointUrl.ts#L18)
+Defined in: [src/services/sharepointUrl.ts:25](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/sharepointUrl.ts#L25)
 
-Parses a SharePoint document URL to extract the site name, host name, and item ID.
+Parses a SharePoint document URL string to extract the site name, host name, drive name and item ID if present.
 
 #### Parameters
 
 | Parameter | Type | Description |
 | ------ | ------ | ------ |
-| `url` | [`URL`](https://developer.mozilla.org/docs/Web/API/URL) | The SharePoint document URL. |
+| `urlString` | `string` | SharePoint URL as a string. |
 
 #### Returns
 
-`object`
+`SharepointUrlComponents`
 
-An object containing the host name, site name, and item ID.
-
-##### hostName
-
-> **hostName**: [`HostName`](HostName.md#hostname)
-
-##### itemId
-
-> **itemId**: [`DriveItemId`](DriveItem-1.md#driveitemid)
-
-##### siteName
-
-> **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.1.2",
   "description": "Microsoft GraphAPI SDK for NodeJS",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",