microsoft-graph 3.7.1 → 3.8.0

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/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"}

package/dist/esm/services/operationInvoker.js

@@ -1,34 +1,15 @@
-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";
+/**
+ * Invoke operations, potentially as parallel or sequential batches.
+ * @module operationInvoker
+ * @category Services
+ **/
 import InconsistentContextError from "../errors/InconsistentContextError.js";
-import InsufficientStorageError from "../errors/InsufficientStorageError.js";
-import InternalServerError from "../errors/InternalServerError.js";
 import InvalidArgumentError from "../errors/InvalidArgumentError.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 ProtocolError from "../errors/ProtocolError.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 { executeHttpRequest } from "./http.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 { execute, throwHttpException } from "./http.js";
+import { isHttpSuccess } from "./httpStatus.js";
 import { operationIdToIndex, operationIndexToId } from "./operationId.js";
-import { sleep } from "./sleep.js";
 /**
  * Endpoint for submitting individual requests.
  * @internal
@@ -86,12 +67,9 @@ export async function sequential(...operations) {
     return (await executeBatch(...definitions));
 }
 const maxBatchOperations = 20; // https://learn.microsoft.com/en-us/graph/json-batching?tabs=http#batch-size-limitations
-const maxRetries = 3;
-const defaultRetryDelayMilliseconds = 1000;
-const consecutiveRetryDelayMultiplier = 2;
 async function executeSingle(definition) {
     const accessToken = await definition.context.generateAccessToken();
-    const response = await innerFetch({
+    const response = await execute({
         url: `${endpoint}${definition.path}`,
         method: definition.method,
         headers: {
@@ -116,7 +94,7 @@ async function executeBatch(...ops) {
         throw new InconsistentContextError("All operations in a batch must share the same context.");
     }
     const accessToken = await context.generateAccessToken();
-    const body = await innerFetch({
+    const body = await execute({
         url: batchEndpoint,
         method: "POST",
         headers: {
@@ -146,188 +124,12 @@ async function executeBatch(...ops) {
             throw new ProtocolError("Reference to operation that was not submitted in the batch");
         }
         if (!isHttpSuccess(r.status)) {
-            throwException(r.status, `Batch operation failed for op #${index}: ${JSON.stringify(r.body, null, 2)}`);
+            throwHttpException(r.status, `Batch operation failed for op #${index}: ${JSON.stringify(r.body, null, 2)}`);
         }
         responses[index] = op.responseTransform(body);
     }
     return responses; // TODO: Is there a neater way to massage the types correctly? This is functionally correct, but I do want to avoid using `unknown` here if possible.
 }
-async function innerFetch(request) {
-    let retryAfterMilliseconds = defaultRetryDelayMilliseconds;
-    let response = null;
-    let attempts = 0;
-    let errorLog = "";
-    while (true) {
-        try {
-            response = await executeHttpRequest(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;
-}
-function requestToString(request) {
-    let url = request.url || "";
-    if (url.startsWith(endpoint)) {
-        url = url.substring(endpoint.length);
-    }
-    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}`;
-    throwException(response.status, message);
-}
-export function throwException(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 NeverError(message);
-}
 function normalizeBatchBody(contentType, body) {
     if (contentType?.startsWith("application/json") && typeof body === "string") {
         return JSON.parse(atob(body));

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

@@ -0,0 +1,25 @@
+import type { Address, CellRangeAddress, UsedAddress } from "../models/Address.ts";
+/**
+ * Resolves a used range address (which may use partial or open-ended A1 notation, e.g., ":D5", "C:", etc.) against a concrete used range.
+ *
+ * This function fills in any missing start/end columns or rows in the `usedRangeAddress` using the corresponding values from the provided `usedRange`.
+ *
+ * @param address - The used range address (may be open-ended, e.g., ":D5", "C:", etc.).
+ * @param usedRange - The concrete used range address to resolve against (e.g., "B2:E10").
+ * @returns The resolved address as a concrete A1 range (e.g., "C2:E10"), or null if there is no overlap.
+ * @throws {InvalidArgumentError} If the used range address is invalid or cannot be resolved.
+ *
+ * @example
+ * // If usedRange is "B2:E10":
+ * //   resolveUsedRangeAddress("C:", usedRange)   // "C2:E10"
+ * //   resolveUsedRangeAddress(":D", usedRange)   // "B2:D10"
+ * //   resolveUsedRangeAddress("3:", usedRange)   // "B3:E10"
+ * //   resolveUsedRangeAddress(":5", usedRange)   // "B2:E5"
+ * //   resolveUsedRangeAddress("C3:", usedRange)  // "C3:E10"
+ * //   resolveUsedRangeAddress(":D5", usedRange)  // "B2:D5"
+ * //   resolveUsedRangeAddress(":", usedRange)    // "B2:E10"
+ * //   resolveUsedRangeAddress("Z100:Z200", usedRange) // null (no overlap)
+ * //   resolveUsedRangeAddress("A1:A1", usedRange) // null (no overlap)
+ */
+export declare function resolveUsedAddress(address: Address | UsedAddress, usedRange: CellRangeAddress): Address | null;
+//# sourceMappingURL=usedAddress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usedAddress.d.ts","sourceRoot":"","sources":["../../../src/services/usedAddress.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMnF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,EAAE,SAAS,EAAE,gBAAgB,GAAG,OAAO,GAAG,IAAI,CAuC9G"}

