microsoft-graph 2.11.3 → 2.13.0

package/biome.jsonc

@@ -7,7 +7,7 @@
 		"defaultBranch": "main"
 	},
 	"files": {
-		"include": ["src/*.ts", "demo/*.ts"],
+		"include": ["*.ts"],
 		"maxSize": 2097152 // 2MB to cover generated models
 	},
 	"formatter": {

package/dist/cjs/errors/TimeoutError.d.ts

@@ -0,0 +1,4 @@
+export default class TimeoutError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=TimeoutError.d.ts.map

package/dist/cjs/errors/TimeoutError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeoutError.d.ts","sourceRoot":"","sources":["../../../src/errors/TimeoutError.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAIlC"}

package/dist/cjs/errors/TimeoutError.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class TimeoutError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TimeoutError";
+    }
+}
+exports.default = TimeoutError;

package/dist/cjs/graphApi.js

@@ -15,10 +15,10 @@ const ProtocolError_ts_1 = __importDefault(require("./errors/ProtocolError.js"))
 const RequestFailedError_ts_1 = __importDefault(require("./errors/RequestFailedError.js"));
 const accessToken_ts_1 = require("./services/accessToken.js");
 const context_ts_1 = require("./services/context.js");
+const http_ts_1 = require("./services/http.js");
 const httpStatus_ts_1 = require("./services/httpStatus.js");
 const operationId_ts_1 = require("./services/operationId.js");
 const sleep_ts_1 = require("./services/sleep.js");
-const http_ts_1 = require("./services/http.js");
 exports.authenticationScope = "https://graph.microsoft.com/.default";
 exports.endpoint = "https://graph.microsoft.com/v1.0";
 exports.batchEndpoint = `${exports.endpoint}/$batch`;
@@ -127,20 +127,20 @@ async function innerFetch(args) {
     }
     let retryAfterMilliseconds = defaultRetryDelayMilliseconds;
     let response = null;
