microsoft-graph 3.10.4 → 3.10.6

package/dist/cjs/operations/drive/createFolder.d.ts

@@ -19,6 +19,7 @@ export interface CreateDriveItemOptions {
  * @param parentRef Reference to the parent drive or folder where the folder will be created.
  * @param folderName Name of the folder to be created.
  * @returns The newly created folder.
+ * @remarks Parent folder must already exist. Multiple folders cannot be created in a single request
  * @see https://learn.microsoft.com/en-us/graph/api/driveitem-post-children
  */
 export default function createFolder(parentRef: DriveRef | DriveItemRef, folderName: string, options?: CreateDriveItemOptions): GraphOperation<DriveItem & DriveItemRef>;

package/dist/cjs/operations/drive/createFolder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createFolder.d.ts","sourceRoot":"","sources":["../../../../src/operations/drive/createFolder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAKrE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,cAAc,CAAC,SAAS,GAAG,YAAY,CAAC,CA0B3K"}
+{"version":3,"file":"createFolder.d.ts","sourceRoot":"","sources":["../../../../src/operations/drive/createFolder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAKrE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,cAAc,CAAC,SAAS,GAAG,YAAY,CAAC,CA0B3K"}

package/dist/cjs/operations/drive/createFolder.js

@@ -14,6 +14,7 @@ const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
  * @param parentRef Reference to the parent drive or folder where the folder will be created.
  * @param folderName Name of the folder to be created.
  * @returns The newly created folder.
+ * @remarks Parent folder must already exist. Multiple folders cannot be created in a single request
  * @see https://learn.microsoft.com/en-us/graph/api/driveitem-post-children
  */
 function createFolder(parentRef, folderName, options = {}) {

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

@@ -39,4 +39,10 @@ export declare function splitDriveItemPath(filePath: DriveItemPath): {
  * @returns File extension ie. "txt", "jpg"
  */
 export declare function getDriveItemExtension(item: DriveItem): string;
+/**
+ * Gets the parent for a drive item. Typically this is the folder of a file.
+ * @param item Drive item.
+ * @returns Parent drive item.
+ */
+export declare function getDriveItemParent(item: DriveItem & DriveItemRef): DriveItemRef;
 //# sourceMappingURL=driveItem.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"driveItem.d.ts","sourceRoot":"","sources":["../../../src/services/driveItem.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAIlE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAMvF,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAC5C,eAAO,MAAM,2BAA2B,SAAS,CAAC;AAElD,eAAO,MAAM,iBAAiB,eAAqB,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,aAAa,CAkClE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,YAAY,CAWpG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG;IAAE,UAAU,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAa3G;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAG7D"}
+{"version":3,"file":"driveItem.d.ts","sourceRoot":"","sources":["../../../src/services/driveItem.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAIlE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAMvF,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAC5C,eAAO,MAAM,2BAA2B,SAAS,CAAC;AAElD,eAAO,MAAM,iBAAiB,eAAqB,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,aAAa,CAkClE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,YAAY,CAWpG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG;IAAE,UAAU,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAa3G;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAG7D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,YAAY,GAAG,YAAY,CAc/E"}

package/dist/cjs/services/driveItem.js

@@ -13,6 +13,7 @@ exports.driveItemPath = driveItemPath;
 exports.createDriveItemRef = createDriveItemRef;
 exports.splitDriveItemPath = splitDriveItemPath;
 exports.getDriveItemExtension = getDriveItemExtension;
+exports.getDriveItemParent = getDriveItemParent;
 const node_path_1 = __importDefault(require("node:path"));
 const InvalidArgumentError_ts_1 = __importDefault(require("../errors/InvalidArgumentError.js"));
 const ProtocolError_ts_1 = __importDefault(require("../errors/ProtocolError.js"));
@@ -98,3 +99,21 @@ function getDriveItemExtension(item) {
     const ext = node_path_1.default.extname(item.name ?? "").toLowerCase();
     return ext.startsWith(".") ? ext.slice(1) : ext;
 }
+/**
+ * Gets the parent for a drive item. Typically this is the folder of a file.
+ * @param item Drive item.
+ * @returns Parent drive item.
+ */
+function getDriveItemParent(item) {
+    const parentId = item.parentReference?.id;
+    if (!parentId) {
+        throw new Error("Parent reference not found for the item.");
+    }
+    const parentRef = {
+        context: item.context,
+        siteId: item.siteId,
+        driveId: item.driveId,
+        itemId: parentId,
+    };
+    return parentRef;
+}

package/dist/esm/operations/drive/createFolder.d.ts

@@ -19,6 +19,7 @@ export interface CreateDriveItemOptions {
  * @param parentRef Reference to the parent drive or folder where the folder will be created.
  * @param folderName Name of the folder to be created.
  * @returns The newly created folder.
+ * @remarks Parent folder must already exist. Multiple folders cannot be created in a single request
  * @see https://learn.microsoft.com/en-us/graph/api/driveitem-post-children
  */
 export default function createFolder(parentRef: DriveRef | DriveItemRef, folderName: string, options?: CreateDriveItemOptions): GraphOperation<DriveItem & DriveItemRef>;

package/dist/esm/operations/drive/createFolder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createFolder.d.ts","sourceRoot":"","sources":["../../../../src/operations/drive/createFolder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAKrE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,cAAc,CAAC,SAAS,GAAG,YAAY,CAAC,CA0B3K"}
+{"version":3,"file":"createFolder.d.ts","sourceRoot":"","sources":["../../../../src/operations/drive/createFolder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAKrE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,cAAc,CAAC,SAAS,GAAG,YAAY,CAAC,CA0B3K"}

package/dist/esm/operations/drive/createFolder.js

@@ -11,6 +11,7 @@ import { generatePath } from "../../services/templatedPaths.js";
  * @param parentRef Reference to the parent drive or folder where the folder will be created.
  * @param folderName Name of the folder to be created.
  * @returns The newly created folder.
+ * @remarks Parent folder must already exist. Multiple folders cannot be created in a single request
  * @see https://learn.microsoft.com/en-us/graph/api/driveitem-post-children
  */
 export default function createFolder(parentRef, folderName, options = {}) {

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

@@ -39,4 +39,10 @@ export declare function splitDriveItemPath(filePath: DriveItemPath): {
  * @returns File extension ie. "txt", "jpg"
  */
 export declare function getDriveItemExtension(item: DriveItem): string;
+/**
+ * Gets the parent for a drive item. Typically this is the folder of a file.
+ * @param item Drive item.
+ * @returns Parent drive item.
+ */
+export declare function getDriveItemParent(item: DriveItem & DriveItemRef): DriveItemRef;
 //# sourceMappingURL=driveItem.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"driveItem.d.ts","sourceRoot":"","sources":["../../../src/services/driveItem.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAIlE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAMvF,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAC5C,eAAO,MAAM,2BAA2B,SAAS,CAAC;AAElD,eAAO,MAAM,iBAAiB,eAAqB,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,aAAa,CAkClE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,YAAY,CAWpG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG;IAAE,UAAU,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAa3G;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAG7D"}
+{"version":3,"file":"driveItem.d.ts","sourceRoot":"","sources":["../../../src/services/driveItem.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAIlE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAMvF,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAC5C,eAAO,MAAM,2BAA2B,SAAS,CAAC;AAElD,eAAO,MAAM,iBAAiB,eAAqB,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,aAAa,CAkClE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,YAAY,CAWpG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG;IAAE,UAAU,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAa3G;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAG7D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,YAAY,GAAG,YAAY,CAc/E"}

package/dist/esm/services/driveItem.js

@@ -88,3 +88,21 @@ export function getDriveItemExtension(item) {
     const ext = path.extname(item.name ?? "").toLowerCase();
     return ext.startsWith(".") ? ext.slice(1) : ext;
 }
+/**
+ * Gets the parent for a drive item. Typically this is the folder of a file.
+ * @param item Drive item.
+ * @returns Parent drive item.
+ */
+export function getDriveItemParent(item) {
+    const parentId = item.parentReference?.id;
+    if (!parentId) {
+        throw new Error("Parent reference not found for the item.");
+    }
+    const parentRef = {
+        context: item.context,
+        siteId: item.siteId,
+        driveId: item.driveId,
+        itemId: parentId,
+    };
+    return parentRef;
+}

package/docs/api/createFolder.md

@@ -26,7 +26,7 @@ Defined in: [src/operations/drive/createFolder.ts:20](https://github.com/Future-
 
 > **createFolder**(`parentRef`, `folderName`, `options`): [`GraphOperation`](GraphOperation.md#graphoperation)\<`DriveItem` & [`SiteRef`](Site-1.md#siteref) & `object` & `object`\>
 
-Defined in: [src/operations/drive/createFolder.ts:30](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/drive/createFolder.ts#L30)
+Defined in: [src/operations/drive/createFolder.ts:31](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/drive/createFolder.ts#L31)
 
 Create a folder in the root of a drive, or in a folder. If it already exists do nothing.
 
@@ -44,6 +44,10 @@ Create a folder in the root of a drive, or in a folder. If it already exists do
 
 The newly created folder.
 
+#### Remarks
+
+Parent folder must already exist. Multiple folders cannot be created in a single request
+
 #### See
 
 https://learn.microsoft.com/en-us/graph/api/driveitem-post-children

package/docs/api/driveItem.md

@@ -105,6 +105,28 @@ File extension ie. "txt", "jpg"
 
 ***
 
+### getDriveItemParent()
+
+> **getDriveItemParent**(`item`): [`DriveItemRef`](DriveItem-1.md#driveitemref)
+
+Defined in: [src/services/driveItem.ts:120](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/driveItem.ts#L120)
+
+Gets the parent for a drive item. Typically this is the folder of a file.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `item` | `DriveItem` & [`SiteRef`](Site-1.md#siteref) & `object` & `object` | Drive item. |
+
+#### Returns
+
+[`DriveItemRef`](DriveItem-1.md#driveitemref)
+
+Parent drive item.
+
+***
+
 ### splitDriveItemPath()
 
 > **splitDriveItemPath**(`filePath`): `object`

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "microsoft-graph",
-	"version": "3.10.4",
+	"version": "3.10.6",
 	"description": "Microsoft GraphAPI SDK for NodeJS",
 	"main": "./dist/cjs/index.js",
 	"module": "./dist/esm/index.js",