microsoft-graph 3.7.2 → 3.9.0

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

@@ -1 +1 @@
-{"version":3,"file":"createDriveItem.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/createDriveItem.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,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;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC,SAAS,GAAG,YAAY,CAAC,CAsBxL"}
+{"version":3,"file":"createDriveItem.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/createDriveItem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,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;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC,SAAS,GAAG,YAAY,CAAC,CAsBxL"}

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

@@ -2,6 +2,7 @@
  * Creates new drive item in the specified parent drive or folder.
  * @module createDriveItem
  * @category Operations
+ * @hidden
  */
 import { createDriveItemRef } from "../../services/driveItem.js";
 import { operation } from "../../services/operationInvoker.js";
@@ -13,6 +14,8 @@ import { generatePath } from "../../services/templatedPaths.js";
  * @returns The newly created drive item.
  * @remarks If the file already exists, it will be replaced.
  * @see https://learn.microsoft.com/en-us/graph/api/driveitem-put-content
+ * @deprecated Use {@link createDriveItemContent} instead for uploading content.
+ * @hidden
  */
 export default function createDriveItem(parentRef, itemPath, contextType, content) {
     const pathSegment = parentRef.itemId ? "items/{item-id}" : "root";

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

@@ -0,0 +1,21 @@
+/**
+ * Creates a new drive item in the specified parent drive or folder using a stream as content.
+ * @module createDriveItemContent
+ * @category Operations
+ */
+import type { DriveItem } from "@microsoft/microsoft-graph-types";
+import type { DriveRef } from "../../models/Drive.ts";
+import type { DriveItemPath, DriveItemRef } from "../../models/DriveItem.ts";
+/**
+ * Creates a new drive item in the specified parent drive or folder using a stream as content.
+ * @param parentRef Reference to the parent drive or folder where the drive item will be created.
+ * @param itemPath Path (including the filename) for the new drive item within the given parent.
+ * @param contentStream A Node.js readable stream containing the file content.
+ * @param totalSize The total size in bytes of the content to be uploaded.
+ * @param conflictBehavior Optional. Specifies how to handle conflicts if the file already exists. Default is 'fail'.
+ * @returns The newly created drive item.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-createuploadsession
+ * @see https://learn.microsoft.com/en-us/graph/api/resources/uploadsession
+ */
+export default function createDriveItemContent(parentRef: DriveRef | DriveItemRef, itemPath: DriveItemPath, contentStream: NodeJS.ReadableStream, totalSize: number, conflictBehavior?: "fail" | "replace" | "rename", chunkSize?: number): Promise<DriveItem & DriveItemRef>;
+//# sourceMappingURL=createDriveItemContent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createDriveItemContent.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/createDriveItemContent.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;AAkB1F;;;;;;;;;;GAUG;AACH,wBAA8B,sBAAsB,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,CAAC,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,GAAE,MAAM,GAAG,SAAS,GAAG,QAAiB,EAAE,SAAS,SAAmB,GAAG,OAAO,CAAC,SAAS,GAAG,YAAY,CAAC,CAmGpS"}

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

@@ -0,0 +1,116 @@
+/**
+ * Creates a new drive item in the specified parent drive or folder using a stream as content.
+ * @module createDriveItemContent
+ * @category Operations
+ */
+import ProtocolError from "../../errors/ProtocolError.js";
+import { createDriveItemRef } from "../../services/driveItem.js";
+import { execute } from "../../services/http.js";
+import { endpoint } from "../../services/operationInvoker.js";
+import { generatePath } from "../../services/templatedPaths.js";
+const defaultChunkSize = 10 * 1024 * 1024;
+/**
+ * Creates a new drive item in the specified parent drive or folder using a stream as content.
+ * @param parentRef Reference to the parent drive or folder where the drive item will be created.
+ * @param itemPath Path (including the filename) for the new drive item within the given parent.
+ * @param contentStream A Node.js readable stream containing the file content.
+ * @param totalSize The total size in bytes of the content to be uploaded.
+ * @param conflictBehavior Optional. Specifies how to handle conflicts if the file already exists. Default is 'fail'.
+ * @returns The newly created drive item.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-createuploadsession
+ * @see https://learn.microsoft.com/en-us/graph/api/resources/uploadsession
+ */
+export default async function createDriveItemContent(parentRef, itemPath, contentStream, totalSize, conflictBehavior = "fail", chunkSize = defaultChunkSize) {
+    const pathSegment = parentRef.itemId ? "items/{item-id}" : "root";
+    const uploadSessionUrl = `${endpoint}${generatePath(`/sites/{site-id}/drives/{drive-id}/${pathSegment}:/${itemPath}:/createUploadSession`, parentRef)}`;
+    const accessToken = await parentRef.context.generateAccessToken();
+    const fileName = itemPath.split("/").pop();
+    const { uploadUrl } = await execute({
+        url: uploadSessionUrl,
+        method: "POST",
+        headers: {
+            authorization: `Bearer ${accessToken}`,
+            "content-type": "application/json",
+        },
+        data: JSON.stringify({
+            item: {
+                "@microsoft.graph.conflictBehavior": conflictBehavior,
+                name: fileName,
+            },
+        }),
+        responseType: "json",
+    });
+    let position = 0;
+    let driveItem = null;
+    let streamEnded = false;
+    const chunks = [];
+    contentStream.on("data", (chunk) => {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    });
+    contentStream.on("end", () => {
+        streamEnded = true;
+    });
+    contentStream.on("error", () => {
+        // error will be handled in readChunk
+    });
+    let chunk = await readChunk();
+    while (chunk !== null) {
+        let currentChunk = chunk;
+        while (currentChunk.length > 0) {
+            const thisChunk = currentChunk.subarray(0, chunkSize);
+            const start = position;
+            const end = position + thisChunk.length - 1;
+            const contentRange = `bytes ${start}-${end}/${totalSize}`;
+            const res = await execute({
+                url: uploadUrl,
+                method: "PUT",
+                headers: {
+                    "Content-Length": thisChunk.length.toString(),
+                    "Content-Range": contentRange,
+                },
+                data: thisChunk,
+                responseType: "json",
+            });
+            position += thisChunk.length;
+            currentChunk = currentChunk.subarray(chunkSize);
+            if (isDriveItem(res)) {
+                driveItem = res;
+                break;
+            }
+        }
+        if (driveItem)
+            break;
+        chunk = await readChunk();
+    }
+    if (!driveItem) {
+        throw new ProtocolError(`Upload did not complete successfully. Last position: ${position}`);
+    }
+    const itemRef = createDriveItemRef(parentRef, driveItem.id);
+    return {
+        ...driveItem,
+        ...itemRef,
+    };
+    function isDriveItem(obj) {
+        return typeof obj === "object" && obj !== null && "id" in obj;
+    }
+    function readChunk() {
+        return new Promise((resolve, reject) => {
+            if (chunks.length > 0) {
+                const next = chunks.shift();
+                return resolve(next ?? null);
+            }
+            if (streamEnded)
+                return resolve(null);
+            contentStream.once("data", (chunk) => {
+                resolve(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+            });
+            contentStream.once("end", () => {
+                streamEnded = true;
+                resolve(null);
+            });
+            contentStream.once("error", (err) => {
+                reject(err);
+            });
+        });
+    }
+}

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

@@ -1 +1 @@
-{"version":3,"file":"existsDriveItem.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/existsDriveItem.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAM/D;;;;GAIG;AACH,wBAA8B,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAuB3G"}
+{"version":3,"file":"existsDriveItem.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/existsDriveItem.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAM/D;;;;GAIG;AACH,wBAA8B,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAsB3G"}

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

@@ -3,7 +3,7 @@
  * @module existsDriveItem
  * @category Operations
  */
-import { executeHttpRequest } from "../../services/http.js";
+import { executeRaw } from "../../services/http.js";
 import { isHttpNotFound, isHttpOk } from "../../services/httpStatus.js";
 import { endpoint } from "../../services/operationInvoker.js";
 import { generatePath } from "../../services/templatedPaths.js";
@@ -16,13 +16,12 @@ export default async function existsDriveItem(driveRef, itemPath) {
     // Note this method doesn't match the standard pattern since the batching library doesn't support non-JSON return types.
     const url = `${endpoint}${generatePath(`/sites/{site-id}/drives/{drive-id}/root:${itemPath}`, driveRef)}`;
     const accessToken = await driveRef.context.generateAccessToken();
-    const response = await executeHttpRequest({
+    const response = await executeRaw({
         url,
         method: "GET",
         headers: {
             authorization: `Bearer ${accessToken}`,
         },
-        validateStatus: () => true,
     });
     if (isHttpOk(response.status)) {
         return true;

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

@@ -1 +1 @@
-{"version":3,"file":"getDriveItemContent.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/getDriveItemContent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAM9D;;;;;;;;;GASG;AACH,wBAA8B,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA6B7F"}
+{"version":3,"file":"getDriveItemContent.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/getDriveItemContent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAK9D;;;;;;;;;GASG;AACH,wBAA8B,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAqB7F"}

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

@@ -4,9 +4,8 @@
  * @category Operations
  * @hidden
  */
-import { executeHttpRequest } from "../../services/http.js";
-import { isHttpSuccess } from "../../services/httpStatus.js";
-import { endpoint, throwException } from "../../services/operationInvoker.js";
+import { execute } from "../../services/http.js";
+import { endpoint } from "../../services/operationInvoker.js";
 import { generatePath } from "../../services/templatedPaths.js";
 /**
  * Download the content of a drive item.
@@ -22,7 +21,7 @@ export default async function getDriveItemContent(itemRef) {
     // Note this method doesn't match the standard pattern since the batching library doesn't support non-JSON return types, and there appears to be no value in adding support.
     const url = `${endpoint}${generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/content", itemRef)}`;
     const accessToken = await itemRef.context.generateAccessToken();
-    const response = await executeHttpRequest({
+    const response = await execute({
         url,
         method: "GET",
         headers: {
@@ -30,13 +29,7 @@ export default async function getDriveItemContent(itemRef) {
         },
         responseType: "arraybuffer",
     });
-    if (!isHttpSuccess(response.status)) {
-        throwException(response.status, "Failed to get content");
-    }
-    if (!Buffer.isBuffer(response.data)) {
-        throw new Error(`Unexpected response type: ${typeof response.data}`);
-    }
-    const buffer = response.data.buffer.slice(response.data.byteOffset, response.data.byteOffset + response.data.byteLength);
+    const buffer = response.buffer.slice(response.byteOffset, response.byteOffset + response.byteLength);
     if (!(buffer instanceof ArrayBuffer)) {
         throw new Error("Failed to convert Buffer to ArrayBuffer");
     }

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

@@ -1 +1 @@
-{"version":3,"file":"streamDriveItemContent.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/streamDriveItemContent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAM9D;;;;;;;GAOG;AACH,wBAA8B,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAuB1G"}
+{"version":3,"file":"streamDriveItemContent.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/streamDriveItemContent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAK9D;;;;;;;GAOG;AACH,wBAA8B,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAe1G"}

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

@@ -3,9 +3,8 @@
  * @module streamDriveItemContent
  * @category Operations
  */
-import { executeHttpRequest } from "../../services/http.js";
-import { isHttpSuccess } from "../../services/httpStatus.js";
-import { endpoint, throwException } from "../../services/operationInvoker.js";
+import { execute } from "../../services/http.js";
+import { endpoint } from "../../services/operationInvoker.js";
 import { generatePath } from "../../services/templatedPaths.js";
 /**
  * Stream the content of a drive item.
@@ -19,7 +18,7 @@ export default async function streamDriveItemContent(itemRef) {
     // TODO: Rename to getDriveItemContent at next breaking update
     const url = `${endpoint}${generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/content", itemRef)}`;
     const accessToken = await itemRef.context.generateAccessToken();
-    const response = await executeHttpRequest({
+    const response = await execute({
         url,
         method: "GET",
         headers: {
@@ -27,11 +26,5 @@ export default async function streamDriveItemContent(itemRef) {
         },
         responseType: "stream",
     });
-    if (!isHttpSuccess(response.status)) {
-        throwException(response.status, "Failed to stream content");
-    }
-    if (!response || typeof response.data?.pipe !== "function") {
-        throw new Error("Failed to get a streamable response");
-    }
-    return response.data;
+    return response;
 }

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

@@ -3,6 +3,16 @@
  * @module http
  * @category Services
  */
-import { type AxiosRequestConfig } from "axios";
-export declare function executeHttpRequest(config: AxiosRequestConfig): Promise<import("axios").AxiosResponse<any, any>>;
+import { type AxiosResponse, type RawAxiosRequestHeaders, type ResponseType } from "axios";
+import type { HttpMethod } from "../models/Http.ts";
+export type Request = {
+    url: string;
+    method: HttpMethod;
+    headers?: RawAxiosRequestHeaders;
+    data?: unknown;
+    responseType?: ResponseType;
+};
+export declare function execute<TResponse>(request: Request): Promise<TResponse>;
+export declare function throwHttpException(responseCode: number, message: string): never;
+export declare function executeRaw(request: Request): Promise<AxiosResponse<any, any>>;
 //# sourceMappingURL=http.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/services/http.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAc,EAAsB,KAAK,kBAAkB,EAA4B,MAAM,OAAO,CAAC;AAKrG,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,oDAMlE"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/services/http.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAc,EAA+C,KAAK,aAAa,EAA4B,KAAK,sBAAsB,EAAE,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AA0BzK,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAkCpD,MAAM,MAAM,OAAO,GAAG;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF,wBAAsB,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAkD7E;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAwE/E;AAID,wBAAsB,UAAU,CAAC,OAAO,EAAE,OAAO,oCAMhD"}

package/dist/esm/services/http.js

@@ -5,12 +5,159 @@
  */
 import axios from "axios";
 import { HttpsProxyAgent } from "https-proxy-agent";
+import BadRequestError from "../errors/BadRequestError.js";
+import BandwidthLimitExceededError from "../errors/BandwidthLimitExceededError.js";
+import ConflictError from "../errors/ConflictError.js";
+import ForbiddenError from "../errors/ForbiddenError.js";
+import GatewayTimeoutError from "../errors/GatewayTimeoutError.js";
+import GoneError from "../errors/GoneError.js";
+import InsufficientStorageError from "../errors/InsufficientStorageError.js";
+import InternalServerError from "../errors/InternalServerError.js";
+import LengthRequiredError from "../errors/LengthRequiredError.js";
+import LockedError from "../errors/LockedError.js";
+import MethodNotAllowedError from "../errors/MethodNotAllowedError.js";
+import NeverError from "../errors/NeverError.js";
+import NotAcceptableError from "../errors/NotAcceptableError.js";
+import NotFoundError from "../errors/NotFoundError.js";
+import NotImplementedError from "../errors/NotImplementedError.js";
+import PaymentRequiredError from "../errors/PaymentRequiredError.js";
+import PreconditionFailedError from "../errors/PreconditionFailedError.js";
+import RequestedRangeNotSatisfiableError from "../errors/RequestedRangeNotSatisfiableError.js";
+import RequestEntityTooLargeError from "../errors/RequestEntityTooLargeError.js";
+import ServiceUnavailableError from "../errors/ServiceUnavailableError.js";
+import TooManyRequestsError from "../errors/TooManyRequestsError.js";
+import UnauthorizedError from "../errors/UnauthorizedError.js";
+import UnprocessableEntityError from "../errors/UnprocessableEntityError.js";
+import UnsupportedMediaTypeError from "../errors/UnsupportedMediaTypeError.js";
+import { isHttpBadRequest, isHttpBandwidthLimitExceeded, isHttpConflict, isHttpForbidden, isHttpGatewayTimeout, isHttpGone, isHttpInsufficientStorage, isHttpInternalServerError, isHttpLengthRequired, isHttpLocked, isHttpMethodNotAllowed, isHttpNotAcceptable, isHttpNotFound, isHttpNotImplemented, isHttpPaymentRequired, isHttpPreconditionFailed, isHttpRequestedRangeNotSatisfiable, isHttpRequestEntityTooLarge, isHttpServiceUnavailable, isHttpSuccess, isHttpTooManyRequests, isHttpUnauthorized, isHttpUnprocessableEntity, isHttpUnsupportedMediaType, isRetryable, } from "./httpStatus.js";
+import { sleep } from "./sleep.js";
+const maxRetries = 3;
+const defaultRetryDelayMilliseconds = 1000;
+const consecutiveRetryDelayMultiplier = 2;
+export async function execute(request) {
+    let retryAfterMilliseconds = defaultRetryDelayMilliseconds;
+    let response = null;
+    let attempts = 0;
+    let errorLog = "";
+    while (true) {
+        try {
+            response = await executeRaw(request);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : error?.toString() || "Unknown error";
+            response = {
+                status: -1,
+                statusText: message,
+                headers: {},
+                data: null,
+                config: request,
+                request: null,
+            };
+            errorLog += message;
+        }
+        errorLog += requestToString(request);
+        errorLog += responseToString(response);
+        attempts++;
+        if (isHttpSuccess(response.status) || !isRetryable(response.status) || attempts === maxRetries) {
+            break;
+        }
+        const requestedRetryAfterSeconds = Number.parseInt(response.headers["retry-after"] ?? "0", 10);
+        if (requestedRetryAfterSeconds) {
+            retryAfterMilliseconds = requestedRetryAfterSeconds * 1000;
+        }
+        else {
+            retryAfterMilliseconds += Math.random() * 1000; // Add some randomness to the retry delay to avoid thundering herd problem
+        }
+        errorLog += waitToString(retryAfterMilliseconds);
+        await sleep(retryAfterMilliseconds);
+        retryAfterMilliseconds *= consecutiveRetryDelayMultiplier;
+    }
+    if (!response) {
+        throw new NeverError("Response is empty.");
+    }
+    if (!isHttpSuccess(response.status)) {
+        handleResponseError(response, errorLog, attempts);
+    }
+    return response.data;
+}
+export function throwHttpException(responseCode, message) {
+    if (isHttpBadRequest(responseCode)) {
+        throw new BadRequestError(message);
+    }
+    if (isHttpUnauthorized(responseCode)) {
+        throw new UnauthorizedError(message);
+    }
+    if (isHttpPaymentRequired(responseCode)) {
+        throw new PaymentRequiredError(message);
+    }
+    if (isHttpForbidden(responseCode)) {
+        throw new ForbiddenError(message);
+    }
+    if (isHttpNotFound(responseCode)) {
+        throw new NotFoundError(message);
+    }
+    if (isHttpMethodNotAllowed(responseCode)) {
+        throw new MethodNotAllowedError(message);
+    }
+    if (isHttpNotAcceptable(responseCode)) {
+        throw new NotAcceptableError(message);
+    }
+    if (isHttpConflict(responseCode)) {
+        throw new ConflictError(message);
+    }
+    if (isHttpGone(responseCode)) {
+        throw new GoneError(message);
+    }
+    if (isHttpLengthRequired(responseCode)) {
+        throw new LengthRequiredError(message);
+    }
+    if (isHttpPreconditionFailed(responseCode)) {
+        throw new PreconditionFailedError(message);
+    }
+    if (isHttpRequestEntityTooLarge(responseCode)) {
+        throw new RequestEntityTooLargeError(message);
+    }
+    if (isHttpUnsupportedMediaType(responseCode)) {
+        throw new UnsupportedMediaTypeError(message);
+    }
+    if (isHttpRequestedRangeNotSatisfiable(responseCode)) {
+        throw new RequestedRangeNotSatisfiableError(message);
+    }
+    if (isHttpUnprocessableEntity(responseCode)) {
+        throw new UnprocessableEntityError(message);
+    }
+    if (isHttpLocked(responseCode)) {
+        throw new LockedError(message);
+    }
+    if (isHttpTooManyRequests(responseCode)) {
+        throw new TooManyRequestsError(message);
+    }
+    if (isHttpInternalServerError(responseCode)) {
+        throw new InternalServerError(message);
+    }
+    if (isHttpNotImplemented(responseCode)) {
+        throw new NotImplementedError(message);
+    }
+    if (isHttpServiceUnavailable(responseCode)) {
+        throw new ServiceUnavailableError(message);
+    }
+    if (isHttpGatewayTimeout(responseCode)) {
+        throw new GatewayTimeoutError(message);
+    }
+    if (isHttpInsufficientStorage(responseCode)) {
+        throw new InsufficientStorageError(message);
+    }
+    if (isHttpBandwidthLimitExceeded(responseCode)) {
+        throw new BandwidthLimitExceededError(message);
+    }
+    throw new Error(message);
+}
 let instance = null;
-export async function executeHttpRequest(config) {
+export async function executeRaw(request) {
     if (!instance) {
         instance = createAxiosInstance();
     }
-    return await instance(config);
+    return await instance(request);
 }
 function createAxiosInstance() {
     const config = {
@@ -24,3 +171,58 @@ function createAxiosInstance() {
     }
     return axios.create(config);
 }
+function requestToString(request) {
+    const url = request.url || "";
+    let message = ` 📤 ${request.method} ${url}\n`;
+    if (request.data) {
+        message += errorObjectToString(request.data);
+    }
+    return message;
+}
+function responseToString(response) {
+    const message = ` 📥 ${response.status} ${response.statusText}\n`;
+    // TODO: Is there any case where we care about the response body?
+    // if (response.data) {
+    // 	message += errorObjectToString(response.data);
+    // }
+    return message;
+}
+function waitToString(milliseconds) {
+    return ` ⏳ Wait ${milliseconds}ms for retry.\n`;
+}
+function errorObjectToString(obj) {
+    const maxLength = 1024;
+    const ellipses = "...";
+    let str = JSON.stringify(obj, null, 2)
+        .split("\n")
+        .map((line) => `    ${line}`)
+        .join("\n");
+    if (str.length > maxLength) {
+        str = `${str.substring(0, maxLength - ellipses.length)}${ellipses}`;
+    }
+    return `${str}\n`;
+}
+function handleResponseError(response, errorLog, attempts, operationIndex = null) {
+    const error = response.data;
+    let message = error?.error?.message;
+    if (message && !message.endsWith(".")) {
+        message += ".";
+    }
+    if (error?.error?.innerError?.message) {
+        message += ` ${error.error.innerError.message}`;
+    }
+    if (message && !message.endsWith(".")) {
+        message += ".";
+    }
+    if (!message) {
+        message = response.statusText;
+    }
+    if (attempts > 1) {
+        message += ` Operation attempted ${attempts} time(s).`;
+    }
+    if (operationIndex !== null) {
+        message += ` (op #${operationIndex})`;
+    }
+    message += `\n${errorLog}`;
+    throwHttpException(response.status, message);
+}

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

@@ -15,6 +15,12 @@ export declare function isHttpSuccess(status: number): boolean;
  * @returns True if the status code is 200, otherwise false.
  */
 export declare function isHttpOk(status: number): boolean;
+/**
+ * Checks if the HTTP status code is created
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 201, otherwise false.
+ */
+export declare function isHttpCreated(status: number): boolean;
 /**
  * Checks if the HTTP status code indicates not found.
  * @param status - The HTTP status code.

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

@@ -1 +1 @@
-{"version":3,"file":"httpStatus.d.ts","sourceRoot":"","sources":["../../../src/services/httpStatus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAenD"}
+{"version":3,"file":"httpStatus.d.ts","sourceRoot":"","sources":["../../../src/services/httpStatus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAenD"}

package/dist/esm/services/httpStatus.js

@@ -19,6 +19,14 @@ export function isHttpSuccess(status) {
 export function isHttpOk(status) {
     return status === 200;
 }
+/**
+ * Checks if the HTTP status code is created
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 201, otherwise false.
+ */
+export function isHttpCreated(status) {
+    return status === 201;
+}
 /**
  * Checks if the HTTP status code indicates not found.
  * @param status - The HTTP status code.

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

@@ -1,12 +1,12 @@
 /**
  * Utilities for iterating over AsyncIterables.
+ * Collects all items from an Iterable or AsyncIterable into an array, optionally converting each item.
  * @module Iteration
  * @category Services
+ * @template TIn The type of items in the input iterable.
+ * @template TOut The type of items in the resulting array (after conversion).
+ * @param {Iterable<TIn> | AsyncIterable<TIn>} iterable - The iterable or async iterable to collect items from.
+ * @returns {Promise<TOut[]>} A promise that resolves to an array of collected (and possibly converted) items.
  */
-/**
- * Iterate over an AsyncIterable and collect all items into an array.
- * @param iterable
- * @returns Array of items collected from the iterable.
- */
-export declare function iterateToArray<T, U = T>(iterable: AsyncIterable<T>, converter?: (item: T) => U): Promise<U[]>;
+export declare function iterateToArray<TIn, TOut = TIn>(iterable: Iterable<TIn> | AsyncIterable<TIn>, converter?: (item: TIn) => TOut): Promise<TOut[]>;
 //# sourceMappingURL=iteration.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"iteration.d.ts","sourceRoot":"","sources":["../../../src/services/iteration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAMnH"}
+{"version":3,"file":"iteration.d.ts","sourceRoot":"","sources":["../../../src/services/iteration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,IAAI,GAAG,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAMpJ"}

package/dist/esm/services/iteration.js

@@ -1,12 +1,12 @@
 /**
  * Utilities for iterating over AsyncIterables.
+ * Collects all items from an Iterable or AsyncIterable into an array, optionally converting each item.
  * @module Iteration
  * @category Services
- */
-/**
- * Iterate over an AsyncIterable and collect all items into an array.
- * @param iterable
- * @returns Array of items collected from the iterable.
+ * @template TIn The type of items in the input iterable.
+ * @template TOut The type of items in the resulting array (after conversion).
+ * @param {Iterable<TIn> | AsyncIterable<TIn>} iterable - The iterable or async iterable to collect items from.
+ * @returns {Promise<TOut[]>} A promise that resolves to an array of collected (and possibly converted) items.
  */
 export async function iterateToArray(iterable, converter) {
     const result = [];

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

@@ -39,5 +39,4 @@ export declare function parallel<T extends GraphOperation<unknown>[]>(...operati
  * @returns The responses for each operation, in the same order.
  */
 export declare function sequential<T extends GraphOperation<unknown>[]>(...operations: T): Promise<OperationResponse<T>>;
-export declare function throwException(responseCode: number, message: string): never;
 //# sourceMappingURL=operationInvoker.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"operationInvoker.d.ts","sourceRoot":"","sources":["../../../src/services/operationInvoker.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,cAAc,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAiC/G;;;GAGG;AACH,eAAO,MAAM,QAAQ,qCAAqC,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,aAAa,4CAAuB,CAAC;AAElD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAQvF;AAED;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,CAAC,SAAS,cAAc,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,UAAU,EAAE,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAInH;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,CAAC,SAAS,cAAc,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,UAAU,EAAE,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAOrH;AAoND,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAwE3E"}
+{"version":3,"file":"operationInvoker.d.ts","sourceRoot":"","sources":["../../../src/services/operationInvoker.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAM/G;;;GAGG;AACH,eAAO,MAAM,QAAQ,qCAAqC,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,aAAa,4CAAuB,CAAC;AAElD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAQvF;AAED;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,CAAC,SAAS,cAAc,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,UAAU,EAAE,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAInH;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,CAAC,SAAS,cAAc,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,UAAU,EAAE,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAOrH"}