microsoft-graph 2.35.0 → 2.37.0

package/dist/esm/services/httpStatus.js

@@ -40,7 +40,7 @@ export function isHttpTooManyRequests(status) {
  * @param status - The HTTP status code.
  * @returns True if the status code is 503, otherwise false.
  */
-export function isServiceUnavailable(status) {
+export function isHttpServiceUnavailable(status) {
     return status === 503;
 }
 /**
@@ -48,7 +48,7 @@ export function isServiceUnavailable(status) {
  * @param status - The HTTP status code.
  * @returns True if the status code is 504, otherwise false.
  */
-export function isGatewayTimeout(status) {
+export function isHttpGatewayTimeout(status) {
     return status === 504;
 }
 /**
@@ -56,6 +56,185 @@ export function isGatewayTimeout(status) {
  * @param status - The HTTP status code.
  * @returns True if the status code is 423, otherwise false.
  */
-export function isLocked(status) {
+export function isHttpLocked(status) {
     return status === 423;
 }
+/**
+ * Checks if the HTTP status code indicates a bad request.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 400, otherwise false.
+ */
+export function isHttpBadRequest(status) {
+    return status === 400;
+}
+/**
+ * Checks if the HTTP status code indicates unauthorized access.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 401, otherwise false.
+ */
+export function isHttpUnauthorized(status) {
+    return status === 401;
+}
+/**
+ * Checks if the HTTP status code indicates payment required.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 402, otherwise false.
+ */
+export function isHttpPaymentRequired(status) {
+    return status === 402;
+}
+/**
+ * Checks if the HTTP status code indicates forbidden access.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 403, otherwise false.
+ */
+export function isHttpForbidden(status) {
+    return status === 403;
+}
+/**
+ * Checks if the HTTP status code indicates method not allowed.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 405, otherwise false.
+ */
+export function isHttpMethodNotAllowed(status) {
+    return status === 405;
+}
+/**
+ * Checks if the HTTP status code indicates not acceptable.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 406, otherwise false.
+ */
+export function isHttpNotAcceptable(status) {
+    return status === 406;
+}
+/**
+ * Checks if the HTTP status code indicates a conflict.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 409, otherwise false.
+ */
+export function isHttpConflict(status) {
+    return status === 409;
+}
+/**
+ * Checks if the HTTP status code indicates gone.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 410, otherwise false.
+ */
+export function isHttpGone(status) {
+    return status === 410;
+}
+/**
+ * Checks if the HTTP status code indicates length required.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 411, otherwise false.
+ */
+export function isHttpLengthRequired(status) {
+    return status === 411;
+}
+/**
+ * Checks if the HTTP status code indicates precondition failed.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 412, otherwise false.
+ */
+export function isHttpPreconditionFailed(status) {
+    return status === 412;
+}
+/**
+ * Checks if the HTTP status code indicates request entity too large.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 413, otherwise false.
+ */
+export function isHttpRequestEntityTooLarge(status) {
+    return status === 413;
+}
+/**
+ * Checks if the HTTP status code indicates unsupported media type.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 415, otherwise false.
+ */
+export function isHttpUnsupportedMediaType(status) {
+    return status === 415;
+}
+/**
+ * Checks if the HTTP status code indicates requested range not satisfiable.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 416, otherwise false.
+ */
+export function isHttpRequestedRangeNotSatisfiable(status) {
+    return status === 416;
+}
+/**
+ * Checks if the HTTP status code indicates unprocessable entity.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 422, otherwise false.
+ */
+export function isHttpUnprocessableEntity(status) {
+    return status === 422;
+}
+/**
+ * Checks if the HTTP status code indicates insufficient storage.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 507, otherwise false.
+ */
+export function isHttpInsufficientStorage(status) {
+    return status === 507;
+}
+/**
+ * Checks if the HTTP status code indicates bandwidth limit exceeded.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 509, otherwise false.
+ */
+export function isHttpBandwidthLimitExceeded(status) {
+    return status === 509;
+}
+/**
+ * Checks if the HTTP status code indicates internal server error.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 500, otherwise false.
+ */
+export function isHttpInternalServerError(status) {
+    return status === 500;
+}
+/**
+ * Checks if the HTTP status code indicates not implemented.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 501, otherwise false.
+ */
+export function isHttpNotImplemented(status) {
+    return status === 501;
+}
+/**
+ * Checks if the HTTP status code indicates a request timeout.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 408, otherwise false.
+ */
+export function isHttpRequestTimeout(status) {
+    return status === 408;
+}
+/**
+ * Checks if the HTTP status code indicates a bad gateway.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 502, otherwise false.
+ */
+export function isHttpBadGateway(status) {
+    return status === 502;
+}
+/**
+ * Checks if the HTTP status code is considered retryable.
+ * Retryable status codes typically indicate a temporary condition.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is retryable, otherwise false.
+ */
+export function isRetryable(status) {
+    return (isHttpNotFound(status) ||
+        isHttpConflict(status) ||
+        isHttpLocked(status) ||
+        isHttpTooManyRequests(status) ||
+        isHttpInternalServerError(status) ||
+        isHttpServiceUnavailable(status) ||
+        isHttpGatewayTimeout(status) ||
+        isHttpInsufficientStorage(status) ||
+        isHttpBandwidthLimitExceeded(status) ||
+        isHttpRequestTimeout(status) ||
+        isHttpBadGateway(status));
+}

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

@@ -53,6 +53,14 @@ export type ResolvedObjectMapping<T> = {
  * @param rows Iterable or async iterable of cell arrays (rows).
  * @param rules Mapping rules for converting columns to object properties.
  * @yields Objects of type T, one for each data row.
+ * @example
+ * const rows = iterateRows(rangeRef)
+ * const rules = {
+ *    name: { columnPattern: /name/i },
+ *    age: { columnPattern: /age/i },
+ *  };
+ * const objs = await iterateToArray(rowsToObjectsWithHeader(rows, rules));
+ * // objs could be [{ name: "Alice", age: 30 }, { name: "Bob", age: 25 }]
  */
 export declare function rowsToObjectsWithHeader<T>(rows: Iterable<Cell[]> | AsyncIterable<Cell[]>, rules: ObjectMapping<T>): AsyncIterable<T>;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"objectMapping.d.ts","sourceRoot":"","sources":["../../../src/services/objectMapping.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAa,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGpE;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;KAC7B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG;QACjB;;;WAGG;QACH,aAAa,EAAE,MAAM,CAAC;QAEtB;;;;;;;WAOG;QACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAE9B;;;;;;;WAOG;QACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;KAC9B;CACD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI;KACrC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG;QACjB,YAAY,EAAE,YAAY,CAAC;QAC3B,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;KAC7B;CACD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAuB,uBAAuB,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAW3I;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAsC1H;AAED;;;;;;GAMG;AACH,wBAAuB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAI3I;AAED;;;;;;GAMG;AACH,wBAAuB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAIlJ;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAe5E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,CAW3F"}
+{"version":3,"file":"objectMapping.d.ts","sourceRoot":"","sources":["../../../src/services/objectMapping.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAa,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGpE;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;KAC7B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG;QACjB;;;WAGG;QACH,aAAa,EAAE,MAAM,CAAC;QAEtB;;;;;;;WAOG;QACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAE9B;;;;;;;WAOG;QACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;KAC9B;CACD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI;KACrC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG;QACjB,YAAY,EAAE,YAAY,CAAC;QAC3B,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;KAC7B;CACD,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAuB,uBAAuB,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAW3I;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAsC1H;AAED;;;;;;GAMG;AACH,wBAAuB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAI3I;AAED;;;;;;GAMG;AACH,wBAAuB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAIlJ;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAe5E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,CAW3F"}

package/dist/esm/services/objectMapping.js

@@ -11,6 +11,14 @@ import { generalCellFormat } from "./cell.js";
  * @param rows Iterable or async iterable of cell arrays (rows).
  * @param rules Mapping rules for converting columns to object properties.
  * @yields Objects of type T, one for each data row.
+ * @example
+ * const rows = iterateRows(rangeRef)
+ * const rules = {
+ *    name: { columnPattern: /name/i },
+ *    age: { columnPattern: /age/i },
+ *  };
+ * const objs = await iterateToArray(rowsToObjectsWithHeader(rows, rules));
+ * // objs could be [{ name: "Alice", age: 30 }, { name: "Bob", age: 25 }]
  */
 export async function* rowsToObjectsWithHeader(rows, rules) {
     let mapping = null;

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

@@ -10,17 +10,34 @@ export declare const endpoint = "https://graph.microsoft.com/v1.0";
  */
 export declare const batchEndpoint = "https://graph.microsoft.com/v1.0/$batch";
 /**
- * Define a operation.
- * @remarks Operations can be `await`d to execute independently, or passed with others as arguments to `parallel` or `sequential` to execute as part of a batch.
+ * Defines a Graph operation.
+ *
+ * Operations can be awaited to execute independently, or passed with others as arguments to {@link parallel} or {@link sequential} to execute as part of a batch.
+ *
+ * @typeParam T - The response type of the operation.
+ * @param definition Definition of the Graph operation.
+ * @returns GraphOperation instance.
  */
 export declare function operation<T>(definition: GraphOperationDefinition<T>): GraphOperation<T>;
 /**
  * Execute a batch of GraphAPI operations in parallel.
- * @remarks Provides the best performance for batch operations, however only useful if operations can logically be performed at the same time.
+ *
+ * Provides the best performance for batch operations, however only useful if operations can logically be performed at the same time.
+ *
+ * @typeParam T - Tuple of GraphOperation types.
+ * @param operations Operations to execute in parallel.
+ * @returns The responses for each operation, in the same order.
  */
 export declare function parallel<T extends GraphOperation<unknown>[]>(...operations: T): Promise<OperationResponse<T>>;
 /**
  * Execute a batch of GraphAPI operations sequentially.
+ *
+ * Each operation is dependent on the previous operation in the batch.
+ *
+ * @typeParam T - Tuple of GraphOperation types.
+ * @param operations Operations to execute sequentially.
+ * @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":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAO/G;;;GAGG;AACH,eAAO,MAAM,QAAQ,qCAAqC,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,aAAa,4CAAuB,CAAC;AAElD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAQvF;AAED;;;GAGG;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;;GAEG;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"}
+{"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;AAsMD,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAwE3E"}

package/dist/esm/services/operationInvoker.js

@@ -1,16 +1,32 @@
-/**
- * Invoke operations, potentially as parallel or sequential batches.
- * @module operationInvoker
- * @category Services
- **/
-import axios from "axios";
+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 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 RequestFailedError from "../errors/RequestFailedError.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 { isGatewayTimeout, isHttpSuccess, isHttpTooManyRequests, isLocked, isServiceUnavailable } from "./httpStatus.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 { operationIdToIndex, operationIndexToId } from "./operationId.js";
 import { sleep } from "./sleep.js";
 /**
@@ -24,8 +40,13 @@ export const endpoint = "https://graph.microsoft.com/v1.0";
  */
 export const batchEndpoint = `${endpoint}/$batch`;
 /**
- * Define a operation.
- * @remarks Operations can be `await`d to execute independently, or passed with others as arguments to `parallel` or `sequential` to execute as part of a batch.
+ * Defines a Graph operation.
+ *
+ * Operations can be awaited to execute independently, or passed with others as arguments to {@link parallel} or {@link sequential} to execute as part of a batch.
+ *
+ * @typeParam T - The response type of the operation.
+ * @param definition Definition of the Graph operation.
+ * @returns GraphOperation instance.
  */
 export function operation(definition) {
     const single = async (definition) => {
@@ -37,7 +58,12 @@ export function operation(definition) {
 }
 /**
  * Execute a batch of GraphAPI operations in parallel.
- * @remarks Provides the best performance for batch operations, however only useful if operations can logically be performed at the same time.
+ *
+ * Provides the best performance for batch operations, however only useful if operations can logically be performed at the same time.
+ *
+ * @typeParam T - Tuple of GraphOperation types.
+ * @param operations Operations to execute in parallel.
+ * @returns The responses for each operation, in the same order.
  */
 export async function parallel(...operations) {
     const definitions = operations.map((op) => op.definition);
@@ -45,6 +71,12 @@ export async function parallel(...operations) {
 }
 /**
  * Execute a batch of GraphAPI operations sequentially.
+ *
+ * Each operation is dependent on the previous operation in the batch.
+ *
+ * @typeParam T - Tuple of GraphOperation types.
+ * @param operations Operations to execute sequentially.
+ * @returns The responses for each operation, in the same order.
  */
 export async function sequential(...operations) {
     const definitions = operations.map((definition, index) => ({
@@ -54,7 +86,7 @@ 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 = 5;
+const maxRetries = 3;
 const defaultRetryDelayMilliseconds = 1000;
 const consecutiveRetryDelayMultiplier = 2;
 async function executeSingle(definition) {
@@ -114,70 +146,172 @@ async function executeBatch(...ops) {
             throw new ProtocolError("Reference to operation that was not submitted in the batch");
         }
         if (!isHttpSuccess(r.status)) {
-            const bodyError = body;
-            let errorMessage = `${r.status}`;
-            if (bodyError?.error) {
-                errorMessage += `: [${bodyError.error.code}] '${bodyError.error.message}'`;
-            }
-            RequestFailedError.throw(`GraphAPI operation ${index} failed: ${errorMessage}`, op, r);
+            throwException(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.
 }
-/** Execute request, supporting GraphAPI retry logic */
-// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: This function does need to be simplified, though it is a TODO for another day
-async function innerFetch(args) {
-    const { url, ...options } = args;
-    if (!url) {
-        throw new Error("URL is required for request");
-    }
+async function innerFetch(request) {
     let retryAfterMilliseconds = defaultRetryDelayMilliseconds;
     let response = null;
-    let retry = 0;
-    while (retry < maxRetries) {
-        try {
-            response = await executeHttpRequest({
-                url,
-                ...options,
-            });
+    let attempts = 0;
+    let errorLog = "";
+    while (true) {
+        response = await executeHttpRequest(request);
+        errorLog += requestToString(request);
+        errorLog += responseToString(response);
+        attempts++;
+        if (isHttpSuccess(response.status) || !isRetryable(response.status) || attempts === maxRetries) {
             break;
         }
-        catch (error) {
-            if (axios.isAxiosError(error) && error.response) {
-                response = error.response;
-                if (!(isHttpTooManyRequests(response.status) || isServiceUnavailable(response.status) || isGatewayTimeout(response.status) || isLocked(response.status))) {
-                    throw error;
-                }
-                const requestedRetryAfterSeconds = Number.parseInt(response.headers["retry-after"] ?? "0", 10);
-                if (requestedRetryAfterSeconds) {
-                    retryAfterMilliseconds = requestedRetryAfterSeconds * 1000;
-                }
-                await sleep(retryAfterMilliseconds);
-                retryAfterMilliseconds *= consecutiveRetryDelayMultiplier;
-                retry++;
-                if (retry >= maxRetries) {
-                    RequestFailedError.throw(`GraphAPI fetch exceed retry limit of ${maxRetries} attempts.`, args);
-                }
-            }
-            else {
-                throw error;
-            }
+        const requestedRetryAfterSeconds = Number.parseInt(response.headers["retry-after"] ?? "0", 10);
+        if (requestedRetryAfterSeconds) {
+            retryAfterMilliseconds = requestedRetryAfterSeconds * 1000;
         }
+        errorLog += waitToString(retryAfterMilliseconds);
+        await sleep(retryAfterMilliseconds);
+        retryAfterMilliseconds *= consecutiveRetryDelayMultiplier;
     }
     if (!response) {
         throw new NeverError("Response is empty.");
     }
     if (!isHttpSuccess(response.status)) {
-        const bodyError = response.data;
-        let errorMessage = `${response.status} '${response.statusText}'`;
-        if (bodyError?.error) {
-            errorMessage += `: [${bodyError.error.code}] '${bodyError.error.message}'`;
-        }
-        RequestFailedError.throw(`GraphAPI fetch failed: ${errorMessage}`, args, response.data);
+        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);
+}
+// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Simple enough
+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/tasks/iterateWorkbookRangeRows.js

@@ -91,7 +91,7 @@ async function getFill(rangeRef, scope) {
     };
 }
 async function getBorders(rangeRef, scope) {
-    if (!scope.borders) {
+    if (!scope.border) {
         return {};
     }
     const response = await listWorkbookRangeBorders(rangeRef);
@@ -140,8 +140,8 @@ function calculateMaxRowsPerOperation(columnCount, overwriteMaxCellsPerOperation
     return maxRowsPerOperation;
 }
 function scopeToRangeSelect(scope) {
-    if (!(scope.values || scope.text || scope.format)) {
+    if (!(scope.value || scope.text || scope.format)) {
         return null;
     }
-    return { values: scope.values ?? false, text: scope.text ?? false, numberFormat: scope.format ?? false };
+    return { values: scope.value ?? false, text: scope.text ?? false, numberFormat: scope.format ?? false };
 }