microsoft-graph 3.2.1 → 3.2.3

package/dist/cjs/operations/driveItem/getDriveItemByPath.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getDriveItemByPath.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/getDriveItemByPath.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAElE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAe,aAAa,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAKrE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAG,cAAc,CAAC,SAAS,GAAG,YAAY,CAAC,CAqBhI"}
+{"version":3,"file":"getDriveItemByPath.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/getDriveItemByPath.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAElE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAe,aAAa,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAKrE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAG,cAAc,CAAC,SAAS,GAAG,YAAY,CAAC,CAuBhI"}

package/dist/cjs/operations/driveItem/getDriveItemByPath.js

@@ -24,10 +24,11 @@ function getDriveItemByPath(driveRef, itemPath) {
     if (!itemPath.startsWith("/")) {
         throw new InvalidArgumentError_ts_1.default("itemPath must start with a forward slash (/)");
     }
+    const normalizedPath = itemPath === "/" ? "/sites/{site-id}/drives/{drive-id}/root" : `/sites/{site-id}/drives/{drive-id}/root:${itemPath}`;
     return (0, operationInvoker_ts_1.operation)({
         context: driveRef.context,
         method: "GET",
-        path: (0, templatedPaths_ts_1.generatePath)(`/sites/{site-id}/drives/{drive-id}/root:${itemPath}`, driveRef),
+        path: (0, templatedPaths_ts_1.generatePath)(normalizedPath, driveRef),
         headers: {},
         body: null,
         responseTransform: (response) => {

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

@@ -1,17 +1,8 @@
-/**
- * Utilities for parsing and extracting information from SharePoint URLs.
- * @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 string to extract the site name, host name, drive name and item ID if present.

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;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;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,uBAAuB,CAkD7E"}
+{"version":3,"file":"sharepointUrl.d.ts","sourceRoot":"","sources":["../../../src/services/sharepointUrl.ts"],"names":[],"mappings":"AAAA,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;CAC1B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,uBAAuB,CAiC7E"}

package/dist/cjs/services/sharepointUrl.js

@@ -1,9 +1,4 @@
 "use strict";
-/**
- * Utilities for parsing and extracting information from SharePoint URLs.
- * @module sharepointUrl
- * @category Services
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseSharepointUrl = parseSharepointUrl;
 /**
@@ -15,8 +10,6 @@ function parseSharepointUrl(urlString) {
     let url;
     let hostName = null;
     let siteName = null;
-    let driveName = null;
-    let itemId = null;
     try {
         url = new URL(urlString);
     }
@@ -24,16 +17,12 @@ function parseSharepointUrl(urlString) {
         return {
             hostName: null,
             siteName: null,
-            driveName: null,
-            itemId: null,
         };
     }
     if (!url.hostname.endsWith(".sharepoint.com")) {
         return {
             hostName: null,
             siteName: null,
-            driveName: null,
-            itemId: null,
         };
     }
     hostName = url.hostname;
@@ -42,19 +31,9 @@ function parseSharepointUrl(urlString) {
     if (sitesIdx !== -1 && pathSegments[sitesIdx + 1]) {
         const rawSiteName = pathSegments[sitesIdx + 1];
         siteName = rawSiteName ? decodeURIComponent(rawSiteName) : null;
-        const afterSite = pathSegments[sitesIdx + 2];
-        if (afterSite && afterSite.toLowerCase() !== "_layouts" && afterSite.toLowerCase() !== "forms") {
-            driveName = decodeURIComponent(afterSite);
-        }
-    }
-    const sourcedoc = url.searchParams.get("sourcedoc");
-    if (sourcedoc) {
-        itemId = decodeURIComponent(sourcedoc.replace(/[{}]/g, "")).toUpperCase();
     }
     return {
         hostName,
         siteName,
-        driveName,
-        itemId,
     };
 }

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

@@ -0,0 +1,13 @@
+import type { Site } from "@microsoft/microsoft-graph-types";
+import type { ContextRef } from "../models/Context.ts";
+import type { SiteRef } from "../models/Site.ts";
+/**
+ * Retrieves a site from a SharePoint URL.
+ *
+ * @param contextRef Context reference containing authentication and environment information.
+ * @param url SharePoint URL pointing to the site.
+ * @returns A Promise that resolves to the Site object
+ * @throws If the URL is invalid or the site cannot be found.
+ */
+export default function getSiteByUrl(contextRef: ContextRef, url: string): Promise<Site & SiteRef>;
+//# sourceMappingURL=getSiteByUrl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getSiteByUrl.d.ts","sourceRoot":"","sources":["../../../src/tasks/getSiteByUrl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAIjD;;;;;;;GAOG;AACH,wBAA8B,YAAY,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,CAWvG"}

package/dist/cjs/tasks/getSiteByUrl.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = getSiteByUrl;
+const getSiteByName_ts_1 = __importDefault(require("../operations/site/getSiteByName.js"));
+const sharepointUrl_ts_1 = require("../services/sharepointUrl.js");
+/**
+ * Retrieves a site from a SharePoint URL.
+ *
+ * @param contextRef Context reference containing authentication and environment information.
+ * @param url SharePoint URL pointing to the site.
+ * @returns A Promise that resolves to the Site object
+ * @throws If the URL is invalid or the site cannot be found.
+ */
+async function getSiteByUrl(contextRef, url) {
+    const { hostName, siteName } = (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.");
+    }
+    return await (0, getSiteByName_ts_1.default)(contextRef, hostName, siteName);
+}

package/dist/esm/operations/driveItem/getDriveItemByPath.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getDriveItemByPath.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/getDriveItemByPath.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAElE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAe,aAAa,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAKrE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAG,cAAc,CAAC,SAAS,GAAG,YAAY,CAAC,CAqBhI"}
+{"version":3,"file":"getDriveItemByPath.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/getDriveItemByPath.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAElE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAe,aAAa,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAKrE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAG,cAAc,CAAC,SAAS,GAAG,YAAY,CAAC,CAuBhI"}

package/dist/esm/operations/driveItem/getDriveItemByPath.js

@@ -18,10 +18,11 @@ export default function getDriveItemByPath(driveRef, itemPath) {
     if (!itemPath.startsWith("/")) {
         throw new InvalidArgumentError("itemPath must start with a forward slash (/)");
     }
+    const normalizedPath = itemPath === "/" ? "/sites/{site-id}/drives/{drive-id}/root" : `/sites/{site-id}/drives/{drive-id}/root:${itemPath}`;
     return operation({
         context: driveRef.context,
         method: "GET",
-        path: generatePath(`/sites/{site-id}/drives/{drive-id}/root:${itemPath}`, driveRef),
+        path: generatePath(normalizedPath, driveRef),
         headers: {},
         body: null,
         responseTransform: (response) => {

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

@@ -1,17 +1,8 @@
-/**
- * Utilities for parsing and extracting information from SharePoint URLs.
- * @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 string to extract the site name, host name, drive name and item ID if present.

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;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;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,uBAAuB,CAkD7E"}
+{"version":3,"file":"sharepointUrl.d.ts","sourceRoot":"","sources":["../../../src/services/sharepointUrl.ts"],"names":[],"mappings":"AAAA,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;CAC1B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,uBAAuB,CAiC7E"}

package/dist/esm/services/sharepointUrl.js

@@ -1,8 +1,3 @@
-/**
- * Utilities for parsing and extracting information from SharePoint URLs.
- * @module sharepointUrl
- * @category Services
- */
 /**
  * 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.
@@ -12,8 +7,6 @@ export function parseSharepointUrl(urlString) {
     let url;
     let hostName = null;
     let siteName = null;
-    let driveName = null;
-    let itemId = null;
     try {
         url = new URL(urlString);
     }
@@ -21,16 +14,12 @@ export function parseSharepointUrl(urlString) {
         return {
             hostName: null,
             siteName: null,
-            driveName: null,
-            itemId: null,
         };
     }
     if (!url.hostname.endsWith(".sharepoint.com")) {
         return {
             hostName: null,
             siteName: null,
-            driveName: null,
-            itemId: null,
         };
     }
     hostName = url.hostname;
@@ -39,19 +28,9 @@ export function parseSharepointUrl(urlString) {
     if (sitesIdx !== -1 && pathSegments[sitesIdx + 1]) {
         const rawSiteName = pathSegments[sitesIdx + 1];
         siteName = rawSiteName ? decodeURIComponent(rawSiteName) : null;
-        const afterSite = pathSegments[sitesIdx + 2];
-        if (afterSite && afterSite.toLowerCase() !== "_layouts" && afterSite.toLowerCase() !== "forms") {
-            driveName = decodeURIComponent(afterSite);
-        }
-    }
-    const sourcedoc = url.searchParams.get("sourcedoc");
-    if (sourcedoc) {
-        itemId = decodeURIComponent(sourcedoc.replace(/[{}]/g, "")).toUpperCase();
     }
     return {
         hostName,
         siteName,
-        driveName,
-        itemId,
     };
 }

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

@@ -0,0 +1,13 @@
+import type { Site } from "@microsoft/microsoft-graph-types";
+import type { ContextRef } from "../models/Context.ts";
+import type { SiteRef } from "../models/Site.ts";
+/**
+ * Retrieves a site from a SharePoint URL.
+ *
+ * @param contextRef Context reference containing authentication and environment information.
+ * @param url SharePoint URL pointing to the site.
+ * @returns A Promise that resolves to the Site object
+ * @throws If the URL is invalid or the site cannot be found.
+ */
+export default function getSiteByUrl(contextRef: ContextRef, url: string): Promise<Site & SiteRef>;
+//# sourceMappingURL=getSiteByUrl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getSiteByUrl.d.ts","sourceRoot":"","sources":["../../../src/tasks/getSiteByUrl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAIjD;;;;;;;GAOG;AACH,wBAA8B,YAAY,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,CAWvG"}

package/dist/esm/tasks/getSiteByUrl.js

@@ -0,0 +1,20 @@
+import getSiteByName from "../operations/site/getSiteByName.js";
+import { parseSharepointUrl } from "../services/sharepointUrl.js";
+/**
+ * Retrieves a site from a SharePoint URL.
+ *
+ * @param contextRef Context reference containing authentication and environment information.
+ * @param url SharePoint URL pointing to the site.
+ * @returns A Promise that resolves to the Site object
+ * @throws If the URL is invalid or the site cannot be found.
+ */
+export default async function getSiteByUrl(contextRef, url) {
+    const { hostName, siteName } = 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.");
+    }
+    return await getSiteByName(contextRef, hostName, siteName);
+}

package/docs/api/README.md

@@ -139,6 +139,13 @@
 | [updateWorkbookWorksheet](updateWorkbookWorksheet.md) | Update the name, position, and/or visibility of a worksheet. |
 | [userSendMail](userSendMail.md) | Send an email. |
 
+## Other
+
+| Module | Description |
+| ------ | ------ |
+| [services/sharepointUrl](services/sharepointUrl.md) | - |
+| [tasks/getSiteByUrl](tasks/getSiteByUrl.md) | - |
+
 ## Services
 
 | Module | Description |
@@ -161,7 +168,6 @@
 | [operationInvoker](operationInvoker.md) | Invoke operations, potentially as parallel or sequential batches. |
 | [random](random.md) | Utilities for generating random values for spreadsheet and API operations. |
 | [rangeManipulation](rangeManipulation.md) | Utilities for inferring and manipulating spreadsheet ranges and objects. |
-| [sharepointUrl](sharepointUrl.md) | Utilities for parsing and extracting information from SharePoint URLs. |
 | [site](site.md) | Utilities for working with Microsoft Graph Site references and operations. |
 | [sleep](sleep.md) | Utility for pausing execution (sleep) in async workflows. |
 | [stringCaseConversion](stringCaseConversion.md) | Utilities for converting string case styles (e.g., kebab-case to camelCase). |
@@ -180,7 +186,6 @@
 | [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/services/sharepointUrl.md

@@ -0,0 +1,40 @@
+[Microsoft Graph SDK](../README.md) / services/sharepointUrl
+
+# services/sharepointUrl
+
+## Type Aliases
+
+### SharepointUrlComponents
+
+> **SharepointUrlComponents** = `object`
+
+Defined in: [src/services/sharepointUrl.ts:4](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/sharepointUrl.ts#L4)
+
+#### Properties
+
+| Property | Type | Defined in |
+| ------ | ------ | ------ |
+| <a id="hostname"></a> `hostName` | [`HostName`](../HostName.md#hostname) \| `null` | [src/services/sharepointUrl.ts:5](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/sharepointUrl.ts#L5) |
+| <a id="sitename"></a> `siteName` | [`SiteName`](../Site-1.md#sitename) \| `null` | [src/services/sharepointUrl.ts:6](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/sharepointUrl.ts#L6) |
+
+## Functions
+
+### parseSharepointUrl()
+
+> **parseSharepointUrl**(`urlString`): [`SharepointUrlComponents`](#sharepointurlcomponents)
+
+Defined in: [src/services/sharepointUrl.ts:14](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/sharepointUrl.ts#L14)
+
+Parses a SharePoint document URL string to extract the site name, host name, drive name and item ID if present.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `urlString` | `string` | SharePoint URL as a string. |
+
+#### Returns
+
+[`SharepointUrlComponents`](#sharepointurlcomponents)
+
+An object containing the host name, site name, drive name, and item ID. Parameters are omitted if not found.

package/docs/api/tasks/getSiteByUrl.md

@@ -0,0 +1,30 @@
+[Microsoft Graph SDK](../README.md) / tasks/getSiteByUrl
+
+# tasks/getSiteByUrl
+
+## Functions
+
+### getSiteByUrl()
+
+> **getSiteByUrl**(`contextRef`, `url`): [`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`Site` & [`SiteRef`](../Site-1.md#siteref)\>
+
+Defined in: [src/tasks/getSiteByUrl.ts:15](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/tasks/getSiteByUrl.ts#L15)
+
+Retrieves a site from a SharePoint URL.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `contextRef` | [`ContextRef`](../Context-1.md#contextref) | Context reference containing authentication and environment information. |
+| `url` | `string` | SharePoint URL pointing to the site. |
+
+#### Returns
+
+[`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`Site` & [`SiteRef`](../Site-1.md#siteref)\>
+
+A Promise that resolves to the Site object
+
+#### Throws
+
+If the URL is invalid or the site cannot be found.

package/docs/topics/findingSiteDriveId.md

@@ -2,12 +2,18 @@
 At the time of writing there is no **good** way to get these values. So what follows is a work-around process.
 
 ## SiteId
-1. Open the Sharepoint UI for the site you're interested in (ie https://msftfuturesecureai.sharepoint.com/sites/FSAI-MQG/)
-2. In your browser, open "View Source"
-3. Search the source for `siteId` and look immediately after it.
-4. The SiteId is a GUID and will look something like "89cb90aa-7977-412d-8215-31c74db72d7b"
+### Automated way
+Install [Microsoft Graph Tool](https://www.npmjs.com/package/microsoft-graph-tool) and run `graph get-site <url>` (ie `graph get-site https://myhost.sharepoint.com/sites/sitename/`) and you will be given the rool
+
+### Manual way
+Go to this path on your site https://{host-name}/sites/{site-name}/_api/site/id (ie https://myhost.sharepoint.com/sites/sitename/_api/site/id) and you will be given the ID
 
 ## DriveID
+
+### Automated way
+Install [Microsoft Graph Tool](https://www.npmjs.com/package/microsoft-graph-tool) and run `graph list-drives <siteId>` 
+
+### Manual way
 1. In the Sharepoint UI, create a workbook. New > Workbook
 2. Close the file and back in Sharepoint refresh the page
 3. Open your web browsers Inspect tool
@@ -15,7 +21,7 @@ At the time of writing there is no **good** way to get these values. So what fol
 5. In the inspect tool, swap to the "Network" table and filter the view vy "Fetch/XHR"
 6. Find the request to the Graph API. It will look like this: 
   `https://msftfuturesecureai.sharepoint.com/_api/v2.1/drives/b!qpDLiXd5LUGCFTHHTbcte07zDZGO-jpHhga5szhvDwEvhFVvV24OSrAv5WljW1aA/items/01LRCMNGPGDA4PSPHWF5AZN45DNO37BP3Z?%24select=id%2Creactions%2Ctrending&%24expand=insights(%24expand%3DkeyPoints)%2Canalytics(%24expand%3DallTime(%24expand%3Dactivities))%2CrecommendedActionSet(%24expand%3DnonAggregatedRecommendedActions%2CaggregatedEditRecommendedAction(%24expand%3DimportantActorsAndActivities))%2CconversationSet(%24expand%3DemailConversations(%24expand%3Dparticipants)%2CmeetingConversations(%24expand%3Dparticipants)%2CteamsConversations(%24expand%3Dparticipants))`
-7. Note the portion between `/drives/` and `/items`/. This is your driveId. In the above example it is `b!qpDLiXd5LUGCFTHHTbcte07zDZGO-jpHhga5szhvDwEvhFVvV24OSrAv5WljW1aA`.
+1. Note the portion between `/drives/` and `/items`/. This is your driveId. In the above example it is `b!qpDLiXd5LUGCFTHHTbcte07zDZGO-jpHhga5szhvDwEvhFVvV24OSrAv5WljW1aA`.
 
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "microsoft-graph",
-  "version": "3.2.1",
+  "version": "3.2.3",
   "description": "Microsoft GraphAPI SDK for NodeJS",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -1649,16 +1649,6 @@
       "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",
@@ -1669,6 +1659,16 @@
       "require": "./dist/cjs/tasks/getRangeLastUsedCell.js",
       "types": "./dist/esm/tasks/getRangeLastUsedCell.d.ts"
     },
+    "./getSiteByUrl": {
+      "import": "./dist/esm/tasks/getSiteByUrl.js",
+      "require": "./dist/cjs/tasks/getSiteByUrl.js",
+      "types": "./dist/esm/tasks/getSiteByUrl.d.ts"
+    },
+    "./dist/cjs/tasks/getSiteByUrl": {
+      "import": "./dist/esm/tasks/getSiteByUrl.js",
+      "require": "./dist/cjs/tasks/getSiteByUrl.js",
+      "types": "./dist/esm/tasks/getSiteByUrl.d.ts"
+    },
     "./getWorkbookTableVisibleBody": {
       "import": "./dist/esm/tasks/getWorkbookTableVisibleBody.js",
       "require": "./dist/cjs/tasks/getWorkbookTableVisibleBody.js",

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

@@ -1,20 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,50 +0,0 @@
-"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/tasks/getDriveFromUrl.d.ts

@@ -1,20 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,44 +0,0 @@
-/**
- * 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/getDriveFromUrl.md

@@ -1,34 +0,0 @@
-[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

@@ -1,44 +0,0 @@
-[Microsoft Graph SDK](README.md) / sharepointUrl
-
-# sharepointUrl
-
-Utilities for parsing and extracting information from SharePoint URLs.
-
-## Type Aliases
-
-### SharepointUrlComponents
-
-> **SharepointUrlComponents** = `object`
-
-Defined in: [src/services/sharepointUrl.ts:12](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/sharepointUrl.ts#L12)
-
-#### Properties
-
-| Property | Type | Defined in |
-| ------ | ------ | ------ |
-| <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) |
-
-## Functions
-
-### parseSharepointUrl()
-
-> **parseSharepointUrl**(`urlString`): [`SharepointUrlComponents`](#sharepointurlcomponents)
-
-Defined in: [src/services/sharepointUrl.ts:24](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/sharepointUrl.ts#L24)
-
-Parses a SharePoint document URL string to extract the site name, host name, drive name and item ID if present.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `urlString` | `string` | SharePoint URL as a string. |
-
-#### Returns
-
-[`SharepointUrlComponents`](#sharepointurlcomponents)
-
-An object containing the host name, site name, drive name, and item ID. Parameters are omitted if not found.