microsoft-graph 2.23.0 → 2.24.0

package/dist/cjs/graphApi.js

@@ -1,4 +1,5 @@
 "use strict";
+// TODO: Move to `services/operationInvoker.ts` at next major version.
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -7,6 +8,11 @@ exports.batchEndpoint = exports.endpoint = void 0;
 exports.operation = operation;
 exports.parallel = parallel;
 exports.sequential = sequential;
+/**
+ * Invoke operations, potentially as parallel or sequential batches.
+ * @module operationInvoker
+ * @category Services
+ **/
 const axios_1 = __importDefault(require("axios"));
 const InconsistentContextError_ts_1 = __importDefault(require("./errors/InconsistentContextError.js"));
 const InvalidArgumentError_ts_1 = __importDefault(require("./errors/InvalidArgumentError.js"));
@@ -17,9 +23,20 @@ const http_ts_1 = require("./services/http.js");
 const httpStatus_ts_1 = require("./services/httpStatus.js");
 const operationId_ts_1 = require("./services/operationId.js");
 const sleep_ts_1 = require("./services/sleep.js");
+/**
+ * Endpoint for submitting individual requests.
+ * @internal
+ */
 exports.endpoint = "https://graph.microsoft.com/v1.0";
+/**
+ * Endpoint for submitting batch requests.
+ * @internal
+ */
 exports.batchEndpoint = `${exports.endpoint}/$batch`;