package/dist/esm/services/usedAddress.js

@@ -0,0 +1,63 @@
+import InvalidArgumentError from "../errors/InvalidArgumentError.js";
+import { composeAddress, decomposeAddress } from "./addressManipulation.js";
+import { columnAddressToOffset, rowAddressToOffset } from "./addressOffset.js";
+const pattern = /^(?<startColumn>[A-Z]*)(?<startRow>[0-9]*):(?<endColumn>[A-Z]*)(?<endRow>[0-9]*)$/;
+/**
+ * Resolves a used range address (which may use partial or open-ended A1 notation, e.g., ":D5", "C:", etc.) against a concrete used range.
+ *
+ * This function fills in any missing start/end columns or rows in the `usedRangeAddress` using the corresponding values from the provided `usedRange`.
+ *
+ * @param address - The used range address (may be open-ended, e.g., ":D5", "C:", etc.).
+ * @param usedRange - The concrete used range address to resolve against (e.g., "B2:E10").
+ * @returns The resolved address as a concrete A1 range (e.g., "C2:E10"), or null if there is no overlap.
+ * @throws {InvalidArgumentError} If the used range address is invalid or cannot be resolved.
+ *
+ * @example
+ * // If usedRange is "B2:E10":
+ * //   resolveUsedRangeAddress("C:", usedRange)   // "C2:E10"
+ * //   resolveUsedRangeAddress(":D", usedRange)   // "B2:D10"
+ * //   resolveUsedRangeAddress("3:", usedRange)   // "B3:E10"
+ * //   resolveUsedRangeAddress(":5", usedRange)   // "B2:E5"
+ * //   resolveUsedRangeAddress("C3:", usedRange)  // "C3:E10"
+ * //   resolveUsedRangeAddress(":D5", usedRange)  // "B2:D5"
+ * //   resolveUsedRangeAddress(":", usedRange)    // "B2:E10"
+ * //   resolveUsedRangeAddress("Z100:Z200", usedRange) // null (no overlap)
+ * //   resolveUsedRangeAddress("A1:A1", usedRange) // null (no overlap)
+ */
+export function resolveUsedAddress(address, usedRange) {
+    const match = pattern.exec(address.toUpperCase());
+    if (!match || !match.groups) {
+        throw new InvalidArgumentError(`Invalid used range address '${address}', Must match pattern '${pattern}'.`);
+    }
+    let { startColumn, startRow, endColumn, endRow } = match.groups;
+    const { startColumn: usedStartColumn, endColumn: usedEndColumn, startRow: usedStartRow, endRow: usedEndRow } = decomposeAddress(usedRange);
+    if (!startColumn)
+        startColumn = usedStartColumn;
+    if (!endColumn)
+        endColumn = usedEndColumn;
+    if (!startRow)
+        startRow = usedStartRow;
+    if (!endRow)
+        endRow = usedEndRow;
+    const resolved = composeAddress({
+        startColumn: startColumn,
+        endColumn: endColumn,
+        startRow: startRow,
+        endRow: endRow,
+    });
+    const decomposed = decomposeAddress(resolved);
+    const resStartCol = columnAddressToOffset(decomposed.startColumn);
+    const resEndCol = columnAddressToOffset(decomposed.endColumn);
+    const usedStartCol = columnAddressToOffset(usedStartColumn);
+    const usedEndCol = columnAddressToOffset(usedEndColumn);
+    const resStartRow = rowAddressToOffset(decomposed.startRow);
+    const resEndRow = rowAddressToOffset(decomposed.endRow);
+    const usedStartRowNum = rowAddressToOffset(usedStartRow);
+    const usedEndRowNum = rowAddressToOffset(usedEndRow);
+    const colOverlap = resStartCol <= usedEndCol && resEndCol >= usedStartCol;
+    const rowOverlap = resStartRow <= usedEndRowNum && resEndRow >= usedStartRowNum;
+    if (!colOverlap || !rowOverlap) {
+        return null;
+    }
+    return resolved;
+}

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

@@ -1 +1 @@
-{"version":3,"file":"iterateDriveItems.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateDriveItems.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAKxE;;;;;;GAMG;AACH,wBAA+B,iBAAiB,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,EAAE,WAAW,SAAO,GAAG,cAAc,CAAC,SAAS,GAAG,YAAY,CAAC,CA0BjJ"}
+{"version":3,"file":"iterateDriveItems.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateDriveItems.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAKxE;;;;;;GAMG;AACH,wBAA+B,iBAAiB,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,EAAE,WAAW,SAAO,GAAG,cAAc,CAAC,SAAS,GAAG,YAAY,CAAC,CAyBjJ"}