-    let attempts = 0; // Track the number of attempts
-    while (attempts < maxRetries) {
+    let retry = 0;
+    while (retry < maxRetries) {
         try {
             response = await (0, http_ts_1.executeHttpRequest)({
                 url,
                 ...options,
             });
-            break; // If successful, exit the loop
+            break;
         }
         catch (error) {
             if (axios_1.default.isAxiosError(error) && error.response) {
                 response = error.response;
                 if (!((0, httpStatus_ts_1.isHttpTooManyRequests)(response.status) || (0, httpStatus_ts_1.isServiceUnavailable)(response.status) || (0, httpStatus_ts_1.isGatewayTimeout)(response.status))) {
-                    throw error; // Don't retry for other error codes
+                    throw error;
                 }
                 const requestedRetryAfterSeconds = Number.parseInt(response.headers["retry-after"] ?? "0", 10);
                 if (requestedRetryAfterSeconds) {
@@ -148,13 +148,12 @@ async function innerFetch(args) {
                 }
                 await (0, sleep_ts_1.sleep)(retryAfterMilliseconds);
                 retryAfterMilliseconds *= consecutiveRetryDelayMultiplier;
-                attempts++; // Increment the attempt counter
-                if (attempts >= maxRetries) {
+                retry++;
+                if (retry >= maxRetries) {
                     RequestFailedError_ts_1.default.throw(`GraphAPI fetch exceed retry limit of ${maxRetries} attempts.`, args);
                 }
             }
             else {
-                // For non-Axios errors or errors without response, just throw
                 throw error;
             }
         }

package/dist/cjs/operations/driveItem/initiateCopyDriveItem.d.ts

@@ -1,13 +1,14 @@
 import type { DriveItemRef } from "../../models/DriveItemRef.ts";
+import type { DriveRef } from "../../models/DriveRef.ts";
 import type { GraphOperation } from "../../models/GraphOperation.ts";
 /**
  * Initiate an asynchronous copy of an item. NOTE: The copied file may not be immediately available and polling is required.
  *
  * @param srcFileRef - A reference to the source file to be copied.
- * @param dstFolderRef - A reference to the destination folder.
+ * @param dstFolderRef - A reference to the destination folder or site (if targeting root).
  * @param dstFileName - The name of the copied file.
  * @returns Nothing. The copied file may not be immediately available, and polling is required.
  * @see https://learn.microsoft.com/en-us/graph/api/driveitem-copy
  */
-export default function initiateCopyDriveItem(srcFileRef: DriveItemRef, dstFolderRef: DriveItemRef, dstFileName: string): GraphOperation<void>;
+export default function initiateCopyDriveItem(srcFileRef: DriveItemRef, dstFolderRef: DriveRef | DriveItemRef, dstFileName: string): GraphOperation<void>;
 //# sourceMappingURL=initiateCopyDriveItem.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"initiateCopyDriveItem.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/initiateCopyDriveItem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAkB7I"}
+{"version":3,"file":"initiateCopyDriveItem.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/initiateCopyDriveItem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,GAAG,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAkBxJ"}

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

@@ -7,7 +7,7 @@ const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
  * Initiate an asynchronous copy of an item. NOTE: The copied file may not be immediately available and polling is required.
  *
  * @param srcFileRef - A reference to the source file to be copied.
- * @param dstFolderRef - A reference to the destination folder.
+ * @param dstFolderRef - A reference to the destination folder or site (if targeting root).
  * @param dstFileName - The name of the copied file.
  * @returns Nothing. The copied file may not be immediately available, and polling is required.
  * @see https://learn.microsoft.com/en-us/graph/api/driveitem-copy
@@ -25,7 +25,7 @@ function initiateCopyDriveItem(srcFileRef, dstFolderRef, dstFileName) {
             parentReference: {
                 siteId: dstFolderRef.siteId,
                 driveId: dstFolderRef.driveId,
-                id: dstFolderRef.itemId,
+                id: "itemId" in dstFolderRef ? dstFolderRef.itemId : undefined,
             },
         },
         responseTransform: () => undefined,

package/dist/cjs/operations/driveItem/moveDriveItem.d.ts

@@ -0,0 +1,14 @@
+import type { DriveItemRef } from "../../models/DriveItemRef.ts";
+import type { DriveRef } from "../../models/DriveRef.ts";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+/**
+ * Moves a file to a new location in the same drive.
+ *
+ * @param srcFileRef - A reference to the source file to be copied.
+ * @param dstFolderRef - A reference to the destination folder or site (if targeting root).
+ * @param dstFileName - The name of the copied file.
+ * @returns new DriveItemRef.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-move
+ */
+export default function moveDriveItem(srcFileRef: DriveItemRef, dstFolderRef: DriveRef | DriveItemRef, dstFileName: string): GraphOperation<void>;
+//# sourceMappingURL=moveDriveItem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"moveDriveItem.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/moveDriveItem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,GAAG,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAkBhJ"}

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

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = moveDriveItem;
+const graphApi_ts_1 = require("../../graphApi.js");
+const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
+/**
+ * Moves a file to a new location in the same drive.
+ *
+ * @param srcFileRef - A reference to the source file to be copied.
+ * @param dstFolderRef - A reference to the destination folder or site (if targeting root).
+ * @param dstFileName - The name of the copied file.
+ * @returns new DriveItemRef.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-move
+ */
+function moveDriveItem(srcFileRef, dstFolderRef, dstFileName) {
+    return (0, graphApi_ts_1.operation)({
+        contextId: srcFileRef.contextId,
+        method: "PATCH",
+        path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}", srcFileRef),
+        headers: {
+            "content-type": "application/json",
+        },
+        body: {
+            name: dstFileName,
+            parentReference: {
+                siteId: dstFolderRef.siteId,
+                driveId: dstFolderRef.driveId,
+                id: "itemId" in dstFolderRef ? dstFolderRef.itemId : "root",
+            },
+        },
+        responseTransform: () => undefined,
+    });
+}

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

@@ -19,4 +19,13 @@ export declare function driveItemPath(...segments: string[]): DriveItemPath;
  * @throws ProtocolError if the item ID is missing.
  */
 export declare function createDriveItemRef(driveRef: DriveRef, itemId: DriveItemId | undefined): DriveItemRef;
+/**
+ * Splits a drive item path into its folder path and file name.
+ * @param filePath - The full path of the file.
+ * @returns An object containing the folder path and file name.
+ */
+export declare function splitDriveItemPath(filePath: DriveItemPath): {
+    folderPath: DriveItemPath;
+    fileName: string;
+};
 //# 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":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMtD,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAE5C,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"}
+{"version":3,"file":"driveItem.d.ts","sourceRoot":"","sources":["../../../src/services/driveItem.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMtD,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAE5C,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"}

package/dist/cjs/services/driveItem.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.rootDriveItemPath = exports.workbookFileExtension = void 0;
 exports.driveItemPath = driveItemPath;
 exports.createDriveItemRef = createDriveItemRef;
+exports.splitDriveItemPath = splitDriveItemPath;
 const InvalidArgumentError_ts_1 = __importDefault(require("../errors/InvalidArgumentError.js"));
 const ProtocolError_ts_1 = __importDefault(require("../errors/ProtocolError.js"));
 const segmentPattern = /^[^"*:<>?\\|#]{1,256}$/;
@@ -63,3 +64,20 @@ function createDriveItemRef(driveRef, itemId) {
         itemId,
     };
 }
+/**
+ * Splits a drive item path into its folder path and file name.
+ * @param filePath - The full path of the file.
+ * @returns An object containing the folder path and file name.
+ */
+function splitDriveItemPath(filePath) {
+    if (!filePath.startsWith("/")) {
+        throw new InvalidArgumentError_ts_1.default("File path must start with a '/'");
+    }
+    const pos = filePath.lastIndexOf("/");
+    const fileName = filePath.substring(pos + 1);
+    const folderPath = (pos === 0 ? "/" : filePath.substring(0, pos));
+    return {
+        folderPath,
+        fileName,
+    };
+}

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

@@ -0,0 +1,14 @@
+import type { DriveItem } from "@microsoft/microsoft-graph-types";
+import type { DriveItemPath } from "../models/DriveItemPath.ts";
+import type { DriveItemRef } from "../models/DriveItemRef.ts";
+import type { DriveRef } from "../models/DriveRef.ts";
+/**
+ * Copy a drive item, blocking and polling for completion.
+ *
+ * @param srcFileRef - A reference to the source file to be copied.
+ * @param dstFilePath - Destination file path
+ * @param timeoutMs - Timeout in milliseconds for the copy operation.
+ * @returns
+ */
+export default function copyDriveItem(srcFileRef: DriveItemRef, dstDriveRef: DriveRef, dstFilePath: DriveItemPath, timeoutMs?: number): Promise<DriveItem & DriveItemRef>;
+//# sourceMappingURL=copyDriveItem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"copyDriveItem.d.ts","sourceRoot":"","sources":["../../../src/tasks/copyDriveItem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMtD;;;;;;;GAOG;AACH,wBAA8B,aAAa,CAAC,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,SAAQ,GAAG,OAAO,CAAC,SAAS,GAAG,YAAY,CAAC,CAqB7K"}

package/dist/cjs/tasks/copyDriveItem.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = copyDriveItem;
+const TimeoutError_ts_1 = __importDefault(require("../errors/TimeoutError.js"));
+const getDriveItemByPath_ts_1 = __importDefault(require("../operations/driveItem/getDriveItemByPath.js"));
+const initiateCopyDriveItem_ts_1 = __importDefault(require("../operations/driveItem/initiateCopyDriveItem.js"));
+const driveItem_ts_1 = require("../services/driveItem.js");
+const sleep_ts_1 = require("../services/sleep.js");
+/**
+ * Copy a drive item, blocking and polling for completion.
+ *
+ * @param srcFileRef - A reference to the source file to be copied.
+ * @param dstFilePath - Destination file path
+ * @param timeoutMs - Timeout in milliseconds for the copy operation.
+ * @returns
+ */
+async function copyDriveItem(srcFileRef, dstDriveRef, dstFilePath, timeoutMs = 16000) {
+    const { folderPath, fileName } = (0, driveItem_ts_1.splitDriveItemPath)(dstFilePath);
+    const dstFolder = folderPath === "/" ? dstDriveRef : await (0, getDriveItemByPath_ts_1.default)(dstDriveRef, folderPath);
+    await (0, initiateCopyDriveItem_ts_1.default)(srcFileRef, dstFolder, fileName);
+    const start = Date.now();
+    let delay = 1000;
+    while (true) {
+        try {
+            return await (0, getDriveItemByPath_ts_1.default)(dstDriveRef, dstFilePath);
+        }
+        catch (_) {
+            const elapsedTime = Date.now() - start;
+            if (elapsedTime + delay > timeoutMs) {
+                throw new TimeoutError_ts_1.default(`Timeout while copying ${srcFileRef.itemId} to ${dstFilePath}`);
+            }
+            await (0, sleep_ts_1.sleep)(delay);
+            delay = Math.min(delay * 2, timeoutMs - (Date.now() - start)); // Double the delay but don't exceed remaining time
+        }
+    }
+}

package/dist/esm/errors/TimeoutError.d.ts

@@ -0,0 +1,4 @@
+export default class TimeoutError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=TimeoutError.d.ts.map

package/dist/esm/errors/TimeoutError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeoutError.d.ts","sourceRoot":"","sources":["../../../src/errors/TimeoutError.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAIlC"}

package/dist/esm/errors/TimeoutError.js

@@ -0,0 +1,6 @@
+export default class TimeoutError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TimeoutError";
+    }
+}

package/dist/esm/graphApi.js

@@ -6,10 +6,10 @@ import ProtocolError from "./errors/ProtocolError.js";
 import RequestFailedError from "./errors/RequestFailedError.js";
 import { getCurrentAccessToken } from "./services/accessToken.js";
 import { getContext } from "./services/context.js";
+import { executeHttpRequest } from "./services/http.js";
 import { isGatewayTimeout, isHttpSuccess, isHttpTooManyRequests, isServiceUnavailable } from "./services/httpStatus.js";
 import { operationIdToIndex, operationIndexToId } from "./services/operationId.js";
 import { sleep } from "./services/sleep.js";
-import { executeHttpRequest } from "./services/http.js";
 export const authenticationScope = "https://graph.microsoft.com/.default";
 export const endpoint = "https://graph.microsoft.com/v1.0";
 export const batchEndpoint = `${endpoint}/$batch`;
@@ -118,20 +118,20 @@ async function innerFetch(args) {
     }
     let retryAfterMilliseconds = defaultRetryDelayMilliseconds;
     let response = null;
-    let attempts = 0; // Track the number of attempts
-    while (attempts < maxRetries) {
+    let retry = 0;
+    while (retry < maxRetries) {
         try {
             response = await executeHttpRequest({
                 url,
                 ...options,
             });
-            break; // If successful, exit the loop
+            break;
         }
         catch (error) {
             if (axios.isAxiosError(error) && error.response) {
                 response = error.response;
                 if (!(isHttpTooManyRequests(response.status) || isServiceUnavailable(response.status) || isGatewayTimeout(response.status))) {
-                    throw error; // Don't retry for other error codes
+                    throw error;
                 }
                 const requestedRetryAfterSeconds = Number.parseInt(response.headers["retry-after"] ?? "0", 10);
                 if (requestedRetryAfterSeconds) {
@@ -139,13 +139,12 @@ async function innerFetch(args) {
                 }
                 await sleep(retryAfterMilliseconds);
                 retryAfterMilliseconds *= consecutiveRetryDelayMultiplier;
-                attempts++; // Increment the attempt counter
-                if (attempts >= maxRetries) {
+                retry++;
+                if (retry >= maxRetries) {
                     RequestFailedError.throw(`GraphAPI fetch exceed retry limit of ${maxRetries} attempts.`, args);
                 }
             }
             else {
-                // For non-Axios errors or errors without response, just throw
                 throw error;
             }
         }

package/dist/esm/operations/driveItem/initiateCopyDriveItem.d.ts

@@ -1,13 +1,14 @@
 import type { DriveItemRef } from "../../models/DriveItemRef.ts";
+import type { DriveRef } from "../../models/DriveRef.ts";
 import type { GraphOperation } from "../../models/GraphOperation.ts";
 /**
  * Initiate an asynchronous copy of an item. NOTE: The copied file may not be immediately available and polling is required.
  *
  * @param srcFileRef - A reference to the source file to be copied.
- * @param dstFolderRef - A reference to the destination folder.
+ * @param dstFolderRef - A reference to the destination folder or site (if targeting root).
  * @param dstFileName - The name of the copied file.
  * @returns Nothing. The copied file may not be immediately available, and polling is required.
  * @see https://learn.microsoft.com/en-us/graph/api/driveitem-copy
  */
-export default function initiateCopyDriveItem(srcFileRef: DriveItemRef, dstFolderRef: DriveItemRef, dstFileName: string): GraphOperation<void>;
+export default function initiateCopyDriveItem(srcFileRef: DriveItemRef, dstFolderRef: DriveRef | DriveItemRef, dstFileName: string): GraphOperation<void>;
 //# sourceMappingURL=initiateCopyDriveItem.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"initiateCopyDriveItem.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/initiateCopyDriveItem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAkB7I"}
+{"version":3,"file":"initiateCopyDriveItem.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/initiateCopyDriveItem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,GAAG,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAkBxJ"}

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

@@ -4,7 +4,7 @@ import { generatePath } from "../../services/templatedPaths.js";
  * Initiate an asynchronous copy of an item. NOTE: The copied file may not be immediately available and polling is required.
  *
  * @param srcFileRef - A reference to the source file to be copied.
- * @param dstFolderRef - A reference to the destination folder.
+ * @param dstFolderRef - A reference to the destination folder or site (if targeting root).
  * @param dstFileName - The name of the copied file.
  * @returns Nothing. The copied file may not be immediately available, and polling is required.
  * @see https://learn.microsoft.com/en-us/graph/api/driveitem-copy
@@ -22,7 +22,7 @@ export default function initiateCopyDriveItem(srcFileRef, dstFolderRef, dstFileN
             parentReference: {
                 siteId: dstFolderRef.siteId,
                 driveId: dstFolderRef.driveId,
-                id: dstFolderRef.itemId,
+                id: "itemId" in dstFolderRef ? dstFolderRef.itemId : undefined,
             },
         },
         responseTransform: () => undefined,

package/dist/esm/operations/driveItem/moveDriveItem.d.ts

@@ -0,0 +1,14 @@
+import type { DriveItemRef } from "../../models/DriveItemRef.ts";
+import type { DriveRef } from "../../models/DriveRef.ts";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+/**
+ * Moves a file to a new location in the same drive.
+ *
+ * @param srcFileRef - A reference to the source file to be copied.
+ * @param dstFolderRef - A reference to the destination folder or site (if targeting root).
+ * @param dstFileName - The name of the copied file.
+ * @returns new DriveItemRef.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-move
+ */
+export default function moveDriveItem(srcFileRef: DriveItemRef, dstFolderRef: DriveRef | DriveItemRef, dstFileName: string): GraphOperation<void>;
+//# sourceMappingURL=moveDriveItem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"moveDriveItem.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/moveDriveItem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,GAAG,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAkBhJ"}

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

@@ -0,0 +1,30 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/**
+ * Moves a file to a new location in the same drive.
+ *
+ * @param srcFileRef - A reference to the source file to be copied.
+ * @param dstFolderRef - A reference to the destination folder or site (if targeting root).
+ * @param dstFileName - The name of the copied file.
+ * @returns new DriveItemRef.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-move
+ */
+export default function moveDriveItem(srcFileRef, dstFolderRef, dstFileName) {
+    return operation({
+        contextId: srcFileRef.contextId,
+        method: "PATCH",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}", srcFileRef),
+        headers: {
+            "content-type": "application/json",
+        },
+        body: {
+            name: dstFileName,
+            parentReference: {
+                siteId: dstFolderRef.siteId,
+                driveId: dstFolderRef.driveId,
+                id: "itemId" in dstFolderRef ? dstFolderRef.itemId : "root",
+            },
+        },
+        responseTransform: () => undefined,
+    });
+}

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

@@ -19,4 +19,13 @@ export declare function driveItemPath(...segments: string[]): DriveItemPath;
  * @throws ProtocolError if the item ID is missing.
  */
 export declare function createDriveItemRef(driveRef: DriveRef, itemId: DriveItemId | undefined): DriveItemRef;
+/**
+ * Splits a drive item path into its folder path and file name.
+ * @param filePath - The full path of the file.
+ * @returns An object containing the folder path and file name.
+ */
+export declare function splitDriveItemPath(filePath: DriveItemPath): {
+    folderPath: DriveItemPath;
+    fileName: string;
+};
 //# 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":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMtD,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAE5C,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"}
+{"version":3,"file":"driveItem.d.ts","sourceRoot":"","sources":["../../../src/services/driveItem.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMtD,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAE5C,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"}

package/dist/esm/services/driveItem.js

@@ -55,3 +55,20 @@ export function createDriveItemRef(driveRef, itemId) {
         itemId,
     };
 }
+/**
+ * Splits a drive item path into its folder path and file name.
+ * @param filePath - The full path of the file.
+ * @returns An object containing the folder path and file name.
+ */
+export function splitDriveItemPath(filePath) {
+    if (!filePath.startsWith("/")) {
+        throw new InvalidArgumentError("File path must start with a '/'");
+    }
+    const pos = filePath.lastIndexOf("/");
+    const fileName = filePath.substring(pos + 1);
+    const folderPath = (pos === 0 ? "/" : filePath.substring(0, pos));
+    return {
+        folderPath,
+        fileName,
+    };
+}

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

@@ -0,0 +1,14 @@
+import type { DriveItem } from "@microsoft/microsoft-graph-types";
+import type { DriveItemPath } from "../models/DriveItemPath.ts";
+import type { DriveItemRef } from "../models/DriveItemRef.ts";
+import type { DriveRef } from "../models/DriveRef.ts";
+/**
+ * Copy a drive item, blocking and polling for completion.
+ *
+ * @param srcFileRef - A reference to the source file to be copied.
+ * @param dstFilePath - Destination file path
+ * @param timeoutMs - Timeout in milliseconds for the copy operation.
+ * @returns
+ */
+export default function copyDriveItem(srcFileRef: DriveItemRef, dstDriveRef: DriveRef, dstFilePath: DriveItemPath, timeoutMs?: number): Promise<DriveItem & DriveItemRef>;
+//# sourceMappingURL=copyDriveItem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"copyDriveItem.d.ts","sourceRoot":"","sources":["../../../src/tasks/copyDriveItem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMtD;;;;;;;GAOG;AACH,wBAA8B,aAAa,CAAC,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,SAAQ,GAAG,OAAO,CAAC,SAAS,GAAG,YAAY,CAAC,CAqB7K"}

package/dist/esm/tasks/copyDriveItem.js

@@ -0,0 +1,33 @@
+import TimeoutError from "../errors/TimeoutError.js";
+import getDriveItemByPath from "../operations/driveItem/getDriveItemByPath.js";
+import initiateCopyDriveItem from "../operations/driveItem/initiateCopyDriveItem.js";
+import { splitDriveItemPath } from "../services/driveItem.js";
+import { sleep } from "../services/sleep.js";
+/**
+ * Copy a drive item, blocking and polling for completion.
+ *
+ * @param srcFileRef - A reference to the source file to be copied.
+ * @param dstFilePath - Destination file path
+ * @param timeoutMs - Timeout in milliseconds for the copy operation.
+ * @returns
+ */
+export default async function copyDriveItem(srcFileRef, dstDriveRef, dstFilePath, timeoutMs = 16000) {
+    const { folderPath, fileName } = splitDriveItemPath(dstFilePath);
+    const dstFolder = folderPath === "/" ? dstDriveRef : await getDriveItemByPath(dstDriveRef, folderPath);
+    await initiateCopyDriveItem(srcFileRef, dstFolder, fileName);
+    const start = Date.now();
+    let delay = 1000;
+    while (true) {
+        try {
+            return await getDriveItemByPath(dstDriveRef, dstFilePath);
+        }
+        catch (_) {
+            const elapsedTime = Date.now() - start;
+            if (elapsedTime + delay > timeoutMs) {
+                throw new TimeoutError(`Timeout while copying ${srcFileRef.itemId} to ${dstFilePath}`);
+            }
+            await sleep(delay);
+            delay = Math.min(delay * 2, timeoutMs - (Date.now() - start)); // Double the delay but don't exceed remaining time
+        }
+    }
+}