-/** Define a operation, which can either be `await`d to execute independently, or passed with other operations ot `parallel` or `sequential` to execute as part of a 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.
+ */
 function operation(definition) {
     const single = async (definition) => {
         return await executeSingle(definition);
@@ -28,12 +45,17 @@ function operation(definition) {
     op.definition = definition;
     return op;
 }
-/** Execute a batch of GraphAPI operations in parallel. Provides the best performance for batch operations, however only useful if operations can logically be performed at the same time. */
+/**
+ * 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.
+ */
 async function parallel(...operations) {
     const definitions = operations.map((op) => op.definition);
     return (await executeBatch(...definitions));
 }
-/** Execute a batch of GraphAPI operations sequentially. */
+/**
+ * Execute a batch of GraphAPI operations sequentially.
+ */
 async function sequential(...operations) {
     const definitions = operations.map((definition, index) => ({
         ...definition.definition,

package/dist/cjs/models/AccessToken.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Token sent to server to authenticate a request.
+ * @remarks May be automatically generated by graphApi (for instance, when `createClientSecretContext` or `createContext` is used with a `accessTokenGenerator`) or may be static (ie when `createAccessTokenContext` is used).
+ * @module AccessToken
+ * @category Models
+ */
 export type AccessToken = string & {
     __brand: "AccessToken";
 };

package/dist/cjs/models/AccessToken.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AccessToken.d.ts","sourceRoot":"","sources":["../../../src/models/AccessToken.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IAClC,OAAO,EAAE,aAAa,CAAC;CACvB,CAAC"}
+{"version":3,"file":"AccessToken.d.ts","sourceRoot":"","sources":["../../../src/models/AccessToken.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IAClC,OAAO,EAAE,aAAa,CAAC;CACvB,CAAC"}

package/dist/cjs/models/AccessTokenGenerator.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Callback function that generates an access token.
+ * @remarks Passed to `createContext`.
+ * @module AccessTokenGenerator
+ * @category Models
+ */
 import type { AccessToken } from "./AccessToken.ts";
 export type AccessTokenGenerator = () => Promise<AccessToken>;
 //# sourceMappingURL=AccessTokenGenerator.d.ts.map

package/dist/cjs/models/AccessTokenGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AccessTokenGenerator.d.ts","sourceRoot":"","sources":["../../../src/models/AccessTokenGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC"}
+{"version":3,"file":"AccessTokenGenerator.d.ts","sourceRoot":"","sources":["../../../src/models/AccessTokenGenerator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC"}

package/dist/cjs/models/AccessTokenGenerator.js

@@ -1,2 +1,8 @@
 "use strict";
+/**
+ * Callback function that generates an access token.
+ * @remarks Passed to `createContext`.
+ * @module AccessTokenGenerator
+ * @category Models
+ */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/models/Address.d.ts

@@ -1,8 +1,51 @@
+/**
+ * Address of a set of cells in a spreadsheet.
+ * @module Address
+ * @category Models
+ */
+/**
+ * Address of a single column in a worksheet.
+ * @example 'C'
+ */
 export type ColumnAddress = `${Uppercase<string>}`;
+/**
+ * Address of multiple consecutive columns in a worksheet ().
+ * @example 'C:D'
+ */
 export type ColumnRangeAddress = `${CellAddress}:${CellAddress}`;
+/**
+ * Address of a single row in a worksheet.
+ * @example '3'
+ */
 export type RowAddress = `${number}`;
+/**
+ * Address of multiple consecutive rows in a worksheet.
+ * @example '3:5'
+ */
 export type RowRangeAddress = `${RowAddress}:${RowAddress}`;
+/**
+ * Address of a single cell in a worksheet.
+ * @example 'C3'
+ */
 export type CellAddress = `${ColumnAddress}${RowAddress}`;
+/**
+ * Address of a range of cells in a worksheet.
+ * @example 'C3:D5'
+ */
 export type CellRangeAddress = `${CellAddress}:${CellAddress}`;
+/**
+ * Any type of address.
+ * @remarks This is a union of all the address types defined above.
+ * @example 'C', 'C:D', '3', '3:5', 'C3', 'C3:D5'
+ */
 export type Address = ColumnAddress | RowAddress | ColumnRangeAddress | RowRangeAddress | CellRangeAddress | CellAddress;
+/**
+ * Address when decomposed into its components.
+ */
+export type DecomposedAddress = {
+    startColumn: ColumnAddress;
+    endColumn: ColumnAddress;
+    startRow: RowAddress;
+    endRow: RowAddress;
+};
 //# sourceMappingURL=Address.d.ts.map

package/dist/cjs/models/Address.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Address.d.ts","sourceRoot":"","sources":["../../../src/models/Address.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;AACnD,MAAM,MAAM,kBAAkB,GAAG,GAAG,WAAW,IAAI,WAAW,EAAE,CAAC;AAEjE,MAAM,MAAM,UAAU,GAAG,GAAG,MAAM,EAAE,CAAC;AACrC,MAAM,MAAM,eAAe,GAAG,GAAG,UAAU,IAAI,UAAU,EAAE,CAAC;AAE5D,MAAM,MAAM,WAAW,GAAG,GAAG,aAAa,GAAG,UAAU,EAAE,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,GAAG,WAAW,IAAI,WAAW,EAAE,CAAC;AAE/D,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,UAAU,GAAG,kBAAkB,GAAG,eAAe,GAAG,gBAAgB,GAAG,WAAW,CAAC"}
+{"version":3,"file":"Address.d.ts","sourceRoot":"","sources":["../../../src/models/Address.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,GAAG,WAAW,IAAI,WAAW,EAAE,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,GAAG,MAAM,EAAE,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,UAAU,IAAI,UAAU,EAAE,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,aAAa,GAAG,UAAU,EAAE,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,GAAG,WAAW,IAAI,WAAW,EAAE,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,UAAU,GAAG,kBAAkB,GAAG,eAAe,GAAG,gBAAgB,GAAG,WAAW,CAAC;AAEzH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B,WAAW,EAAE,aAAa,CAAC;IAC3B,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;CACnB,CAAC"}

package/dist/cjs/models/Address.js

@@ -1,2 +1,7 @@
 "use strict";
+/**
+ * Address of a set of cells in a spreadsheet.
+ * @module Address
+ * @category Models
+ */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/models/AzureApplicationCredentials.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Credentials used to authenticate an application with Azure.
+ * @module AzureApplicationCredentials
+ * @category Models
+ */
+/**
+ * Application Client ID to authenticate with Azure.
+ */
+export type AzureClientId = string & {
+    __brand: "AzureClientId";
+};
+/**
+ * Application Client secret to authenticate with Azure.
+ */
+export type AzureClientSecret = string & {
+    __brand: "AzureClientSecret";
+};
+/**
+ * ID of tenant in Azure.
+ */
+export type AzureTenantId = string & {
+    __brand: "AzureTenantId";
+};
+/**
+ * Scope for which the access token is requested.
+ * @remarks Typically, this is set to "https://graph.microsoft.com/.default" for Microsoft Graph API.
+ */
+export type Scope = string & {
+    __brand: "Scope";
+};
+//# sourceMappingURL=AzureApplicationCredentials.d.ts.map

package/dist/cjs/models/AzureApplicationCredentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AzureApplicationCredentials.d.ts","sourceRoot":"","sources":["../../../src/models/AzureApplicationCredentials.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IACpC,OAAO,EAAE,eAAe,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG;IACxC,OAAO,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IACpC,OAAO,EAAE,eAAe,CAAC;CACzB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG;IAC5B,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC"}

package/dist/cjs/models/AzureApplicationCredentials.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Credentials used to authenticate an application with Azure.
+ * @module AzureApplicationCredentials
+ * @category Models
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/models/Cartesian.d.ts

@@ -1,9 +1,26 @@
+/**
+ * Cartesian coordinates of a set of cells in a spreadsheet.
+ * @module Cartesian
+ * @category Models
+ */
 import type { ColumnOffset } from "../models/ColumnOffset.ts";
 import type { RowOffset } from "../models/RowOffset.ts";
 export type Cartesian = {
+    /**
+     * The column offset of the top-left cell in the Cartesian coordinates.
+     */
     ax: ColumnOffset;
+    /**
+     * The row offset of the top-left cell in the Cartesian coordinates.
+     */
     ay: RowOffset;
+    /**
+     * The column offset of the bottom-right cell in the Cartesian coordinates.
+     */
     bx: ColumnOffset;
+    /**
+     * The row offset of the bottom-right cell in the Cartesian coordinates.
+     */
     by: RowOffset;
 };
 //# sourceMappingURL=Cartesian.d.ts.map

package/dist/cjs/models/Cartesian.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Cartesian.d.ts","sourceRoot":"","sources":["../../../src/models/Cartesian.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,MAAM,SAAS,GAAG;IACvB,EAAE,EAAE,YAAY,CAAC;IACjB,EAAE,EAAE,SAAS,CAAC;IACd,EAAE,EAAE,YAAY,CAAC;IACjB,EAAE,EAAE,SAAS,CAAC;CACd,CAAC"}
+{"version":3,"file":"Cartesian.d.ts","sourceRoot":"","sources":["../../../src/models/Cartesian.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,MAAM,SAAS,GAAG;IACvB;;OAEG;IACH,EAAE,EAAE,YAAY,CAAC;IAEjB;;OAEG;IACH,EAAE,EAAE,SAAS,CAAC;IAEd;;OAEG;IACH,EAAE,EAAE,YAAY,CAAC;IAEjB;;OAEG;IACH,EAAE,EAAE,SAAS,CAAC;CACd,CAAC"}

package/dist/cjs/models/Cartesian.js

@@ -1,2 +1,7 @@
 "use strict";
+/**
+ * Cartesian coordinates of a set of cells in a spreadsheet.
+ * @module Cartesian
+ * @category Models
+ */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/models/Cell.d.ts

@@ -1,9 +1,28 @@
-import type { CellValue } from "../models/CellValue.ts";
+/**
+ * Cell in a worksheet.
+ * @module Cell
+ * @category Models
+ */
 import type { CellText } from "./CellText.ts";
+import type { CellValue } from "./CellValue.ts";
 import type { NumberFormat } from "./NumberFormat.ts";
+/**
+ * Cell in a worksheet.
+ * @remarks Contrary to common expectation, while a cell does contain a single value, it also contains a text representation of that value and a number format that often defines that representation.
+ */
 export type Cell = {
+    /**
+     * The text representation of the cell's value.
+     * @remarks This is often the same as the value, but can differ in cases where the value is a number and the text representation is formatted (e.g., "1,000" vs. 1000), or in the case of the value being a formula.
+     */
     text: CellText;
+    /**
+     * The actual value of the cell.
+     */
     value: CellValue;
+    /**
+     * Formatting that is applied to the value to derive the text representation.
+     */
     numberFormat: NumberFormat;
 };
 //# sourceMappingURL=Cell.d.ts.map

package/dist/cjs/models/Cell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Cell.d.ts","sourceRoot":"","sources":["../../../src/models/Cell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,IAAI,GAAG;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;CAC3B,CAAC"}
+{"version":3,"file":"Cell.d.ts","sourceRoot":"","sources":["../../../src/models/Cell.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG;IAClB;;;OAGG;IACH,IAAI,EAAE,QAAQ,CAAC;IAEf;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,YAAY,EAAE,YAAY,CAAC;CAC3B,CAAC"}

package/dist/cjs/models/Cell.js

@@ -1,2 +1,7 @@
 "use strict";
+/**
+ * Cell in a worksheet.
+ * @module Cell
+ * @category Models
+ */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/models/CellText.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Text content of a cell in a worksheet.
+ * @remarks This is a string that represents the text displayed in the cell, which may differ from the actual value of the cell (e.g., due to formatting).
+ * @module CellText
+ * @category Models
+ */
 export type CellText = string & {
     __brand: "CellText";
 };

package/dist/cjs/models/CellText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CellText.d.ts","sourceRoot":"","sources":["../../../src/models/CellText.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAC/B,OAAO,EAAE,UAAU,CAAC;CACpB,CAAC"}
+{"version":3,"file":"CellText.d.ts","sourceRoot":"","sources":["../../../src/models/CellText.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAC/B,OAAO,EAAE,UAAU,CAAC;CACpB,CAAC"}

package/dist/cjs/models/CellText.js

@@ -1,2 +1,3 @@
 "use strict";
+// TODO: Move to `Cell.ts` at next major version.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/models/CellValue.d.ts

@@ -1,2 +1,8 @@
+/**
+ * CellValue represents the value of a cell in a spreadsheet.
+ * @module CellValue
+ * @category Models
+ * @see {@link Cell} for a more comprehensive representation of a cell, which includes text and formatting.
+ */
 export type CellValue = string | number | boolean;
 //# sourceMappingURL=CellValue.d.ts.map

package/dist/cjs/models/CellValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CellValue.d.ts","sourceRoot":"","sources":["../../../src/models/CellValue.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC"}
+{"version":3,"file":"CellValue.d.ts","sourceRoot":"","sources":["../../../src/models/CellValue.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC"}

package/dist/cjs/models/CellValue.js

@@ -1,2 +1,3 @@
 "use strict";
+// TODO: Move to `Cell.ts` at next major version.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/models/ColumnName.d.ts

@@ -1,5 +1,7 @@
 /**
- * Column name configured by user
+ * Name of a column, as configured by the user.
+ * @module ColumnName
+ * @category Models
  */
 export type ColumnName = string & {
     __brand: "ColumnName";

package/dist/cjs/models/ColumnName.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ColumnName.d.ts","sourceRoot":"","sources":["../../../src/models/ColumnName.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IACjC,OAAO,EAAE,YAAY,CAAC;CACtB,CAAC"}
+{"version":3,"file":"ColumnName.d.ts","sourceRoot":"","sources":["../../../src/models/ColumnName.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IACjC,OAAO,EAAE,YAAY,CAAC;CACtB,CAAC"}

package/dist/cjs/models/ColumnOffset.d.ts

@@ -1,5 +1,7 @@
 /**
- * Column offset in a table. First column is 0.
+ * Zero-based index representing the position of a column in a range.
+ * @module ColumnOffset
+ * @category Models
  */
 export type ColumnOffset = number & {
     __brand: "ColumnOffset";

package/dist/cjs/models/ColumnOffset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ColumnOffset.d.ts","sourceRoot":"","sources":["../../../src/models/ColumnOffset.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IACnC,OAAO,EAAE,cAAc,CAAC;CACxB,CAAC"}
+{"version":3,"file":"ColumnOffset.d.ts","sourceRoot":"","sources":["../../../src/models/ColumnOffset.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IACnC,OAAO,EAAE,cAAc,CAAC;CACxB,CAAC"}

package/dist/cjs/models/Context.d.ts

@@ -1,5 +1,13 @@
+/**
+ * Context of requests.
+ * @module Context
+ * @category Models
+ */
 import type { AccessTokenGenerator } from "./AccessTokenGenerator.ts";
 export type Context = {
+    /**
+     * Method to generate an access token to use to authenticate the request.
+     */
     generateAccessToken: AccessTokenGenerator;
 };
 //# sourceMappingURL=Context.d.ts.map

package/dist/cjs/models/Context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Context.d.ts","sourceRoot":"","sources":["../../../src/models/Context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,MAAM,OAAO,GAAG;IACrB,mBAAmB,EAAE,oBAAoB,CAAC;CAC1C,CAAC"}
+{"version":3,"file":"Context.d.ts","sourceRoot":"","sources":["../../../src/models/Context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,MAAM,OAAO,GAAG;IACrB;;OAEG;IACH,mBAAmB,EAAE,oBAAoB,CAAC;CAC1C,CAAC"}

package/dist/cjs/models/Context.js

@@ -1,2 +1,7 @@
 "use strict";
+/**
+ * Context of requests.
+ * @module Context
+ * @category Models
+ */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/models/ContextRef.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Reference to a context
+ * @module ContextRef
+ * @category Models
+ */
 import type { Context } from "./Context.ts";
 export type ContextRef = {
     context: Context;

package/dist/cjs/models/ContextRef.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContextRef.d.ts","sourceRoot":"","sources":["../../../src/models/ContextRef.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC"}
+{"version":3,"file":"ContextRef.d.ts","sourceRoot":"","sources":["../../../src/models/ContextRef.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC"}

package/dist/cjs/models/ContextRef.js

@@ -1,2 +1,7 @@
 "use strict";
+/**
+ * Reference to a context
+ * @module ContextRef
+ * @category Models
+ */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/models/DriveId.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Identifier for a drive.
+ * @module DriveId
+ * @category Models
+ */
 export type DriveId = string & {
     __brand: "DriveId";
 };

package/dist/cjs/models/DriveId.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DriveId.d.ts","sourceRoot":"","sources":["../../../src/models/DriveId.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAC9B,OAAO,EAAE,SAAS,CAAC;CACnB,CAAC"}
+{"version":3,"file":"DriveId.d.ts","sourceRoot":"","sources":["../../../src/models/DriveId.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAC9B,OAAO,EAAE,SAAS,CAAC;CACnB,CAAC"}

package/dist/cjs/models/DriveItemId.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Identifier for an item in a drive.
+ * @module DriveItemId
+ * @category Models
+ */
 export type DriveItemId = string & {
     __brand: "DriveItemId";
 };

package/dist/cjs/models/DriveItemId.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DriveItemId.d.ts","sourceRoot":"","sources":["../../../src/models/DriveItemId.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IAClC,OAAO,EAAE,aAAa,CAAC;CACvB,CAAC"}
+{"version":3,"file":"DriveItemId.d.ts","sourceRoot":"","sources":["../../../src/models/DriveItemId.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IAClC,OAAO,EAAE,aAAa,CAAC;CACvB,CAAC"}

package/dist/cjs/models/DriveItemPath.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Path of an item in a drive.
+ * @module DriveItemPath
+ * @category Models
+ */
 export type DriveItemPath = string & {
     __brand: "DriveItemPath";
 };

package/dist/cjs/models/DriveItemPath.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DriveItemPath.d.ts","sourceRoot":"","sources":["../../../src/models/DriveItemPath.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IACpC,OAAO,EAAE,eAAe,CAAC;CACzB,CAAC"}
+{"version":3,"file":"DriveItemPath.d.ts","sourceRoot":"","sources":["../../../src/models/DriveItemPath.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IACpC,OAAO,EAAE,eAAe,CAAC;CACzB,CAAC"}

package/dist/cjs/models/DriveItemRef.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Reference to an item in a drive.
+ * @module DriveItemRef
+ * @category Models
+ */
 import type { DriveItemId } from "./DriveItemId.ts";
 import type { DriveRef } from "./DriveRef.ts";
 export type DriveItemRef = DriveRef & {

package/dist/cjs/models/DriveItemRef.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DriveItemRef.d.ts","sourceRoot":"","sources":["../../../src/models/DriveItemRef.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG;IACrC,MAAM,EAAE,WAAW,CAAC;CACpB,CAAC"}
+{"version":3,"file":"DriveItemRef.d.ts","sourceRoot":"","sources":["../../../src/models/DriveItemRef.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG;IACrC,MAAM,EAAE,WAAW,CAAC;CACpB,CAAC"}

package/dist/cjs/models/DriveItemRef.js

@@ -1,2 +1,8 @@
 "use strict";
+// TODO: Move to DriveItem.ts
+/**
+ * Reference to an item in a drive.
+ * @module DriveItemRef
+ * @category Models
+ */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/models/DriveRef.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Reference to a drive.
+ * @module DriveRef
+ * @category Models
+ */
 import type { DriveId } from "./DriveId.ts";
 import type { SiteRef } from "./SiteRef.ts";
 export type DriveRef = SiteRef & {

package/dist/cjs/models/DriveRef.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DriveRef.d.ts","sourceRoot":"","sources":["../../../src/models/DriveRef.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG;IAChC,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC"}
+{"version":3,"file":"DriveRef.d.ts","sourceRoot":"","sources":["../../../src/models/DriveRef.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG;IAChC,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC"}

package/dist/cjs/models/DriveRef.js

@@ -1,2 +1,8 @@
 "use strict";
+// Move to Drive.ts
+/**
+ * Reference to a drive.
+ * @module DriveRef
+ * @category Models
+ */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/models/GraphOperation.d.ts

@@ -1,28 +1,40 @@
+/**
+ * An atomic operation to be performed against the Microsoft Graph API.
+ * @module GraphOperation
+ * @category Models
+ */
 import type { Context } from "./Context.ts";
-import type { WorkbookSessionId } from "./WorkbookSessionId.ts";
-export type GraphMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-export type GraphPath = string & {
-    __brand: "Path";
-};
-export type GraphHeaders = {
-    "workbook-session-id"?: WorkbookSessionId | undefined;
-    "content-type"?: string | undefined;
-};
+import type { HttpHeaders, HttpMethod, HttpPath } from "./Http.ts";
+/**
+ * Definition of an operation to be performed against the Microsoft Graph API.
+ * @template T The type of the response from the operation.
+ */
 export type GraphOperationDefinition<T> = {
     /** Context to match the operation to. Used for authentication etc. */
     context: Context;
     /** HTTP method to be used. */
-    method: GraphMethod;
+    method: HttpMethod;
     /** Relative resource URL for the individual request. Ie, if the absolute URL is `https://graph.microsoft.com/v1.0/users`, this path is `/users`. */
-    path: GraphPath;
+    path: HttpPath;
     /** HTTP headers to be used. When the body is supplied, a Content-Type header must be included. */
-    headers: GraphHeaders;
+    headers: HttpHeaders;
     /** JSON object or a base64 URL-encoded value, for example, when the body is an image. When a body is included with the request, the headers object must contain a value for Content-Type. */
     body: unknown;
     /** Translate the server response into a usable model */
     responseTransform: (response: unknown) => T;
 };
+/**
+ * Instance of an operation to be performed against the Microsoft Graph API.
+ * @template T The type of the response from the operation.
+ */
 export type GraphOperation<T> = Promise<T> & {
     definition: GraphOperationDefinition<T>;
 };
+/**
+ * Response from a batch of Graph operations.
+ * @template T The type of the operations in the batch.
+ */
+export type OperationResponse<T> = {
+    [K in keyof T]: T[K] extends GraphOperation<infer R> ? R : never;
+};
 //# sourceMappingURL=GraphOperation.d.ts.map

package/dist/cjs/models/GraphOperation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GraphOperation.d.ts","sourceRoot":"","sources":["../../../src/models/GraphOperation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AACtE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AACrD,MAAM,MAAM,YAAY,GAAG;IAC1B,qBAAqB,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACtD,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,CAAC;AAGF,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAAI;IACzC,sEAAsE;IACtE,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,MAAM,EAAE,WAAW,CAAC;IACpB,oJAAoJ;IACpJ,IAAI,EAAE,SAAS,CAAC;IAChB,kGAAkG;IAClG,OAAO,EAAE,YAAY,CAAC;IACtB,6LAA6L;IAC7L,IAAI,EAAE,OAAO,CAAC;IACd,wDAAwD;IACxD,iBAAiB,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,CAAC,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG;IAC5C,UAAU,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC;CACxC,CAAC"}
+{"version":3,"file":"GraphOperation.d.ts","sourceRoot":"","sources":["../../../src/models/GraphOperation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAAI;IACzC,sEAAsE;IACtE,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,MAAM,EAAE,UAAU,CAAC;IACnB,oJAAoJ;IACpJ,IAAI,EAAE,QAAQ,CAAC;IACf,kGAAkG;IAClG,OAAO,EAAE,WAAW,CAAC;IACrB,6LAA6L;IAC7L,IAAI,EAAE,OAAO,CAAC;IACd,wDAAwD;IACxD,iBAAiB,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,CAAC,CAAC;CAC5C,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG;IAC5C,UAAU,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC;CACxC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI;KACjC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;CAChE,CAAC"}

package/dist/cjs/models/GraphOperation.js

@@ -1,2 +1,7 @@
 "use strict";
+/**
+ * An atomic operation to be performed against the Microsoft Graph API.
+ * @module GraphOperation
+ * @category Models
+ */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/models/HostName.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Name of a remote host, resolvable by DNS.
+ * @module HostName
+ * @category Models
+ */
 export type HostName = string & {
     __brand: "Hostname";
 };

package/dist/cjs/models/HostName.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HostName.d.ts","sourceRoot":"","sources":["../../../src/models/HostName.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAC/B,OAAO,EAAE,UAAU,CAAC;CACpB,CAAC"}
+{"version":3,"file":"HostName.d.ts","sourceRoot":"","sources":["../../../src/models/HostName.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAC/B,OAAO,EAAE,UAAU,CAAC;CACpB,CAAC"}